Activer l’autorisation de lecture sur les canaux IVS - Amazon IVS
Instructions de la consoleInstructions de la CLIDemandes d’API (créer et mettre à jour)

Activer l’autorisation de lecture sur les canaux IVS

L’exigence d’autorisation d’un canal peut être configurée lorsque le canal est créé ou ultérieurement (à l’aide d’une opération de mise à jour). Notez que les étapes sont les mêmes que vous souhaitiez activer ou désactiver l'autorisation de lecture.

Notez que les politiques de restriction de lecture (les restrictions géographiques, par exemple) ne peuvent pas être utilisées simultanément avec l’autorisation de lecture. Si l’autorisation de lecture est activée pour une chaîne, toutes les politiques de restriction de lecture configurées seront ignorées. Pour appliquer des restrictions géographiques sur une chaîne privée, validez l’emplacement de l’utilisateur dans votre logique de génération de jetons avant d’émettre un jeton de lecture.

Instructions de la console

Pour activer l'autorisation lors de la création d'un canal :

  1. Ouvrez la console Amazon IVS. Sélectionnez la région de votre canal si ce n'est pas déjà fait.

  2. Dans Get started (Mise en route) (en haut à droite), sélectionnez Create channel (Créer un canal).

  3. Sur la page Channel create (Créer un canal), sélectionnez Custom configuration (Configuration personnalisée).

  4. Dans la section Playback authentication (Authentification de lecture), activez l'option Enable token-authentication requirement for video playback (Activer l'exigence d'authentification par jeton pour la lecture vidéo).

  5. Suivez le reste des instructions pour créer un canal. (Voir Mise en route avec le streaming à faible latence IVS.)

Pour activer l'autorisation en mettant à jour un canal existant :

  1. Ouvrez la console Amazon IVS. Sélectionnez la région de votre canal si ce n'est pas déjà fait.

  2. Dans le menu de navigation de gauche, sélectionnez Channels (Canaux).

  3. Cochez la case du canal à mettre à jour, puis sélectionnez Edit (Modifier).

  4. Dans la section Playback authentication (Authentification de lecture), activez l'option Enable token-authentication requirement for video playback (Activer l'exigence d'authentification par jeton pour la lecture vidéo).

  5. Cliquez sur Save changes (Enregistrer les modifications).

Instructions de la CLI

Pour activer l’autorisation lors de la création d’un canal :

aws ivs create-channel --authorized --region <aws-region>

Vous pouvez omettre --region <aws-region> si la région se trouve dans votre fichier de configuration AWS local.

Voici un exemple de réponse. Notez que authorized est true.

{
    "streamKey": {
        "channelArn": "arn:aws:ivs:us-west-2:123456789:channel/fbc789c1-2c56-4ce6-a30a-d99275dc4481",
        "value": "sk_us-west-2_abcd1234efgh5678ijkl",
        "arn": "arn:aws:ivs:us-west-2:123456789:stream-key/62f15f1b-fe31-4127-b252-0666ac7f55a7",
        "tags": {}
    },
    "channel": {
        "name": "test-channel",
        "tags": {},
        "authorized": true,
        "latencyMode": "LOW",
        "ingestEndpoint": "jds34ksdg3las.global-contribute.live-video.net",
        "playbackUrl": "https://b37c565f6d79.us-west-2.playback.live-video.net/api/video/v1/aws.ivs.us-west-2.123456789.channel.oU4OKS4LA1Dz.m3u8",
        "arn": "arn:aws:ivs:us-west-2:123456789:channel/fbc789c1-2c56-4ce6-a30a-d99275dc4481"
    }
}

Pour activer l’autorisation en mettant à jour un canal existant :

aws ivs update-channel --arn
arn:aws:ivs:us-west-2:693991300569:channel/742da049-fe9f-4f23-928e-c6753760a189 
--authorized

Ceci est juste un exemple ; vous devez spécifier votre propre ARN de canal après --arn. Comme lors de la création d’un canal, authorized est true dans la réponse de mise à jour.

Demandes d’API (créer et mettre à jour)

Pour plus d’informations sur l’utilisation, consultez CreateChannel et UpdateChannel dans la Référence de l’API de diffusion à faible latence IVS. 

POST /CreateChannel HTTP/1.1
{
  "name": "<your channel name>",
  "authorized": true
}
POST /UpdateChannel HTTP/1.1
{
  "arn": "<channel arn>",
  "authorized": true
}