Depreciação da autenticação básica em troca on-line

A Microsoft desativará permanentemente a autenticação básica para protocolos específicos em Exchange Online a partir de 1º de outubro de 2022. Isso impacta os clientes que executam o bot para automação de e-mails que se conectam ao Exchange Online usando os protocolos IMAP, POP3, ou EWS com autenticação Básica.

Importante: Atualizamos o pacote E-mail e o gatilho E-mail com versões mais recentes, como mencionado abaixo:


Embalagem ou gatilho	Nova versão	Versão antiga
Pacote E-mail	Versão: 3.14.3-20220923-220748 Nome do arquivo: bot-command-email-3.14.3.jar	Versão: 3.14.1-20220831-084727 Nome do arquivo: bot-command-email-3.14.1.jar
Gatilho da E-mail	Versão: 2.8.3-20220923-171042 Nome do arquivo: bot-trigger-email-2.8.3.jar	Versão: 2.8.1-20220831-123116 Nome do arquivo: bot-trigger-email-2.8.1.jar

Recomendamos que você atualize seus bots impactados com as novas versões, uma vez que são compatíveis com os próximos lançamentos do Automation 360 v.27. Se você continuar a usar as versões antigas e atualizar para o lançamento Automation 360 v.27, você pode encontrar problemas ao importar ou exportar bots ou ao carregar as versões antigas do pacote para Automation 360 v.27. Para resolver essa questão, veja a solução fornecida em Tudo sobre a descontinuação da autenticação básica no Microsoft Exchange on-line (login no A-People necessário).

Forneceremos uma nova versão do pacote E-mail com o apoio do OAuth 2.0 em um próximo lançamento do Automation 360 somente embalagens até a semana de 29 de agosto de 2022.

Para garantir que seus bots existentes que estão usando a autenticação básica no Exchange Online são suportados depois que a autenticação básica for depreciada, recomendamos que você atualize os bots para usar o OAuth 2.0. Para identificar os bots do Automation 360 que estão usando a autenticação Básica no pacote E-mail ou gatilho E-mail, use o Bot Scanner para escanear bots. Isto ajuda você a planejar seus esforços para atualizar seus bots para OAuth 2.0 no Automation 360.

Atualização do bots Automation 360 para usar o OAuth 2.0

Atualização do cenário para atualização dos bots usando a autenticação básica para usar o OAuth

Atualize para a versão mais recente do Automation 360.
Atualização para a versão do Automation 360 mais recente
Faça um backup do repositório da Control Room.
Integração da Control Room com repositórios Git
Identifique os bots que estão usando a autenticação básica usando o Bot Scanner.
Digitalização Automation 360 bots para ação E-mail com o uso de autenticação Basic
Baixe a versão mais recente do pacote E-mail e adicione-a à sua Control Room.
Adicione pacotes à Control Room
Atualize os bots que estão usando a autenticação básica nas ações Conecte, Enviar, Avançar ou Resposta ou gatilho E-mail para usar o OAuth 2.0.
Depreciação da autenticação básica em troca on-line
Verifique se os bots atualizados podem ser implantados.
Executar um bot
Nota: Você pode atualizar seus bots para usar OAuth 2.0 em um ambiente (por exemplo, desenvolvimento ou DEV) e depois mover esses bots para outro ambiente (por exemplo, UAT e produção ou PROD) sem atualizar os bots em cada ambiente.

Protocolos impactados para a desvalorização da autenticação básica

A Microsoft está removendo a capacidade de usar a autenticação básica em Exchange Online para estes protocolos específicos: MAPI, RPC, OAB (Offline Address Book), Exchange Web Services (EWS), POP, IMAP, Exchange ActiveSync (EAS) e Remote PowerShell.

Nota: A SMTP AUTH está excluída desta desvalorização.

Qualquer cliente (por exemplo, aplicativo de usuário, script ou integração) usando autenticação Básica para um dos protocolos afetados não será capaz de se conectar ao servidor Exchange a partir de 1 de outubro de 2022. Um erro HTTP 401 (mau nome de usuário ou senha) será exibido.

Nota: Qualquer aplicativo que utilize OAuth 2.0 para estes protocolos não será afetado.

Para obter mais informações, consulte Substituição da autenticação básica no Exchange Online – Atualizações.

Atualização de bots usando autenticação básica para OAuth 2.0

Você deve atualizar seus bots que estão usando autenticação básica para OAuth 2.0 nas ações Conecte, Avançar, Resposta e Enviar do pacote E-mail e E-mail antes que a autenticação básica seja depreciada.

Nota: Esse procedimento é aplicável a ambos os clientes Automation 360Nuvem e No local.

Pré-requisitos

A pasta Configuração da instalação na pasta de downloads Autenticação 360 v.25 Basic Authentication MS Online - Deprecation contém os seguintes arquivos JAR:
- E-mail pacote (bot-command-email-3.14.1.jar)
  Certifique-se de baixar este pacote e adicione-a à Control Room no Automation 360.
- Gatilho de E-mail (bot-trigger-email-2.8.1.jar)
  Certifique-se de baixar esse pacote e adicione-a à Control Room no Automation 360
- Ouvinte do gatilho (triggerlistener.jar)
  Se você estiver na v.25 do Automation 360, certifique-se de baixar e instalar o arquivo do ouvinte do gatilho. Consulte Depreciação da autenticação básica em troca on-line.
Para informações sobre como adicionar pacotes para a Control Room, veja Adicione pacotes à Control Room.

Para baixar esses arquivos JAR, veja Tudo sobre a descontinuação da autenticação básica no Microsoft Exchange on-line (login no A-People necessário).
Assegure-se de que você tenha executado o utilitário Bot Scanner para as características depreciadas para identificar os bots que estão usando a autenticação básica em seu repositório da Control Room.
Consulte Digitalização Automation 360 bots para ação E-mail com o uso de autenticação Basic.
Certifique-se de ter registrado seu pedido no Portal do Azure e ter realizado as seguintes configurações para o fluxo de credenciais do cliente:
- IMAP/POP3
  1. Registrar um aplicativo
  2. Autenticar uma conexão IMAP, POP ou SMTP usando o OAuth
- EWS

Procedimento

Faça o login em sua Control Room como Bot Creator.
Selecione o bot que foi identificado no relatório do Bot Scanner para atualização.
Confira o bot para editá-lo.
No editor Bot, clique na elipse vertical no canto superior direito e clique em Pacotes.
Expandir a fila para o pacote E-mail.
Na lista suspensa de versões de pacote, selecione a versão Padrão.
Nota: Para o pacote E-mail, certifique de que a versão do pacote é 3.14.1-20220831-084727 ou posterior. Para o gatilho E-mail, certifique de que a versão do pacote é 2.8.1-20220831-123116 ou posterior.
Clique em Alterar versão e Salvar.
Clique em Retornar ao editor.
Clique na ação E-mail ou no gatilho E-mail que está usando o modo Básico de autenticação.
Clique na opção Servidor de e-mail ou Servidor EWS.

Na lista suspensa Modo de autenticação, escolha o modo OAuth 2.0 necessário.

Nota: Para automação de E-mail não assistida, use credenciais do cliente ou fluxos ROPC, e para atendimento da automação de E-mail, use fluxos implícitos ou PKCE. A Microsoft não recomenda o uso de ROPC e fluxos de legados implícitos. Portanto, recomendamos que você utilize as credenciais do cliente ou o fluxo PKCE.

A tabela a seguir fornece informações sobre os modos de autenticação OAuth 2.0 que estão disponíveis para as ação E-mail no servidor E-mail e nas opções de servidor EWS:


Ações do E-mail	servidor de E-mail	Servidor EWS
Conectar	OAuth2 - Código de autorização com PKCE OAuth2 - Credenciais de clientes	OAuth2 - ROPC OAuth2 - Implícito OAuth2 - Código de autorização com PKCE OAuth2 - Credenciais de clientes
Enviar	OAuth2 - Código de autorização com PKCE	OAuth2 - ROPC OAuth2 - Implícito OAuth2 - Código de autorização com PKCE OAuth2 - Credenciais de clientes
Encaminhar	OAuth2 - Código de autorização com PKCE	--
Responder	OAuth2 - Código de autorização com PKCE	--

A tabela a seguir fornece informações sobre os modos de autenticação OAuth 2.0 que estão disponíveis para os gatilhos E-mail no servidor E-mail e nas opções de servidor EWS:


Gatilhos	servidor de E-mail	Servidor EWS
Gatilho da E-mail	OAuth2 - Credenciais de clientes	OAuth2 - Credenciais de clientes

OAuth2 - ROPC: Utiliza o fluxo de senha do proprietário do recurso (Plataforma de identidade da Microsoft e credenciais da senha do proprietário do recurso OAuth 2.0)
Nota: O fluxo silencioso existente foi renomeado para ROPC.
OAuth2 - Implícito: Utiliza o fluxo de subsídios implícito (Plataforma de identidade da Microsoft e fluxo de concessão implícito)
Nota: O fluxo Interativo existente foi renomeado para Implícito.
OAuth2 - Código de autorização com PKCE: Usa código de autorização com fluxo de concessão PKCE (Plataforma de identidade da Microsoft e fluxo de código de autorização OAuth 2.0)
OAuth2 - Credenciais de clientes: Utiliza o fluxo de credenciais do cliente (A plataforma de identidade da Microsoft e o fluxo de credenciais do cliente OAuth 2.0)

Dependendo do modo de autenticação que você selecionou, talvez você tenha que atualizar alguns dos seguintes campos:
- Nome de usuário: Insira o nome de usuário que deseja usar para acessar o servidor de e-mail.
  Por exemplo, john.smith@myCompanyName.com
- Senha: Insira a senha para o nome de usuário que você forneceu.
- Provedor de e-mail: Selecione o provedor de e-mail a partir da lista suspensa.
Nota: Para as opções Identificação do cliente, Identificação do locatário, URI redirecionado e Segredo do cliente utilize as informações que são fornecidas para sua conta em seu Portal do Azure.

Consulte E-mail pacote e Adicionar um disparador de e-mail.
Para Servidor EWS, clique em Testar conexão para entrar em sua conta, aceitar as permissões solicitadas de autenticação e estabelecer uma conexão com o servidor.
Nota: No portal de registros de aplicativo Microsoft Azure, em Gerenciar > Autenticação, assegure-se de que o URI que você adicionou é ou https://outlook.office365.com ou https://outlook.office365.us para que a conexão funcione corretamente.
Clique em Salvar.

Repita estas etapas para todos os bots impactados e execute os bots para garantir que eles possam se conectar ao Exchange Online usando o OAuth 2.0 com êxito.

Instalar o arquivo do ouvinte do gatilho

Para usar o E-mail com OAuth 2.0, você tem que atualizar o triggerlistener.jar no Agente de bot.

No gerenciador de tarefas do Windows, pare o serviço Agente de bot da Automation Anywhere.
Vá para a pasta onde o Agente de bot está instalado (C:\Program Files\Automation Anywhere\Bot Agent).
Localize o arquivo triggerlistener.jar e renomeie o arquivo para triggerlistener.jar_old.
Copie o triggerlistener.jar baixado.
No gerenciador de tarefas do Windows, inicie o serviço Agente de bot da Automation Anywhere.

Depreciação da autenticação básica em troca on-line

Atualização do bots Automation 360 para usar o OAuth 2.0

Protocolos impactados para a desvalorização da autenticação básica

Atualização de bots usando autenticação básica para OAuth 2.0

Instalar o arquivo do ouvinte do gatilho

Outros recursos