Passer au contenu principal
Avec webhook contrôle d’accès, lorsqu’un spectateur tente de lire du contenu restreint, Livepeer Studio appelle votre point de terminaison. Vous renvoyez 2XX pour autoriser, ou non-2XX pour refuser.

1. Créer un webhook de contrôle d’accès

Dans Livepeer Studio → Developers → Webhooks, créez un webhook avec le type playback.accessControl et l’URL de votre point de terminaison (par ex. https://yourdomain.com/api/check-access).

2. Créer du contenu restreint

Lors de la création du flux ou de l’actif, définissez playbackPolicy sur le type de webhook ainsi que votre ID de webhook et le contexte :
await livepeer.stream.create({
  name: "Gated stream",
  playbackPolicy: {
    type: "webhook",
    webhookId: "<webhook_id>",
    webhookContext: { assetId: "...", userId: "..." },
  },
});
Même idée pour livepeer.asset.create avec playbackPolicy.

3. Configurer le lecteur

Passez un clé d’accès (par ex. jeton de session ou identifiant utilisateur) au lecteur. Le lecteur l’envoie à Livepeer, qui le transmet à votre webhook :
<Player.Root src={src} accessKey={getAccessKeyForUser()}>
  <Player.Container><Player.Video /></Player.Container>
</Player.Root>

4. Gérer le webhook

Votre point de terminaison reçoit un POST avec accessKey et context. Validez la clé (par ex. vérifiez l’authentification, l’abonnement). Retournez 2XX pour autoriser la lecture, non-2XX pour refuser. Lecteur personnalisé : Pour WebRTC ou HLS, envoyez la clé d’accès dans le Livepeer-Access-Key en-tête ou comme paramètre de requête accessKey sur l’URL de lecture.
Last modified on March 1, 2026