View a markdown version of this page

À propos des alias - AWS Cryptographie des paiements

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.

À propos des alias

Découvrez comment les alias fonctionnent dans AWS Payment Cryptography.

Un alias est une AWS ressource indépendante

Un alias n'est pas la propriété d'une clé de chiffrement AWS de paiement. Les actions que vous effectuez sur l'alias n'ont aucune incidence sur la clé qui lui est associée. Vous pouvez créer un alias pour une clé de chiffrement AWS de paiement, puis mettre à jour l'alias afin qu'il soit associé à une autre clé de cryptographie AWS de paiement. Vous pouvez même supprimer l'alias sans aucun effet sur la clé de cryptographie AWS de paiement associée. Si vous supprimez une clé AWS de chiffrement des paiements, tous les alias associés à cette clé ne seront plus attribués.

Si vous spécifiez un alias comme ressource dans une stratégie IAM, celle-ci fait référence à l'alias et non à la clé de chiffrement des AWS paiements associée.

Chaque alias a un nom convivial

Lorsque vous créez un alias, vous spécifiez le nom de l'alias préfixé paralias/. Par exemple alias/test_1234

Chaque alias est associé à une clé AWS de cryptographie de paiement à la fois

L'alias et sa clé AWS de cryptographie de paiement doivent se trouver dans le même compte et dans la même région.

Une clé AWS de chiffrement des paiements peut être associée à plusieurs alias simultanément, mais chaque alias ne peut être mappé qu'à une seule clé

Par exemple, cette list-aliases sortie indique que l'alias/sampleAlias1alias est associé à exactement une clé de cryptographie de AWS paiement cible, qui est représentée par la KeyArn propriété.

$ aws payment-cryptography list-aliases
  



  {
    "Aliases": [
        {
            "AliasName": "alias/sampleAlias1",
            "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h"
        }
    ]
}
Plusieurs alias peuvent être associés à la même clé de cryptographie AWS de paiement

Par exemple, vous pouvez associer les alias/sampleAlias2 alias alias/sampleAlias1; et à la même clé.

$ aws payment-cryptography list-aliases

{
        "Aliases": [
            {
                "AliasName": "alias/sampleAlias1",
                "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h"
            },
            {
                "AliasName": "alias/sampleAlias2",
                "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h"
            }
        ]
    }
Un alias doit être unique pour un compte et une région donnés

Par exemple, vous ne pouvez avoir qu'un seul alias alias/sampleAlias1 dans chaque compte et région. Les alias distinguent les majuscules et minuscules, mais nous vous déconseillons d'utiliser des alias dont la seule différence est la majuscule, car ils peuvent être sujets à des erreurs. Vous ne pouvez pas modifier un nom d'alias. Toutefois, vous pouvez supprimer l'alias et créer un alias avec le nom souhaité.

Vous pouvez créer des alias avec le même nom dans des régions différentes.

Par exemple, vous pouvez avoir un alias alias/sampleAlias2 dans l'est des États-Unis (Virginie du Nord) et un alias alias/sampleAlias2 dans l'ouest des États-Unis (Oregon). Chaque alias serait associé à une clé AWS de cryptographie de paiement dans sa région. Si votre code fait référence à un nom d'alias comme alias/finance-key, vous pouvez l'exécuter dans plusieurs régions. Dans chaque région, il en utilise un différent alias/sampleAlias2. Pour en savoir plus, consultez Utilisation d'alias dans vos applications.

Vous pouvez modifier la clé AWS de cryptographie des paiements associée à un alias

Vous pouvez utiliser cette UpdateAlias opération pour associer un alias à une autre clé AWS de chiffrement des paiements. Par exemple, si l'alias/sampleAlias2alias est associé à la clé de chiffrement des arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h AWS paiements, vous pouvez le mettre à jour afin qu'il soit associé à la arn:aws:payment-cryptography:us-east-2:111122223333:key/tqv5yij6wtxx64pi clé.

Avertissement

AWS La cryptographie des paiements ne permet pas de vérifier que l'ancienne et la nouvelle clé possèdent tous les mêmes attributs, tels que l'utilisation de la clé. La mise à jour avec un type de clé différent peut entraîner des problèmes dans votre application.

Avertissement

Les mises à jour des alias sont soumises à une éventuelle cohérence. Une fois que vous avez mis à jour un alias, il se peut que l'alias soit l'ancienne clé soit la nouvelle clé pendant une brève période. Ne mettez pas à jour les alias si ce comportement risque de perturber vos processus.

Certaines clés n'ont pas d'alias

Un alias est une fonctionnalité facultative et toutes les clés n'auront pas d'alias à moins que vous ne choisissiez de faire fonctionner votre environnement de cette manière. Les clés peuvent être associées à des alias à l'aide de la create-alias commande. Vous pouvez également utiliser l'opération update-alias pour modifier la clé de cryptographie de AWS paiement associée à un alias et l'opération delete-alias pour supprimer un alias. Par conséquent, certaines clés AWS de cryptographie de paiement peuvent avoir plusieurs alias, tandis que d'autres n'en ont aucun.

Associer une clé à un alias

Vous pouvez mapper une clé (représentée par un ARN) à un ou plusieurs alias à l'aide de la create-alias commande. Cette commande n'est pas idempotente. Pour mettre à jour un alias, utilisez la commande update-alias. 

$ aws payment-cryptography create-alias --alias-name alias/sampleAlias1 \
             --key-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h
{
    "Alias": {
        "AliasName": "alias/alias/sampleAlias1",
        "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h"
    }
}