--- title: "Configurar o provisionamento de usuários (SCIM)" slug: "configuring-scim-with-saml-sso" updated: 2026-10-22T15:01:54Z published: 2026-10-22T15:01:54Z canonical: "support.tulip.co/configuring-scim-with-saml-sso" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Configurar o provisionamento de usuários (SCIM) *É 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](/r230/docs/set-up-saml-sso){`target=_blank`}, você também pode querer provisionar e desprovisionar usuários em tempo real, seguindo a [API SCIM](https://scim.cloud/). 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](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image-GLQUUKFA.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?}}