ReOTP.
Beveiliging en synchronisatie/Webhooks en HMAC
1 min. lezen

Webhooks en HMAC

Ontdek hoe u veilige, realtime meldingen kunt ontvangen wanneer een telefoonnummer is geverifieerd.

Webhooks zijn de snelste en veiligste manier om te weten dat een gebruiker de verificatie succesvol heeft voltooid zonder SSE (Server-Sent Events) (continue statuscontrole) te hoeven gebruiken.

Wanneer de gebruiker het bericht verstuurt en het succesvol is gematcht, stuurt ons systeem een POST-verzoek naar een URL die u vooraf instelt in de projectinstellingen.

Webhook-beveiliging (HMAC-handtekening)

Om te garanderen dat verzoeken echt van onze servers afkomstig zijn en geen nep-aanvallen betreffen, ondertekenen we elk verzoek met behulp van het HMAC-SHA256-algoritme.

1. Ga naar de projectinstellingen en genereer een Webhook Secret.

2. Er wordt een versleutelde handtekening toegevoegd aan de request header onder de naam x-webhook-signature.

3. Op uw server moet u de handtekening berekenen met behulp van hetzelfde secret en deze vergelijken met de verzonden handtekening.

Integratiecode (SDK's)
const express = require('express');
const crypto = require('crypto');
const app = express();

const WEBHOOK_SECRET = 'your_webhook_secret_here';

// Must parse raw body to verify signature correctly
app.use(express.json());

app.post('/webhook/reotp', (req, res) => {
  const signatureHeader = req.headers['x-webhook-signature'];
  const payloadString = JSON.stringify(req.body);

  // Calculate HMAC SHA256
  const expectedSignature = crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(payloadString)
    .digest('hex');

  // Securely compare signatures
  if (signatureHeader !== expectedSignature) {
    return res.status(401).send('Invalid signature');
  }

  // Handle successful verification
  const { event, phoneNumber, requestId } = req.body;
  if (event === 'verification.success') {
    console.log(`User ${phoneNumber} verified! (ID: ${requestId})`);
    // Login user, create session, update DB, etc.
  }

  // Must return 200 OK so we know it was delivered
  res.status(200).send('OK');
});

app.listen(3000, () => console.log('Listening for Webhooks...'));
Volgend artikelAan de slag met ReOTP