As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Especifique o tipo de autorização e as credenciais para acessar o destino do gateway

No corpo da CreateGatewayTarget solicitação, você especifica a configuração do provedor de credenciais na credentialProviderConfigurations matriz. A configuração depende do tipo de autorização de saída que você configurou. Para obter informações de referência sobre a estrutura da API para a configuração do provedor de credenciais, consulte CredentialProviderConfiguration. Para obter mais informações sobre autorização de saída, consulte Configurar autorização de saída para seu gateway.

Para saber mais sobre a configuração de um provedor de credenciais, selecione um tópico:

AgentCore Autorização da função de serviço de gateway (IAM)

Se você estiver usando a autorização do IAM por meio de uma função de serviço do AgentCore Gateway para seu destino, especifique o credentialProviderType asGATEWAY_IAM_ROLE. A configuração depende do seu tipo de alvo.

Para destinos Lambda, API Gateway, Smithy e Connector

A iamCredentialProvider configuração não é necessária porque o nome do serviço de destino já é conhecido pelo serviço AgentCore Gateway. Use somente a credentialProviderType configuração, conforme mostrado no exemplo a seguir:

{
    "credentialProviderType": "GATEWAY_IAM_ROLE"
}

Para servidores MCP e destinos OpenAPI

Para o servidor MCP e os destinos OpenAPI, você também deve fornecer um iamCredentialProvider com o nome do serviço usado para AWS assinatura Signature Version 4 (Sig V4). O campo service é obrigatório. O region campo é opcional e o padrão é a Região do gateway.

{
    "credentialProviderType": "GATEWAY_IAM_ROLE",
    "credentialProvider": {
        "iamCredentialProvider": {
            "service": "execute-api",
            "region": "us-west-2"
        }
    }
}

A tabela a seguir descreve os campos no iamCredentialProvider objeto:

Autorização OAuth

Se você estiver usando a autorização OAuth, especifique o ascredentialProviderType. OAUTH No objeto para o qual o credentialProvider campo é mapeado, mapeie um nome de oauthCredentialProvider campo para um OAuthCredentialProvider objeto e forneça os valores com base na sua configuração de autorização de saída.

A estrutura do OAuthCredentialProvider difere dependendo do tipo de padrão de autenticação que você configurou. Para saber mais sobre diferentes padrões de autenticação, consulte Padrões de autenticação compatíveis.

Selecione um dos seguintes métodos:

Autorização de chave de API

Se você configurar a autorização da chave de API, especifique o credentialProviderType asAPI_KEY. No objeto para o qual o credentialProvider campo é mapeado, mapeie um nome de apiKeyCredentialProvider campo para um ApiKeyCredentialProvider objeto e forneça os valores com base na sua configuração de autorização de saída. O JSON a seguir mostra a estrutura:

{
    "credentialProviderType": "API_KEY",
    "credentialProvider": {
        "apiKeyCredentialProvider": {
            "providerArn": "string",
            "credentialLocation": "HEADER" | "QUERY_PARAMETER",
            "credentialParameterName": "string",
            "credentialPrefix": "string"
        }
    }
}

Autorização de credenciais IAM do chamador

Se você quiser que o gateway use a identidade do IAM e as permissões do chamador para assinar solicitações para o destino downstream, especifique ascredentialProviderType. CALLER_IAM_CREDENTIALS Com esse tipo de autorização, o gateway faz uma solicitação ao destino downstream em nome do chamador do gateway usando SigV4. Isso permite que o alvo downstream aplique políticas de IAM com base em quem originalmente chamou o gateway.

{
    "credentialProviderType": "CALLER_IAM_CREDENTIALS"
}

Autorização de passagem do JWT

Se você quiser que o gateway passe o token do portador da solicitação recebida diretamente para o destino downstream sem modificação, especifique o as. credentialProviderType JWT_PASSTHROUGH O gateway valida o token de entrada e o encaminha para o destino na solicitação de saída. Isso é útil quando o serviço de destino gerencia sua própria autorização usando o token do chamador original.

{
    "credentialProviderType": "JWT_PASSTHROUGH"
}