Blank white background with no objects or features visible.

Olá, EMEA! A TrueFoundry está expandindo sua presença pela Europa, Oriente Médio e África. Leia mais. →

Como Configurar SSO e SCIM para um AI Gateway

Published: novembro 20, 2026

TL;DR
  • SSO e SCIM resolvem problemas diferentes. O SSO (SAML ou OIDC) autentica uma pessoa no momento do login. O SCIM 2.0 provisiona e, fundamentalmente, desprovisiona a conta e suas associações a grupos ao longo de todo o seu ciclo de vida. Você precisa de ambos; o SSO sozinho deixa acessos órfãos para trás.
  • O modo de falha que o SCIM corrige é o que realmente causa prejuízo. Chaves de API compartilhadas e offboarding manual significam que uma pessoa que sai na sexta-feira ainda pode chamar seus modelos mais caros na segunda-feira. O SCIM revoga o acesso automaticamente, em todos os lugares, no momento em que o IdP desativa a conta.
  • Grupos são a superfície de controle. O SCIM sincroniza usuários e seus grupos do IdP no gateway; você mapeia grupos para funções RBAC; as funções controlam quais modelos, quais servidores MCP e quais orçamentos uma equipe pode usar. O acesso se torna uma propriedade da associação ao grupo no IdP, gerenciado em um único lugar.
  • A configuração consiste em cinco etapas conceituais: configurar o aplicativo no IdP, trocar metadados e claims para o SSO, emitir um token e endpoint SCIM, mapear atributos e grupos para funções e, em seguida, testar o provisionamento, a alteração de grupo e o desprovisionamento de ponta a ponta.
  • Esta é a base para a governança de agentes, não apenas para o login humano. Uma vez que a identidade humana flui via SSO e SCIM para as funções, a mesma estrutura de funções e políticas se estende à identidade de agentes, autorização detalhada por ferramenta e controles de residência de dados.

A maioria dos incidentes de segurança em AI gateways não é exótica. Trata-se da chave de API de um prestador de serviços desligado que continua funcionando três semanas depois, de uma "chave de equipe" compartilhada e colada em uma dúzia de notebooks que ninguém pode rotacionar sem quebrar o trabalho de todos, e de uma política de acesso a modelos que existe apenas na memória de um engenheiro. O acesso à IA corporativa falha de maneiras banais e evitáveis, e a solução é a mesma infraestrutura de identidade que qualquer outro sistema corporativo sério já utiliza: single sign-on para autenticação e SCIM para provisionamento de ciclo de vida.

Este artigo explica por que o acesso à IA deve ser gerenciado via SSO e SCIM em vez de chaves estáticas, o que cada protocolo faz, como eles se mapeiam nas especificidades de um AI gateway (login no console, acesso a modelos, acesso a servidores MCP, orçamentos) e como configurá-los conceitualmente em qualquer grande provedor de identidade. Ele foi escrito para o engenheiro de plataforma ou segurança que recebeu a tarefa de "colocar o AI gateway sob SSO" e precisa entender o mecanismo, não apenas clicar em um assistente de configuração.

Quer o SSO e o SCIM integrados a cada modelo e servidor MCP que suas equipes usam? Agende uma demonstração.

Por que chaves compartilhadas falham e a identidade resolve

Comece com o que a maioria das equipes realmente faz: uma chave de API de longa duração, frequentemente uma por equipe, às vezes uma para toda a empresa, repassada entre as pessoas para chamar o gateway. Isso apresenta quatro problemas estruturais, e todos os quatro são resolvidos pelo acesso baseado em identidade.

  • Sem atribuição. Uma chave compartilhada significa que todas as requisições parecem idênticas. Você não consegue identificar quem executou a consulta que custou US$ 400 em tokens, o que anula a observabilidade por usuário e o controle de orçamento que o gateway deveria fornecer.
  • Sem ciclo de vida. A chave não sabe nem se importa se alguém saiu da empresa. Revogá-la significa rotacioná-la, o que exige atualizar todas as pessoas que a utilizam legitimamente. Na prática, ela nunca é rotacionada e o acesso nunca termina.
  • Sem granularidade. Uma chave funciona ou não funciona. Você não pode definir que "esta equipe pode usar modelos baratos, mas não o modelo de ponta", porque a chave não carrega uma identidade para impor restrições.
  • Sem controle central. A política de acesso reside onde quer que as chaves estejam, ou seja, em todos os lugares e em lugar nenhum.

O SSO e o SCIM substituem isso por um modelo em que o acesso é uma função de quem você é no provedor de identidade e a quais grupos pertence. A autenticação comprova a identidade no login. O provisionamento mantém a visão do gateway sobre quem existe e quem pertence a qual grupo sincronizada automaticamente com o IdP. Quando o IdP desativa uma conta, o acesso é encerrado em todos os locais alcançados por ela, sem etapas manuais. Essa propriedade única — desprovisionamento automático — é a razão pela qual isso não é opcional para a IA corporativa.

SSO e SCIM não são a mesma coisa

Eles são rotineiramente confundidos, e essa confusão é a causa de acessos órfãos. O SSO faz o login das pessoas. O SCIM gerencia se a conta e as associações a grupos sequer existem. O SSO é um evento de autenticação; o SCIM é uma sincronização de ciclo de vida.

DimensãoSSO (SAML / OIDC)SCIM 2.0
PropósitoAutenticar um usuário no loginProvisionar, atualizar e desprovisionar contas e associações a grupos
Quando é executadoA cada login, de forma interativaContinuamente, impulsionado por alterações no IdP, sem a presença do usuário
ProtocoloAsserções SAML 2.0 ou ID tokens OpenID Connect (OAuth 2.0)SCIM 2.0 (esquema RFC 7643, protocolo RFC 7644) sobre REST/JSON
O que carregaQuem é o usuário naquele momento, além de claims (e-mail, grupos) na asserçãoO registro completo do usuário e associações a grupos, enviados conforme mudam
O que quebra sem eleUsuários gerenciam senhas separadas; sem login centralizado; MFA enfraquecidoContas e acessos persistem após o offboarding; mudanças de grupo não propagam; desprovisionamento manual
AnalogiaO porteiro que verifica seu crachá toda vez que você entraO processo de RH que emite e revoga o crachá

A armadilha é configurar o SSO, ver as pessoas fazendo login com sua identidade corporativa e cantar vitória. O SSO sozinho significa que, quando alguém passa pelo offboarding no IdP, sua capacidade de fazer login desaparece, mas se o gateway provisionou a conta e os acessos fora de banda, ou se a pessoa ainda possui um token ou chave, a conta e suas permissões podem persistir. O SCIM é o recurso que atua dentro do gateway para remover a conta e suas associações a grupos quando o IdP informa que a pessoa saiu. Você precisa de ambos: SSO para que o login seja centralizado e protegido por MFA, e SCIM para que a existência da conta e os acessos acompanhem a fonte da verdade.

Como isso se mapeia em um AI gateway

Um AI gateway possui elementos específicos a proteger, e a identidade se conecta a cada um deles. A cadeia vai do provedor de identidade até uma política concreta sobre modelos, servidores MCP e orçamentos.

Identity flow: the IdP (Okta, Entra ID, and the like) authenticates via SSO (SAML or OIDC) and provisions via SCIM into the gateway, where groups map to RBAC roles, and roles enforce policy on models, MCP servers, and budgets.
Fluxo de identidade: o IdP (Okta, Entra ID e similares) autentica via SSO (SAML ou OIDC) e provisiona via SCIM no gateway, onde os grupos são mapeados para funções RBAC, e as funções aplicam políticas sobre modelos, servidores MCP e orçamentos.

Acompanhe a cadeia da esquerda para a direita:

  1. SSO para o console e acesso via API. Quando um engenheiro abre o console do gateway, ele se autentica no IdP via SAML ou OIDC em vez de usar uma senha local. A asserção ou o ID token comprova a identidade e carrega claims. A mesma identidade dá suporte ao acesso programático, permitindo atribuir chamadas de API a uma pessoa ou serviço real, e não a uma chave compartilhada anônima.
  2. SCIM sincroniza usuários e grupos. O IdP envia registros de usuários e suas associações a grupos para o endpoint SCIM do gateway conforme ocorrem alterações. Um novo contratado adicionado ao grupo "ml-platform" no IdP aparece no gateway dentro desse grupo sem que ninguém precise intervir no gateway.
  3. Grupos são mapeados para funções RBAC. Você define, uma única vez, que o grupo "ml-platform" é mapeado para uma função e que "finance-analysts" é mapeado para outra. Esse mapeamento é o coração do projeto: é onde a identidade se transforma em autorização.
  4. Funções controlam modelos, servidores MCP e orçamentos. Uma função carrega permissões: quais modelos ela pode chamar, quais servidores MCP pode acessar, quais limites de taxa e orçamentos de tokens se aplicam. O TrueFoundry impõe orçamentos e limites de taxa por usuário, equipe e modelo, retornando HTTP 429 em caso de violação, permitindo que uma função autorize o acesso e limite os gastos ao mesmo tempo.

O resultado é que o acesso ao seu modelo de ponta mais caro, ou a um servidor MCP interno sensível, torna-se uma propriedade da associação ao grupo no IdP. Conceda o acesso adicionando alguém a um grupo no IdP; revogue-o removendo a pessoa. O RBAC do gateway é coberto com mais detalhes no artigo sobre autorização detalhada, e a visão geral de decisão está disponível no guia sobre como escolher um AI gateway.

Um mapeamento concreto de grupo para função

Abaixo está um exemplo ilustrativo para concretizar a abstração. Ajuste os nomes das funções e permissões de acordo com a sua própria política.

Grupo no IdPFunção no GatewayModelos permitidosServidores MCP permitidosOrçamento / Limites
ml-platformplatform-adminTodos, incluindo modelos avançados de raciocínioTodos, incluindo ferramentas administrativasOrçamento mensal alto; alto limite de RPS
product-engapp-developerModelos intermediários de chat e embeddingsServidores de dados internos somente leituraOrçamento moderado; HTTP 429 ao exceder
finance-analystsanalystApenas modelos econômicos de chatApenas servidor de dados financeirosOrçamento baixo; limite estrito de taxa
contractorsrestrictedApenas um modelo em sandboxNenhum servidor internoOrçamento mínimo; limite reduzido de tokens
(offboarded: removido de todos os grupos)nenhumanenhumnenhumnenhum — acesso revogado

A última linha representa o objetivo principal. A remoção dos grupos do IdP, propagada automaticamente pelo SCIM, reduz as permissões da pessoa a zero. Sem chamados no suporte, sem rotação manual de chaves e sem dúvidas sobre "lembrarmos de remover o acesso em todos os lugares".

Veja como o TrueFoundry mapeia grupos do IdP para funções RBAC em todo o gateway. Agende uma demonstração.

Configuração passo a passo

As telas exatas variam de acordo com o provedor de identidade, mas a sequência conceitual é a mesma para Okta, Entra ID, Google Workspace ou qualquer IdP compatível com SAML/OIDC e SCIM 2.0. Consulte a documentação oficial de cada IdP para validar os nomes exatos dos campos. A estrutura é a seguinte:

Etapa 1: Criar o aplicativo no IdP. No provedor de identidade, registre o gateway como um aplicativo corporativo. Este é o objeto que conterá tanto as configurações de SSO quanto, posteriormente, as de SCIM. Defina desde já quais usuários e grupos serão atribuídos a este aplicativo, pois apenas usuários atribuídos serão provisionados.

Etapa 2: Configurar o SSO (metadados e claims). Escolha SAML ou OIDC. Para SAML, faça a troca de metadados: o IdP fornece seu entity ID, URL de sign-in e certificado de assinatura; o gateway fornece sua URL de ACS (Assertion Consumer Service) e entity ID. Para OIDC, registre um cliente, troque a URL do emissor, client ID e secret, e configure as URIs de redirecionamento. Em ambos os casos, configure as claims: no mínimo o e-mail do usuário ou identificador exclusivo e, fundamentalmente, as associações a grupos do usuário, pois os grupos serão mapeados para as funções. Confirme se a claim de grupo está efetivamente incluída na asserção ou token; a ausência dessa claim é a causa mais comum de falhas silenciosas no mapeamento de funções.

Etapa 3: Habilitar o SCIM (token e endpoint). Ative o provisionamento. O gateway disponibiliza um endpoint base SCIM 2.0 (uma URL) e você gera um bearer token que autoriza o IdP a chamá-lo. Cole o endpoint e o token na configuração de provisionamento do IdP. O IdP testará a conexão chamando o endpoint SCIM; um teste bem-sucedido indica que o IdP pode criar, ler, atualizar e desativar usuários e grupos no gateway.

Etapa 4: Mapear atributos e grupos para funções. Configure os mapeamentos de atributos para que os campos de usuário do IdP (e-mail, nome de exibição, ID externo) preencham o registro do usuário no gateway e os envios de grupos via SCIM se tornem grupos no gateway. Em seguida, dentro do gateway, mapeie cada grupo para uma função RBAC com suas respectivas permissões de modelos, servidores MCP e orçamentos, conforme a tabela acima. Esse mapeamento constitui a política de acesso; solicite a revisão do responsável pela governança de acesso.

Etapa 5: Testar o ciclo de vida completo. Não considere o processo concluído apenas com um teste de login. Teste os três eventos do ciclo de vida:

  • Provisionamento: adicione um usuário de teste a um grupo mapeado no IdP, confirme se ele aparece no gateway com a função correta e valide se ele consegue chamar exatamente os modelos e servidores permitidos por essa função, e nada mais.
  • Movimentação: altere o grupo do usuário de teste no IdP e confirme se sua função e permissões no gateway mudam proporcionalmente.
  • Desprovisionamento: desative o usuário de teste no IdP, confirme se a desativação via SCIM revoga o acesso e valide se uma chamada que antes funcionava agora falha. Esta etapa comprova que o problema de acesso órfão foi resolvido.

O ciclo de vida que o SCIM automatiza

Todo o valor dessa arquitetura se resume a três eventos ao longo do ciclo de permanência de um funcionário ou prestador de serviços, e o SCIM gerencia todos os três sem a necessidade de intervenção humana no gateway.

The lifecycle SCIM automates: join (auto-provision the account and assign a role from group membership), move (a group change in the IdP changes gateway access), and leave (SCIM deprovision revokes access everywhere).
O ciclo de vida que o SCIM automatiza: entrada (autoprovisionamento da conta e atribuição de função a partir da associação ao grupo), movimentação (uma mudança de grupo no IdP altera o acesso no gateway) e saída (o desprovisionamento via SCIM revoga o acesso em todos os lugares).
  • Entrada. O RH ou TI adiciona a pessoa aos grupos no IdP como parte da integração. O SCIM provisiona a conta no gateway e, por meio do mapeamento de grupo para função, concede exatamente as permissões corretas. A pessoa obtém acesso à IA funcional e delimitado desde o primeiro dia, sem necessidade de abrir chamados para o gateway.
  • Movimentação. Um colaborador se transfere da engenharia de produto para a equipe de plataforma de ML. Sua associação a grupos no IdP muda. O SCIM propaga a alteração, a função no gateway é atualizada, ele ganha acesso aos modelos mais avançados e perde acesso aos servidores de dados da equipe antiga. O acesso acompanha o organograma automaticamente.
  • Saída. O colaborador passa pelo offboarding. O IdP desativa a conta. O SCIM desativa a conta no gateway e remove suas associações a grupos. Todas as permissões, modelos, servidores MCP e orçamentos são reduzidos a zero imediatamente. Não há janela de tempo em que a pessoa desligada mantenha acesso, pois não existe etapa manual passível de esquecimento.

Compare essa estrutura com o modelo de chaves compartilhadas: a integração exige localizar e compartilhar a chave correta, as movimentações não alteram nada automaticamente e a saída exige que alguém lembre de rotacionar uma chave — ação que interrompe o trabalho de outros usuários e, por isso, acaba não sendo realizada. As falhas no ciclo de vida são precisamente onde ocorrem as violações de segurança.

Além dos humanos: agentes e residência de dados

A identidade humana via SSO e SCIM é a base, mas o acesso à IA corporativa possui duas dimensões que não são totalmente cobertas por usuários humanos.

Primeiro, agentes também realizam chamadas. Um agente autônomo que invoca modelos e servidores MCP precisa de sua própria identidade, sua própria função e seu próprio orçamento, em vez de usar uma chave humana emprestada. A mesma estrutura de RBAC que mapeia grupos humanos para funções se estende às identidades de agentes, garantindo acesso com privilégio mínimo a ferramentas específicas e orçamento limitado. Essa é a evolução natural do gerenciamento de identidades; consulte os artigos sobre identidade de agentes de IA e os controles específicos de MCP em governança de MCP corporativo.

Segundo, a localização da identidade e dos dados é crítica. A autenticação e o provisionamento determinam quem pode fazer chamadas; a implantação determina para onde as requisições e seus dados vão fisicamente. O TrueFoundry pode ser implantado como SaaS, in-VPC, on-premise ou em ambientes isolados (air-gapped), mantendo o plano de dados dentro da sua rede enquanto a identidade se integra ao seu IdP. Para cargas de trabalho regulamentadas, essa separação é a diferença entre um gateway utilizável e um bloqueio de conformidade; acesse os artigos sobre residência de dados e a divisão entre plano de controle e plano de dados para entender esse funcionamento.

Onde as equipes cometem erros

Configuram o SSO e ignoram o SCIM. O login fica centralizado, a equipe aprova a mudança, mas o offboarding continua deixando contas e permissões ativas porque o desprovisionamento não é sincronizado. SSO sem SCIM resolve a autenticação e ignora o ciclo de vida. Configure ambos.

Nunca testam o desprovisionamento. O fluxo de provisionamento é testado porque novos usuários precisam de acesso no primeiro dia. O fluxo de desprovisionamento — aquele que efetivamente protege a infraestrutura — é apenas presumido. Desative uma conta de teste e confirme que uma chamada antes funcional passe a falhar, sempre que alterar a configuração.

Esquecem a claim de grupo. O SSO funciona, os usuários fazem login, mas todos caem em uma função padrão ou vazia porque a asserção do IdP não incluiu as associações a grupos. O mapeamento de funções depende inteiramente da presença e do nome correto da claim de grupo. Verifique sua presença em uma asserção ou token real.

Mantecamp uma chave compartilhada como "backup". Manter ativa uma chave única de administrador ou emergência anula todo o modelo, pois ela é inatribuível e nunca desprovisionada. Se precisar de acesso emergencial, crie um fluxo identificado, auditado e de curta duração, e não um segredo compartilhado permanente.

Mapeiam todos para uma única função abrangente. Provisionar via SCIM em uma função genérica "todos os usuários" fornece atribuição, mas não aplica o privilégio mínimo; todos continuam podendo chamar o modelo de ponta e qualquer servidor MCP. O objetivo do mapeamento de grupo para função é a granularidade. Mapeie equipes reais e permissões reais.

Conclusão

O acesso à IA corporativa não falha por motivos complexos. Ele falha porque uma chave compartilhada durou mais do que a permanência da pessoa que a utilizava, porque o offboarding era uma etapa manual esquecida ou porque ninguém conseguia identificar quem consumiu o orçamento de tokens. O SSO e o SCIM eliminam essas lacunas ao tornar o acesso uma função da identidade: o SSO autentica cada login por meio do seu provedor de identidade, e o SCIM mantém a visão do gateway sobre quem existe e a qual grupo pertence em sincronia automática com a fonte da verdade.

Configure ambos, mapeie grupos para funções com permissões reais de privilégio mínimo e teste o fluxo de desprovisionamento até garantir sua total confiabilidade. Ao fazer isso, o acesso aos seus modelos mais caros e aos servidores MCP mais sensíveis passa a ser concedido ao adicionar alguém a um grupo e revogado ao removê-lo, de forma instantânea e global. Essa mesma base de identidade se estende posteriormente para a identidade de agentes, autorização detalhada por ferramenta e controles de residência de dados exigidos pela IA regulamentada.

Automatize o acesso no ciclo de vida de colaboradores para sua infraestrutura de IA. Agende uma demonstração.

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
novembro 20, 2026
|
5 min read

Grok 4.3 no Amazon Bedrock: Roteamos Quatro Modelos de Fronteira por um Único Gateway e Medimos o Custo

Ferramentas de LLM
comparação
novembro 20, 2026
|
5 min read

GPT-6.1 Terra: API, Benchmarks, Preço & Como Usar

No items found.
TrueFoundry AI gateway is an enterprise alternative to Bifrost and Portkey
novembro 20, 2026
|
5 min read

Bifrost vs Portkey: Precificação, Recursos de Gateway e Adequação Enterprise Comparados

No items found.
novembro 20, 2026
|
5 min read

Evolução do Machine Learning: Um Mergulho Profundo na Jornada de Savin

True ML Talks
No items found.
Take a quick product tour
Start Product Tour
Product Tour