Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Enmascaramiento de datos mediante secretos
<a name="workflows-secrets"></a>

En ocasiones, es posible que necesite utilizar datos confidenciales, como credenciales de autenticación, en sus flujos de trabajo. Debe evitarse el almacenamiento de estos valores en texto sin formato en cualquier parte del repositorio, ya que cualquier persona que tenga acceso al repositorio que contiene el secreto podría verlos. Del mismo modo, estos valores no deberían usarse directamente en ninguna definición de flujo de trabajo, ya que estarán visibles como archivos en el repositorio. Con CodeCatalyst él, puede proteger estos valores añadiendo un secreto a su proyecto y, a continuación, haciendo referencia al secreto en su archivo de definición de flujo de trabajo. Tenga en cuenta que se puede tener un máximo de cinco secretos por acción.

**nota**  
Los secretos solo se pueden usar para reemplazar las contraseñas y la información confidencial del archivo de definición del flujo de trabajo.

**Topics**
+ [Creación de un secreto](workflows-secrets.creating.md)
+ [Edición de un secreto](workflows-secrets.editing.md)
+ [Uso de un secreto](workflows-secrets.using.md)
+ [Eliminación de un secreto](workflows-secrets.deleting.md)

# Creación de un secreto
<a name="workflows-secrets.creating"></a>

Utilice el siguiente procedimiento para crear un secreto. El secreto contiene la información confidencial que quiere ocultar a la vista.

**nota**  
Los secretos son visibles para las acciones y no se ocultan cuando se escriben en un archivo.

**Creación de un secreto**

1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Secretos**.

1. Elija **Crear secreto**.

1. Introduzca la información siguiente:  
**Nombre**  
Escriba un nombre para su secreto.  
**Valor**  
Introduzca el valor para el secreto. Esta es la información confidencial que quiera ocultar de la vista. De forma predeterminada, el valor no se muestra. Para mostrar el valor, seleccione **Mostrar valor**.  
**Descripción**  
(Opcional) Escriba una descripción para el secreto.

1. Seleccione **Crear**.

# Edición de un secreto
<a name="workflows-secrets.editing"></a>

Utilice el siguiente procedimiento para editar un secreto.

**Edición de un secreto**

1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Secretos**.

1. En la lista de secretos, seleccione el secreto que quiera editar.

1. Elija **Edit (Edición de)**.

1. Edite las siguientes propiedades:  
**Valor**  
Introduzca el valor para el secreto. Este es el valor que quiera ocultar de la vista. De forma predeterminada, el valor no se muestra.  
**Descripción**  
(Opcional) Escriba una descripción para el secreto.

1. Seleccione **Save**.

# Uso de un secreto
<a name="workflows-secrets.using"></a>

Para usar un secreto en una acción de flujo de trabajo, debe obtener el identificador de referencia del secreto y usarlo en la acción del flujo de trabajo.

**Topics**
+ [Obtención del identificador de un secreto](#workflows-using-secrets.get-identifier)
+ [Referencia a un secreto en un flujo de trabajo](#workflows-using-secrets.using-identifier)

## Obtención del identificador de un secreto
<a name="workflows-using-secrets.get-identifier"></a>

Utilice el siguiente procedimiento para obtener el identificador de referencia del secreto. Añadirá este identificador a su flujo de trabajo.

**Obtención del identificador de referencia del secreto**

1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Secretos**.

1. En la lista de secretos, busque el secreto que quiera eliminar.

1. En la columna **ID de referencia**, copie el identificador del secreto. Esta es la sintaxis del **ID de referencia**:

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

## Referencia a un secreto en un flujo de trabajo
<a name="workflows-using-secrets.using-identifier"></a>

Utilice el siguiente procedimiento para hacer referencia a un secreto en un flujo de trabajo.

**Referencia a un secreto**

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.

1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.

1. Elija **Edit (Edición de)**.

1. Elija **YAML**.

1. Modifique el YAML para usar el identificador del secreto. Por ejemplo, para utilizar un nombre de usuario y una contraseña que se almacenan como secretos con el comando `curl`, usaría un comando `Run` similar al siguiente:

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

1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.

1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.

# Eliminación de un secreto
<a name="workflows-secrets.deleting"></a>

Utilice el siguiente procedimiento para eliminar un secreto y el identificador de referencia del secreto.

**nota**  
Antes de eliminar un secreto, se recomienda eliminar el identificador de referencia del secreto de todas las acciones del flujo de trabajo. Si elimina el secreto sin eliminar el identificador de referencia, la acción fallará la próxima vez que se ejecute. 

**Eliminación del identificador de referencia de un secreto de un flujo de trabajo**

1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.

1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo.

1. Elija **Edit (Edición de)**.

1. Elija **YAML**.

1. Busque la siguiente cadena en el flujo de trabajo:

   ```
   ${Secrets.
   ```

   Esto busca todos los identificadores de referencia de todos los secretos.

1. Elimine el identificador de referencia del secreto elegido o sustitúyalo por un valor de texto no cifrado.

1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo.

1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**.

**Eliminación de un secreto**

1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Secretos**.

1. En la lista de secretos, elija el secreto que quiera eliminar.

1. Elija **Eliminar**.

1. Escriba **delete** para confirmar la eliminación.

1. Elija **Eliminar**.