Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Spécifiez le type d'autorisation et les informations d'identification pour accéder à la cible de la passerelle

Dans le corps de la CreateGatewayTarget demande, vous spécifiez la configuration du fournisseur d'informations d'identification dans la credentialProviderConfigurations baie. La configuration dépend du type d'autorisation sortante que vous configurez. Pour obtenir des informations de référence sur la structure d'API pour la configuration du fournisseur d'informations d'identification, consultez CredentialProviderConfiguration. Pour plus d'informations sur l'autorisation sortante, voir Configurer l'autorisation sortante pour votre passerelle.

Pour en savoir plus sur la configuration d'un fournisseur d'informations d'identification, sélectionnez une rubrique :

AgentCore Autorisation du rôle de service de passerelle (IAM)

Si vous utilisez l'autorisation IAM via un rôle de service AgentCore Gateway pour votre cible, spécifiez-le credentialProviderType commeGATEWAY_IAM_ROLE. La configuration dépend de votre type de cible.

Pour les cibles Lambda, API Gateway, Smithy et Connector

La iamCredentialProvider configuration n'est pas nécessaire car le nom du service cible est déjà connu du service AgentCore Gateway. Utilisez uniquement la credentialProviderType configuration, comme illustré dans l'exemple suivant :

{
    "credentialProviderType": "GATEWAY_IAM_ROLE"
}

Pour le serveur MCP et les cibles OpenAPI

Pour le serveur MCP et les cibles OpenAPI, vous devez également fournir un iamCredentialProvider avec le nom de service utilisé pour la AWS signature Signature Version 4 (Sig V4). Le champ service est obligatoire. Le region champ est facultatif et correspond par défaut à la région de la passerelle.

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

Le tableau suivant décrit les champs de l'iamCredentialProviderobjet :

Autorisation OAuth

Si vous utilisez l'autorisation OAuth, vous devez spécifier comme. credentialProviderType OAUTH Dans l'objet auquel le credentialProvider champ est mappé, associez un nom de oauthCredentialProvider champ à un OAuthCredentialProvider objet et fournissez les valeurs en fonction de votre configuration d'autorisation sortante.

La structure du modèle OAuthCredentialProvider varie en fonction du type de modèle d'authentification que vous configurez. Pour en savoir plus sur les différents modèles d'authentification, consultez la section Modèles d'authentification pris en charge.

Sélectionnez l'une des méthodes suivantes :

Autorisation par clé API

Si vous configurez l'autorisation par clé API, vous spécifiez credentialProviderType commeAPI_KEY. Dans l'objet auquel le credentialProvider champ est mappé, associez un nom de apiKeyCredentialProvider champ à un ApiKeyCredentialProvider objet et fournissez les valeurs en fonction de votre configuration d'autorisation sortante. Le JSON suivant montre la structure :

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

Autorisation des informations d'identification IAM de l'appelant

Si vous souhaitez que la passerelle utilise l'identité IAM et les autorisations de l'appelant pour signer les demandes destinées à la cible en aval, spécifiez credentialProviderType comme. CALLER_IAM_CREDENTIALS Avec ce type d'autorisation, la passerelle adresse une demande à la cible en aval au nom de l'appelant de la passerelle à l'aide de SIGv4. Cela permet à la cible en aval d'appliquer des politiques IAM en fonction de la personne qui a initialement appelé la passerelle.

{
    "credentialProviderType": "CALLER_IAM_CREDENTIALS"
}

Autorisation JWT Passthrough

Si vous souhaitez que la passerelle transmette le jeton porteur de la demande entrante directement à la cible en aval sans modification, spécifiez le credentialProviderType asJWT_PASSTHROUGH. La passerelle valide le jeton entrant, puis le transmet à la cible dans la demande sortante. Cela est utile lorsque le service cible gère sa propre autorisation à l'aide du jeton de l'appelant d'origine.

{
    "credentialProviderType": "JWT_PASSTHROUGH"
}