Perguntas frequentes sobre a descontinuidade da API do EWS
- Última atualização2024/11/06
Perguntas frequentes sobre a descontinuidade da API do EWS
A Microsoft anunciou a descontinuação para APIs EWS que são usadas para se conectar ao Exchange Online. Essa descontinuidade pode afetar as automações (bots) que usam o E-mail pacote ou o gatilho do E-mail com a opção EWS. Consulte as Perguntas frequentes para obter detalhes sobre a descontinuidade da API do EWS.
- O que é descontinuidade da API do EWS?
- A Microsoft descontinuou 25 APIs menos usadas do EWS desde 31 de março de 2022. Essa é uma descontinuação contínua e a Microsoft continuará descontinuando APIs EWS adicionais à medida que as APIs Graph equivalentes estiverem disponíveis.
Para saber mais sobre a descontinuação da API do EWS, consulte Upcoming API Deprecations in Exchange Web Services for Exchange Online.
- Por que essa mudança?
- O EWS é uma API herdada, que é menos segura e não atende às necessidades de segurança e gerenciabilidade do desenvolvimento de aplicativos modernos. De acordo com a Microsoft, é solicitado que você mude de APIs EWS baseadas em SOAP para API Graph baseada em REST se seus clientes ou aplicativos estiverem usando APIs EWS para se conectar ao servidor Exchange por meio do Exchange Online.O Microsoft Graph oferece as seguintes vantagens em comparação com o EWS:
- Segurança: O Microsoft Graph é mais seguro e tem políticas de governança mais rígidas com o OAuth e permite limitar o acesso aos dados em uma caixa de correio, em comparação com o modelo de acesso "tudo ou nada" no EWS.
- Simplicidade: O Microsoft Graph fornece o Graph Explorer para descobrir e testar APIs de forma fácil e rápida, SDKs em diferentes linguagens de programação e uma comunidade de desenvolvedores ativa.
- Eficiência: As APIs do Microsoft Graph são baseadas em REST, enquanto as APIs do EWS são baseadas em SOAP. A vantagem de usar protocolos baseados em REST inclui a serialização mais rápida de JSON e o menor uso da rede.
Nota: A descontinuação da API EWS se aplica somente ao Exchange Online e não à versão local do Exchange.
- Como essa descontinuidade me afetará?
- Por enquanto, você não será afetado porque o Automation 360 não usa nenhuma das APIs do EWS que foram descontinuadas pela Microsoft. De acordo com a Microsoft, as APIs do EWS não obsoletas continuarão a ter suporte para uso em ambientes de produção e não temos um cronograma fixo de quando essas APIs serão obsoletas no futuro.
Caso as APIs específicas do EWS usadas em Automation 360 fiquem obsoletas no futuro e se você tiver automatizado o e-mail usando E-mail do acionador pacote E-mail e ações com a opção EWS, essas automações serão interrompidas devido à falha de conexão com o Exchange Online.
- Onde o Automation 360 usa a API do EWS?
- Automation 360 utiliza a API do EWS no E-mail do pacote e gatilho de E-mail para a opção EWS que permite conectar ao Exchange Online hospedado no Azure Cloud e acessar e-mails pelo Microsoft 365.
- Como posso identificar os bots afetados que usam a opção EWS de E-mail?
- Você pode usar o utilitário Automation 360 Bot Scanner para o recurso descontinuado para fazer uma varredura e identificar os bots afetados que usam o EWS. Consulte Digitalizar bots para a autenticação Básica.
- Qual é a orientação para os clientes do Automation 360 mudarem da API do EWS para a API do Graph?
- Lançamos um novo Microsoft 365 Outlook pacote com Automation 360 v.29, que se baseia na versão mais recente da API do Graph. Você pode usar esse pacote para automatizar e-mails do Outlook para o Exchange Online. Esse pacote contém todas as ações semelhantes às disponíveis no E-mail pacote. Você pode usar o Microsoft 365 Outlook pacote em vez do E-mail pacote com a opção EWS para alternar da API do EWS para a API do Graph.
- Como faço para atualizar meus bots existentes para o Microsoft 365 Outlook pacote?
- Para atualizar os bots afetados existentes para o Microsoft 365 Outlook pacote, consulte Depreciação da APIs EWS no Exchange Online.
- A Automation Anywhere fornecerá alguma ferramenta para que os clientes do Automation 360 atualizem os bots da API do EWS para a API do Graph?
- Não. Você precisa atualizar manualmente os bots afetados para mudar para a API do Graph (Microsoft 365 Outlook pacote).
- Existe um mapeamento individual entre E-mail e Microsoft 365 Outlook pacotes ou há alguma diferença?
- Todos as ações disponíveis no E-mail
pacote também estão disponíveis no Microsoft 365 Outlook
pacote. No entanto, você precisa considerar as seguintes diferenças ao criar um bot com o novo Microsoft 365 Outlook
pacote:
- No pacote E-mail, as ações Enviar, Encaminhar, Responder e Responder a todos possuem parâmetros de conexão e, portanto, ao criar uma automação, você pode usar estas ações independentemente da ação Conectar. Contudo, no caso do pacote Microsoft 365 Outlook, você deve usar a ação Conectar antes de cada uma dessas ações já que se referem à sessão criada pela ação Conectar, consulte Microsoft 365 Outlook pacote
- O novo Microsoft 365 Outlook
pacote é compatível com dois modos de autenticação: Código de autorização com PKCE e credenciais de cliente. O E-mail
pacote com opção EWS é compatível com quatro modos de autenticação: ROPC, implícita, código de autorização com PKCE e credenciais de cliente.Nota: Os modos de autenticação ROPC e implícita estão obsoletos e, portanto, não são compatíveis com o Microsoft 365 Outlook pacote. Você deve usar o código de autorização mais seguro com o fluxo PKCE para automação assistida e o fluxo de credenciais do cliente para automação não assistida.