# Activer l’autorisation de lecture sur les canaux IVS
<a name="private-channels-enable-playback-auth"></a>

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
<a name="private-channels-auth-console"></a>

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

1. Ouvrez la [console Amazon IVS](https://console.aws.amazon.com/ivs). Sélectionnez la région de votre canal si ce n'est pas déjà fait.

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

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

1. 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).

1. Suivez le reste des instructions pour créer un canal. (Voir [Mise en route avec le streaming à faible latence IVS](getting-started.md).)

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

1. Ouvrez la [console Amazon IVS](https://console.aws.amazon.com/ivs). Sélectionnez la région de votre canal si ce n'est pas déjà fait.

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

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

1. 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).

1. Cliquez sur **Save changes** (Enregistrer les modifications).

## Instructions de la CLI
<a name="private-channels-auth-cli"></a>

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)
<a name="private-channels-auth-api"></a>

Pour plus d’informations sur l’utilisation, consultez [CreateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_CreateChannel.html) et [UpdateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_UpdateChannel.html) 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
}
```