Configuration de base avec laquelle travailler Services AWS - AWS SDK for Java 1. x
PrésentationPossibilité de connexion au portail d' AWS accèsConfiguration de fichiers de configuration partagésInstallation d'un environnement de développement Java

La AWS SDK for Java version 1.x est entrée en mode maintenance le 31 juillet 2024 et atteindra end-of-supportle 31 décembre 2025. Nous vous recommandons de migrer vers le pour continuer AWS SDK for Java 2.xà bénéficier des nouvelles fonctionnalités, des améliorations de disponibilité et des mises à jour de sécurité.

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.

Configuration de base avec laquelle travailler Services AWS

Présentation

Pour développer avec succès des applications qui accèdent à l' Services AWS aide de AWS SDK for Java, les conditions suivantes sont requises :

  • Vous devez être en mesure de vous connecter au portail AWS d'accès disponible dans le AWS IAM Identity Center.

  • Les autorisations du IAM rôle configuré pour le SDK doivent autoriser l'accès à Services AWS ce dont votre application a besoin. Les autorisations associées à la politique PowerUserAccess AWS gérée sont suffisantes pour répondre à la plupart des besoins de développement.

  • Un environnement de développement comprenant les éléments suivants :

Important

Les instructions de cette section de configuration supposent que vous ou votre organisation utilisez IAM Identity Center. Si votre organisation utilise un fournisseur d'identité externe qui fonctionne indépendamment d'IAMIdentity Center, découvrez comment obtenir des informations d'identification temporaires à utiliser SDK pour Java. Suivez ces instructions pour ajouter des informations d'identification temporaires au ~/.aws/credentials fichier.

Si votre fournisseur d'identité ajoute automatiquement des informations d'identification temporaires au ~/.aws/credentials fichier, assurez-vous que le nom du profil est [default] tel que vous n'avez pas besoin de fournir un nom de profil au SDK ou AWS CLI.

Possibilité de connexion au portail d' AWS accès

Le portail AWS d'accès est l'emplacement Web où vous vous connectez manuellement au IAM Identity Center. Le format du URL est d-xxxxxxxxxx.awsapps.com/start ouyour_subdomain.awsapps.com/start.

Si vous ne connaissez pas le portail d' AWS accès, suivez les instructions relatives à l'accès au compte figurant à l'étape 1 de la rubrique sur l'authentification d'IAMIdentity Center dans le guide de référence sur les outils AWS SDKs et. Ne suivez pas l'étape 2 car la version AWS SDK for Java 1.x ne prend pas en charge l'actualisation automatique des jetons ni la récupération automatique des informations d'identification temporaires pour les informations d'identification décrites à l'SDKétape 2.

Configuration de fichiers de configuration partagés

Les fichiers de configuration partagés résident sur votre poste de développement et contiennent les paramètres de base utilisés par tous AWS SDKs et par AWS Command Line Interface (CLI). Les fichiers de configuration partagés peuvent contenir un certain nombre de paramètres, mais ces instructions définissent les éléments de base nécessaires pour utiliser leSDK.

Configuration du config fichier partagé

L'exemple suivant montre le contenu d'un config fichier partagé.

[default]
region=us-east-1
output=json

À des fins de développement, utilisez le code le Région AWS plus proche de l'endroit où vous prévoyez d'exécuter votre code. Pour une liste des codes régionaux à utiliser dans le config fichier, consultez le Référence générale d'Amazon Web Services guide. Le json paramètre du format de sortie est l'une des nombreuses valeurs possibles.

Suivez les instructions de cette section pour créer le config fichier.

Configurez des informations d'identification temporaires pour SDK

Une fois que vous avez accès à un IAM rôle Compte AWS and via le portail AWS d'accès, configurez votre environnement de développement avec des informations d'identification temporaires SDK pour l'accès.

Étapes pour configurer un credentials fichier local avec des informations d'identification temporaires

  1. Créez un credentials fichier partagé.

  2. Dans le credentials fichier, collez le texte d'espace réservé suivant jusqu'à ce que vous y colliez des informations d'identification temporaires fonctionnelles.

    [default]
aws_access_key_id=<value from AWS access portal>
aws_secret_access_key=<value from AWS access portal>
aws_session_token=<value from AWS access portal>

  3. Enregistrez le fichier. Le fichier ~/.aws/credentials devrait maintenant exister sur votre système de développement local. Ce fichier contient le profil [par défaut] utilisé par Java si aucun profil nommé spécifique n'est spécifié. SDK

  4. Connectez-vous au portail d' AWS accès.

  5. Suivez ces instructions sous la rubrique Actualisation manuelle des informations d'identification pour copier les informations d'identification des IAM rôles depuis le portail AWS d'accès.

    1. Pour l'étape 4 des instructions liées, choisissez le nom du IAM rôle qui accorde l'accès pour vos besoins de développement. Ce rôle porte généralement un nom tel que PowerUserAccess« Développeur ».

    2. Pour l'étape 7, sélectionnez l'option Ajouter manuellement un profil à votre fichier AWS d'informations d'identification et copiez le contenu.

  6. Collez les informations d'identification copiées dans votre credentials fichier local et supprimez tout nom de profil collé. Votre fichier doit ressembler à ce qui suit :

    [default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE

  7. Enregistrez le credentials fichier

Le SDK for Java accèdera à ces informations d'identification temporaires lorsqu'il créera un client de service et les utilisera pour chaque demande. Les paramètres du IAM rôle choisi à l'étape 5a déterminent la durée de validité des informations d'identification temporaires. La durée maximale est de douze heures.

Une fois les informations d'identification temporaires expirées, répétez les étapes 4 à 7.

Installation d'un environnement de développement Java

La AWS SDK for Java V1 nécessite un Java 7 JDK ou une version plus récente. Si vous utilisez la version 1.12.767 ou une version antérieure duSDK, vous pouvez utiliser Java 7, mais si vous utilisez la version 1.12.768 ou une version plus récenteSDK, Java 8 est requis. Le référentiel central de Maven répertorie la dernière version de SDK pour Java.

Il AWS SDK for Java fonctionne avec le kit de développement Oracle Java SE et avec les distributions d'Open Java Development Kit (OpenJDK) telles qu'Amazon Corretto, Red Hat JDK Open et Adoptium.