> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/provedores-de-identidade-saml/okta-saml-configuracao.md).

# Okta - SAML - Configuração

{% hint style="success" %}

#### Credenciais de Usuário Obrigatórias

\[**Usuário Flosum**] - **Administrador do Sistema** Função
{% endhint %}

{% hint style="success" %}

#### Aviso importante

As instruções neste artigo cobrem um aplicativo de terceiros e podem não refletir a versão mais recente. Use estas instruções como um guia para concluir a tarefa, mas esteja ciente de que algumas telas, nomes de campos e etapas podem ter sido alterados.
{% endhint %}

## ![](https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FSxcnKlaJKPzDqONWoDNv%2FSummary2-Small-Icon.svg?alt=media\&token=5e3253d0-a069-4ba5-9c06-83c70bd0b21d) Visão geral

Este artigo explica como integrar um provedor de identidade Okta com os Flosum Cloud Apps usando autenticação SAML para habilitar o Single Sign-On (SSO), permitindo que os usuários acessem a plataforma de forma contínua com suas credenciais existentes.

{% hint style="info" %}
Para instruções mais gerais sobre como adicionar um Provedor de Identidade, consulte o artigo a seguir.

* [Adicionando um provedor de identidade (SSO)](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/adicionando-um-provedor-de-identidade-sso.md)
  {% endhint %}

{% hint style="warning" %}

#### Hospedado pelo Cliente

Clientes que hospedam os Aplicativos Flosum em sua própria infraestrutura terão uma URL personalizada para fazer login em seus aplicativos. Ao usar esta documentação, substitua qualquer **URLs Hospedadas pelo Flosum** pelas suas próprias URLs.
{% endhint %}

## Configurar o Okta

{% stepper %}
{% step %}

### Criar aplicativo

1. Faça login no **Console de Administração do Okta**. 
2. Navegue até **Aplicativos**. 
3. Clique em **Criar integração de aplicativo**. 
4. Selecione **SAML 2.0** como o **método de login**. 
5. Clique em **Próximo**. 
6. Insira um **Nome do app**. 
7. Clique em **Próximo**.
   {% endstep %}

{% step %}

### Configurar as configurações de SAML

1. Clique no **URL de single sign-on** campo de texto e insira a URL SAML da sua região na tabela abaixo.

<table><thead><tr><th width="159.6666259765625">Região</th><th>URL SAML</th></tr></thead><tbody><tr><td>Estados Unidos</td><td>https://global-us.flosum.app/api/v1/saml/acs</td></tr><tr><td>Alemanha</td><td>https://global-de.flosum.app/api/v1/saml/acs</td></tr><tr><td>Japão</td><td>https://global-jp.flosum.app/api/v1/saml/acs</td></tr><tr><td>Austrália</td><td>https://global-au.flosum.app/api/v1/saml/acs</td></tr></tbody></table>

2. Clique em **URI da audiência (ID da entidade do SP)** e insira uma identidade exclusiva para este SSO. Pode ser qualquer valor de string exclusivo.
3. Clique em **Adicionar identificador** e insira uma identidade exclusiva para este SSO. Pode ser qualquer valor de string exclusivo.
4. Clique em **Mostrar configurações avançadas**.
5. Clique em **Resposta** e selecione **Assinada**.
6. Clique em **Assinatura da asserção** e selecione **Assinada**.
7. (Opcional) A **Criptografia da asserção (opcional)** configuração não é necessária para funcionar com o SSO da Flosum. Configure apenas se for exigido por suas políticas de segurança ou conformidade.
   1. Se necessário, você precisará de um certificado público e de um par de chave privada.
   2. Faça o upload do certificado público para o **Certificado de criptografia**.
8. (Opcional) A **Solicitações assinadas (opcional)** configuração não é necessária para funcionar com o SSO da Flosum. Configure apenas se suas políticas de segurança ou conformidade exigirem solicitações de autenticação assinadas (AuthnRequest).
   1. Se necessário, você precisará de um certificado público e de um par de chave privada.
   2. Ativar **Solicitações assinadas**
   3. Faça o upload do certificado público para o **Certificado de assinatura**.
9. Clique em **Próximo**.
10. Clique em **Concluir**.
    {% endstep %}

{% step %}

### Configurar declarações de atributos

1. Abra a aba **Sign On** .&#x20;
2. Role para baixo até **Declarações de atributos**.&#x20;
3. Clique em **Mostrar configuração legada**.&#x20;
4. Clique em **Editar** em **Declarações de atributos do perfil**.
5. Adicione as seguintes declarações de atributos.

| Nome         | Atributo de origem |
| ------------ | ------------------ |
| firstName    | user.firstName     |
| lastName     | user.lastName      |
| email        | user.email         |
| uniqueUserId | device.trusted     |

{% hint style="info" %}
A **uniqueUserId** claim pode ser mapeada para qualquer atributo de usuário que seja exclusivo e constante.
{% endhint %}
{% endstep %}

{% step %}

### Atribuir usuários

1. Abra a aba **Atribuições** .
2. Clique em **Atribuir → Atribuir para pessoas**.
3. Atribua o aplicativo aos usuários necessários.
4. Clique em **Salvar e voltar**.
5. Clique em **Concluído**.
   {% endstep %}

{% step %}

### Criar provedor de identidade em Configurações globais

Siga as instruções gerais no artigo abaixo para começar a criar um provedor de identidade SAML.

1. [Adicionando um provedor de identidade (SSO)](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/adicionando-um-provedor-de-identidade-sso.md)
2. Complete a **Informações básicas** seção.
   1. Selecione **SAML** para o provedor de identidade **Tipo**.
3. Complete a **Informações do botão** seção.
4. (Opcional) Complete as **Informações do grupo** seção.

#### **Preencher os campos de informações SAML 2.0**

Copie as informações do seu aplicativo Okta para a seção de Informações SAML 2.0. As duas primeiras capturas de tela abaixo mostram quais campos do aplicativo Okta devem ser copiados. A tabela explica onde inserir essas informações. A captura de tela final mostra um provedor de identidade concluído para um aplicativo SAML do Okta.

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F9GxXgWCRo0ZCgcU7uKqd%2FOktaSamlConfig-Okta-01.png?alt=media&amp;token=a6c0e2e1-047f-4cf9-b663-a1e4afb51cd3" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FELZWHAJf1l0tDaADS6sj%2FOktaSamlConfig-Okta-02.png?alt=media&amp;token=43cf9ddb-b056-448a-9acd-a234dca25584" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="179.6666259765625">Campo da Flosum</th><th>Campo do Okta</th><th>Instruções</th></tr></thead><tbody><tr><td><strong>Emissor</strong></td><td>Aba Geral → Configurações de SAML → <strong>Restrição de audiência</strong></td><td></td></tr><tr><td><strong>ID da entidade</strong></td><td>Aba Sign On → Configurações → Mais detalhes → <strong>Emissor</strong></td><td>Clique no <strong>Copiar</strong> ícone para copiar este link.</td></tr><tr><td><strong>Certificado de assinatura do provedor de identidade</strong></td><td>Aba Sign On → Configurações → Mais detalhes → <strong>Certificado de assinatura</strong></td><td>Clique em <strong>Baixar</strong> para baixar o certificado. Depois de baixado, clique em <strong>Certificado de assinatura do provedor de identidade</strong> e faça o upload dele.</td></tr><tr><td><strong>Formato do Name ID</strong></td><td></td><td>Deixe em branco</td></tr><tr><td><strong>URL de login do provedor de identidade</strong></td><td>Aba Sign On → Configurações → Mais detalhes → <strong>URL de login</strong></td><td>Clique no <strong>Copiar</strong> ícone para copiar este link.</td></tr></tbody></table>

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F70j8MmQy1nmUQrIzizqC%2FOktaSamlConfig-Flosum-01.png?alt=media&amp;token=cfbd640b-b7d8-406e-9a1f-eb451da41790" alt="" width="563"><figcaption></figcaption></figure></div>

#### Solicitação assinada SAML ativada

Se Aba Geral → Configurações de SAML → **Solicitação assinada SAML** estiver **Ativada:**

1. Marque a **Solicitação assinada SAML ativada** caixa de seleção.
2. Preencha os campos na tabela abaixo.

<table><thead><tr><th width="180.33331298828125">Campo da Flosum</th><th>Valor</th></tr></thead><tbody><tr><td><strong>Certificado de assinatura de autenticação</strong></td><td>Clique para fazer upload do certificado público que corresponde ao certificado de verificação.</td></tr><tr><td><strong>Chave privada de autenticação</strong></td><td>Clique para fazer upload da chave privada que corresponde ao certificado público.</td></tr><tr><td><strong>Senha da chave privada de autenticação</strong></td><td>Digite a frase secreta da chave privada, se estiver criptografada.</td></tr><tr><td><strong>Algoritmo de assinatura de autenticação</strong></td><td>Deixe em branco (ou especifique, se necessário).</td></tr></tbody></table>

#### Criptografia da asserção ativada

Se Aba Geral → Configurações de SAML → **Criptografia da asserção** estiver **Criptografado**:

1. Marque a **Criptografia da asserção ativada** caixa de seleção.
2. Preencha os campos na tabela abaixo.

<table><thead><tr><th width="180.33331298828125">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Certificado de criptografia</strong></td><td>Clique para fazer upload do certificado público usado para a criptografia da asserção.</td></tr><tr><td><strong>Chave privada de criptografia</strong></td><td>Clique para fazer upload da chave privada que corresponde ao certificado público.</td></tr><tr><td><strong>Senha da chave privada de criptografia</strong></td><td>Digite a frase secreta da chave privada, se estiver criptografada.</td></tr></tbody></table>
{% endstep %}

{% step %}

### Salvar e testar

{% hint style="info" %}
Para instruções sobre como fazer login com SSO, veja o artigo a seguir.

* [Fazendo login com SSO](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/fazendo-login-com-sso.md)
  {% endhint %}

1. Clique **Salvar** para salvar o provedor de identidade.
2. Para testar, abra uma janela anônima.
3. Comece a fazer login nas Configurações Globais com o nome do seu locatário.
4. Se o provedor de identidade foi configurado com sucesso, você deverá ver o botão SSO que você criou.&#x20;

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FutMuZrPQFHKOwmRPgx7i%2FOktaSamlConfig-Login-01.png?alt=media&amp;token=7d3d3afb-0671-4036-8b11-c9973efb0d83" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# 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.flosum.com/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/provedores-de-identidade-saml/okta-saml-configuracao.md?ask=<question>&goal=<user_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.