O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.
Carregando…
iam.assumeMódulo 31
Módulo da plataforma
Cloud credential broker
Dê a um agente uma credencial de nuvem de curta duração só enquanto ele detém um lease ativo sobre o papel, e deixe a credencial morrer com o lease.
iam.assume intermedia credenciais AWS por STS AssumeRoleWithWebIdentity. Sem lease no ARN do papel, sem credencial, e a vida da credencial nunca passa do que resta do lease. O ledger registra uma emissão, nunca as chaves. Uma rota warehouse faz o mesmo para Snowflake e BigQuery.
Intralock · Leases · Parley · Fleet Map
Um produto da Trustvice
Os agentes agem quando o plano diz sim, e o registo diz porquê.
Passe ações de agentes, hashes de conteúdo, checagens de API, DNS, webhooks, chamadas de LLM e commits git pela Intramedial. Receba um recibo assinado que todos verificam – sem confiar em nós.
Obrigatório. O token OIDC passado ao STS. A AWS o confere; o broker não.
sessionName
O nome de sessão do papel AWS. O padrão é acp e é só um rótulo.
region
A região do STS. O padrão é us-east-1.
ttlMs
Opcional. A duração que você pede. Só pode encurtar o que o lease e o teto permitem.
leaseId
Na resposta: o lease que justificou a credencial. leaseScoped é true.
expirationMs
Na resposta: quando a credencial expira, conforme informado pelo STS.
Mecanismo
Passo a passo
Como funciona
Formas e fases
A
Papel AWS
assume recebe um roleArn, um actorDid e um webIdentityToken, e devolve credenciais STS para esse papel. O lease de que precisa é detido no próprio ARN do papel.
B
Warehouse
warehouse recebe uma URN de recurso no formato imd://warehouse/<snowflake|bigquery>/<account>/<path>, um actorDid e opcionalmente um subjectToken, e emite um JWT de par de chaves ou um token de acesso federado.
Passo a passo
Pegue um lease
O agente adquire um lease no ARN do papel por coordination.lease. O lease é o que justifica a credencial; nada mais.
Peça o papel
assume recebe roleArn, actorDid, sessionName, webIdentityToken e opcionalmente region e ttlMs. O token deve ser um em que a AWS confie para o papel.
As chamadas deste módulo alteram estado real ou alcançam serviços externos, então a demonstração compartilhada não as executa. Entre para executá-lo no seu próprio workspace. Docs de iam.assume
Respostas
As chamadas deste módulo alteram estado real ou alcançam serviços externos, então a demonstração compartilhada não as executa. Entre para executá-lo no seu próprio workspace.
Código
Exemplo ao vivo
Uma requisição real
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
Um agente que faz deploy detém um lease no papel de deploy e nada mais. Sem ele, o papel não tem credencial para entregar.
A morte da credencial com o lease
Um lease com vinte minutos restantes não pode render uma credencial de uma hora; a duração é o menor entre o que resta do lease, ttlMs e 3.600.000 ms.
Observar as emissões
Cada emissão acrescenta um evento iam.assume com o ator, o papel e a expiração. watchdog.check lê esses eventos atrás de anomalias de taxa.
Manter as joias da coroa de fora
Um papel cujo nome corresponde a uma classe protegida como billing ou kms é recusado com 403, mesmo para um detentor de lease.
Quando usar outra coisa
Adquirir ou liberar o lease. Use coordination.lease; o broker só lê leases.
Decidir se uma ação na nuvem é permitida. O IAM da nuvem faz isso; este módulo emite a credencial e para.
Detectar uma rajada de pedidos de credencial. Isso é watchdog.check, que lê o que este módulo registra.
Evidência
Garantias
O que faz e o que não faz
Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
Faz
Uma credencial só é emitida para o DID que detém um lease ativo no ARN de papel exato.
Sua duração é o mínimo entre o tempo restante do lease, o ttlMs pedido e 3.600.000 ms.
O evento de ledger iam.assume registra o ator, o papel e a expiração, e nunca a chave de acesso, o segredo ou o token de sessão.
Um lease com pouco tempo para o mínimo de 900 segundos do próprio STS é recusado com 409 em vez de arredondado para cima.
Não faz
Que um lease liberado mate uma credencial já emitida. A credencial vive até seu expirationMs; o lease só impede a próxima.
Que o token de identidade web seja válido para o agente. O STS decide isso, e o broker repassa o token.
Que o registro no ledger tenha dado certo todas as vezes. Uma gravação com falha não bloqueia a emissão; a checagem de silêncio do watchdog cobre a lacuna.
Detalhes
Notas de construção
Antes de construir
Leases curtos
O AWS STS recusa sessões abaixo de 900 segundos, então um lease com menos que isso restante não pode virar credencial.
Classes protegidas
O nome do papel, a parte depois da última /, é conferido contra as classes protegidas do snapshot. Uma correspondência é recusada antes de qualquer lease ser lido.
A correspondência do detentor
O detentor do lease é comparado com actorDid, que um agente autenticado só pode definir como seu próprio DID.
Configuração do warehouse
Os caminhos do Snowflake e do BigQuery precisam de seus próprios segredos vinculados. Um warehouse não configurado responde 501, e um recurso Snowflake sem papel mapeado é 403.
Limites e medição
roleArn deve começar com arn:aws:iam::, webIdentityToken e actorDid são obrigatórios, e a falta de um devolve 400.
Sem lease, lease expirado, lease detido por outro agente ou com pouco tempo restante devolve 409.
A duração da credencial nunca passa de 3.600.000 ms, diga o que ttlMs disser.
A resposta contém as chaves secretas uma vez; mantenha-a fora dos logs, pois o ledger não a terá.
Acesso
API e MCP
REST e MCP
Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/iam/assumeEmita credenciais temporárias AWS para um papel com lease.
POST/api/v1/acp/iam/warehouseEmita uma credencial Snowflake ou BigQuery para um recurso com lease.
Ações MCP
MCPcoordination.iam.assumePeça credenciais AWS a partir de um agente.
Recusa com 403 um nome de papel de classe protegida, depois com 409 um lease ausente, expirado, alheio ou quase esgotado, e então chama o STS.
Use e deixe expirar
A resposta traz a chave de acesso, o segredo e o token de sessão com expirationMs. Liberar o lease encerra a disposição do broker de emitir, não as credenciais já emitidas.
coordination.halt06
Emergency stop switches
Pare um agente, um mandato ou um recurso de uma vez, com um motivo registrado, e levante a parada quando for seguro.