Creación y administración de tokens de acceso para el acceso basado en tokens para realizar solicitudes de AMB Access Polygon

También puede utilizar los tokens de acceso para realizar llamadas JSON-RPC a los puntos finales de la red Polygon como una práctica alternativa al proceso de firma de la versión 4 (SiGv4) de Signature. Debe proporcionar uno BILLING_TOKEN de los tokens de acceso que cree y añada como parámetro a sus llamadas.

importante

• Si priorizas la seguridad y la auditabilidad por encima de la comodidad, utiliza el proceso de firma SigV4 en su lugar.

• Puede acceder a los JSON-RPC de Polygon mediante la versión 4 de Signature (SiGv4) y el acceso basado en tokens. Sin embargo, si decide utilizar ambos protocolos, se rechazará su solicitud.

• Nunca debe incrustar los tokens de acceso en aplicaciones orientadas a los usuarios.

En la consola, la página Tokens Accessors muestra una lista de todos los tokens de acceso que puede utilizar para realizar llamadas JSON-RPC de AMB Access Polygon desde el código de un cliente. Cuenta de AWS

Para obtener más información sobre las solicitudes JSON-RPC de AMB Access Polygon, consulte. La API de cadena de bloques gestionada y los JSON-RPC son compatibles con AMB Access Polygon

Puede crear y administrar los tokens de acceso mediante. AWS Management Console También puede crear y administrar los tokens de acceso mediante las siguientes operaciones de API:CreateAccessor, GetAccessorListAccessors, y. DeleteAccessor A BILLING_TOKEN es propiedad del descriptor de acceso. Esta BILLING_TOKEN propiedad se utiliza para rastrear su descriptor de acceso y para facturar las solicitudes JSON-RPC de AMB Access Polygon realizadas por usted. Cuenta de AWS

Todas las acciones de la API relacionadas con la creación y administración de los tokens de acceso también están disponibles a través de los SDK, y. AWS Management Console AWS CLI

Crear un token de acceso para el acceso basado en un token

Puede crear un token de acceso y usarlo para realizar llamadas a la API de AMB Access Polygon en cualquier nodo de AMB Access Polygon de su entorno. Cuenta de AWS

Cree un token de acceso para realizar solicitudes JSON-RPC de AMB Access Polygon mediante el AWS Management Console

1. Abre la consola de Managed Blockchain en https://console.aws.amazon.com/managedblockchain/.

2. Elija Token Accessors.

3. Elija Crear descriptor de acceso.

4. Elija una red de cadena de bloques Polygon válida.

5. Opcional, añada etiquetas para su descriptor de acceso.

6. Seleccione Crear descriptor de acceso para crear un nuevo token de acceso.

Cree un token de acceso para realizar solicitudes JSON-RPC de AMB Access Polygon mediante el AWS CLI

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

El comando anterior devuelve el valor AccessorId junto con elBillingToken, como se muestra en el siguiente ejemplo.

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

El elemento clave de su respuesta es elBillingToken. Puede usar esta propiedad para realizar llamadas JSON-RPC a AMB Access Polygon. Algunos valores del ejemplo se han ocultado por motivos de seguridad, pero aparecerán completamente en las respuestas reales.

nota

Una vez ejecutada la operación, Managed Blockchain aprovisiona y configura el token por ti. La duración de este proceso depende de muchas variables.

Visualización de los detalles de un token de acceso

Puede ver las propiedades de cada token de acceso que posea Cuenta de AWS . Por ejemplo, puede ver el ID de acceso o el nombre de recurso de Amazon (ARN) del descriptor de acceso. También puede ver el estado, el tipo, la fecha de creación y el. BillingToken

Para ver la información de un token de acceso mediante el AWS Management Console

1. Abre la consola de Managed Blockchain en https://console.aws.amazon.com/managedblockchain/.

2. En el panel de navegación, elija Token Accessors.

3. Elija el ID de acceso del token de la lista.

Aparece la página de detalles del token. Desde esta página, puede ver las propiedades del token.

Para ver la información de un token de acceso mediante el AWS CLI

Ejecute el siguiente comando para ver los detalles de un token de acceso. Sustituya los valores --accessor-id de por su ID de acceso.

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

Esta BillingToken y otras propiedades clave se devuelven como se muestra en el siguiente ejemplo. Algunos valores del ejemplo se han ocultado por motivos de seguridad, pero aparecen completamente en las respuestas reales.

{
  "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********"
  }
}

Eliminar un token de acceso

Al eliminar un token de acceso, el token cambia de estado AVAILABLE a estado. PENDING_DELETION No puedes usar un token de acceso con ese estado. PENDING_DELETION

Para eliminar un token de acceso mediante el AWS Management Console

1. Abre la consola de Managed Blockchain en https://console.aws.amazon.com/managedblockchain/.

2. En el panel de navegación, elija Token Accessors.

3. Seleccione el token de acceso que desee de la lista.

4. Elija Eliminar.

5. Confirme su elección.

Volverás a la página de identificadores de acceso con el identificador de acceso eliminado. La página muestra el PENDING_DELETION estado.

Para eliminar un token de acceso mediante el AWS CLI

En el siguiente ejemplo, se muestra cómo eliminar un token. Utilice el delete-accessor comando para eliminar un token. Defina el valor de --accessor-id con su ID de acceso.

Eliminar un token de acceso mediante la CLI AWS

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

Si este comando se ejecuta correctamente, no se devuelve ningún mensaje.