Tous les produits
Search
Centre de documentation

Resource Access Management:Démarrage rapide : Créer et utiliser une paire de clés d'accès

Dernière mise à jour :Aug 09, 2026

Ce guide de démarrage rapide vous explique comment créer, consulter et utiliser une paire de clés d'accès dans Resource Access Management (RAM) afin d'accéder aux ressources Alibaba Cloud avec la CLI Alibaba Cloud.

Important

Par mesure de sécurité, évitez d'utiliser des identifiants à long terme, tels qu'une paire de clés d'accès, pour un accès programmatique. Pour en savoir plus, consultez la rubrique Bonnes pratiques pour l'accès programmatique.

Qu'est-ce qu'une paire de clés d'accès ?

Une paire de clés d'accès se compose d'un AccessKey ID et d'un AccessKey secret. Les paires de clés d'accès sont principalement utilisées pour authentifier une application ou un service lorsqu'il appelle les API Alibaba Cloud.

Une paire de clés d'accès est un identifiant à long terme associé à un utilisateur RAM spécifique. Cet identifiant à long terme présente un risque élevé pour la sécurité en cas de compromission.

Procédure

  1. Créer une paire de clés d'accès : générez une paire de clés d'accès pour un utilisateur RAM spécifié.

  2. Utiliser la paire de clés d'accès pour effectuer des appels API : configurez la CLI Alibaba Cloud pour utiliser la paire de clés d'accès afin d'effectuer des appels API directs ou indirects.

  3. Nettoyer les ressources : supprimez la configuration locale des identifiants, puis désactivez et supprimez la paire de clés d'accès.

Prérequis

  • Vous avez créé un utilisateur RAM. Si ce n'est pas le cas, consultez la rubrique Démarrage rapide : Créer un utilisateur RAM et lui accorder des autorisations. N'utilisez pas votre compte Alibaba Cloud pour créer une paire de clés d'accès.

  • Vous devez disposer des autorisations RAM requises pour créer et consulter une paire de clés d'accès. Nous vous recommandons d'attribuer la stratégie système AliyunRAMFullAccess à l'utilisateur qui effectue ces opérations. Supprimez cette stratégie une fois le tutoriel terminé.

  • Vous avez installé la CLI Alibaba Cloud. Pour en savoir plus, consultez la rubrique Premiers pas avec la CLI Alibaba Cloud.

Créer une paire de clés d'accès

  1. Connectez-vous à la console RAM. Dans le volet de navigation de gauche, choisissez Identities > Users.

  2. Sur la page Users, repérez l'RAM user cible et cliquez sur son nom d'utilisateur.

  3. Sous l'onglet Authentication, cliquez sur Create AccessKey.

    Remarque

    Un RAM user peut posséder au maximum deux paires de AccessKey. L'une est utilisée activement et la seconde ne doit être créée que lorsque vous devez faire tourner les identifiants.

  4. Dans la boîte de dialogue de confirmation, sélectionnez CLI, cochez la case I confirm that it is necessary to create an AccessKey, puis cliquez sur Continue.

  5. Suivez les instructions affichées à l'écran pour terminer l'authentification multifacteur (MFA).

  6. Dans la boîte de dialogue Create AccessKey, cliquez sur Download CSV File pour enregistrer l'AccessKey ID et l'AccessKey secret. Cliquez ensuite sur OK.

    Important

    L'AccessKey secret n'est affiché qu'au moment de la création et ne peut pas être récupéré ultérieurement. Vous devez le stocker dans un emplacement sécurisé.

Utiliser une paire de clés d'accès pour appeler des API

Remarque

Ce tutoriel utilise la CLI Alibaba Cloud comme exemple. Pour apprendre à utiliser une paire de clés d'accès dans votre code, consultez les rubriques suivantes :

Accès direct

Cette méthode est simple, mais elle introduit des risques tels que des clés codées en dur et des autorisations excessives, car la paire de clés d'accès est configurée directement sur le client. Cette approche n'est pas recommandée pour les environnements de production.

  1. Accordez à l'utilisateur RAM disposant de la paire de clés d'accès des autorisations en lecture seule sur RAM en attachant la stratégie AliyunRAMReadOnlyAccess.

    1. Connectez-vous à la console RAM. Dans le volet de navigation de gauche, choisissez Identities > Users.

    2. Repérez l'RAM user cible et cliquez sur Add Permissions dans la colonne Actions.

    3. Dans le panneau Add Permissions, recherchez et sélectionnez la stratégie système AliyunRAMReadOnlyAccess, puis cliquez sur OK.

    4. Revenez à la page Users et cliquez sur le nom d'utilisateur de l'RAM user cible. Sous l'onglet Permissions > Individual, vérifiez que la stratégie AliyunRAMReadOnlyAccess figure dans la liste.

  1. Ouvrez votre terminal local et exécutez la commande suivante pour configurer vos identifiants de manière interactive.

    aliyun configure --profile AkProfile
  2. Aux invites, saisissez l'AccessKey ID et l'AccessKey secret obtenus lors de l'étape Créer une paire de clés d'accès. Définissez ensuite la région par défaut et la langue.

    Configuring profile 'AkProfile' in 'AK' authenticate mode...
    Access Key Id []: <yourAccessKeyID>
    Access Key Secret []: <yourAccessKeySecret>
    Default Region Id []: cn-shanghai
    Default Output Format [json]: json (Only support json)
    Default Language [zh|en] en: en
    Saving profile[AkProfile] ...Done.
  3. Si la paire de clés d'accès et les autres configurations sont correctes, le terminal affiche un message de succès. En cas d'erreur, supprimez la configuration des identifiants mise en cache par la CLI Alibaba Cloud, vérifiez vos paramètres, puis relancez la commande à partir de l'étape 2.

    Configure Done!!!
    ..............888888888888888888888 ........=8888888888888888888D=..............
    ...........88888888888888888888888 ..........D8888888888888888888888I...........
    .........,8888888888888ZI: ...........................=Z88D8888888888D..........
    .........+88888888 ..........................................88888888D..........
    .........+88888888 .......Welcome to use Alibaba Cloud.......O8888888D..........
    .........+88888888 ............. ************* ..............O8888888D..........
    .........+88888888 .... Command Line Interface(Reloaded) ....O8888888D..........
    .........+88888888...........................................88888888D..........
    ..........D888888888888DO+. ..........................?ND888888888888D..........
    ...........O8888888888888888888888...........D8888888888888888888888=...........
    ............ .:D8888888888888888888.........78888888888888888888O ..............
  4. Exécutez la commande suivante pour tester l'appel API.

    aliyun ram ListUsers --profile AkProfile

    Si la configuration a réussi, la commande renvoie une liste d'utilisateurs RAM. Le résultat ressemble à ce qui suit :

    {
      "IsTruncated": false,
      "RequestId": "B3CDEF9E-A3F4-58B0-80BE-54576991****",
      "Users": {
        "User": [
          {
            "Comments": "",
            "CreateDate": "2025-10-29T02:47:52Z",
            "DisplayName": "username",
            "UpdateDate": "2025-10-29T02:47:52Z",
            "UserId": "20376656170607****",
            "UserName": "username"
          },
          ...
        ]
      }
    }

Accès indirect

Cette méthode utilise la paire de clés d'accès à long terme pour obtenir un jeton STS temporaire permettant d'effectuer des appels API. Bien que la configuration soit plus complexe, cette approche est plus sécurisée car elle réduit le risque d'exposition de l'identifiant à long terme et permet une gestion dynamique des autorisations via des rôles.

  1. Accordez à l'utilisateur RAM disposant de la paire de clés d'accès l'autorisation d'appeler l'opération STS AssumeRole en attachant la stratégie AliyunSTSAssumeRoleAccess.

    1. Connectez-vous à la console RAM. Dans le volet de navigation de gauche, choisissez Identities > Users.

    2. Repérez l'RAM user cible et cliquez sur Add Permissions dans la colonne Actions.

    3. Dans le panneau Add Permissions, recherchez et sélectionnez la stratégie système AliyunSTSAssumeRoleAccess, puis cliquez sur OK.

    4. Revenez à la page Users et cliquez sur le nom d'utilisateur de l'RAM user cible. Sous l'onglet Permissions > Individual, vérifiez que la stratégie AliyunSTSAssumeRoleAccess figure dans la liste.

  2. Créez un rôle RAM et obtenez son ARN de rôle.

    1. Dans la console RAM, choisissez Identities > Roles dans le volet de navigation de gauche.

    2. Sur la page Roles, cliquez sur Create Role.

    3. Sur la page Create Role, sélectionnez Cloud Account pour le champ Principal Type, spécifiez le compte Alibaba Cloud, puis cliquez sur OK.

    4. Dans le panneau Create Role, saisissez un nom de rôle, par exemple cli-test-role, et cliquez sur OK.

    5. Sur la page des détails du rôle, repérez l'ARN dans la section Basic Information. Cliquez sur Copy et enregistrez l'ARN pour une utilisation ultérieure.

  3. Accordez au rôle RAM des autorisations en lecture seule sur RAM en attachant la stratégie AliyunRAMReadOnlyAccess.

    Accédez à la page Identities > Roles, cliquez sur Add Permissions dans la colonne Actions pour le rôle, et ajoutez l'autorisation comme décrit à l'étape 1.

  4. Ouvrez votre terminal local et exécutez la commande suivante pour configurer vos identifiants de manière interactive.

    aliyun configure --profile RamRoleArnProfile --mode RamRoleArn
  5. Aux invites, saisissez l'AccessKey ID et l'AccessKey secret obtenus lors de l'étape Créer une paire de clés d'accès, ainsi que l'ARN du rôle obtenu à l'étape 2. Pour les autres paramètres, reportez-vous à l'exemple suivant.

    Configuring profile 'RamRoleArnProfile' in 'RamRoleArn' authenticate mode...
    Access Key Id []: <yourAccessKeyID>
    Access Key Secret []: <yourAccessKeySecret>
    Sts Region []: cn-shanghai
    Ram Role Arn []: acs:ram::012345678910****:role/cli-test-role
    Role Session Name []: cli-test-role
    External ID []: abcd1234
    Expired Seconds [900]: 900
    Default Region Id []: cn-shanghai
    Default Output Format [json]: json (Only support json)
    Default Language [zh|en] en: en
    Saving profile[RamRoleArnProfile] ...Done.
  6. Si la paire de clés d'accès et les autres configurations sont correctes, le terminal affiche un message de succès. En cas d'erreur, supprimez la configuration des identifiants mise en cache par la CLI Alibaba Cloud, vérifiez vos paramètres, puis relancez la commande à partir de l'étape 4.

    Configure Done!!!
    ..............888888888888888888888 ........=8888888888888888888D=..............
    ...........88888888888888888888888 ..........D8888888888888888888888I...........
    .........,8888888888888ZI: ...........................=Z88D8888888888D..........
    .........+88888888 ..........................................88888888D..........
    .........+88888888 .......Welcome to use Alibaba Cloud.......O8888888D..........
    .........+88888888 ............. ************* ..............O8888888D..........
    .........+88888888 .... Command Line Interface(Reloaded) ....O8888888D..........
    .........+88888888...........................................88888888D..........
    ..........D888888888888DO+. ..........................?ND888888888888D..........
    ...........O8888888888888888888888...........D8888888888888888888888=...........
    ............ .:D8888888888888888888.........78888888888888888888O ..............
  7. Exécutez la commande suivante pour tester l'appel API.

    aliyun ram ListUsers --profile RamRoleArnProfile

    Si la configuration a réussi, la commande renvoie une liste d'utilisateurs RAM. Le résultat ressemble à ce qui suit :

    {
      "IsTruncated": false,
      "RequestId": "B3CDEF9E-A3F4-58B0-80BE-54576991****",
      "Users": {
        "User": [
          {
            "Comments": "",
            "CreateDate": "2025-10-29T02:47:52Z",
            "DisplayName": "username",
            "UpdateDate": "2025-10-29T02:47:52Z",
            "UserId": "20376656170607****",
            "UserName": "username"
          },
          ...
        ]
      }
    }

Nettoyer les ressources

Supprimer les identifiants CLI mis en cache

Exécutez la commande appropriée pour supprimer la configuration des identifiants mise en cache.

Désactiver et supprimer la paire de clés d'accès

  1. Connectez-vous à la console RAM. Dans le volet de navigation de gauche, choisissez Identities > Users.

  2. Repérez l'RAM user cible pour lequel vous avez créé la paire de clés d'accès et cliquez sur son nom d'utilisateur.

  3. Désactivez la paire de clés d'accès : sous l'onglet Authentication, repérez la paire de clés d'accès cible et cliquez sur Disable dans la colonne Actions. Dans la boîte de dialogue Disable, cliquez sur Disable.

  4. Déplacez la paire de clés d'accès vers la corbeille : cliquez sur Delete dans la colonne Actions pour la paire de clés d'accès cible. Dans la boîte de dialogue de confirmation, saisissez l'AccessKey ID, puis cliquez sur Move to Recycle Bin.

  5. Supprimez définitivement la paire de clés d'accès : sur la page des détails de l'utilisateur, dans la section AccessKey Pair Recycle Bin, repérez la paire de clés d'accès cible et cliquez sur Delete dans la colonne Actions. Dans la boîte de dialogue de confirmation, saisissez l'AccessKey ID, puis cliquez sur Delete.

Références

Pour en savoir plus, consultez les rubriques suivantes :