Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
LançamentoAnálise · No radarAWS Machine Learning Blog→ original

AWS descreve 3 esquemas para o agente de IA acessar o Snowflake: com a identidade da pessoa ou com uma conta compartilhada

Quando um agente de IA no Amazon Bedrock AgentCore consulta o Snowflake, é preciso decidir: ele entra com o nome do funcionário ou com uma conta compartilhada? A AWS testou três esquemas OAuth: login direto no Snowflake, SSO corporativo (Okta, Entra ID) e um usuário de serviço compartilhado. Nos dois primeiros, o log QUERY_HISTORY mostra a pessoa real e a função (role) dela. No terceiro, aparece uma única conta compartilhada. Para auditoria, use os dois primeiros e deixe o terceiro para tarefas em segundo plano.

Processado por IA de AWS Machine Learning Blog; editado por Hamidun News
AWS descreve 3 esquemas para o agente de IA acessar o Snowflake: com a identidade da pessoa ou com uma conta compartilhada
Fonte: AWS Machine Learning Blog. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalAWS Machine Learning Blog ↗
Editor-chefe
Esquemas 1 e 2OAuth de três vias (3LO), em que o próprio usuário confirma o login
Esquema 3OAuth de duas vias (2LO), sem necessidade de consentimento humano
Dado-chave #3Se o escopo MCP estiver vinculado a um IdP externo, os tokens do Snowflake OAuth são rejeitados

Imagine que você conectou um agente de IA ao data warehouse corporativo Snowflake e ele responde às perguntas dos analistas sobre os dados. Logo surge a dúvida: com qual conta o agente acessa o banco? O caminho mais simples é uma única conta de serviço com permissões amplas, mas, nesse caso, todas as consultas parecem iguais no log, e o agente enxerga mais do que um funcionário específico enxergaria.

A AWS publicou uma análise de três esquemas de autorização OAuth para a combinação entre o Amazon Bedrock AgentCore e o servidor MCP do Snowflake (MCP, ou Model Context Protocol, é o padrão pelo qual o agente encontra e chama ferramentas). Por esse servidor, os agentes têm acesso ao Cortex Search e ao Cortex Analyst. Se você está implantando agentes na sua empresa, o artigo ajuda a escolher o esquema conforme os requisitos de auditoria e segurança.

Quem emite o passe: três esquemas

O agente roda no AgentCore Runtime e se conecta ao Snowflake pelo AgentCore Gateway. Os tokens ficam a cargo do AgentCore Identity: ele os guarda em um armazenamento protegido, os renova e os associa ao usuário. O caminho do token é o mesmo em todos os esquemas. O que muda é qual servidor de autorização o emite e por qual tipo de login (grant).

O primeiro esquema é o Snowflake OAuth. O próprio Snowflake atua como servidor de autorização, e não é preciso um provedor de identidade (IdP) externo. O usuário entra diretamente no Snowflake por OAuth de três vias (3LO) e concorda em trabalhar com uma função específica, por exemplo ANALYST_ROLE. Todas as consultas são executadas em nome dele, e o QUERY_HISTORY registra o nome real.

O segundo esquema usa o mesmo login de três vias, mas por meio do login único (SSO) corporativo no Okta ou no Microsoft Entra ID. O Snowflake confia nos tokens JWT emitidos pelo IdP, por meio da integração de segurança External OAuth. As consultas também partem do usuário real, com a função atribuída a ele.

O terceiro esquema é o OAuth de duas vias (2LO) com um usuário de serviço compartilhado. A pessoa não confirma nada, por isso o esquema serve para tarefas em segundo plano, de máquina para máquina. Em contrapartida, no Snowflake todas as consultas partem de uma única conta de serviço. Para ter identidade pessoal sem tela de consentimento, o AgentCore Identity também oferece suporte ao grant on-behalf-of (TOKEN_EXCHANGE), mas os autores não o testaram de ponta a ponta.

Como funciona no exemplo do primeiro esquema

Um analista pede pela primeira vez que o agente consulte o Snowflake. O Gateway verifica o armazenamento de tokens do AgentCore Identity e não encontra um token para esse usuário. Então devolve um erro JSON-RPC com o código -32042 e um link de autorização. O cliente abre o link no navegador, o usuário vê a tela de login do Snowflake e confirma o acesso com uma função definida. Depois disso, os tokens de acesso e de atualização ficam em cache, e as chamadas seguintes passam sem novo login.

Onde é fácil tropeçar:

  • A ordem de configuração não é óbvia. Primeiro, cria-se o provedor de credenciais CustomOauth2 com valores provisórios para obter o callbackUrl. Depois, registra-se esse endereço no Snowflake como redirect URI na integração TYPE = OAUTH, OAUTH_CLIENT = CUSTOM. Só então se informam o client ID e o secret verdadeiros.
  • A seleção de função no consentimento não vem ativada por padrão: o servidor declara session:role:all e recorre à DEFAULT_ROLE. É possível restringir o escopo com OAUTH_SCOPES_SUPPORTED e limitar as funções permitidas com ALLOWED_ROLES_LIST. Já o PRE_AUTHORIZED_ROLES_LIST lista as funções para as quais o consentimento é dispensado.
  • Os nomes das funções na requisição devem estar em maiúsculas, por exemplo session:role:ANALYST_ROLE.
  • Se o escopo MCP for vinculado a um IdP externo por meio de OAUTH_AUTHORIZATION_SERVER (segundo esquema), os tokens do Snowflake OAuth são rejeitados, sem fallback para o outro esquema. Se você precisa dos dois esquemas na mesma conta, defina o parâmetro no nível do schema ou do banco de dados.

Qual escolher

Se os funcionários já têm contas no Snowflake e você precisa de um piloto rápido com auditoria pessoal, escolha o primeiro esquema: não é necessário um provedor externo. Se a empresa usa SSO, o segundo esquema integra o agente à gestão de usuários que já existe. O terceiro serve para tarefas automáticas em que a simplicidade pesa mais do que o vínculo com uma pessoa, e as permissões da conta de serviço devem ser reduzidas ao mínimo.

Há também limitações. Os esquemas foram testados apenas com o servidor MCP gerenciado pelo Snowflake e com os provedores Okta e Microsoft Entra ID. Os esquemas 2 e 3 seguem fluxos OAuth padrão e podem servir para outros servidores MCP protegidos por OAuth, mas claims, scopes e audience precisam ser verificados para cada provedor SaaS. Apenas o esquema 1 é específico do Snowflake, porque se apoia no servidor de autorização embutido da plataforma.

História

Perguntas frequentes sobre a notícia

O que se sabe sobre Quem emite o passe: três esquemas?

O agente roda no AgentCore Runtime e se conecta ao Snowflake pelo AgentCore Gateway. Os tokens ficam a cargo do AgentCore Identity: ele os guarda em um armazenamento protegido, os renova e os associa ao usuário. O caminho do token é o mesmo em todos os esquemas. O que muda é qual servidor de autorização o emite e por qual tipo de login (grant). O primeiro esquema é o Snowflake OAuth. O próprio Snowflake atua como servidor de autorização, e não é preciso um provedor de identidade (IdP) externo.

Como funciona no exemplo do primeiro esquema?

Um analista pede pela primeira vez que o agente consulte o Snowflake. O Gateway verifica o armazenamento de tokens do AgentCore Identity e não encontra um token para esse usuário. Então devolve um erro JSON-RPC com o código -32042 e um link de autorização. O cliente abre o link no navegador, o usuário vê a tela de login do Snowflake e confirma o acesso com uma função definida. Depois disso, os tokens de acesso e de atualização ficam em cache, e as chamadas seguintes passam sem novo login.

O que se sabe sobre Qual escolher?

Se os funcionários já têm contas no Snowflake e você precisa de um piloto rápido com auditoria pessoal, escolha o primeiro esquema: não é necessário um provedor externo. Se a empresa usa SSO, o segundo esquema integra o agente à gestão de usuários que já existe. O terceiro serve para tarefas automáticas em que a simplicidade pesa mais do que o vínculo com uma pessoa, e as permissões da conta de serviço devem ser reduzidas ao mínimo. Há também limitações.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
O que você acha?
Carregando comentários…