Claves Webhook
Las claves Webhook ayudan a su herramienta de recepción a confiar en que una entrega webhook proviene de Atomicat. Las claves son secretos de larga duración, así que guárdelas en un administrador de contraseñas o en una bóveda secreta, no en capturas de pantalla o registros de chat.
Abre el modal
- Vaya a Entrega del formulario webhook o Entrega Quiz webhook.
- Haga clic en API administración de claves en el encabezado.
El área clave sigue el tipo de webhook que está administrando. Los formularios webhooks y quiz webhooks pueden utilizar claves independientes.
Lea la guía
El producto explica que su herramienta de recepción debe usar la clave para validar las entregas webhook. Una nota secundaria le recuerda que debe mantener la clave en privado y rotarla si se sospecha que ha estado expuesta.
Generar o rotar
- Si aún no existe ninguna clave, el botón principal dice Generar clave API.
- Después de que existe una clave, el mismo botón se convierte en Regenerar clave API, lo que invalida el secreto anterior cuando el servidor acepta la rotación.
- Un estado de carga muestra Generando mientras se crea la clave.
Copia la clave
Cuando una clave está presente, aparece en un campo de solo lectura con una acción Copiar. Después de copiar, el botón muestra brevemente un estado de verificación para que sepa que la escritura en el portapapeles se realizó correctamente.
Prácticas operativas
| Práctica | Por qué es importante |
|---|---|
| Rotar según lo programado | Limita el radio de explosión si se pierde una llave. |
| Diferentes claves por entorno | Los destinos de producción y pruebas no deberían compartir secretos. |
| Verificar antes de procesar | Rechace solicitudes que no incluyan la clave esperada. |
Si su configuración es personalizada, pregunte a su equipo técnico qué encabezado o regla de validación espera su herramienta de recepción.
Documentación relacionada
- Entrega del formulario webhook
- Entrega de webhooks de quiz
- Webhooks de quiz (configuración)
- Formulario
Preguntas frecuentes
¿Se romperán las entregas antiguas inmediatamente después de la regeneración?
Cualquier reintento durante el vuelo puede seguir usando el secreto antiguo hasta que finalice. Planifique rotaciones durante ventanas de bajo tráfico y actualice su servidor antes o en sincronización con la acción de la interfaz de usuario.
¿La clave webhook es lo mismo que mi inicio de sesión de usuario?
No. Su inicio de sesión lo identifica como una persona que utiliza Atomicat. Las claves Webhook ayudan a los sistemas externos a verificar las entregas automatizadas de webhook.