

A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

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

# Conceder aos usuários acesso ao repositório com tokens de acesso pessoal
<a name="ipa-tokens-keys"></a>

Para acessar alguns CodeCatalyst recursos, como repositórios de origem, em um computador local com um cliente Git ou ambiente de desenvolvimento integrado (IDE), você deve inserir uma senha específica do aplicativo. Você pode criar um token de acesso pessoal (PAT) para usar com essa finalidade. PATs você cria estão associados à sua identidade de usuário em todos os espaços e projetos em CodeCatalyst. Você pode criar mais de um PAT para sua CodeCatalyst identidade. 

Você pode ver os nomes e as datas de expiração dos que PATs você criou e pode excluir aqueles que não são mais necessários. Você só pode copiar o segredo do PAT no momento em que é criado.

**nota**  
Por padrão, PATs expira em 1 ano.

## Criando PATs
<a name="ipa-tokens-keys-create"></a>

PATs estão associados à sua identidade de usuário em CodeCatalyst. Você só pode copiar um segredo do PAT no momento em que é criado.

### Criando PATs (console)
<a name="ipa-tokens-keys-create-console"></a>

Você pode usar o console para criar PATs em CodeCatalyst.

**Para criar um token de acesso pessoal (console)**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Na barra de menu superior, escolha seu selo de perfil e escolha **Minhas configurações**. A página CodeCatalyst **Minhas configurações** é aberta.
**dica**  
Você também pode encontrar seu perfil de usuário acessando a página de membros de um projeto ou espaço e escolhendo seu nome na lista de membros.

1. Em **Tokens de acesso pessoal**, escolha **Criar**.

   A página **Criar PAT** é exibida.

1. Em **Nome do PAT**, insira um nome descritivo para o seu PAT.

1. Em **Data de expiração**, mantenha a data padrão ou escolha o ícone do calendário para selecionar uma data personalizada. A data de vencimento é padronizada para 1 ano a contar da data atual.

1. Escolha **Criar**.
**dica**  
Você também pode criar esse token ao escolher **Clonar repositório** para um repositório de origem.

1. Para copiar o segredo do PAT, selecione **Copiar**. Armazene o segredo do PAT onde você poderá recuperá-lo.
**Importante**  
O segredo do PAT só é exibido uma vez. Não é possível recuperá-lo depois de fechar a janela. Se você não salvou o segredo do PAT em um local seguro, é possível criar outro.

.

### Criando PATs (CLI)
<a name="ipa-tokens-keys-create-cli"></a>

Você pode usar a CLI para criar PATs em. CodeCatalyst

**Para criar um token de acesso pessoal (AWS CLI)**

1. No terminal ou na linha de comando, execute o comando **create-access-token** da seguinte maneira.

   ```
   aws codecatalyst create-access-token
   ```

   Se houver êxito, o comando retornará informações sobre o PAT criado como o exemplo a seguir.

   ```
   {
       "secret": "value",
       "name": "marymajor-22222EXAMPLE",
       "expiresTime": "2024-02-04T01:56:04.402000+00:00"
   }
   ```

1. 

Você só pode ver o segredo do PAT uma vez — ao criar o PAT. Se você um segredo do PAT ou está preocupado com o fato de ele não estar armazenado com segurança, você pode criar outro.

Você pode ver o PATs associado à sua conta de usuário usando AWS CLI o. Você só pode visualizar informações sobre o PAT, e não o valor do segredo do PAT em si. 

**nota**  
Verifique se você está usando uma versão recente do AWS CLI para trabalhar CodeCatalyst. As versões anteriores podem não conter os CodeCatalyst comandos. Você deve configurar seu AWS CLI perfil antes de poder usá-lo com CodeCatalyst. Para obter mais informações, consulte [Configurando para usar o AWS CLI com CodeCatalyst](set-up-cli.md).

## Visualizando PATs
<a name="ipa-tokens-keys-view"></a>

Você pode ver PATs em CodeCatalyst. A lista mostra tudo o PATs que você associou à sua identidade de usuário. Seu PAT está associado ao seu perfil de usuário em todos os espaços e projetos em CodeCatalyst. Os expirados PATs não são exibidos porque são excluídos após expirarem.

### Visualização PATs (console)
<a name="ipa-tokens-keys-view-console"></a>

Você pode usar o console para ver os PATs associados à sua identidade de usuário em CodeCatalyst.

**Para ver seus tokens de acesso pessoais (console)**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Na barra de menu superior, escolha seu selo de perfil e escolha **Minhas configurações**. A página CodeCatalyst **Minhas configurações** é aberta.
**dica**  
Você também pode encontrar seu perfil de usuário acessando a página de membros de um projeto ou espaço e escolhendo seu nome na lista de membros.

1. Em **Tokens de acesso pessoal**, veja os nomes e as datas de expiração dos seus atuais PATs.

### Visualização PATs (CLI)
<a name="ipa-tokens-keys-view-cli"></a>

Você pode usar a CLI para visualizar os PATs associados à sua identidade de usuário em. CodeCatalyst<a name="ipa-view-pat-cli"></a>

**Para ver seus tokens de acesso pessoais (AWS CLI)**
+ No terminal ou na linha de comando, execute o comando **list-access-tokens** da seguinte maneira.

  ```
  aws codecatalyst list-access-tokens
  ```

  Se for bem-sucedido, o comando retornará informações sobre o PATs associado à sua conta de usuário, como no exemplo a seguir.

  ```
  {
      "items": [
          {
              "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa",
              "name": "marymajor-22222EXAMPLE",
              "expiresTime": "2024-02-04T01:56:04.402000+00:00"
          },
          {
              "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb",
              "name": "marymajor-11111EXAMPLE",
              "expiresTime": "2023-03-12T01:58:40.694000+00:00"
          }
      ]
  }
  ```

## Excluindo PATs
<a name="ipa-tokens-keys-delete"></a>

Você pode excluir o PATs associado à sua identidade de usuário em CodeCatalyst.

### Excluindo PATs (console)
<a name="ipa-tokens-keys-delete-console"></a>

Você pode usar o console para excluir PATs CodeCatalyst.

**Para excluir um token de acesso pessoal (console)**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Na barra de menu superior, escolha seu selo de perfil e escolha **Minhas configurações**. A página CodeCatalyst **Minhas configurações** é aberta.
**dica**  
Você também pode encontrar seu perfil de usuário acessando a página de membros de um projeto ou espaço e escolhendo seu nome na lista de membros.

1. Em **Tokens de acesso pessoal**, escolha o seletor ao lado do PAT que você deseja excluir e, depois, selecione **Excluir**.

   Na página **Excluir PAT: <name>?**, para confirmar a exclusão, digite *delete* no campo de texto. Escolha **Excluir**.

### Excluindo PATs (CLI)
<a name="ipa-tokens-keys-delete-cli"></a>

Você pode excluir um PAT associado à sua identidade de usuário usando a AWS CLI. Para fazer isso, você deve fornecer o ID do PAT, que pode ser visualizado usando o comando **delete-access-token**.

**nota**  
Verifique se você está usando uma versão recente do AWS CLI para trabalhar CodeCatalyst. As versões anteriores podem não conter os CodeCatalyst comandos. Para obter mais informações sobre como usar o AWS CLI com CodeCatalyst, consulte[Configurando para usar o AWS CLI com CodeCatalyst](set-up-cli.md).

**Como excluir um token de acesso pessoal (AWS CLI)**
+ No terminal ou na linha de comando, execute o comando **delete-access-token**, fornecendo o ID do PAT que você deseja excluir. Por exemplo, execute o comando a seguir para excluir um PAT com uma ID de*123EXAMPLE*.

  ```
  aws codecatalyst delete-access-token --id a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb
  ```

  Se houver êxito, o comando não retornará resposta nenhuma.