--- title: SSO / SAML description: Configure o Single Sign-On via SAML para que seus usuários se autentiquem com o próprio provedor de identidade da sua empresa, em vez de credenciais individuais da Unico. canonical: https://developer.unico.io/pt-BR/dual-api/developers/api-reference/sso-saml locale: pt-BR generated_by: markdown-export --- - [/pt-BR/](/pt-BR/) - [Referência de API](/pt-BR/dual-api/developers/api-reference/) - SSO / SAML **Nesta página# SSO / SAML O Single Sign-On (SSO) permite que as pessoas da sua organização façam login nos produtos da Unico usando as mesmas credenciais corporativas que já utilizam internamente, em vez de um usuário e senha separados da Unico. Este não é o fluxo servidor a servidorEsta página trata do **login humano** por meio do provedor de identidade da sua empresa. Se você está procurando autenticação back-end, máquina a máquina, para chamadas de API, veja [Autenticação](/pt-BR/dual-api/developers/api-reference/authentication). O gerenciamento de autenticação permanece sob o controle da sua empresa, diretamente no seu próprio sistema de gerenciamento de identidade e acesso — não é necessário abrir uma solicitação de suporte com a Unico para criar ou desabilitar logins de usuários individuais. O SSO é implementado por meio do **SAML** (Security Assertion Markup Language), um protocolo padrão para trocar de forma segura dados de autenticação e autorização entre um Identity Provider e um Service Provider. ### Componentes do SAML​ ComponentePapel**Identity Provider (IdP)**O serviço que autentica o usuário — seu diretório corporativo (ex.: Active Directory) ou um serviço de identidade externo (ex.: Okta, Microsoft Entra ID).**Service Provider (SP)**A aplicação que o usuário está tentando acessar. Neste caso, a plataforma de autenticação da Unico, que autentica e autoriza usuários nos portais de produtos da Unico.**Assertions**As mensagens XML que carregam dados de autenticação e autorização entre o IdP e o SP.**SAML Metadata**Um documento XML que descreve como o IdP e o SP devem se comunicar de forma segura (endpoints, certificados). informaçãoO SAML lida apenas com **autenticação** — confirmando quem é o usuário. Ele não controla o que o usuário está autorizado a acessar dentro dos produtos da Unico; o acesso ainda precisa ser concedido pela sua equipe de projeto na Unico. ### Etapas de integração​ #### 1. Registre o Service Provider (SP) no seu IdP​ Seu IdP precisa de dois valores para registrar a Unico como Service Provider: o **Entity ID** (um identificador único para o SP) e a **ACS URL** (Assertion Consumer Service URL) — o endpoint que recebe as assertions do SAML. AmbienteEntity IDACS URL**Produção**`https://identity.acesso.io``https://identity.acesso.io/auth/saml/callback`**UAT**`https://identityhomolog.acesso.io``https://identityhomolog.acesso.io/auth/saml/callback` #### 2. Mapeie os atributos do usuário​ Configure seu IdP para enviar os seguintes claims na assertion SAML. Eles mapeiam os atributos dos seus usuários (nome, e-mail, nome de usuário) entre o seu IdP e a Unico. AtributoValorObrigatório`email`Endereço de e-mail do usuárioSim`user_name`Nome de usuárioSim`given_name`Primeiro nomeSim`family_name`SobrenomeSim`phone_number`Número de telefoneNão #### 3. Obtenha os metadados do seu IdP​ Seu IdP normalmente fornece um arquivo XML com sua própria configuração — seu certificado público, URLs de endpoint de autenticação e configurações relacionadas. Envie esse arquivo ao seu contato de suporte na Unico para concluir a integração do lado da Unico. Exemplo de metadados SAML para um SP``` YourSigningCertificate ``` ### Primeiro acesso​ Uma vez que o SP esteja registrado e configurado no seu IdP, os usuários podem se autenticar diretamente em: AmbienteURL de login**Produção**[`https://identity.acesso.io`](https://identity.acesso.io)**UAT**[`https://identityhomolog.acesso.io`](https://identityhomolog.acesso.io) Após informar os dados da empresa e do usuário na tela de login, o usuário é redirecionado ao seu IdP para autenticação. Em caso de sucesso, ele é redirecionado de volta para a URL de callback configurada e sua conta é criada na plataforma de autenticação da Unico. ### Configuração por provedor de identidade​ Microsoft Entra IDCriar uma Enterprise Application No **Microsoft Entra ID**, acesse **Enterprise Applications** e selecione **New application**. Escolha **Create your own application** e, em seguida, **Integrate any other application you don't find in the gallery (Non-gallery)**. Nomeie a aplicação de acordo com o produto Unico que está sendo configurado (ex.: "Unico IDCloud") e clique em **Create**. Configurar o Single Sign-On No menu **Manage** da aplicação, abra **Single sign-on** e selecione **SAML**. Edite a **Basic SAML Configuration** e preencha o **Identifier (Entity ID)** e a **Reply URL (Assertion Consumer Service URL)** com os valores do [passo 1](#1-register-the-service-provider-sp-in-your-idp) acima, para o ambiente que está configurando. Edite a seção **Attributes & Claims** para corresponder à tabela de atributos do [passo 2](#2-map-user-attributes). Para cada claim editado, limpe o campo **Namespace** — ele precisa ficar vazio. Os claims finais devem ficar assim:Nome do claimTipoValorUnique User Identifier (Name ID)SAML`user.userprincipalname` (`nameid-format:emailAddress`)`email`SAML`user.mail``family_name`SAML`user.surname``given_name`SAML`user.givenname``user_name`SAML`user.mail` ### Próximos passos​ [Autenticação](/pt-BR/dual-api/developers/api-reference/authentication) — o fluxo OAuth2 separado utilizado para chamadas de API servidor a servidor [Ambientes](/pt-BR/dual-api/developers/api-reference/environments) — sandbox vs hosts de produção Última atualização em 8 de out. de 2026**