> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Single Sign-On (SSO) com Azure AD

> Configure a Autenticação SSO com Azure AD

Este artigo serve como um guia abrangente para configurar o Single Sign-On (SSO) usando o Azure Active Directory (AD) como seu provedor de identidade. Ao integrar o Azure AD com o EKB, sua organização pode aprimorar a autenticação de usuários permitindo que eles acessem a plataforma usando suas credenciais Microsoft existentes. Você encontrará pré-requisitos, etapas detalhadas de configuração e dicas de solução de problemas especificamente para o SSO com Azure AD.

Utilizar o SSO com Azure AD oferece várias vantagens principais:

* **Autenticação Centralizada** - Um login para todas as aplicações corporativas.
* **Segurança Aprimorada** - Acesso controlado pela organização.
* **Gerenciamento de Usuários** - Provisionamento e desprovisionamento centralizados de usuários.
* **Conformidade** - Atende aos requisitos de segurança corporativa.
* **Experiência do Usuário** - Experiência de autenticação contínua.

## Configuração de SSO com Azure AD

Esta seção descreve as etapas necessárias para configurar o SSO com Azure AD para sua instância do EKB.

### Pré-requisitos

Antes de prosseguir, você deve ter o seguinte ou entrar em contato com sua equipe para obter suporte:

* Acesso de administrador do Portal Azure.
* Conta Microsoft 365 com acesso de administrador.
* URL da sua instância do EKB.

### Etapa 1: Configuração do aplicativo Azure AD

1. **Acesse o Portal Azure**
   Acesse [portal.azure.com](https://portal.azure.com) e faça login com sua conta de administrador.

2. **Abra Aplicativos Corporativos**
   No portal Azure, em **Azure services**, clique em **Enterprise applications**.

   <img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/azure-enterprise-applications.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=0d1d8a35d25c2b4d24152d834572873a" alt="Portal Azure – Aplicativos Corporativos" width="1024" height="191" data-path="img/authentication/azure-enterprise-applications.png" />

3. **Crie um aplicativo corporativo**
   Clique em **New application**. Na página **Browse Microsoft Entra Gallery**, clique em **Create your own application**. Na janela que abrir, insira um nome para o aplicativo (por exemplo, "EKB"), selecione **Integrate any other application you don't find in the gallery (Non-gallery)** e clique em **Create**.

   <img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/azure-create-your-own-application.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=38e8c6484b160c29a8271edb92d48d2a" alt="Azure – Criar seu próprio aplicativo" width="1024" height="324" data-path="img/authentication/azure-create-your-own-application.png" />

   <img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/azure-create-app-modal.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=aeca23e8f9191c74e5f2f0288e7a7419" alt="Azure – Criar seu próprio aplicativo (janela)" width="510" height="782" data-path="img/authentication/azure-create-app-modal.png" />

4. **Configure o Single Sign-On**
   Na página **Getting started** do aplicativo, clique em **Set up single sign on** (ou **Get started** nesse cartão). Em **Select a single sign-on method**, escolha **SAML**.

   <img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/azure-getting-started-sso.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=a6a66bfe33ab32e70780a112d0fc3f2e" alt="Azure – Getting started – Configurar single sign on" width="1024" height="366" data-path="img/authentication/azure-getting-started-sso.png" />

   <img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/azure-select-saml.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=bd7770479c95aa06de5b45c7e0aad7a8" alt="Azure – Selecione um método de single sign-on – SAML" width="1024" height="412" data-path="img/authentication/azure-select-saml.png" />

5. **Configure o SAML (Configuração Básica SAML)**
   Em **Basic SAML Configuration** insira (para EKB Cloud use os valores abaixo):

   * **Identifier (Entity ID)**: `https://api.getodin.ai/user/azure/sso/saml/acs/admin`
   * **Reply URL (Assertion Consumer Service URL)**: `https://api.getodin.ai/user/azure/sso/saml/acs/admin`
   * **Sign on URL**: Deixe vazio.
   * **Relay State**: `default`
   * **Logout URL**: Deixe vazio.

6. **Atributos e declarações do usuário**
   Em **Attributes & Claims**, certifique-se dos seguintes mapeamentos (clique em **Edit** para adicionar ou alterar):

   * **Unique User Identifier** → `user.userprincipalname`
   * **email** → `user.mail`
   * **emailaddress** → `user.mail`
   * **givenname** → `user.givenname`
   * **surname** → `user.surname`
   * **name** → `user.userprincipalname`
   * **DisplayName** → `user.displayname`

   <img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/azure-attributes-claims.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=3978d9014aad767e6b7a9921a4e5ce54" alt="Azure – Atributos e Declarações" width="1024" height="304" data-path="img/authentication/azure-attributes-claims.png" />

7. **Atribua usuários**
   Vá até **Users and groups** > **Add user/group**, selecione usuários ou grupos e clique em **Assign**. Usuários atribuídos farão login via SSO assim que a configuração estiver completa.

### Etapa 2: Obtenha a configuração do Azure

1. **Obtenha a URL de Metadados**
   No seu aplicativo, vá até **Single sign-on** > **SAML**. Na seção **SAML Certificates**, copie a **App Federation Metadata Url** (use o ícone de copiar ao lado). Envie esta URL ao Suporte do EKB na Etapa 3.

   <img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/azure-saml-metadata-url.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=fcf7444260f5d1b5c9e53f9a0420cf78" alt="Azure – Certificados SAML – App Federation Metadata Url" width="1024" height="542" data-path="img/authentication/azure-saml-metadata-url.png" />

### Etapa 3: Envie a configuração para o EKB

A equipe de suporte do EKB configurará e testará sua configuração de SSO. Por favor, forneça as seguintes informações:

1. **Envie os Detalhes da Configuração**
   Envie um e-mail para o [**Suporte**](mailto:support@automationanywhere.com) com o seguinte:
   * **Provider**: Azure AD (ou Azure)
   * **Enterprise ID**: O domínio da sua organização (por exemplo, `company.com`)
   * **Metadata URL**: A App Federation Metadata Url da Etapa 2
   * **SSO Sign-In Only** (Opcional): Especifique se deseja exigir SSO para todos os usuários com este domínio.

2. **Configuração do EKB**
   A equipe de suporte do EKB configurará o SSO em sua instância e testará a conexão. Você será notificado quando a configuração estiver completa.

3. **Testes**
   A equipe do EKB testará a conexão SSO e você pode ser solicitado a verificar se funciona. Uma vez confirmado, o SSO será habilitado para sua organização.

### Solução de Problemas do SSO com Azure AD

Nesta seção, você encontrará problemas comuns e soluções relacionadas ao SSO com Azure AD.

**Problema**: Erros de declaração SAML\
**Soluções**:

* Verifique se Reply URL e Identifier (Entity ID) correspondem a `https://api.getodin.ai/user/azure/sso/saml/acs/admin`.
* Certifique-se de que Relay State é `default`; deixe Sign on URL e Logout URL vazios.
* Certifique-se de que os atributos do usuário estão mapeados corretamente.
* Verifique se o certificado é válido e não expirou.

**Problema**: Usuário não encontrado após login via SSO\
**Soluções**:

* Verifique se o usuário está atribuído ao aplicativo no Azure AD.
* Verifique o mapeamento de atributos de e-mail.
* Certifique-se de que o usuário existe no EKB.
* Verifique se o enterprise ID corresponde ao domínio de e-mail.

## Contato

Para dúvidas ou problemas de configuração do SSO, entre em contato com o [Suporte](mailto:support@automationanywhere.com).
