Saltar al contenido principal
Administrador

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>