# Guia Configuração do SSO com SAML para Integração entre Google Workspace e a Elven Platform

O SSO com SAML é uma solução que simplifica o acesso dos usuários a diversas plataformas utilizando uma única autenticação. Neste guia, vamos detalhar como configurar o SSO entre o Google Workspace e a Elven Platform, proporcionando segurança e eficiência no gerenciamento de identidades e acessos.

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

## **Configuração do SSO no Google Workspace**

Para começar, acesse o painel do Google Workspace e navegue até **Apps >**\
**Apps da Web e para dispositivos móveis**. Aqui você pode adicionar novos aplicativos, então clique em **Adicionar App > Adicionar App SAML personalizado**. Isso permitirá que você configure uma integração personalizada com a Elven Platform. Insira o nome sugerido, **Elven Platform** e, se desejar, adicione uma descrição e o ícone ou avatar da Elven Platform para facilitar a identificação visual pelos usuários. Após preencher essas informações, clique em **CONTINUE**.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F7fHhWLCC7zo86oi39EEj%2Fssogw01.png?alt=media&#x26;token=76ccdf36-2491-464b-ad7a-b5e7359900db" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F5Sf5H62D7aSk9c8y9Ao8%2Fssogw02.png?alt=media&#x26;token=d71042ef-962e-4609-9261-4fd1a4b67361" alt=""><figcaption></figcaption></figure>

No próximo passo, será gerado o **Entity ID** e o certificado necessário para autenticar a conexão. Faça o download do certificado e copie o Entity ID, pois serão usados mais adiante.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FpP9xQSIvhCtKFxL2o1Fm%2Fssogw03.png?alt=media&#x26;token=6e3959f5-ad0d-4161-b9b2-5401887599ac" alt=""><figcaption></figcaption></figure>

## **Integração com a Elven Platform**

Com os dados do Google Workspace em mãos, acesse a **Elven Platform** e vá até **Settings > Organization**. Na aba **Single Sign-On**, insira o **Sign In URL** obtido no Workspace no campo correspondente e faça o upload do certificado baixado. Além disso, copie as informações como **ACS URL** e **Entity ID** da Elven Platform e cole nos campos do Google Workspace. Em “ID de nome”, manter o valor “Basic Information > Primary email”.

Avance para a última etapa e configure o mapeamento desta forma:

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F6vXbHj3BZHZYty5zj0vQ%2Fssogw04.png?alt=media&#x26;token=a1714ad5-6a5f-429b-8fae-4589bac3e4d5" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fe7POzzlISxaaRJgVVak8%2Fssogw05.png?alt=media&#x26;token=8da31541-a4a5-400e-a5eb-7fd8142e6695" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FpO9TcOEzpCDP743CZc4z%2Fssogw06.png?alt=media&#x26;token=0b37ac86-27e2-4394-9bd3-8cf050b5c3e7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fwoyi88muh6O4wiwQZvxI%2Fssogw07.png?alt=media&#x26;token=74ff1986-e5bc-4699-a4e1-691b452ede2e" alt=""><figcaption></figcaption></figure>

Essa troca de informações é essencial para que ambas as plataformas confiem e validem as solicitações de autenticação, garantindo que o SSO funcione de forma fluida e segura.

## **Personalização de Acesso dos Usuários**

No Google Workspace, você pode decidir quem terá acesso à aplicação. Acesse a app criada e clique em **Acesso do usuário**. Aqui, habilite o acesso para todos os usuários, selecionando **Ativado para todos**, ou configure um grupo específico. Isso garante que somente as pessoas autorizadas possam usar o SSO para acessar a Elven Platform. Depois de salvar as configurações, aguarde alguns minutos para que a integração fique ativa.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FEZEBo3CCbwju1vWpdryv%2Fssogw08.png?alt=media&#x26;token=6a4ab1c0-a552-429c-9dc1-22b077d43165" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FQJZdtsKxOVBcAy6fDMoV%2Fssogw09.png?alt=media&#x26;token=8d3686e7-24f0-453b-86d8-9222e5a08248" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FrIkB5X2E5JXRIgIcKioz%2Fssogw10.png?alt=media&#x26;token=24b560c8-07b1-472a-a61e-fe0007efafcf" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fl4TWERLZHVPK1fO3MOMR%2Fssogw11.png?alt=media&#x26;token=ef46f728-3735-4e77-b3cd-d3e65b32929f" alt=""><figcaption></figcaption></figure>

## **Sincronização de Usuários na Elven Platform**&#x20;

Para sincronizar usuários do Google Workspace com a Elven Platform, é necessário configurar uma conta de serviço no Google Cloud. No **Google Cloud Console**, vá até **IAM & Admin > Service Accounts** e clique em **Create Service Account**. Nomeie a conta como “Elven Platform SSO” e complete a criação.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FirTSRtsVQrhWHnqab9ti%2Fssogw12.png?alt=media&#x26;token=1a6a2866-11ce-486d-8911-6f4272c034d3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FRZ7N6MxsE9hWId81W4S7%2Fssogw13.png?alt=media&#x26;token=29ac3e45-5abd-45e2-aa8a-bc0e3b7688bd" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fdj21EKGaXIfaQad3Yr8A%2Fssogw14.png?alt=media&#x26;token=e2aa3a04-3b72-4e2e-a28f-f9bbf7257a02" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FLH4ZEjoeUa7H9HWTdY80%2Fssogw15.png?alt=media&#x26;token=9e8f6a79-3a8d-4ee1-bb9f-60ae43edcd56" alt=""><figcaption></figcaption></figure>

Na conta criada, acesse a aba **KEYS** e clique em **ADD KEY > Create New Key**, selecionando o formato **JSON**. Isso criará um arquivo com as chaves necessárias para autenticar a sincronização. Lembre-se de armazenar este arquivo com segurança.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F5kxoiEQ3h2i2GqfkKjj7%2Fssogw16.png?alt=media&#x26;token=0d0f8748-1aad-44c3-9443-9f7517fe824b" alt=""><figcaption></figcaption></figure>

Depois, selecione a aba **Details** e clique em **Advanced settings** e anote o **Client ID**, pois será usado em passos futuros.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fnc7ky4jfj16pzlFGuS8m%2Fssogw17.png?alt=media&#x26;token=1a14826a-cf89-4835-b43b-704011456145" alt=""><figcaption></figcaption></figure>

## **Delegação de Acessos no Google Workspace**

Para que a conta de serviço funcione corretamente, é preciso autorizar a delegação de domínio. No painel do administrador do Google Workspace, vá em **Segurança > Controle de dados e acesso > Controles de API** e clique em **GERENCIAR A DELEGAÇÃO EM TODO DOMÍNIO**.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F9XenZFCQZAMVtWAVNGaB%2Fssogw18.png?alt=media&#x26;token=5f54a72f-0c80-460b-8bc5-607172ecfe09" alt=""><figcaption></figcaption></figure>

Adicione um novo cliente usando o **ID do cliente** gerado anteriormente e insira os escopos necessários para leitura de informações de usuários e grupos:&#x20;

* <https://www.googleapis.com/auth/admin.directory.group.readonly>&#x20;
* <https://www.googleapis.com/auth/admin.directory.group.member.readonly>&#x20;
* <https://www.googleapis.com/auth/admin.directory.user.readonly>&#x20;

Esses escopos garantem que a Elven Platform possa sincronizar usuários e grupos do Google Workspace sem comprometer dados confidenciais.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FBuFOQVb0xjnCxnuOyafL%2Fssogw19.png?alt=media&#x26;token=39f9814b-9656-4039-aaf9-0df2d8d9b0ac" alt=""><figcaption></figcaption></figure>

## **Ativando a API Admin SDK**&#x20;

Ainda no Google Cloud Console, ative a **Admin SDK API**, pesquisando por ela na biblioteca de APIs. Isso é fundamental, pois a Elven Platform utiliza essa API para gerenciar e sincronizar informações de usuários e grupos.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FA3FRJ9YDO5EdCsIiLHds%2Fssogw20.png?alt=media&#x26;token=e6f4fbac-8b2b-4662-af0d-7f08db707436" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F60tABrydTP4zqCNYF0tb%2Fssogw21.png?alt=media&#x26;token=65b8c0e8-3854-44e6-81de-f945df42f4e7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F3xIH2wnpfEhd50qe7sMK%2Fssogw22.png?alt=media&#x26;token=7d89cad8-de0f-4603-9005-740713e4c073" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FTE17XbvrfxcnDQTPylt3%2Fssogw23.png?alt=media&#x26;token=3583128e-4e10-4d2e-894a-bda23fe3b854" alt=""><figcaption></figcaption></figure>

## **Finalizando a Configuração**

De volta à Elven Platform, acesse a configuração de SSO e insira as informações obtidas:&#x20;

* O e-mail do administrador do workspace.&#x20;
* O e-mail do grupo de usuários configurado no Workspace para sincronização.&#x20;

Faça o upload do arquivo JSON com as chaves criadas anteriormente e clique em **SAVE INTEGRATION**. Com isso, a sincronização estará ativa, e os usuários do grupo definido no Google Workspace serão automaticamente adicionados à organização na Elven Platform com a role padrão de “member”. Caso precise alterar as permissões, é possível ajustar posteriormente.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F5GANwjihzpNKhy7NqaDe%2Fssogw24.png?alt=media&#x26;token=1548d331-d161-497f-a309-b9cd0fd5c8f3" alt=""><figcaption></figcaption></figure>

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

Para acessar a **Elven Platform via SSO** utilizando o **Google Workspace**, basta seguir um caminho simples e intuitivo. Na página inicial do seu **navegador Google Chrome**, clique no ícone de **aplicativos do Google** (localizado no canto superior direito, ao lado da sua foto de perfil). Em seguida, localize e clique no ícone da **Elven Platform**. Isso iniciará automaticamente o processo de **login com autenticação única (SSO)**, conectando você de forma segura e prática com sua conta na **Elven Platform**. Essa abordagem melhora a **experiência do usuário** ao eliminar a necessidade de múltiplos logins, garantindo mais agilidade e segurança no seu acesso à plataforma.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FAfImN2jrnyTN3ZznI9hO%2Fssogw25.png?alt=media&#x26;token=3d2dcc16-1150-4cfe-92b6-20de4b082c41" alt=""><figcaption></figcaption></figure>

## **Glossário de Termos Técnicos**&#x20;

**ACS URL (Assertion Consumer Service URL):** Um endpoint fornecido pela Elven Platform para receber as respostas de autenticação do provedor de identidade (IdP). É essencial para validar o login do usuário durante o processo SAML.&#x20;

**Admin SDK API:** *Uma API do Google que permite o gerenciamento de usuários, grupos e outras configurações de diretório no Google Workspace. É usada para sincronizar dados entre o Workspace e a Elven Platform.*&#x20;

**API Controls:** Configurações de segurança do Google Workspace que permitem gerenciar o acesso de APIs a informações de usuários e grupos. Fundamental para delegação de domínio.&#x20;

**Client ID/ ID do cliente :** Identificador exclusivo de uma conta de serviço criada no Google Cloud. É usado para autorizar a delegação de domínio e vincular a conta ao SSO.&#x20;

**Delegação de Domínio (Domain-Wide Delegation):** *Permissão concedida a uma conta de serviço para acessar dados de usuários e grupos em nome do administrador do domínio. Essencial para sincronização de usuários.*&#x20;

**Entity ID/ ID da Entidade:** Identificador exclusivo da aplicação SAML, usado para diferenciar o serviço em integrações de SSO. Tanto o Google Workspace quanto a Elven Platform possuem Entity IDs específicos.&#x20;

**Google Cloud Console:** *Interface do Google Cloud para gerenciar recursos, como contas de serviço, APIs e configurações relacionadas ao Google Workspace.*&#x20;

**Google Workspace:** Plataforma de produtividade do Google, que inclui ferramentas como Gmail, Google Drive e Google Calendar. Também serve como provedor de identidade (IdP) para integrações SAML.&#x20;

**IdP (Identity Provider):** *Provedor de identidade responsável por autenticar os usuários em um sistema de SSO. No caso desta integração, o Google Workspace atua como IdP.*&#x20;

**JSON Key:** Arquivo contendo as credenciais da conta de serviço no Google Cloud, utilizado para autenticação em serviços externos, como a sincronização de usuários na Elven Platform.&#x20;

**OAuth Scopes:** Permissões que definem o nível de acesso que um aplicativo ou serviço pode ter aos dados do Google Workspace. Exemplos incluem leitura de informações de usuários e grupos.&#x20;

**Primary Email:** O endereço de e-mail principal do usuário no Google Workspace, usado como identificador padrão em integrações de SSO.&#x20;

**Role (Papel):** Permissão atribuída a um usuário em uma plataforma, como “member” (membro), que define os níveis de acesso e ações permitidas.&#x20;

**SAML (Security Assertion Markup Language):** Um padrão aberto para troca de dados de autenticação e autorização entre um provedor de identidade (IdP) e um provedor de serviço (SP). É o protocolo usado no SSO configurado.&#x20;

**Service Account (Conta de Serviço):** Uma conta no Google Cloud que permite que aplicações acessem recursos e APIs em nome do administrador ou de um domínio.&#x20;

<br>