Criação e gerenciamento de tokens de acesso para acesso baseado em tokens para fazer solicitações do AMB Access Polygon - Polígono de acesso AMB

O Amazon Managed Blockchain (AMB) Access Polygon está em versão prévia e está sujeito a alterações.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criação e gerenciamento de tokens de acesso para acesso baseado em tokens para fazer solicitações do AMB Access Polygon

Você também pode usar tokens Accessor para fazer chamadas JSON-RPC para os endpoints da rede Polygon como uma alternativa conveniente ao processo de assinatura Signature Version 4 (SigV4). Você deve fornecer BILLING_TOKEN a de um dos tokens do Accessor que você cria e adiciona como parâmetro às suas chamadas.

Importante
  • Se você priorizar a segurança e a auditabilidade em vez da conveniência, use o processo de assinatura SigV4 em vez disso.

  • Você pode acessar os Polygon JSON-RPCs usando o Signature Version 4 (SigV4) e o acesso baseado em token. No entanto, se você optar por usar os dois protocolos, sua solicitação será rejeitada.

  • Você nunca deve incorporar tokens de acesso em aplicativos voltados para o usuário.

No console, a página Token Accessors exibe uma lista de todos os tokens de acesso que você pode usar para fazer chamadas JSON-RPC do AMB Access Polygon a partir do seu código de origem em um cliente. Conta da AWS

Para obter mais informações sobre solicitações AMB Access Polygon JSON-RPC, consulte. API de blockchain gerenciada e JSON-RPCs compatíveis com o AMB Access Polygon

Você pode criar e gerenciar tokens de acesso usando o. AWS Management Console Você também pode criar e gerenciar tokens de acesso usando as seguintes operações de API: CreateAccessor GetAccessor,ListAccessors, e. DeleteAccessor A BILLING_TOKEN é uma propriedade do Acessador. Essa BILLING_TOKEN propriedade é usada para rastrear seu Acessador e para cobrar solicitações JSON-RPC do AMB Access Polygon feitas a partir do seu. Conta da AWS

Todas as ações de API relacionadas à criação e gerenciamento de tokens do Accessor também estão disponíveis por meio dos SDKs AWS Management Console AWS CLI,, e.

Criação de um token de acesso para acesso baseado em token

Você pode criar um token de acesso e usá-lo para fazer chamadas à API AMB Access Polygon em qualquer nó do AMB Access Polygon em seu. Conta da AWS

  1. Abra o console do Managed Blockchain em https://console.aws.amazon.com/managedblockchain/.

  2. Escolha Token Accessors.

  3. Escolha Criar acessador.

  4. Escolha uma rede de blockchain Polygon válida.

  5. Opcionalmente, adicione tags para seu acessador.

  6. Escolha Criar acessador para criar um novo token de acesso.

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

O comando anterior retorna o AccessorId junto com oBillingToken, conforme mostrado no exemplo a seguir.

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

O elemento-chave em sua resposta é BillingToken o. Você pode usar essa propriedade para fazer chamadas AMB Access Polygon JSON-RPC. Alguns valores no exemplo foram ofuscados por motivos de segurança, mas aparecerão totalmente nas respostas reais.

nota

Depois que a operação é executada, o Managed Blockchain provisiona e configura o token para você. A duração desse processo depende de muitas variáveis.

Visualizando os detalhes de um token de acesso

Você pode ver as propriedades de cada token de acesso que você Conta da AWS possui. Por exemplo, você pode visualizar o ID do acessador ou o Amazon Resource Name (ARN) do acessador. Você também pode visualizar o status, o tipo, a data de criação e BillingToken o.

  1. Abra o console do Managed Blockchain em https://console.aws.amazon.com/managedblockchain/.

  2. No painel de navegação, escolha Token Accessors.

  3. Escolha o ID do acessador do token na lista.

A página de detalhes do token é exibida. Nessa página, você pode ver as propriedades do token.

Execute o comando a seguir para ver os detalhes de um token de acesso. Substitua os valores --accessor-id de pelo seu ID de acesso.

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

As BillingToken e outras propriedades da chave são retornadas conforme mostrado no exemplo a seguir. Alguns valores no exemplo foram ofuscados por motivos de segurança, mas aparecem totalmente nas respostas reais.

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

Excluindo um token de acesso

Quando você exclui um token de acesso, o token muda do PENDING_DELETION status AVAILABLE para o. Você não pode usar um token de acesso com o PENDING_DELETION status.

  1. Abra o console do Managed Blockchain em https://console.aws.amazon.com/managedblockchain/.

  2. No painel de navegação, escolha Token Accessors.

  3. Selecione o token de acesso que você deseja na lista.

  4. Escolha Excluir.

  5. Confirme sua escolha.

Você retornará à página de acessadores de Tokens com seu token de acessador excluído. A página exibe o PENDING_DELETION status.

O exemplo a seguir mostra como excluir um token. Use o delete-accessor comando para excluir um token. Defina o valor de --accessor-id com sua ID de acesso.

Excluindo um token de acesso usando a CLI AWS

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

Se esse comando for executado com êxito, nenhuma mensagem será retornada.