O Read é compatível com logon único usando vários provedores de identidade SAML diferentes. Esta página explica o processo passo a passo para configurar a autenticação SAML com o Okta. Para ver uma lista de outros provedores compatíveis, consulte Como fazer: configurar a autenticação SAML com o Read AI.
Para obter instruções sobre como configurar isso do ponto de vista do Okta, consulte este artigo de ajuda do Okta.
Pré-requisitos
Para configurar a autenticação SAML com o Okta, você precisará de:
- um Workspace do Read com a assinatura Enterprise+
- alguém que seja administrador do seu Workspace do Read
- alguém que possa administrar seu tenant do Okta
Instruções passo a passo
1. Obtenha o URL do ACS e o ID da entidade
Comece pedindo para um administrador do Workspace do Read acessar Configurações do Workspace, abrir a aba Configurações e expandir a seção Avançado (plano Enterprise+ obrigatório). Role para baixo até a seção SAML, onde você poderá encontrar e copiar o URL do ACS e o ID da entidade.
Você precisará desses dados em uma etapa posterior.
2. Configure seu app SAML no Okta
a) Na página Applications, clique em “Create App Integration” e selecione “SAML 2.0”
b) Escolha um nome para a integração e clique em “Next”
c) Configure a configuração do SAML
Atualize as configurações do SAML e as declarações de atributos da seguinte forma. Qualquer campo não descrito abaixo ou que não apareça como atualizado na captura de tela pode permanecer com o valor padrão.
- O valor de “Single sign-on URL” é o URL do ACS obtido na primeira etapa.
- “Audience URI (SP Entity ID)” é o ID da entidade da primeira etapa (
https://api.read.ai). - O “Name ID format” deve ser definido como “EmailAddress”.
- Duas declarações de atributos precisam ser adicionadas:
- “first_name” com o formato “Basic” e o valor “user.firstName”
- “last_name” com o formato “Basic” e o valor “user.lastName”
d) Conclua a etapa de feedback e finalize a configuração
3. Salve o URL de login, o ID do emissor e o certificado no Read
Acesse a aba “Sign On” na página do aplicativo que você acabou de criar e clique em “more details” para revelar os seguintes valores que você precisará copiar e salvar nas configurações do seu Workspace do Read:
- URL de login
- Emissor
- Certificado de assinatura
O URL de login deve ser inserido em URL de SSO, o emissor deve ser inserido em ID da entidade do IdP e o certificado de assinatura deve ser inserido no campo de certificado:
Clique em Salvar depois de inserir tudo.
4. Atribua seu app SAML aos usuários
Em seguida, você precisará atribuir o aplicativo SAML do Okta aos usuários que devem ter acesso ao Read. Acesse a aba "Assignments" e atribua o app a pessoas ou grupos específicos:
Você pode começar com um grupo menor para fins de teste antes de adicionar todos.
5. Teste se está funcionando
Depois de concluir a configuração do aplicativo SAML e atribuí-lo aos usuários na configuração do Okta, teste o processo de login. Peça para um dos usuários acessar seu URL de SSO/URL de login para verificar se ele é redirecionado automaticamente primeiro para a página de login do Okta e, depois de ser autenticado com sucesso, para o Read.
Depois de confirmar que está funcionando, todos os usuários autorizados poderão usar o URL de SSO para entrar no Read. Como sempre, entre em contato com o suporte do Read se precisar de ajuda.
6. [Opcional] Desative outros métodos de login aplicando o SAML
Como etapa final opcional, se quiser restringir seus usuários a fazer login somente via SAML, consulte Aplicando o SAML para usuários do seu domínio. Se isso estiver ativado, os usuários que tentarem fazer login na página de login do Read serão redirecionados automaticamente para o fluxo de login do SAML.
7. [Opcional] Configure o provisionamento de usuários
O SAML controla como os usuários fazem login, mas não cria nem remove contas do Read. Para provisionar e desprovisionar usuários automaticamente a partir do Okta, consulte Configuração do SCIM com código de autorização (Okta). Se você já criou este app SAML, poderá reutilizá-lo para o SCIM.