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

# Configurar SSO e provisionamento SCIM

> Conecte seu provedor de identidade ao AhaSlides para login único, exija SSO para o domínio de e-mail e provisione membros da equipe com SCIM 2.0.

O login único (SSO) permite que sua equipe entre no AhaSlides pelo provedor de identidade da sua organização, em vez de usar uma senha do AhaSlides, e o provisionamento SCIM cria e desativa as contas deles a partir desse mesmo provedor. Use os dois juntos quando sua equipe de TI precisa de um único lugar para controlar quem acessa o AhaSlides.

## Antes de começar com SSO e SCIM

SSO e SCIM não estão disponíveis em todos os planos. Para adicioná-los à sua equipe, fale conosco pelo [formulário Enterprise](https://ahaslides.com/enterprise/) ou em [hi@ahaslides.com](mailto:hi@ahaslides.com).

Não há uma tela de SSO ou SCIM nas configurações da sua equipe. Você configura seu provedor de identidade e nossa equipe conclui o lado do AhaSlides para você:

| Etapa | Você | AhaSlides |
| - | - | - |
| Conectar seu provedor de identidade | Cria o app do AhaSlides no seu provedor de identidade e nos envia os detalhes | Envia o nome do seu provedor e ativa o SSO para a sua equipe |
| Vincular seus domínios de e-mail | Nos diz com quais domínios sua equipe entra | Vincula os domínios à sua equipe |
| Exigir login somente por SSO | Pede para ativarmos | Ativa ou desativa para seus domínios vinculados |
| Provisionamento SCIM | Insere a URL do SCIM e o token no seu provedor de identidade | Gera seu token SCIM |

Você precisa de acesso de administrador ao seu provedor de identidade e de uma [equipe](/pt-BR/teams-and-enterprise/managing-your-team-members) do AhaSlides em que seus membros entrarão.

## Conecte seu provedor de identidade

O AhaSlides funciona com qualquer provedor de identidade SAML 2.0, como o Okta, e com o Microsoft Entra ID.

<Steps>
  <Step title="Peça para ativarmos o SSO">
    Fale conosco informando o nome da sua equipe e os domínios de e-mail que vocês usam. Respondemos com o **nome do provedor**, um identificador curto da sua organização que aparece nos seus endereços de SSO.
  </Step>

  <Step title="Crie o app do AhaSlides no seu provedor de identidade">
    Para um provedor SAML 2.0, crie um app SAML com estes valores:

    | Campo | Valor |
    | - | - |
    | Single sign-on URL (ACS URL) | `https://presenter.ahaslides.com/p/saml/your-provider-name/login/callback` |
    | Audience URI (SP entity ID) | O valor que enviamos junto com o nome do seu provedor |
    | Name ID | O endereço de e-mail do usuário |

    Você também pode baixar os metadados do nosso provedor de serviço em `https://presenter.ahaslides.com/p/saml/your-provider-name/metadata`.

    Para o Microsoft Entra ID, registre um aplicativo. Enviamos o URI de redirecionamento para você adicionar a ele.
  </Step>

  <Step title="Envie os detalhes do seu provedor de identidade">
    Para SAML, envie a URL de login do provedor de identidade, o emissor e o certificado de assinatura X.509, ou o arquivo de metadados que contém essas informações. Se quiser que o nome e o sobrenome sejam preenchidos, diga quais atributos os trazem.

    Para o Microsoft Entra ID, envie o ID do locatário (tenant), o ID do cliente e um segredo do cliente.
  </Step>

  <Step title="Atribua as pessoas e teste">
    Atribua o app às pessoas que devem usar o AhaSlides. Quando confirmarmos que a conexão está ativa, teste seguindo os passos de Entrar com SSO.
  </Step>
</Steps>

## Vincule seus domínios de e-mail à sua equipe

O SSO funciona apenas para endereços de e-mail de um domínio vinculado à sua equipe, e nós vinculamos esses domínios para você. Envie todos os domínios com que seus membros entram.

* Um domínio pode ser vinculado a uma única equipe.
* Quem tem um e-mail em um domínio que não está vinculado não consegue entrar pelo seu SSO.

## Entrar com SSO

<Steps>
  <Step title="Abra a página de SSO">
    Na [página de login do AhaSlides](https://presenter.ahaslides.com/pages/login), clique em **Iniciar sessão com SSO** (Log in with SSO).
  </Step>

  <Step title="Digite seu e-mail de trabalho">
    Digite seu endereço de e-mail e clique em **Iniciar sessão** (Log in). O AhaSlides leva você para a página de login da sua organização.
  </Step>

  <Step title="Entre com a sua organização">
    Depois de entrar lá, você chega ao AhaSlides.
  </Step>
</Steps>

Na primeira vez que alguém entra com SSO, o AhaSlides cria a conta dessa pessoa, se ela ainda não tiver uma, e a adiciona à sua equipe com a função **membro** (Member). Ela nunca define uma senha do AhaSlides.

## Exija SSO para o seu domínio

Por padrão, configurar o SSO acrescenta uma forma de entrar; não remove as outras. Quem já tem uma senha do AhaSlides ainda pode usá-la. Se a sua organização precisa que o SSO seja a única forma de entrar, peça para ativarmos o login somente por SSO nos seus domínios vinculados. Antes, é preciso ter uma conexão SSO funcionando.

Depois de ativado, quem usa um endereço de e-mail de um domínio vinculado vê o seguinte:

| Onde | O que a pessoa vê |
| - | - |
| Páginas de login, cadastro e esqueci a senha | Uma janela com o título **A sua organização exige início de sessão único (SSO)** (Your organisation requires single sign-on) depois de digitar o e-mail. **Continuar com o SSO** (Continue with SSO) leva à página de SSO; **Utilizar outro endereço de email** (Use a different email) limpa o campo. |
| A página de SSO | A mensagem "Your organisation requires single sign-on. Please continue below to sign in." com o e-mail dela já preenchido |
| Configurações da conta | Nenhuma seção **Palavra-passe** (Password), e o endereço de e-mail não pode ser editado |

Isso vale para todos os endereços do domínio vinculado, inclusive pessoas que ainda não entraram na sua equipe.

## Configure o provisionamento de usuários SCIM

O SCIM permite que seu provedor de identidade crie, atualize e desative contas do AhaSlides para você. O AhaSlides é compatível com o SCIM 2.0 para usuários.

<Steps>
  <Step title="Peça um token SCIM">
    Nós geramos o token e o enviamos para você. Guarde-o em um lugar seguro: mantemos apenas um hash dele, então não conseguimos mostrá-lo de novo. Se você o perder, ou se ele puder ter sido exposto, peça um novo.
  </Step>

  <Step title="Insira os detalhes da conexão no seu provedor de identidade">
    | Configuração | Valor |
    | - | - |
    | SCIM base URL | `https://presenter.ahaslides.com/api/scim/v2` |
    | Authentication | Bearer token, enviado como `Authorization: Bearer your-token` |
    | Unique identifier | `userName` |
  </Step>

  <Step title="Mapeie os atributos do usuário">
    Mapeie os atributos listados em Atributos SCIM compatíveis e depois ative a criação, a atualização e a desativação de usuários. Deixe a sincronização de senha desativada.
  </Step>

  <Step title="Atribua os usuários">
    Atribua pessoas ou grupos ao app do AhaSlides. Seu provedor de identidade então cria as contas deles.
  </Step>
</Steps>

### Atributos SCIM compatíveis

| Atributo SCIM | Usado para |
| - | - |
| `userName` | O endereço de e-mail do membro. Identifica o usuário e é armazenado em minúsculas. |
| `name.givenName`, `name.familyName` | Nome e sobrenome |
| `displayName` | Usado para o nome somente quando `name` não é enviado: a primeira palavra vira o nome e o restante o sobrenome |
| `active` | `true` mantém a conta ativa; `false` a desativa e desconecta o membro |
| `externalId` | Devolvido sem alterações na resposta |

### Operações SCIM compatíveis

| Método | Endpoint | O que faz |
| - | - | - |
| `GET` | `/Users` | Lista os usuários da sua equipe. Aceita `filter=userName eq "name@example.com"`, `startIndex` e `count` (10 por padrão). |
| `GET` | `/Users/{id}` | Retorna um usuário |
| `POST` | `/Users` | Cria um usuário |
| `PATCH` | `/Users/{id}` | Atualiza alguns atributos, por exemplo `active` |
| `PUT` | `/Users/{id}` | Substitui os atributos de um usuário |

Grupos e `DELETE` não são compatíveis. Para retirar o acesso de alguém, defina `active` como `false`, que é o que a maioria dos provedores de identidade envia quando você remove a atribuição de um usuário.

Um usuário criado pelo SCIM entra na sua equipe com a função **membro** (Member). Se o e-mail já pertence a uma conta do AhaSlides que não está em uma equipe, essa conta é adicionada à sua equipe em vez de ser criada uma nova.

### O que muda na página da sua equipe

Enquanto o SCIM estiver ativado, seu provedor de identidade é o lugar para gerenciar a participação. Na página da equipe, o botão **Convidar** (Invite) deixa de aparecer, e os membros não podem editar o próprio endereço de e-mail nas configurações da conta.

## Solução de problemas de SSO e SCIM

### O teste da conexão SCIM retorna 401

O token está ausente, foi digitado errado ou não está mais ativo. Confira se ele é enviado como bearer token, sem nada a mais ao redor. Se continuar falhando, peça um novo token.

### O nome de um membro provisionado está errado ou vazio

Envie `name.givenName` e `name.familyName`. Quando apenas `displayName` é enviado, o AhaSlides o divide no primeiro espaço, o que coloca no lugar errado nomes com mais de duas partes.

### Um membro não consegue entrar com SSO

Confira se o membro está atribuído ao app do AhaSlides no seu provedor de identidade e se o domínio de e-mail dele é um dos que você pediu para vincularmos. Se você adicionou um domínio novo, avise para que possamos vinculá-lo.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Um domínio de e-mail pode ser vinculado a duas equipes?">
    Não. Cada domínio pertence a uma única equipe, então todos desse domínio entram na mesma equipe.
  </Accordion>

  <Accordion title="O SCIM exclui contas do AhaSlides?">
    Não. O SCIM desativa uma conta e desconecta o membro. As apresentações dele continuam na conta.
  </Accordion>

  <Accordion title="Uso SSO e esqueci minha senha. O que faço?">
    Você não tem uma senha do AhaSlides para redefinir. Entre com **Iniciar sessão com SSO** (Log in with SSO) e veja [Alterar ou redefinir sua senha](/pt-BR/account-management/change-or-reset-your-password) para saber como a redefinição de senha trata contas com SSO.
  </Accordion>
</AccordionGroup>

**Tem alguma dúvida?**

Fale com a nossa equipe de suporte: se você estiver conectado, use o ícone de chat no canto inferior direito do painel; caso contrário, [fale conosco aqui](https://ahaslides.com/contact-us/) ou envie um e-mail para [hi@ahaslides.com](mailto:hi@ahaslides.com).

Quer se conectar com outros usuários? Participe da [comunidade AhaSlides](https://community.ahaslides.com/) para compartilhar dicas, sugerir funcionalidades e ver como outras pessoas engajam suas audiências.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.