Microsoft Entra ID - SCIM - Configuração

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.

Visão geral

Este artigo fornece detalhes sobre a configuração de um provedor de identidade do Entra ID para usar a API SCIM da Flosum. Para mais informações sobre SCIM, consulte o artigo a seguir.

• Configurando SCIM para o Flosum

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.

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.

Certifique-se de que sua Atributos e Claims SAML configuração inclua os seguintes atributos:

Nome da Claim	Valor
userUniqueId	user.objectid
firstName	user.givenname
lastName	user.surname
email	user.mail

Para obter instruções para adicionar e configurar um provedor de identidade do Microsoft Entra ID, consulte os artigos a seguir.

• Adicionando um provedor de identidade (SSO)

• Microsoft Entra ID - OIDC - Configuração

• Microsoft Entra ID - SAML - Configuração

Configurar Entra ID

1

Configurar integração de API

1. Entre na sua conta do Entra ID.
2. Acesse o provedor de identidade que você criou.
3. Clique em Provisionamento em Gerenciar no menu lateral esquerdo.

   
4. Altere Modo de provisionamento de Manual para Automático.
5. Conclua a seção de Credenciais do administrador .
6. URL do tenant: Insira a URL da API SCIM para sua região na tabela abaixo.

Região	URL da API SCIM
Estados Unidos	https://global-us.flosum.app/api/v1/scim
Alemanha	https://global-de.flosum.app/api/v1/scim
Japão	https://global-jp.flosum.app/api/v1/scim
Austrália	https://global-au.flosum.app/api/v1/scim

1. Token secreto: Insira seu 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

2. Clique em Testar conexão para verificar se é possível estabelecer uma conexão com seu tenant da Flosum.

   

Se você não receber uma confirmação de conexão, verifique o URL do tenant 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.

1. Clique em Salvar.

   

2

Mapeamentos de usuários

A API SCIM da Flosum usa valores específicos de metadados dos perfis de usuário do Entra ID. Esta seção explica os mapeamentos necessários entre a API SCIM da Flosum e os atributos do Entra ID.

1. Clique em Provisionamento em Gerenciar no menu lateral esquerdo.
2. Clique em Provisionar usuários do Microsoft Entra ID em Mapeamentos .

   
3. Certifique-se de que Habilitado esteja definido como Sim.
4. Certifique-se de que todas as Ações do objeto de destino (Criar, Atualizar, e Excluir) estejam marcadas.

   
5. Se alguma alteração foi feita, clique em Salvar.
6. Os mapeamentos de atributos definem quais atributos do Microsoft Entra ID são sincronizados com quais atributos da API SCIM da Flosum. Veja a captura de tela e a tabela abaixo sobre como definir os mapeamentos corretos de atributos.

Atributo da API SCIM da Flosum	Atributo do Microsoft Entra ID
userName	mail
active	Switch([IsSoftDeleted],,"False","True","True","False")
emails[type eq "work"].value	mail
name.givenName	givenName
name.familyName	surname
externalId	objectId

A Flosum usa o endereço de e-mail como nome de usuário. Certifique-se de que o userName atributo esteja mapeado para o mail atributo. A captura de tela abaixo mostra como editar o mail atributo para configurar esse mapeamento.

Durante o provisionamento de usuários, o atributo de fuso horário é definido como Etc/UTC por padrão.

3

Mapeamentos de grupos

A API SCIM da Flosum não oferece suporte atualmente ao provisionamento de grupos. Certifique-se de que a sincronização de grupos esteja desabilitada.

1. Clique em Provisionamento em Gerenciar no menu lateral esquerdo.
2. Clique em Provisionar grupos do Microsoft Entra ID em Mapeamentos .
3. Certifique-se de que Habilitado esteja definido como Não.

   
4. Se alguma alteração foi feita, clique em Salvar.

4

Iniciar provisionamento

Depois de configurar o Entra ID para funcionar com a API SCIM da Flosum, você pode ativar o Provisionamento no Entra ID para iniciar o processo de provisionamento de usuários.

1. Clique em Provisionamento em Gerenciar no menu lateral esquerdo.
2. Na Configurações seção, alterne o Status do provisionamento para Ativado.

   
3. Clique em Salvar.

Isso iniciará o provisionamento inicial, o que pode levar algum tempo. Verifique a parte inferior da página em cerca de 20 minutos para ver o status.

Desativar provisionamento

O provisionamento pode ser desativado alterando o Status do provisionamento para Desativado.

Se você precisar de uma atualização urgente, pare o provisionamento e reinicie-o. Isso acionará uma ressincronização imediata que inclui todas as atualizações.