Claves y credenciales
Un proyecto tiene dos clases de secretos, y los dos se manejan en su Configuración: las credenciales de subida y las claves de servidor. Crearlos y revocarlos es tarea de administradores y propietarios. El DSN, que no es secreto, está explicado en la misma página.
Las dos clases funcionan igual:
- Puedes tener varias: una por cada lugar que la usa (una por cada pipeline, una por cada aplicación o entorno). Así, si una se filtra, revocas solo esa.
- Al crear una le das un nombre, Dónde se usa: "GitHub Actions", "Servidores de la API".
- El secreto se muestra una sola vez, al crearlo. Cópialo antes de elegir Listo, la guardé. Si lo pierdes, revócalo y crea otro.
- La lista muestra cuándo se usó cada una por última vez, o Nunca usada.
- Revocar la deja sin efecto al instante.
- Crear y revocar quedan en el registro de auditoría.
Credenciales de subida
cltu_…. Permiten que tu integración continua suba los mapas de código fuente, para que las pilas de llamadas muestren el código que escribiste. Guárdala como COLLECTOR_UPLOAD_TOKEN en los secretos de tu integración continua, nunca en el código que publicas: con ella cualquiera puede subir mapas a tu proyecto. La clave del DSN no sirve para subir.
Claves de servidor
clts_…. Permiten que tus servidores manden sus registros: líneas de log, solicitudes e inicios de sesión. Dásela a tus servidores como COLLECTOR_SERVER_KEY, junto a COLLECTOR_DSN: definirla es lo que enciende los registros en los SDK, así que actualizar un paquete nunca empieza a mandar registros por su cuenta. La misma clave sirve para OpenTelemetry.
Nunca la pongas en una página web: con ella cualquiera podría mandar registros como si fuera tu aplicación, falsear inicios de sesión o gastar el presupuesto del proyecto. Collector rechaza una clave de servidor enviada desde un navegador.
Desde la terminal
collector upload-tokens create "GitHub Actions" # imprime el secreto una vez
collector upload-tokens list
collector upload-tokens revoke <id>
collector server-keys create "Servidores de la API"
collector server-keys list
collector server-keys revoke <id>