Secrets

Los Secrets son credenciales y valores sensibles que las tareas y agentes pueden usar de forma segura.

¿Qué son los secrets?

Los secrets almacenan:

• Claves API
• Tokens de acceso
• Contraseñas de bases de datos
• Credenciales de servicios externos
• Variables de entorno sensibles

Seguridad

Importante

Los secrets se almacenan encriptados y nunca se muestran en logs ni interfaces.

Característica	Descripción
Encriptación	AES-256 en reposo
Acceso	Solo tareas autorizadas
Logs	Valores enmascarados
Auditoría	Registro de uso

Vista de secrets

┌─────────────────────────────────────────────────────────────────┐
│ Secrets - Proyecto: E-commerce                    [+ Nuevo]     │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ Nombre              │ Tipo     │ Usado por  │ Actualizado       │
├─────────────────────┼──────────┼────────────┼───────────────────┤
│ 🔑 DATABASE_URL     │ String   │ 5 tareas   │ Hace 1 semana     │
│ 🔑 API_KEY_STRIPE   │ String   │ 2 tareas   │ Hace 2 días       │
│ 🔑 AWS_CREDENTIALS  │ JSON     │ 3 tareas   │ Hace 1 mes        │
│ 🔑 SMTP_PASSWORD    │ String   │ 1 tarea    │ Hace 3 días       │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Crear secret

1. Acceder

1. Abre el proyecto
2. Ve a la pestaña Secrets
3. Haz clic en + Nuevo secret

2. Configurar

┌─────────────────────────────────────────────────────────────────┐
│ Nuevo Secret                                                    │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ Nombre *                                                        │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ API_KEY_OPENAI                                              │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ ℹ️ Usa MAYÚSCULAS_CON_GUIONES                                   │
│                                                                 │
│ Valor *                                                         │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ ••••••••••••••••••••••••••••••••                            │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ [👁️ Mostrar]                                                    │
│                                                                 │
│ Descripción                                                     │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ Clave API para servicios de OpenAI                          │ │
│ └─────────────────────────────────────────────────────────────┘ │
│                                                                 │
│                                        [Cancelar] [Guardar]     │
└─────────────────────────────────────────────────────────────────┘

Campo	Descripción
Nombre	Identificador único (MAYÚSCULAS recomendado)
Valor	El valor secreto a almacenar
Descripción	Para qué se usa este secret

3. Guardar

Haz clic en Guardar. El valor se encripta inmediatamente.

Usar secrets en tareas

Los secrets se referencian con la sintaxis ${SECRET_NAME}:

# En configuración de tarea
database_url: ${DATABASE_URL}
api_key: ${API_KEY_STRIPE}

En prompts de agentes:

Usa la API key ${OPENAI_API_KEY} para conectar al servicio.

Tipos de secrets

Tipo	Uso
String	Valores simples (API keys, tokens)
JSON	Credenciales estructuradas
Certificado	Archivos PEM, certificados
Archivo	Archivos de configuración

Editar secret

1. Haz clic en el secret
2. Puedes modificar:
3. Valor (se requiere confirmación)
4. Descripción
5. Guarda los cambios

Nota

Al editar el valor, no se muestra el valor anterior por seguridad.

Eliminar secret

Precaución

Verifica que ninguna tarea use el secret antes de eliminarlo.

1. Haz clic en el secret
2. Selecciona Eliminar
3. Confirma la acción

Rotación de secrets

Para rotar un secret:

1. Actualiza el valor en el servicio externo
2. Edita el secret en Nexus con el nuevo valor
3. Las tareas usarán el nuevo valor automáticamente

Scope de secrets

Los secrets tienen alcance a nivel de proyecto:

graph TD
    A[Organización] --> B[Proyecto A]
    A --> C[Proyecto B]
    B --> D[Secrets Proyecto A]
    C --> E[Secrets Proyecto B]
    D -.->|No accesible| C
    E -.->|No accesible| B

Auditoría

Consulta quién accedió a los secrets:

1. En el secret, ve a Historial
2. Verás:
3. Fecha de creación
4. Modificaciones
5. Tareas que lo usaron

---

Siguiente: Git - Integración con repositorios.