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

# Mascarar dados usando segredos
<a name="workflows-secrets"></a>

Pode haver momentos em que você precise usar dados confidenciais, como credenciais de autenticação, em seus fluxos de trabalho. Armazenar esses valores em texto simples em qualquer lugar do seu repositório deve ser evitado, pois qualquer pessoa com acesso ao repositório que contém o segredo pode vê-los. Da mesma forma, esses valores não devem ser usados diretamente em nenhuma definição de fluxo de trabalho porque estarão visíveis como arquivos no seu repositório. Com CodeCatalyst, você pode proteger esses valores adicionando um segredo ao seu projeto e, em seguida, referenciando o segredo no seu arquivo de definição de fluxo de trabalho. Observe que você pode ter, no máximo, cinco segredos por ação.

**nota**  
Os segredos só podem ser usados para substituir senhas e informações confidenciais no arquivo de definição do fluxo de trabalho.

**Topics**
+ [Criar um segredo](workflows-secrets.creating.md)
+ [Editar um segredo](workflows-secrets.editing.md)
+ [Usar um segredo](workflows-secrets.using.md)
+ [Excluir um segredo](workflows-secrets.deleting.md)

# Criar um segredo
<a name="workflows-secrets.creating"></a>

Use o procedimento a seguir para criar um segredo. O segredo contém as informações confidenciais que você deseja ocultar da visualização.

**nota**  
Os segredos são visíveis para ações e não são mascarados quando gravados em um arquivo.

**Como criar um segredo**

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

1. No painel de navegação, escolha **CI/CD** e **Segredos**.

1. Escolha **Criar segredo**.

1. Insira as seguintes informações:  
**Nome**  
Insira um nome para o segredo.  
**Valor**  
Insira o valor do segredo. Essas são as informações confidenciais que você deseja ocultar da visualização. Por padrão, o valor não é exibido. Para exibir o valor, selecione **Mostrar valor**.  
**Descrição**  
(Opcional) Insira uma descrição para o seu segredo.

1. Escolha **Criar**.

# Editar um segredo
<a name="workflows-secrets.editing"></a>

Utilize o seguinte procedimento para editar um segredo.

**Como editar um segredo**

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

1. No painel de navegação, escolha **CI/CD** e **Segredos**.

1. Na lista de segredos, selecione o segredo que você quer editar.

1. Escolha **Editar**.

1. Edite as seguintes propriedades:  
**Valor**  
Insira o valor do segredo. Esse é o valor que você deseja ocultar da visualização. Por padrão, o valor não é exibido.  
**Descrição**  
(Opcional) Insira uma descrição para o seu segredo.

1. Escolha **Salvar**.

# Usar um segredo
<a name="workflows-secrets.using"></a>

Para usar um segredo em uma ação de fluxo de trabalho, obtenha o identificador de referência do segredo e use-o na ação do fluxo de trabalho.

**Topics**
+ [Receber o identificador de um segredo](#workflows-using-secrets.get-identifier)
+ [Fazer referência a um segredo em um fluxo de trabalho](#workflows-using-secrets.using-identifier)

## Receber o identificador de um segredo
<a name="workflows-using-secrets.get-identifier"></a>

Use o procedimento a seguir para obter o identificador de referência do segredo. Esse identificador será adicionado ao seu fluxo de trabalho.

**Como receber o identificador de referência do segredo**

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

1. No painel de navegação, escolha **CI/CD** e **Segredos**.

1. Na lista de segredos, selecione o segredo que você deseja usar.

1. Na coluna **ID de referência**, copie o identificador do segredo. Veja a seguir a sintaxe do **ID de referência**:

   ```
   ${Secrets.<name>}
   ```

## Fazer referência a um segredo em um fluxo de trabalho
<a name="workflows-using-secrets.using-identifier"></a>

Use o procedimento a seguir para fazer referência a um segredo em um fluxo de trabalho.

**Como fazer referência a um segredo**

1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.

1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.

1. Escolha **Editar**.

1. Selecione **YAML**.

1. Modifique o YAML para usar o identificador do segredo. Por exemplo, para usar um nome de usuário e uma senha armazenados como segredos com o comando `curl`, use um comando `Run` semelhante ao seguinte:

   ```
   - Run: curl -u <username-secret-identifier>:<password-secret-identifier> https://example.com
   ```

1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar.

1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente.

# Excluir um segredo
<a name="workflows-secrets.deleting"></a>

Use o procedimento a seguir para excluir um segredo e o identificador de referência do segredo.

**nota**  
Antes de excluir um segredo, recomendamos que você remova o identificador de referência do segredo de todas as ações do fluxo de trabalho. Se você excluir o segredo sem excluir o identificador de referência, a ação falhará na próxima vez em que for executada. 

**Como excluir o identificador de referência de um segredo de um fluxo de trabalho**

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

1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.

1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.

1. Escolha **Editar**.

1. Selecione **YAML**.

1. Pesquise no fluxo de trabalho a seguinte string:

   ```
   ${Secrets.
   ```

   Todos os identificadores de referência de todos os segredos serão encontrados.

1. Exclua o identificador de referência do segredo selecionado ou substitua-o por um valor de texto simples.

1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar.

1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente.

**Para excluir um segredo**

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

1. No painel de navegação, escolha **CI/CD** e **Segredos**.

1. Na lista de segredos, selecione o segredo que você quer excluir.

1. Escolha **Excluir**.

1. Insira **delete** para confirmar a exclusão.

1. Escolha **Excluir**.