View a markdown version of this page

Création et gestion de jetons Accessor pour un accès basé sur des jetons afin d'effectuer des requêtes AMB Access Polygon - Polygone d'accès AMB
Création d'un jeton Accessor pour un accès basé sur des jetonsAfficher les détails d'un jeton AccessorSupprimer un jeton d'accès

Amazon Managed Blockchain (AMB) Access Polygon est en version préliminaire et est susceptible d'être modifiée.

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.

Création et gestion de jetons Accessor pour un accès basé sur des jetons afin d'effectuer des requêtes AMB Access Polygon

Vous pouvez également utiliser des jetons Accessor pour passer des JSON-RPC appels vers les points de terminaison du réseau Polygon, ce qui constitue une alternative pratique au processus de signature Signature Version 4 (Sigv4). Vous devez fournir un BILLING_TOKEN provenant de l'un des jetons Accessor que vous créez et que vous ajoutez en tant que paramètre à vos appels.

Important

  • Si vous privilégiez la sécurité et l'auditabilité à la commodité, utilisez plutôt le processus de signature SIGv4.

  • Vous pouvez accéder au polygone à l' JSON-RPCs aide de Signature Version 4 (Sigv4) et d'un accès basé sur des jetons. Toutefois, si vous choisissez d'utiliser les deux protocoles, votre demande est rejetée.

  • Vous ne devez jamais intégrer de jetons Accessor dans des applications destinées aux utilisateurs.

Dans la console, la page Token Accessors affiche une liste de tous les jetons Accessor que vous pouvez utiliser pour passer des JSON-RPC appels AMB Access Polygon à partir de votre code Compte AWS from sur un client.

Pour plus d'informations sur les JSON-RPC requêtes AMB Access Polygon, consultez. API de blockchain gérée et JSON RPCs compatibles avec AMB Access Polygon

Vous pouvez créer et gérer des jetons Accessor à l'aide du Console de gestion AWS. Vous pouvez également créer et gérer des jetons Accessor à l'aide des opérations d'API suivantes : CreateAccessor GetAccessor,ListAccessors, et DeleteAccessor. A BILLING_TOKEN est une propriété de l'Accesseur. Cette BILLING_TOKEN propriété est utilisée pour suivre votre Accessor et pour facturer les JSON-RPC demandes AMB Access Polygon effectuées auprès de vous. Compte AWS

Toutes les actions d'API liées à la création et à la gestion des jetons Accessor sont également disponibles via les SDK Console de gestion AWS AWS CLI, et.

Création d'un jeton Accessor pour un accès basé sur des jetons

Vous pouvez créer un jeton Accessor et l'utiliser pour effectuer des appels à l'API AMB Access Polygon sur n'importe quel nœud AMB Access Polygon de votre. Compte AWS

  1. Ouvrez la console Managed Blockchain à l'adresse https://console.aws.amazon.com/managedblockchain/.

  2. Choisissez Token Accessors.

  3. Choisissez Create Accessor.

  4. Choisissez un réseau de blockchain Polygon valide.

  5. Facultatif, ajoutez des balises pour votre accessoire.

  6. Choisissez Create Accessor pour créer un nouveau jeton Accessor.

aws managedblockchain create-accessor --accessor-type BILLING_TOKEN --network-type POLYGON_MAINNET

La commande précédente renvoie le AccessorId ainsi que leBillingToken, comme indiqué dans l'exemple suivant.

{
"AccessorId": "ac-NGQ6QNKXLNEBXD3UI6********",
"NetworkType": "POLYGON_MAINNET", 
"BillingToken": "jZlP8OUI-PcQSKINyX9euJJDC5-IcW9e-n********"
}

L'élément clé de votre réponse est leBillingToken. Vous pouvez utiliser cette propriété pour passer des appels AMB Access Polygon JSON-RPC . Certaines valeurs de l'exemple ont été masquées pour des raisons de sécurité mais apparaîtront intégralement dans les réponses réelles.

Note

Une fois l'opération exécutée, Managed Blockchain provisionne et configure le jeton pour vous. La durée de ce processus dépend de nombreuses variables.

Afficher les détails d'un jeton Accessor

Vous pouvez consulter les propriétés de chaque jeton Accessor que vous possédez Compte AWS . Par exemple, vous pouvez consulter l'ID d'accès ou le nom de ressource Amazon (ARN) de l'acceseur. Vous pouvez également afficher le statut, le type, la date de création et leBillingToken.

  1. Ouvrez la console Managed Blockchain à l'adresse https://console.aws.amazon.com/managedblockchain/.

  2. Dans le volet de navigation, choisissez Token Accessors.

  3. Choisissez l'ID d'accès du jeton dans la liste.

La page des détails du jeton s'affiche. Sur cette page, vous pouvez consulter les propriétés du jeton.

Exécutez la commande suivante pour afficher les détails d'un jeton Accessor. Remplacez les valeurs de --accessor-id par votre identifiant d'accès.

aws managedblockchain get-accessor --accessor-id ac-NGQ6QNKXLNEBXD3UI6********

Les propriétés clés BillingToken et les autres propriétés clés sont renvoyées comme indiqué dans l'exemple suivant. Certaines valeurs de l'exemple ont été masquées pour des raisons de sécurité mais apparaissent intégralement dans les réponses réelles.

{
  "Accessor": {
  "Id": "ac-NGQ6QNKXLNEBXD3UI6********",
  "Type": "BILLING_TOKEN",
  "BillingToken": "jZlP8OUI-PcQSKINyX9euJJDC5-IcW9e-n********",
  "Status": "AVAILABLE",
  "NetworkType": "POLYGON_MAINNET"
  "CreationDate": "2022-01-04T23:09:47.750Z",
  "Arn": "arn:aws:managedblockchain:us-east-1:666666666666:accessors/ac-NGQ6QNKXLNEBXD3UI6********"
  }
}

Supprimer un jeton d'accès

Lorsque vous supprimez un jeton Accessor, le jeton passe du PENDING_DELETION statut AVAILABLE au statut. Vous ne pouvez pas utiliser un jeton Accessor avec ce PENDING_DELETION statut.

  1. Ouvrez la console Managed Blockchain à l'adresse https://console.aws.amazon.com/managedblockchain/.

  2. Dans le volet de navigation, choisissez Token Accessors.

  3. Sélectionnez le jeton d'accès que vous souhaitez dans la liste.

  4. Sélectionnez Delete (Supprimer).

  5. Confirmez votre choix.

Vous êtes redirigé vers la page des accesseurs des jetons avec votre jeton d'accès supprimé. La page affiche le PENDING_DELETION statut.

L'exemple suivant montre comment supprimer un jeton. Utilisez la delete-accessor commande pour supprimer un jeton. Définissez la valeur de à l'--accessor-idaide de votre identifiant d'accès.

Supprimer un jeton Accessor à l'aide de l'interface de ligne de commande AWS 

aws managedblockchain delete-accessor --accessor-id ac-NGQ6QNKXLNEBXD3UI6********

Si cette commande s'exécute correctement, aucun message n'est renvoyé.