Cómo conectar webhooks firmados y verificar su firma
Crea un webhook en Metixon, guarda su secreto de firma y verifica cada entrega en tu servidor. Además: pausar, rotar el secreto y eliminar.
Conecta webhooks firmados, paso a paso
Con un webhook, Metixon le avisa a tu servidor cada vez que ocurre un evento, con una firma para que sepas que de verdad viene de Metixon.
1Nuevo webhook: nombre, URL y eventos
En Webhooks, da clic en Nuevo webhook. Ponle un nombre y la URL pública de tu servidor que va a recibir los avisos.
En Eventos escribe cuáles quieres, separados por comas. Si lo dejas vacío, recibes todos. Luego da clic en Crear.
2Guarda el secreto de firma: solo se ve una vez
Al crearlo aparece su secreto de firma. Cópialo a tu servidor ahora mismo: solo se muestra esta vez.
Con ese secreto, tu servidor recalcula la firma de cada entrega y la compara. Si no coincide o tiene más de cinco minutos, la rechaza.
En Endpoints ves el estado y la última entrega. Un código doscientos quiere decir que tu servidor la recibió bien.
3Pausar, Rotar el secreto y Eliminar
Si tu servidor va a estar en mantenimiento, da clic en Pausar, y en Activar cuando vuelva.
Si crees que el secreto se filtró, da clic en Rotar. Se genera uno nuevo y, otra vez, solo lo ves una vez: actualízalo en tu servidor.
Y el webhook que ya no uses, elimínalo. El navegador te pide confirmar.
Nombre, URL y eventos; guarda el secreto, verifica la firma y rótalo cuando haga falta.
Preguntas frecuentes
¿Dónde veo el secreto de firma del webhook?
Aparece una sola vez, justo al crear el webhook o al rotarlo. Cópialo a tu servidor en ese momento; después solo verás sus primeros caracteres.
¿Cómo verifico que una entrega viene de Metixon?
Con el secreto, tu servidor recalcula la firma de cada entrega y la compara con la que llega. Si no coincide o tiene más de cinco minutos, la rechaza.
¿Qué hago si se filtró el secreto?
Da clic en Rotar en la tabla Endpoints. Se genera uno nuevo, que también se muestra una sola vez, y lo actualizas en tu servidor.
