Description des limites de périphérique de mise en œuvre

introduction

Le service de gestion des droits de lecture de Brightcove vous permet de définir des limites de périphérique pour la lecture vidéo. L'appareil de chaque utilisateur est enregistré avec un identifiant unique lorsqu'une demande de licence DRM est effectuée. Vous contrôlez le nombre d'appareils par utilisateur.

La limite d'appareils est vérifiée et appliquée à chaque demande de licence. Pour utiliser cette restriction, vous passerez un Jeton Web JSON (JWT) avec l'identifiant actuel de l'utilisateur uid à le Playback API.

Si vous n'êtes pas familier avec cette fonction, consultez le Aperçu: Service de gestion des droits de lecture document.

Enregistrement de l'appareil

Un appareil est enregistré auprès de Brightcove lorsqu'une demande de lecture valide qui inclut un Jeton Web JSON (JWT) avec uid et dlimit les réclamations sont reçues. A partir de ce moment, cet appareil occupera un emplacement.

Mise en œuvre

Pour activer les limites d'appareils, procédez comme suit:

1. Créer un Jeton Web JSON (JWT) avec les revendications généralement requises ainsi que les uid et dlimit réclamations.

   L'appareil de chaque utilisateur est enregistré avec un identifiant unique lorsqu'une demande de licence DRM est effectuée.

   Les dlimit la revendication vous permet de contrôler le nombre d'appareils pouvant être associés à l'utilisateur spécifié uid. La valeur doit être > 0.

   Si la dlimit la valeur de la réclamation est supprimée dans les demandes ultérieures, les appareils précédemment autorisés continueront de fonctionner.

   Exemple
   Si la dlimit la valeur est définie sur 3 , l'utilisateur peut jouer sur les appareils A, B et C (tous seraient autorisés). Essayer de jouer sur l'appareil D serait refusé.
   Si la dlimit la valeur est changée en 1 , l'utilisateur peut toujours jouer sur les 3 appareils A, B et C, à moins que les appareils ne soient révoqués manuellement en gérant les appareils avec l'API Devices. Pour ce faire, consultez le Gérer les appareils section.

2. Gérer les appareils des utilisateurs avec l'API des appareils. Cette API vous permet d'obtenir les appareils d'un utilisateur, de supprimer des appareils et de mettre à jour le nom d'un appareil.

   Lorsqu'un appareil est enregistré, il est identifié par son identifiant et son pseudonyme. L'API des appareils vous permet de modifier le surnom de l'appareil, ce qui facilite la gestion de votre liste d'appareils.

3. Configurez votre lecteur d'utiliser le Jeton Web JSON (JWT) créé à l'étape précédente.

Gérer les appareils

Vous pouvez gérer les appareils utilisateur avec le API des appareils.

API des appareils

Avec l'API Devices, vous pouvez obtenir et supprimer des appareils utilisateur.

URL de base

L'URL de base de l'API est:

https://playback-auth.api.brightcove.com/v1

Chemin du compte

Dans tous les cas, des demandes seront faites pour un compte Video Cloud spécifique. Ainsi, vous ajouterez toujours le terme comptes suivi de votre identifiant de compte à l'URL de base:

https://playback-auth.api.brightcove.com/v1/accounts/{accountID}

Autorisation

Un jeton d'accès pour les demandes est requis et doit être présent dans l'en-tête Authorization:

Authorization: Bearer {access_token}

Le jeton d'accès est un jeton d'accès OAuth2 temporaire qui doit être obtenu auprès du service Brightcove OAuth. Pour plus de détails sur la façon d'obtenir les informations d'identification client et de les utiliser pour récupérer des jetons d'accès, consultez le Présentation de Brightcove OAuth.

Autorisations

Les demandes à l'API Devices doivent être effectuées à partir de informations d'identification du client avec les autorisations suivantes :

• video-cloud/playback-auth/devices/read
• video-cloud/playback-auth/devices/write

Méthodes API

L'API Devices prend en charge les requêtes suivantes. Pour plus de détails, consultez le Référence de l'API des appareils.

Obtenir tous les appareils utilisateur

GET /v1/accounts/{accountID}/users/{userID}/devices

Corps de réponse

Le corps de la réponse contient un tableau de périphériques et devrait ressembler à ceci:

[
    {
        "id": "12e12345-11e1-1bd1-d123-1234567890",
        "created_at": 1612646018,
        "updated_at": 1612646018,
        "name": "my device1",
        "user_agent": "PlayReadyClient"
    },
    {
        "id": "WVCf123456789abcdefghijkl1234567890abcdefg",
        "created_at": 1612385697,
        "updated_at": 1612385697,
        "name": "my device2",
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:85.0) Gecko/20100101 Firefox/85.0"
    }
]

Mettre à jour le nom de l'appareil

Les PATCH demande vous permet de définir un nom descriptif pour l'appareil.

PATCH  /v1/accounts/{accountID}/users/{userID}/devices/{deviceID}
  Content-Type: application/json
  Body: {devices object}

Corps de la demande

Le corps de la requête contient le nom de l'appareil.

{
    "name": "my device1"
}

Voici les détails du champ :

Supprimer tous les appareils utilisateur

DELETE /v1/accounts/{accountID}/users/{userID}/devices

Supprimer un appareil utilisateur spécifique

DELETE /v1/accounts/{accountID}/users/{userID}/devices/{deviceID}