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.

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.

Fournisseurs d'identifiants

Pour effectuer des demandes d' AWS utilisation du AWS SDK pour C++, le SDK utilise des informations d'identification signées cryptographiquement émises par. AWS Au moment de l'exécution, le SDK récupère les valeurs de configuration pour les informations d'identification en vérifiant plusieurs emplacements.

L'authentification avec AWS peut être gérée en dehors de votre base de code. De nombreuses méthodes d'authentification peuvent être automatiquement détectées, utilisées et actualisées par le SDK à l'aide de la chaîne de fournisseurs d'informations d'identification.

Pour connaître les options guidées permettant de démarrer l' AWS authentification pour votre projet, consultez la section Authentification et accès dans le guide de référence des outils AWS SDKs et.

La chaîne de fournisseurs d'identifiants

Si vous ne spécifiez pas explicitement de fournisseur d'informations d'identification lors de la création d'un client, le SDK pour C++ utilise une chaîne de fournisseurs d'informations d'identification qui vérifie une série d'emplacements où vous pouvez fournir des informations d'identification. Une fois que le SDK a trouvé des informations d'identification à l'un de ces emplacements, la recherche s'arrête.

Ordre de récupération des informations d'identification

Tous SDKs ont une série de lieux (ou de sources) qu'ils vérifient afin d'obtenir des informations d'identification valides à utiliser pour faire une demande à un Service AWS. Une fois les informations d’identification valides trouvées, la recherche s’arrête. Cette recherche systématique est appelée chaîne de fournisseurs d'informations d'identification.

Pour chaque étape de la chaîne, il existe différentes manières de définir les valeurs. La définition des valeurs directement dans le code est toujours prioritaire, suivie de la définition en tant que variables d'environnement, puis dans le AWS config fichier partagé. Pour plus d'informations, consultez la section Priorité des paramètres dans le Guide de référence des outils AWS SDKs et des outils.

Le SDK tente de charger les informations d'identification à partir du [default] profil dans les credentials fichiers partagés AWS config et. Vous pouvez utiliser la variable d'AWS_PROFILEenvironnement pour choisir un profil nommé que vous souhaitez que le SDK charge au lieu de l'utiliser[default]. Les credentials fichiers config et sont partagés par AWS SDKs et les outils. Le guide de référence AWS SDKs and Tools contient des informations sur les paramètres de configuration du SDK utilisés par tous AWS SDKs et les AWS CLI. Pour en savoir plus sur la configuration du SDK via le AWS config fichier partagé, consultez la section Fichiers de configuration et d'informations d'identification partagés. Pour en savoir plus sur la configuration du SDK en définissant des variables d'environnement, consultez la section Prise en charge des variables d'environnement.

Pour s'authentifier auprès de AWS lui, le SDK for C++ vérifie les fournisseurs d'informations d'identification dans l'ordre suivant.

La chaîne de fournisseurs d'informations d'identification peut être consultée AWSCredentialsProviderChaindans le code AWS SDK pour C++ source sur GitHub.

Si vous avez suivi l'approche recommandée pour les nouveaux utilisateurs pour démarrer, vous avez configuré AWS IAM Identity Center l'authentification au cours Authentification du SDK avec AWS de la rubrique Mise en route. D'autres méthodes d'authentification sont utiles dans différentes situations. Pour éviter les risques de sécurité, nous vous recommandons de toujours utiliser des informations d'identification à court terme. Pour les autres procédures relatives aux méthodes d'authentification, voir Authentification et accès dans le guide de référence des outils AWS SDKs et.

Fournisseur d'informations d'identification explicite

Au lieu de vous fier à la chaîne de fournisseurs d'informations d'identification pour détecter votre méthode d'authentification, vous pouvez spécifier un fournisseur d'informations d'identification spécifique que le SDK doit utiliser. Vous pouvez le faire en fournissant des informations d'identification dans le constructeur de votre client de service.

L'exemple suivant crée un client Amazon Simple Storage Service en fournissant directement des informations d'accès temporaires au lieu d'utiliser la chaîne.

    SDKOptions options;
    Aws::InitAPI(options);
    {
        const auto cred_provider = Aws::MakeShared<Auth::SimpleAWSCredentialsProvider>("TestAllocationTag",
            "awsAccessKeyId",
            "awsSecretKey",
            "sessionToken");
        S3Client client{cred_provider};
    }
    Aws::ShutdownAPI(options);

Mise en cache des identités

Le SDK mettra en cache les informations d'identification et les autres types d'identité tels que les jetons SSO. Par défaut, le SDK utilise une implémentation de cache différé qui charge les informations d'identification lors de la première demande, les met en cache, puis tente de les actualiser lors d'une autre demande lorsqu'elles sont sur le point d'expirer. Les clients créés à partir du même Aws::Client::ClientConfigurationsite partagent un cache.