

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
<a name="polygon-tokens"></a>

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](https://docs.aws.amazon.com/managed-blockchain/latest/APIReference/API_CreateAccessor.html) 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 o Polygon JSON- RPCs usando Signature Version 4 (SigV4) e 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](polygon-api.md)

Você pode criar e gerenciar tokens de acesso usando o. Console de gerenciamento da AWS Você também pode criar e gerenciar tokens de acesso usando as seguintes operações de API: `[CreateAccessor](https://docs.aws.amazon.com//managed-blockchain/latest/APIReference/API_CreateAccessor.html)``[ GetAccessor](https://docs.aws.amazon.com//managed-blockchain/latest/APIReference/API_GetAccessor.html)`,`[ListAccessors](https://docs.aws.amazon.com//managed-blockchain/latest/APIReference/API_ListAccessors.html)`, e. `[ DeleteAccessor](https://docs.aws.amazon.com//managed-blockchain/latest/APIReference/API_DeleteAccessor.html)` 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 de acesso também estão disponíveis por meio do Console de gerenciamento da AWS AWS CLI, e. SDKs

## Criação de um token de acesso para acesso baseado em token
<a name="polygon-create-tokens"></a>

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

### Crie um token de acesso para fazer solicitações JSON-RPC do AMB Access Polygon usando o Console de gerenciamento da AWS
<a name="polygon-create-token.con"></a>

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

1. Escolha **Token Accessors.**

1. Escolha **Criar acessador**.

1. **Escolha uma rede de blockchain *Polygon* válida.**

1. Opcionalmente, adicione **tags** para seu acessador.

1. Escolha **Criar acessador** para criar um novo token de acesso.

### Crie um token de acesso para fazer solicitações JSON-RPC do AMB Access Polygon usando o AWS CLI
<a name="polygon-create-token.cli"></a>

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

O comando anterior retorna o `AccessorId` junto com o`BillingToken`, 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
<a name="polygon-view-token"></a>

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 nome de recurso da Amazon (ARN) do acessador. Você também pode visualizar o status, o tipo, a data de criação e `BillingToken` o.

### Para visualizar as informações de um token de acesso usando o Console de gerenciamento da AWS
<a name="polygon-view-token.con"></a>

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

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

1. 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. 

### Para visualizar as informações de um token de acesso usando o AWS CLI
<a name="polygon-view-token.cli"></a>

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
<a name="polygon-delete-token"></a>

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.

### Para excluir um token de acesso usando o Console de gerenciamento da AWS
<a name="polygon-delete-token.con"></a>

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

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

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

1. Escolha **Excluir**.

1. 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.

### Para excluir um token de acesso usando o AWS CLI
<a name="polygon-delete-token.cli"></a>

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.