# Guia Configuração do SSO com SAML para integração entre Microsoft Entra e Elven Platform

A integração SSO (Single Sign-On) com SAML oferece aos usuários uma experiência de login simplificada e segura, permitindo o acesso a várias aplicações usando uma única autenticação. A seguir, detalhamos o processo de configuração entre o **Microsoft Entra Admin Center** e a **Elven Platform**, explicando cada etapa de forma clara e intuitiva. 

{% embed url="<https://demo.elven.works/demo/cmd3e0crr008ey80ip2u1a96a>" %}

## **Configurando o aplicativo no Microsoft Entra**

Comece acessando o painel do **Microsoft Entra Admin Center**. No menu lateral, vá até **Identity > Applications > Enterprise applications** e clique em **New application**. Aqui, você criará um novo aplicativo personalizado para integrar com a **Elven Platform**. Escolha a opção **Create your own application** e selecione “Integrate any other application you don’t find in the gallery (Non-gallery)”. Isso garante que você poderá configurar qualquer aplicativo que não esteja listado previamente no catálogo.

<div align="left"><figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FErgTLaIDbZ8Fe0ZLjRRJ%2Fssome01.png?alt=media&#x26;token=e233f2b3-a21a-4532-96e5-8f6475b22520" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FbkWzsijXmj48Dlf8MZX1%2Fssome02.png?alt=media&#x26;token=0fe39b8b-9313-4797-bc0a-e8c4842f4d4e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FVUmlem5RiB0tVlgMdbhm%2Fssome03.png?alt=media&#x26;token=a6785611-8448-4993-82dc-197aff45952a" alt=""><figcaption></figcaption></figure>

## **Habilitando o SAML no aplicativo**

Após criar o aplicativo, acesse o menu dele e selecione a aba **Single sign-on**, optando pelo método **SAML**. No campo **Basic SAML Configuration**, será necessário preencher informações específicas da **Elven Platform**. Essas configurações são fundamentais para estabelecer a comunicação entre os sistemas.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FzQrYKYbnuubJYI2KwPuT%2Fssome04.png?alt=media&#x26;token=518da57d-5583-4f1b-b900-70cc01527e27" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F9p3emAk0u56ogHBovtuO%2Fssome05.png?alt=media&#x26;token=d3d804e6-15d2-4aad-8ffa-2bba30a48c08" alt=""><figcaption></figcaption></figure>

## **Obtendo dados da Elven Platform**

Na **Elven Platform**, vá até **Organization Settings** no canto inferior esquerdo. Clique nos três pontos ao lado de **SAML Microsoft** e selecione **Integrate now**. Um formulário será exibido com as informações que você precisará copiar para preencher a **Basic SAML Configuration** no Microsoft Entra. Essa troca de dados cria a ponte entre as duas plataformas.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FzdM6OLLa5Dwk1AuHxIqj%2Fssome06.png?alt=media&#x26;token=ff5a1bc8-e6c7-48dd-ae5f-69fdf1abdd94" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FlUy2UFAzrHpO87HqhieX%2Fssome07.png?alt=media&#x26;token=0ca38242-3301-4cb1-a1ad-f19835d0ad95" alt=""><figcaption></figcaption></figure>

## **Configurando o certificado**

Para garantir a segurança da comunicação, será necessário configurar um certificado. No Microsoft Entra, vá até o item 3 da configuração SAML e clique em “editar”. Depois, clique nos três pontos e selecione **PEM certificate download**. Após baixar o certificado, volte à **Elven Platform** e faça o upload dele clicando em **SELECT FILE**. Este passo autentica a conexão, garantindo que somente fontes confiáveis possam interagir.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F1YMPDig004PhP2PubD6h%2Fssome08.png?alt=media&#x26;token=7ab5667e-0649-45d7-bee0-6d2fb096f7ee" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F0gsnnShtN5sTUbnW7eKg%2Fssome09.png?alt=media&#x26;token=84a9ab20-b886-4910-b771-eaf8a375a603" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fp5Uk5wgWkQl73VMSNy3X%2Fssome10.png?alt=media&#x26;token=1ff136f1-c8ac-48de-b997-4fe2e086c94c" alt=""><figcaption></figcaption></figure>

## **Ajustando URLs e adicionando usuários**

Na **Elven Platform**, insira o **Sing In URL** gerado no Microsoft Entra. Em seguida, adicione os usuários e grupos que terão permissão para acessar a **Elven Platform** por meio do Microsoft Workspace. Isso garante que apenas pessoas autorizadas tenham acesso à aplicação.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FsDH8Ak9eRPyQuvpKLe8x%2Fssome10.png.png?alt=media&#x26;token=bb3ad9b1-63cf-4ba4-81d3-4a2026a15020" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F4Z4VuFh9HQXxAdcHiA6l%2Fssome11.png?alt=media&#x26;token=7b9ef511-1114-4465-ad2d-38c18776ac07" alt=""><figcaption></figcaption></figure>

## **Sincronizando IDs entre as plataformas**

No Microsoft Entra, vá até **Identity > Overview** e copie o **Tenant ID**. Este identificador único representa o workspace configurado e deve ser colado no campo **Your workspace tenant ID** na **Elven Platform**. Em seguida, volte ao Microsoft Entra em **Applications > App registrations > All applications**, abra seu aplicativo e copie o **Application (client) ID**, colando-o no campo **Client ID** na **Elven Platform**.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FaexqR82SMuDheOdVHl9O%2Fssome12.png?alt=media&#x26;token=2ef72db7-6efb-4d08-939f-68c4a8abed6e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FvajxNQ0QnWAloLcl1lcs%2Fssome13.png?alt=media&#x26;token=af818006-6f59-40be-a33a-6cb7ed6d35aa" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FLqEQFYUCfLwpOrQD0aY7%2Fssome14.png?alt=media&#x26;token=f39a9183-9461-40cb-86fd-ad97b275c89f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FGmYnUn0A3iB1pzwE0uTJ%2Fssome15.png?alt=media&#x26;token=d5d2fd66-ccd5-4025-9cf9-b889dc2235d8" alt=""><figcaption></figcaption></figure>

## **Configurando permissões e segredo de cliente**

Para que a integração funcione perfeitamente, é necessário conceder permissões ao aplicativo. No Microsoft Entra, vá em **API permissions > Add a permission**, escolha **Microsoft Graph** e adicione as permissões **User.Read.All**, **Group.Read.All** e **GroupMember.Read.All**. Após isso, clique em **Grant admin consent** para ativar essas permissões.&#x20;

<br>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FLkxkEUT08wV2jnfNT5HT%2Fssome16.png?alt=media&#x26;token=59a3c481-ff09-42aa-b3cd-0acc62a9d17d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FwLX3gOUTKrEQJWMXzDvJ%2Fssome17.png?alt=media&#x26;token=24678e94-d6b8-41d6-a10a-efa120b3b398" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FfALYA8poQLyvsFn6gyIS%2Fssome18.png?alt=media&#x26;token=0e4181f8-7649-4f4f-95a0-67bb97f10e31" alt=""><figcaption></figcaption></figure>

Depois, vá até **Certificates & secrets > New client secret** e preencha os campos com uma descrição, como “ElvenPlatform”, e um período de validade de 24 meses. Copie o **Value** gerado e cole no campo **Client Secret** na **Elven Platform**. Esse segredo é crucial para a autenticação segura entre as plataformas.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FF478vqM6UuQ7nvVrDQUV%2Fssome19.png?alt=media&#x26;token=0819a55a-2bbd-4902-bbed-acd877554d7d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FJFfQk7F8VJAdBpvxPxhG%2Fssome20.png?alt=media&#x26;token=8ae13a67-33bc-4a69-9337-5660ff20858a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FmvH9X8VvwPXhiWLRawqq%2Fssome21.png?alt=media&#x26;token=2d2651ee-b20c-4981-8e0c-e6898828a950" alt=""><figcaption></figcaption></figure>

## **Sincronizando usuários do grupo**

No Microsoft Entra, acesse **Groups > All groups** e copie o **Object ID** do grupo que deseja integrar com a **Elven Platform**. Insira esse ID no campo **Identifier of group to sync users** e clique em **SAVE INTEGRATION**. Com isso, os usuários pertencentes a esse grupo serão automaticamente adicionados à **Elven Platform** com a role “member”. Caso precise ajustar as permissões dos usuários, a plataforma permite modificar a role posteriormente.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FvIvjFbtF5pAlrlXedU3T%2Fssome22.png?alt=media&#x26;token=dabc96bc-6587-4cad-a237-ecf1c420578e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FKeA98JrfSXVk4u0eQHqi%2Fssome23.png?alt=media&#x26;token=9c2ab175-2936-4a4b-9dfa-b1c6c097df6f" alt=""><figcaption></figcaption></figure>

## **Finalizando a integração**

Com todas as etapas concluídas, o processo de sincronização estará configurado. A partir desse momento, os usuários do grupo definido no Microsoft Entra serão sincronizados automaticamente na **Elven Platform** dentro de um intervalo de até 15 minutos, proporcionando acesso rápido e seguro.&#x20;

## **Acessando a Elven Platform pelo SSO**

Para acessar a **Elven Platform via SSO** utilizando o **Microsoft Entra**, o processo é rápido e direto. Acesse o portal de aplicativos em [**https://myapps.microsoft.com**](https://myapps.microsoft.com/). Após isso, você verá uma lista de aplicativos disponíveis. Basta localizar o ícone da **Elven Platform** e clicar sobre ele. O acesso será feito automaticamente por meio do **Single Sign-On (SSO)**, garantindo mais **segurança** e eliminando a necessidade de digitar senhas repetidamente. Essa jornada foi pensada para ser fluida, segura e sem fricções, focada em uma **experiência de usuário eficiente e descomplicada**.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FDn6MO3iyXDaBQpUPYAij%2Fssome24.png?alt=media&#x26;token=3e0ceed0-d9db-498f-a0b6-f9326bd1b48f" alt=""><figcaption></figcaption></figure>

## **Glossário de Termos Técnicos**

**SSO (Single Sign-On):** Mecanismo de autenticação que permite aos usuários acessar várias aplicações com um único login, eliminando a necessidade de gerenciar múltiplas credenciais.&#x20;

**SAML (Security Assertion Markup Language):** Protocolo padrão para troca de informações de autenticação e autorização entre diferentes sistemas, facilitando a implementação do SSO.&#x20;

**Microsoft Entra Admin Center:** Plataforma da Microsoft para gerenciar identidades e acessos em ambientes corporativos, anteriormente conhecida como Azure Active Directory.&#x20;

**Enterprise Applications:** Aplicativos corporativos gerenciados no Microsoft Entra, usados para integrar soluções de terceiros com autenticação centralizada.&#x20;

**Basic SAML Configuration:** Seção na configuração SAML onde são inseridos os detalhes técnicos que permitem a integração entre sistemas, como URLs de login e metadados.&#x20;

**PEM Certificate:** Formato de arquivo para armazenar certificados de segurança, garantindo a autenticação segura entre sistemas.&#x20;

**Tenant ID:** Identificador único do diretório do Microsoft Entra que representa o workspace configurado para a organização.&#x20;

**Client ID (Application ID):** Identificador único de um aplicativo registrado no Microsoft Entra, usado para autenticação e integração entre plataformas.&#x20;

**Client Secret:** Chave secreta gerada para autenticar aplicativos ao acessar APIs e serviços do Microsoft Entra.&#x20;

**Microsoft Graph:** API unificada da Microsoft para acessar dados de vários serviços Microsoft 365, como usuários, grupos e permissões.&#x20;

**API Permissions:** Permissões concedidas a aplicativos para acessar dados e executar operações por meio do Microsoft Graph.&#x20;

**Group Object ID:** Identificador único de um grupo no Microsoft Entra, usado para sincronizar membros com a **Elven Platform**.&#x20;

**Elven Platform:** Plataforma que integra e gerencia ferramentas para desenvolvedores e equipes, oferecendo funcionalidades como autenticação centralizada com SSO.&#x20;

**Role (Papel):** Nível de permissão ou conjunto de acessos atribuídos a um usuário dentro de uma aplicação, como “member” ou “admin”.&#x20;

**Sync (Sincronização):** Processo automático de atualização de dados entre sistemas conectados, garantindo consistência nas informações.&#x20;

**Workspace:** Ambiente de trabalho configurado no Microsoft Entra, representando a organização e seus recursos integrados.&#x20;

**Identity (Identidade):** Elemento central no gerenciamento de acessos, representando usuários, grupos ou aplicativos autorizados.&#x20;