Configurar o provisionamento de usuários (SCIM)

Prev Next

É possível usar o provisionamento e o desprovisionamento de usuários em conjunto com o SAML para provisionar e desprovisionar usuários instantaneamente.

Visão geral

Após configurar o SSO via SAML no Tulip{target=_blank}, você também pode querer provisionar e desprovisionar usuários em tempo real, seguindo a API SCIM.

Com o SCIM, seu provedor de identidade (IdP) cria automaticamente usuários no Tulip, atualiza seus nomes e os desativa quando eles saem, permitindo que você gerencie o acesso em um único lugar. A configuração do SCIM tem duas partes: obter seus detalhes do SCIM no Tulip e configurar um aplicativo SCIM personalizado em seu IdP. :::(Warning) ()
Note: Tulip does not provide a pre-built SCIM application or configuration for identity providers
:::

Etapa 1: Obter seus detalhes SCIM do Tulip

Para conectar seu IdP ao Tulip, você deverá inserir dois valores do Tulip em um aplicativo SCIM personalizado no seu IdP (veja a Etapa 2):- URL do locatário: o endpoint SCIM para o qual seu IdP envia solicitações.- Chave/Segredo da API: o token Bearer que seu IdP usa para se autenticar no Tulip. Guarde-os em local seguro.

Para encontrá-los no Tulip: 1. Acesse “Configurações da conta ” e clique na página “SAML ”. 2. Selecione a aba “SCIM ”.

image.png

  1. Copie a URL do locatário. Em seguida, gere uma chave de API (ou gere-a novamente, caso já exista uma) e copie a chave de API/segredo. Você precisa ser um administrador do sistema ou proprietário da conta para fazer isso. Mantenha ambos os valores à mão para a Etapa 2.

Etapa 2: Crie um aplicativo SCIM personalizado no seu IdP

O Tulip não fornece um aplicativo SCIM pré-configurado nem uma configuração para provedores de identidade; portanto, você criará um aplicativo personalizado (que não faz parte da galeria) no seu IdP.

Insira a URL do locatário e a chave/segredo da API que você copiou na Etapa 1 neste aplicativo. Dependendo do seu IdP, esses campos podem ter nomes diferentes (por exemplo, “Token secreto”).

Ao configurar o aplicativo, certifique-se de que seu IdP esteja configurado da seguinte forma: - Mapeie o atributo do IdP para o nome de usuário SCIM ao mesmo valor que seu IdP envia como NameID do SAML. Isso ajuda os usuários provisionados a fazerem login na primeira vez que acessarem via SAML.- Confirme os mapeamentos de nome de usuário e e-mail antes de atribuir usuários. Esses valores são fixos assim que um usuário é provisionado.- Desative o provisionamento de grupos. O Tulip provisiona apenas usuários, e os grupos não são sincronizados por meio do SCIM.

Microsoft Entra ID

Para quem usa o Microsoft Entra como IdP, o aplicativo Tulip na galeria do Entra oferece suporte apenas ao SSO via SAML e não possui a guia “Provisionamento”. Isso é esperado e não significa que haja alguma configuração incorreta.

Para usar o SCIM com o Microsoft Entra ID:

  1. No centro de administração do Microsoft Entra, acesse Entra ID > Aplicativos corporativos > Novo aplicativo > Criar seu próprio aplicativo.
    1. Dê um nome a ele, selecione “Integrar qualquer outro aplicativo que você não encontrar na galeria (Fora da galeria)” e crie-o. Use esse aplicativo apenas para provisionamento.
  2. No novo aplicativo, selecione “Provisionamento” > “Conectar seu aplicativo”.
    1. Defina o método de autenticação como Autenticação Bearer.
    2. Insira a URL do seu locatário (https:///scim/v2) e a chave de API da Etapa 1 como o token secreto e, em seguida, selecione “Testar conexão”.
  3. Abra “Mapeamento de atributos”. Mapeie o atributo “userName ” do SCIM para o mesmo valor do seu “NameID” do SAML e desative o mapeamento de grupos.
  4. Na guia “Usuários e grupos”, atribua usuários individuais. Não atribua grupos, pois o Tulip não oferece suporte à sincronização deles e o provisionamento falhará.
  5. Use “Provisionamento sob demanda” para testar um usuário e, em seguida, selecione “Iniciar provisionamento”.

Como o Entra e outros IdPs podem exigir personalizações adicionais para o seu ambiente, entre em contato com o administrador do seu IdP ou com o Suporte da Tulip caso precise de ajuda para planejar sua implantação.

Recursos compatíveis

O Tulip oferece suporte às seguintes atualizações em tempo real por meio da API SCIM: - Criação de usuários - Atualizações no nome de um usuário - Exclusão/desprovisionamento de usuários

Criação de usuário

No seu IdP, você controla quais usuários têm acesso ao aplicativo Tulip.

Quando o Tulip for registrado como Provedor de Serviços, seu IdP usará a API SCIM para provisionar todos os usuários que precisam de acesso ao Tulip. Esses usuários serão criados automaticamente no Tulip, sem acesso a nenhuma parte da plataforma.

Depois que você configurar o SAML no Tulip, quando um usuário fizer login com o SAML pela primeira vez, ele receberá um espaço de trabalho e uma função com base na sua configuração do SAML.

Em seguida, quando um novo usuário for adicionado ao seu IdP e precisar ter acesso ao Tulip, ele será imediatamente provisionado no Tulip, sem acesso a nenhuma outra parte da plataforma.

Atualizações no nome de usuário

Quando o nome de um usuário for atualizado no seu IdP, ou se você modificar a ordem do sobrenome e do nome próprio nas configurações SCIM do Tulip, os nomes de usuário serão atualizados em tempo real na plataforma do Tulip.

Exclusão/desativação de usuários

A API SCIM usa o termo “excluir” em relação ao cancelamento do provisionamento de usuários, mas os usuários no Tulip só podem ser desativados, não excluídos. O Tulip espera que o endpoint “excluir usuário” seja usado apenas ao cancelar o provisionamento de usuários.

Quando o endpoint “delete user” for usado para um determinado usuário, ele será imediatamente desativado no Tulip.

Pontos a serem considerados ao configurar o SCIM com o Tulip

Para ajudar a garantir que sua implantação ocorra sem problemas, lembre-se do seguinte:

  • Reative os usuários no Tulip. Quando um usuário é removido ou desativado no seu IdP, o SCIM o desativa no Tulip. O SCIM não pode reverter isso; portanto, se você adicionar ou reativar o mesmo usuário no seu IdP posteriormente, ele permanecerá desativado no Tulip. Para restaurar o acesso, reative o usuário no Tulip e, em seguida, execute uma sincronização no seu IdP (por exemplo, “Provision on demand” no Microsoft Entra ID) para que ambos os sistemas fiquem em sincronia.
  • Apenas alguns usuários são visíveis para o SCIM. O SCIM funciona apenas com usuários que possuem um endereço de e-mail e um NameID SAML. Usuários que não atendem a ambos os requisitos não aparecem no SCIM; portanto, seu IdP não pode identificá-los e as alterações feitas no seu IdP não se aplicarão a eles. Se um usuário não estiver sendo sincronizado conforme o esperado, verifique primeiro se ele possui um endereço de e-mail e um NameID SAML.

{{snippet.Você encontrou o que estava procurando?}}