> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-pt-br/proteja-e-governe/identity-providers/okta.md).
# Okta
Use o Okta como seu provedor de identidade para que os usuários façam login no Dispel com suas credenciais do Okta via OAuth (OIDC) ou SAML.
## Visão geral
Conecte o Okta — a plataforma de identidade corporativa da Okta — como provedor de identidade da sua organização. Depois de conectado, seus usuários entram no Dispel com suas credenciais do Okta por meio de login único. Você pode conectar o Okta por **OAuth (OIDC)** ou **SAML**.
Esta página aborda a configuração específica do Okta. Para o comportamento compartilhado que se aplica a todos os provedores — como os usuários fazem login, o mapeamento de grupos, MFA e a desconexão — veja [Provedores de identidade](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md).
{% hint style="info" %}
**Onde encontrá-lo.** Entre como administrador da organização e abra **Configurações → Integrações** (ou a página dedicada **Configurações → Autenticação** página). O Okta aparece no **Identidade e autenticação (IdP / SSO)** seção. Clique em **Conectar** no card dele para começar.
{% endhint %}
## Antes de começar
* Você configurará o lado do IdP em **Console de Administração do Okta**, então você precisará de acesso administrativo lá.
* Decida um protocolo — **OAuth (OIDC)** ou **SAML**. Veja [Escolhendo um protocolo](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#choosing-a-protocol).
* Certifique-se de que os usuários que farão login via Okta já estejam **convidados para sua organização** no Dispel. O SSO autentica usuários, mas não cria acesso por si só.
{% hint style="warning" %}
**Um provedor por vez.** Se a sua organização já estiver conectada a outro provedor de identidade, desconecte-o antes de conectar o Okta.
{% endhint %}
## Conectar com OAuth (OIDC)
#### No Okta
1. No Console de Administração do Okta, acesse **Aplicativos → Criar integração de aplicativo** e escolha **OIDC — OpenID Connect**.
2. Defina o **URI de redirecionamento de login** para o endereço do seu Dispel seguido de `/oauth/login-callback` — por exemplo `https://app.dispel.com/oauth/login-callback`. Confirme o endereço exato do seu ambiente com seu representante do Dispel se tiver dúvidas.
3. Atribua o app aos usuários ou grupos que devem ter acesso.
4. Na **Geral** aba, copie o **ID do cliente** e **segredo do cliente**, e anote seu domínio/emissor do Okta.
#### No Dispel
1. Clique em **Conectar** no cartão do Okta e **Selecione Protocolo de Autenticação → OAuth**.
2. Preencha os campos:
| Campo | Valor do Okta |
| -------------------------------- | ------------------------------------------------------------------------------------ |
| **URL do cliente** | Seu endpoint OAuth/OIDC do Okta (emissor), por exemplo, `https://your-org.okta.com`. |
| **ID do cliente** | O **ID do cliente**. |
| **Segredo do cliente** | O **segredo do cliente**. |
| **Identificador da organização** | Um identificador exclusivo que você escolhe; os usuários o digitam na tela de login. |
3. Clique em **Salvar configurações**.
## Conectar com SAML
#### No Okta
1. No Console de Administração do Okta, acesse **Aplicativos → Criar integração de aplicativo** e escolha **SAML 2.0**.
2. Nas configurações de SAML, cole os valores que o Dispel mostra no topo do formulário SAML:
* **URL de login único / Destinatário / Destino** ← ID da Entidade do **URL do Assertion Consumer Service**.
* **URI de audiência (ID da entidade do provedor de serviços)** ← ID da Entidade do **ID da entidade do Provedor de Serviço (SP)**.
3. Conclua a criação do app e, em seguida, abra sua **Login** aba e colete:
* **URL de login único do provedor de identidade** → SSO do **URL do SSO**.
* **Emissor do provedor de identidade** → SSO do **ID da entidade do provedor de identidade**.
* O **Certificado X.509 / de assinatura** → SSO do **Certificado de assinatura em Base64**.
4. Atribua o app aos usuários ou grupos que devem ter acesso.
#### No Dispel
1. Clique em **Conectar** no cartão do Okta e **Selecione Protocolo de Autenticação → SAML**.
2. Copie o **ID da entidade do Provedor de Serviço (SP)** e **URL do Assertion Consumer Service** mostrado no topo do formulário (use **Copiar ID** / **Copiar URL**) no Okta, como acima.
3. Preencha os campos:
| Campo | Valor do Okta |
| -------------------------------------------- | ------------------------------------------------------------------------------------ |
| **URL do SSO** | O **URL de login único do provedor de identidade**. |
| **ID da entidade do provedor de identidade** | O **Emissor do provedor de identidade**. |
| **Certificado de assinatura em Base64** | O certificado de assinatura do Okta. Cole-o ou use **Carregar certificado**. |
| **Identificador da organização** | Um identificador exclusivo que você escolhe; os usuários o digitam na tela de login. |
4. Clique em **Salvar configurações**.
5. Clique em **Testar conexão**. O Dispel redireciona você para o Okta para fazer login e, em seguida, mostra o e-mail e o nome recebidos. Se o teste falhar, confirme se os valores correspondem ao seu app do Okta e se o usuário de teste foi convidado para a sua organização.
## Após conectar
* **Os usuários entram** digitando o Identificador da sua Organização na tela de login do Dispel e autenticando com o Okta. Veja [Como os usuários entram](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#how-users-sign-in).
* **Mapear grupos do Okta para grupos do Dispel** para que a associação permaneça sincronizada — veja [Mapeamento de grupos OIDC](/documentation/documentation-pt-br/integre-e-administre/integrations/oidc-group-mapping.md).
* **MFA** a exigência configurada no Okta se aplica durante o login; os códigos únicos por e-mail do Dispel não se aplicam a usuários de SSO. Veja [SSO e autenticação multifator](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#sso-and-multi-factor-authentication).
* **Para trocar de protocolo ou provedor**, desconecte primeiro. Veja [Alternando ou desconectando um provedor](/documentation/documentation-pt-br/proteja-e-governe/identity-providers.md#switching-or-disconnecting-a-provider).
## Perguntas frequentes
Qual protocolo devo usar com o Okta?
Qualquer um funciona. Use o que corresponder ao app que você criar no Okta — uma integração de app OIDC para OAuth, ou uma integração de app SAML 2.0 para SAML.
Preciso atribuir usuários ao app do Okta?
Sim. Somente usuários (ou grupos) atribuídos ao app do Okta podem se autenticar por meio dele. Eles também precisam ser convidados para sua organização Dispel.
Minha conexão de teste SAML falhou. O que devo verificar?
Confirme se a URL de SSO, o Emissor e o certificado correspondem às configurações de Login do seu app do Okta, se você colou o ID da entidade do provedor de serviços (SP Entity ID) e a URL ACS do Dispel nas configurações de SAML do Okta, e se o usuário de teste está atribuído ao app do Okta e convidado para sua organização Dispel.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dispel.com/documentation/documentation-pt-br/proteja-e-governe/identity-providers/okta.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.