> 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/configuracoes-de-scim/pingone-scim-configuracao.md).

# PingOne - SCIM - Configuração

{% 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 fornece detalhes sobre como configurar um provedor de identidade PingOne para usar a API SCIM da Flosum. Para obter mais informações sobre SCIM, consulte o artigo a seguir.

* [Configurando SCIM para o Flosum](/global-settings/global-settings-docs-pt-br/seguranca/provedores-de-identidade-sso/configurando-scim-para-o-flosum.md)

{% 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 %}

## Pré-requisitos

Antes de configurar o provisionamento automatizado, verifique se o SSO baseado em SAML está configurado corretamente e totalmente funcional em seu tenant da Flosum.

Verifique se suas **mapeamentos de atributos** estão configurados corretamente. Veja a captura de tela e a tabela abaixo. 

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FJiSHfifWvgPmWS2e8UB5%2FUsingJitProvisioning-PingOne-01.png?alt=media&amp;token=7ea5c39a-0681-464f-9198-d4b0a114e98e" alt="" width="563"><figcaption></figcaption></figure></div>

| Nome da declaração | Valor              |
| ------------------ | ------------------ |
| userUniqueId       | ID do usuário      |
| firstName          | Nome               |
| lastName           | Sobrenome          |
| email              | Endereço de e-mail |

Para obter instruções sobre como adicionar e configurar um provedor de identidade PingOne, consulte os artigos 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)

## Configurar PingOne

{% stepper %}
{% step %}

### Criar conexão SCIM de saída

{% hint style="info" %}

#### Provisionamento SCIM de saída

Esse método permite que as identidades fluam do PingOne para os aplicativos de nuvem da Flosum, com as alterações ocorrendo quase instantaneamente. Quando uma conta de usuário é alterada no PingOne, a Flosum reflete a atualização imediatamente.
{% endhint %}

1. Navegue até a guia **Integração** seção no menu da barra lateral esquerda.
2. Clique no **Provisionamento** .
3. Clique no **+** ícone ao lado do **Provisionamento** título.
4. Clique em **Selecione** para o **Identity Store** tipo.&#x20;

   <div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FepNOl3aLm9WvQB9RyRTv%2FPingOneScimConfig-S01-01.png?alt=media&amp;token=6192dd43-ac50-4b8c-a31e-b0443cbb0ca6" alt=""><figcaption></figcaption></figure></div>
5. Selecione **SCIM de saída** para a conexão.
6. Clique em **Próximo**.&#x20;

   <div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FBi2Fp8cFdgm2uzpTCBjT%2FPingOneScimConfig-S01-02.png?alt=media&amp;token=9810288e-95c3-449e-87e1-efdf14e5dc76" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Nome da conexão

1. Conclua a seção de **Ícone da conexão**, **Nome**, e **Descrição** campos para ajudar a identificar esta conexão.
2. Clique em **Próximo**.
   {% endstep %}

{% step %}

### Configurar autenticação

Consulte a captura de tela para ver um exemplo de configuração das definições de autenticação para conectar à API SCIM da Flosum.

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FtmLDbtLtiMegfwRBG4ZN%2FPingOneScimConfig-S03-01.png?alt=media&amp;token=7c1a9d73-ec53-4a7c-889b-39741f12d57f" alt="" width="563"><figcaption></figcaption></figure></div>

1. Em **URL base do SCIM** caixa de texto, insira a URL da API SCIM da sua região a partir da tabela abaixo.

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

2. Em **Token de acesso OAuth** caixa de texto, insira suas Configurações globais **Token da API**. Se você não tiver um Token de API, consulte o artigo a seguir para obter instruções sobre como criar um.
   1. [Criando um token de API](/global-settings/global-settings-docs-pt-br/seguranca/tokens-de-api/criando-um-token-de-api.md)
3. Em **Recurso de usuários** caixa de texto, insira **/Users**.

{% hint style="info" %}
A API SCIM da Flosum não oferece suporte ao provisionamento de grupos neste momento, então deixe a **Recursos de grupo** caixa de texto em branco.
{% endhint %}

4. Clique em **Testar conexão**.
5. Se o teste de conexão foi bem-sucedido, clique em **Próximo**.

{% hint style="info" %}
Se você não receber uma confirmação de conexão, verifique o **URL base do SCIM** e certifique-se de que ele não esteja bloqueado por firewalls ou outros interceptadores de tráfego de rede. Em seguida, verifique se o **Token da API** está correto.
{% endhint %}
{% endstep %}

{% step %}

### Configurar preferências

Consulte a captura de tela para ver um exemplo de configuração das preferências para conexão com a API SCIM da Flosum.

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FahqeJWB3haA4UH5gJkD5%2FPingOneScimConfig-S04-01.png?alt=media&amp;token=8bb2b39f-ae5e-493c-9923-5902b0548823" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
A Flosum usa o endereço de e-mail como nome de usuário. Certifique-se de que o **Identificador do usuário** é mapeado para `workEmail`.
{% endhint %}

1. Selecione **workEmail** para o **Identificador do usuário** menu suspenso.&#x20;
2. Selecione qualquer uma das opções para **Tratamento da associação a grupos**, já que o provisionamento de grupos não é compatível com a API SCIM da Flosum.
3. Marque a **Habilitar criação de usuários** caixa de seleção.
4. Marque a **Habilitar atualização de usuários** caixa de seleção.
5. (Opcional) Quando a **Habilitar desativação de usuários** configuração está habilitada, os usuários desativados no PingOne são desativados automaticamente na Flosum.
6. Marque a **Habilitar desprovisionamento de usuários** caixa de seleção. Quando marcada, os usuários excluídos no PingOne são excluídos automaticamente na Flosum.
7. Selecione a **Excluir** ou **Desativar** em **Ação de remoção** menu suspenso.
8. (Opcional) Quando o Desprovisionar na exclusão da regra estiver habilitado, todos os usuários provisionados por esta regra na Flosum serão removidos (**excluídos** ou **desativados**) quando a regra for excluída.
9. Clique em **Salvar**.
   {% endstep %}

{% step %}

### Criar regra

Crie uma regra para a conexão criada acima.

1. Escolha PingOne como a **Origem**.
2. Escolha a conexão que você criou para a API SCIM da Flosum como o **Destino**.&#x20;

   <div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FyrF0oEyaCTdoaB66upqt%2FPingOneScimConfig-S05-01.png?alt=media&amp;token=48bdf793-0e7d-41aa-88fc-6b6bb2242c48" alt="" width="563"><figcaption></figcaption></figure></div>
3. Insira um **Nome** da regra.&#x20;

   <div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FJD4As5dYdMWS7jxWDHBf%2FPingOneScimConfig-S05-02.png?alt=media&amp;token=45043d3b-6c8b-4bff-acbe-afcd1ce02d54" alt="" width="563"><figcaption></figcaption></figure></div>
4. Configure as definições do diretório para o provisionamento de saída. Escolha quais usuários sincronizar do PingOne para a Flosum, com base na população ou nos atributos do usuário.
5. Mapeie os atributos entre PingOne e Flosum para garantir que os usuários sejam provisionados corretamente. Veja a captura de tela e a tabela abaixo sobre como definir os mapeamentos de atributos corretos.

<div align="left"><figure><img src="https://539069234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FmShFEQOTx5DhZeKJJx8R%2FPingOneScimConfig-S05-03.png?alt=media&amp;token=9bf30f3e-7659-4e96-8501-14cc9890444c" alt="" width="563"><figcaption></figcaption></figure></div>

| Atributo do PingOne | Atributo da API Flosum |
| ------------------- | ---------------------- |
| Habilitado          | active                 |
| Sobrenome           | familyName             |
| GivenName           | givenName              |
| EmailAddress        | userName               |
| EmailAddress        | workEmail              |
| Timezone            | timeZone               |

6. Clique em **Salvar**.
   {% endstep %}

{% step %}

### Habilitar provisionamento

Depois de configurar a regra e a conexão para a API SCIM da Flosum, ative ambas para habilitar o provisionamento. No PingOne, o provisionamento ocorre imediatamente após você criar, excluir ou editar usuários.
{% 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/configuracoes-de-scim/pingone-scim-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.