--- title: "Autorização SAML e controle de acesso" slug: "authorization-and-access-control-using-saml" updated: 2026-10-22T14:57:56Z published: 2026-10-22T14:57:56Z canonical: "support.tulip.co/authorization-and-access-control-using-saml" --- > ## 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. # Autorização SAML e controle de acesso *Instruções e metodologia para definir sua política de acesso e gerenciar o SAML para sua organização.* O SAML permite que as organizações gerenciem a autenticação e os direitos de acesso dos usuários do Tulip usando seu provedor de identidade (IdP) existente. Este guia detalhará as opções disponíveis para a implementação da integração de IdP de nível empresarial por meio do protocolo SAML. NOTE This article focuses on all the options for configuring your SAML and Tulip integration. For the guide on how to set this up within Tulip, see [tulip](/r230/docs/how-to-set-up-saml-sso-on-your-Set up SAML SSO . ## Pré-trabalho - Entenda [as funções](https://support.tulip.co/docs/adding-users-and-managing-user-roles) dos usuários do Tulip - Agrupe os usuários previstos do Tulip por função, para que você esteja pronto para atualizar um atributo SAML com a função deles no Tulip - Identifique quem, dentro da sua organização, irá configurar o IdP e a conta do Tulip ## Configuração do IdP Quando sua instância do Tulip estiver configurada para usar SAML no login, o Tulip mantém uma ligação entre os usuários no Tulip e os usuários no seu Provedor de Identidade (IdP) corporativo. Um determinado usuário que possua uma conta no IdP deve ter **, no máximo, uma conta em uma determinada instância do Tulip**. O Tulip mantém essa ligação por meio de um conceito específico do SAML chamado “NameID”. Um NameID é um tipo opaco de identificador fornecido pela autenticação SAML e definido pelo IdP. Como o NameID é usado para manter essa ligação, o Tulip espera que os NameIDs sejam *estáveis*, o que significa que **o NameID que o Tulip recebe para um determinado usuário do IdP não deve mudar ao longo da vida útil do usuário.** Se o NameID de um usuário mudar, a ligação será interrompida e você poderá encontrar erros ao fazer login. O Tulip recomenda enfaticamente que você configure seu IdP para fornecer um NameID que não mude com o tempo. Por esse motivo, **o Tulip desaconselha o uso de nomes ou endereços de e-mail como NameIDs**, pois esses valores podem mudar com o tempo. Recomendamos que você configure seu IdP para usar **IDs de objeto internos** ou **nomes de conta** que tenham a garantia de nunca mudar. Observe que os NameIDs não precisam ser legíveis ou reconhecíveis por humanos (na verdade, geralmente é melhor para a segurança usar valores não reconhecíveis como NameIDs). Ao configurar seu IdP, recomendamos que você defina o formato do NameID como **“Persistente”**, o que indica ao Tulip que o valor deve permanecer constante durante toda a vida útil de um usuário. Ao mapear o valor de origem do atributo NameID, mapeie-o para um valor que seja conhecido por ser imutável, como “ID de objeto” ou “nome principal do usuário”. ### Microsoft Entra Para clientes que utilizam **o Microsoft Entra** como IdP, siga estas instruções específicas para configurar seu aplicativo Tulip para usar NameIDs persistentes: 1. No Entra, comece pela Aplicação Corporativa associada à sua instância do Tulip. 2. No menu de navegação à esquerda, clique em “Single sign-on” no grupo “Manage”. 3. Edite a seção “Atributos e reivindicações”.![image2.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image2(3).png) 4. Na seção “Reivindicações obrigatórias”, clique na linha correspondente à reivindicação chamada “Identificador único do usuário (Name ID)”.![image3.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image3(3).png) 5. Certifique-se de que o “Formato do identificador de nome” esteja definido como “Persistente”. Defina a “Fonte” como “Atributo” e selecione um atributo que permaneça estável durante todo o ciclo de vida do usuário. `user.userprincipalname` e `user.objectid` são boas opções.![image1.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image1(3).png) ## Opções de configuração do SAML e do Tulip ### Modos de controle **O Modo de Controle do Tulip** indica que a função e o espaço de trabalho de um usuário no Tulip são obtidos a partir do mapeamento de atributos SAML **apenas na primeira vez em que ele faz login no Tulip.** Usuários desativados no Tulip não podem fazer login. **O Modo de Controle do IdP** significa que a função e o espaço de trabalho do usuário no Tulip serão atualizados a partir do IdP **sempre que ele fizer login.** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/SAML%20Access%20Control%20Modes.png) #### Mapeamento padrão de funções (somente no modo de controle do Tulip) No primeiro login, todos os usuários recebem um nível padrão de acesso (Visualizador com acesso ao Player). O Titular da conta precisará, então, ajustar a função para o nível apropriado manualmente no Tulip. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Authorization%20and%20Access%20control%20using%20SAML_417348705.png) ### Espaços de trabalho Saiba mais sobre [os espaços de trabalho](https://support.tulip.co/docs/what-are-workspaces-1) Assim como o atributo de função, agora você terá a opção de mapear usuários para um espaço de trabalho específico automaticamente quando o usuário for criado pela primeira vez. Após a criação do usuário, os proprietários de conta podem transferir usuários entre espaços de trabalho de maneira flexível. #### Mapeamento personalizado de espaços de trabalho via SAML :::(Informação) (Vários espaços de trabalho) Observe que só é possível mapear usuários para vários espaços de trabalho no Modo de Controle d Tulip. No Modo de Controle do IdP, cada usuário só pode ser membro de um único espaço de trabalho. ::: No primeiro login, é atribuído ao usuário o acesso ao espaço de trabalho com base no grupo apresentado em seu atributo de espaço de trabalho. A partir desse momento, o Tulip não lerá mais o atributo de espaço de trabalho desse usuário, e quaisquer alterações no espaço de trabalho deverão ser feitas na plataforma por um proprietário da conta. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Authorization%20and%20Access%20control%20using%20SAML_417348718.png) **Mapeamento padrão do espaço de trabalho** No primeiro login, todos os usuários recebem acesso a um espaço de trabalho padrão de sua escolha. O titular da conta pode, então, ajustar o acesso ao espaço de trabalho. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Authorization%20and%20Access%20control%20using%20SAML_417348723.png) ### Grupos de usuários Você pode mapear usuários para o recurso [Grupos de Usuários](/r230/docs/create-and-manage-user-groups){`target=_blank`} do Tulip em todas as configurações SAML. Os Grupos de Usuários existem no nível da conta. Assim que um usuário for mapeado para um grupo de usuários, ele se tornará membro desse grupo em todos os espaços de trabalho. Depois de ativar a opção “Grupos de usuários”, você poderá mapear usuários do seu IdP para os Grupos de usuários no Tulip com base no valor de um atributo no SAML. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28882%29.png) Depois disso, você pode nomear até 100 atributos SAML e mapear os valores de cada um deles para um grupo de usuários. Um usuário pode, então, ser mapeado para vários grupos de usuários. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28883%29.png) #### Mapeamento de grupos de usuários e comportamento do modo de controle O comportamento da associação a grupos de usuários depende da sua configuração do Modo de Controle. - **Modo de Controle do Tulip**: os grupos mapeados por SAML de um usuário são aplicados apenas na primeira vez em que ele faz login. Depois disso, a associação a grupos pode ser gerenciada dentro do Tulip, e quaisquer alterações manuais são preservadas nos logins subsequentes. - **Modo de Controle do IdP**: A associação completa do usuário a grupos é recalculada a partir de seus atributos SAML atuais a cada login. O Tulip atribui os grupos calculados pelo mapeamento e remove o usuário de qualquer grupo não coberto pelo mapeamento, incluindo grupos que foram atribuídos manualmente no Tulip. SAML custom user group management in IDP control mode In IdP Control Mode, any user group without a corresponding SAML attribute mapping rule will be removed from a user's account the next time they log in, even if it was assigned manually. To keep a user permanently in a group under IdP Control Mode, add a mapping rule for the group rather than assigning it manually. ### Opções de autenticação Se você quiser usar chaves FIDO para autenticação de usuários, será necessário “Desativar a correspondência de métodos de autenticação”. ### Classe de contexto de autenticação A classe de contexto de autenticação é o método especificado pelo qual os usuários se autenticam. Quando ativada, os usuários só poderão se autenticar usando o método especificado. Quando desativada, a seleção do método de autenticação será totalmente delegada ao Provedor de Identidade. ### Forçar autenticação O Tulip usa o parâmetro `forceAuthn` do SAML para controlar se os usuários devem se autenticar novamente com seu Provedor de Identidade (IdP) a cada login ou se uma sessão SAML existente no nível do sistema operacional pode ser reutilizada. O Tulip não utiliza o parâmetro `isPassive`. Aqui, a sessão existente é a sessão SAML no nível do sistema operacional (por exemplo, uma sessão do Windows vinculada ao seu provedor de identidade), e não uma sessão específica do Tulip. **Autenticação forçada ativada (padrão)**: o Tulip envia `forceAuthn=true`, exigindo que o usuário se autentique ativamente com seu IdP a cada login, independentemente de qualquer sessão SAML existente no nível do sistema operacional. Essa configuração garante que os usuários não possam ignorar a reautenticação. **Autenticação forçada DESATIVADA**: o Tulip envia `forceAuthn=false`. Se o usuário já tiver uma sessão SAML ativa no nível do sistema operacional reconhecida pelo IdP, ele será conectado ao Tulip automaticamente, sem precisar digitar novamente as credenciais. NOTE The exact behavior of `forceAuthn` depends on your IdP's implementation. ### Personalização Personalização opcional para o login do usuário. **Rótulo do botão de login** — Personalize o texto do botão de login SAML nas páginas de login do Tulip. **E-mail de suporte personalizado** — Defina um endereço de e-mail personalizado que será exibido aos usuários quando eles encontrarem um erro de login SAML. Isso pode direcionar os usuários ao seu suporte de TI interno. Se deixado em branco, o endereço de e-mail de suporte padrão “support@tulip.co” será usado. ## Reprodutor para desktop: navegador padrão do sistema operacional para autenticação Se o seu login SSO ou a autorização do conector OAuth exigirem integração disponível apenas por meio do navegador padrão do sistema operacional, o Tulip Player pode ser configurado para abrir os fluxos de autenticação no navegador padrão do sistema operacional, em vez de em uma janela incorporada. Contact Tulip Support to enable this behavior for your instance. ### Requisitos de versão Para a autenticação pelo navegador padrão do sistema operacional, é necessário atender aos seguintes requisitos de versão do Tulip:* Reprodutor para desktop 2.8 ou superior* Versão de fábrica 318 ou superior ### Comportamento do recurso Esse comportamento se aplica tanto ao login no Desktop Player via SSO quanto à autorização de conectores OAuth nos aplicativos do Tulip. Em ambos os casos, quando um usuário inicia a autenticação, **o navegador padrão do sistema** é aberto para lidar com o seguinte fluxo: 1. O navegador do sistema é iniciado e navega até a página de login do provedor de identidade (IdP) da sua organização. 2. O usuário conclui o login (inserindo credenciais, concluindo a autenticação multifatorial, etc.) no navegador exatamente como faria na web. 3. Assim que a autenticação for concluída, a página do navegador exibe a seguinte mensagem: **“Concluído! Você pode fechar esta janela.”** 4. A janela do navegador **permanece aberta**. Ela não é fechada automaticamente. O usuário deve fechá-la manualmente. 5. O Tulip Desktop Player detecta que o login foi concluído e prossegue normalmente. ### Solicitações de permissão esperadas Os usuários podem encontrar uma ou duas solicitações de permissão, dependendo da configuração do sistema operacional e do navegador: #### 1. Permissão de firewall do Desktop Player / servidor local (nível do sistema operacional) Quando a autenticação é iniciada, o Desktop Player cria um servidor local temporário para receber a resposta de autenticação. Dependendo do sistema operacional e das configurações de segurança, pode aparecer **um aviso do firewall do sistema ou de acesso à rede** perguntando se o Desktop Player tem permissão para aceitar conexões de entrada. - **Ação necessária**: Permita a conexão. Esse é um comportamento esperado e necessário para que o login seja concluído. - Dependendo da configuração do sistema operacional, essa solicitação pode aparecer apenas na primeira vez ou sempre.![Desktop player firewall permission prompt](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Desktop%20player%20firewall%20permission%20prompt.jpg) #### 2. Permissão de acesso à rede local do navegador (nível do navegador) Depois que o usuário concluir o login com seu provedor de identidade, a página de conclusão da autenticação do navegador envia o resultado de volta ao Desktop Player, fazendo uma solicitação ao servidor local descrito acima. Alguns navegadores exibem uma solicitação de permissão perguntando se a página tem permissão para acessar dispositivos na rede local. - **Ação necessária**: Permitir o acesso. Essa é uma etapa segura e esperada no fluxo de autenticação. - A solicitação é feita apenas para `o localhost` e contém apenas a resposta de autenticação criptografada. Nenhuma credencial confidencial é transmitida neste momento. ### Resumo das diferenças para o usuário A tabela abaixo compara os comportamentos da autenticação padrão e da autenticação habilitada pelo navegador do sistema operacional: | Comportamento | Padrão (não habilitado) | Habilitada pelo navegador do sistema operacional | | --- | --- | --- | | Onde ocorre o login | Dentro da janela do Player | Navegador padrão do sistema | | A janela do navegador fecha após o login | Automaticamente | Deve ser fechada manualmente | | Pode aparecer uma solicitação de permissão do firewall | Não | Sim (na primeira utilização ou por sessão) | | Solicitação de permissão na rede local do navegador | Não | Possivelmente (depende do navegador/sistema operacional) | | Suporta senhas salvas no navegador / sessão de SSO | Limitado | Total (usa a sessão existente do navegador do usuário) | ## Exemplo: Crie grupos de acesso no seu IdP O exemplo a seguir ajudará você a entender como todas as diferentes opções nas configurações do SAML podem ser usadas em conjunto. ### Crie funções padronizadas no Tulip Cada usuário precisará de um atributo de função especificado no seu IdP para que o Tulip possa determinar seus privilégios assim que ele se autenticar com seu nome de usuário e senha do IdP. Você também pode usar esse campo “Função” para determinar a quais sites eles têm acesso, utilizando uma convenção de nomenclatura padronizada. Embora um campo de função possa ser apenas uma variável definida, recomenda-se que você atribua o usuário a **grupos** específicos do Tulip **dentro do seu IdP** e mapeie esses grupos a um atributo. #### Função Cada usuário receberá uma única função em um espaço de trabalho. Quando o Tulip recebe várias funções válidas para um usuário, ele aplica a seguinte lógica: Se o conjunto incluir quaisquer funções integradas (Operador, Construtor etc.), o Tulip seleciona a função integrada com a classificação mais alta com base em uma hierarquia interna estática. As funções personalizadas são sempre classificadas abaixo de todas as funções integradas; portanto, elas nunca serão selecionadas se houver alguma função integrada presente. Se o conjunto incluir apenas funções personalizadas, o Tulip seleciona a primeira função personalizada recebida na carga útil do SAML. Role requirement There must be at least one Account Owner per site. **Saiba mais sobre [as funções de usuário](https://support.tulip.co/docs/adding-users-and-managing-user-roles) do Tulip.** #### Site Digamos que sua organização tenha dois locais, com um Tulip Instance para cada um. Podemos identificar cada local por sua localização (Texas e Londres, respectivamente). #### Combinando local e função Podemos combinar essas duas propriedades para criar uma matriz **de grupos** à qual os usuários serão atribuídos. Recomendamos que as organizações acrescentem “Tulip” no início ou no final do valor, para facilitar a filtragem. Convenção: **tulip-siteRole** | | acme-texas.tulip.co | acme-london.tulip.co | | --- | --- | --- | | Proprietário da conta | tulip-texasAccountOwner | tulip-londonAccountOwner | | Supervisor da aplicação | tulip-texasSupervisorDeAplicativo | tulip-londonSupervisorDeAplicativo | | Visualizador | tulip-texasVisualizador | tulip-londonVisualizador | | Operador | tulip-texasOperador | tulip-londonOperador | | ... | | | Se Jane Smith for a líder da unidade do Texas, você a designaria ao grupo **tulip-texasAccountOwner**. Se Jane Smith também precisar de acesso de visualização à unidade de Londres, ela poderia ser adicionada ao grupo **tulip-londonViewer**. #### Exponha esses grupos como um atributo para o Tulip No seu IdP, Jane deve ter um atributo, **tulip-role**, no qual serão mapeados todos os grupos dos quais ela seja membro e que contenham o prefixo “tulip-”. Quando ela fizer login no Tulip, o atributo **“** Tulip instance **”** terá dois valores: **“tulip-texasAccountOwner” e “tulip-londonViewer”.** Você pode configurar o mapeamento de funções para cada “ ” individualmente, de modo que ela receba as permissões corretas em cada instância. ### Funções globais Você também pode criar funções de acesso globais, como a função “Viewer”, por exemplo. Esses usuários poderão fazer login em todas as instâncias do Tulip instance com as mesmas permissões. O formato recomendado para isso é: **tulip-globalViewer** Você precisará configurar esse mapeamento de função em cada instância individual na página de configuração do SAML, em “Configurações da conta”, para permitir que esse usuário acesse cada instância. {{snippet.Você encontrou o que estava procurando?}}