# Aktivieren der Wiedergabe-Autorisierung für IVS-Kanäle
<a name="private-channels-enable-playback-auth"></a>

Die Autorisierungsanforderung eines Kanals kann beim Erstellen des Kanals konfiguriert werden oder später (mit einem Aktualisierungsvorgang). Beachten Sie, dass die Schritte unabhängig davon sind, ob Sie die Wiedergabe-Autorisierung aktivieren oder deaktivieren möchten.

Beachten Sie, dass Richtlinien für Wiedergabebeschränkungen (wie Geoblocking) nicht gleichzeitig mit der Wiedergabeautorisierung verwendet werden können. Wenn die Wiedergabeautorisierung für einen Kanal aktiviert ist, werden alle konfigurierten Richtlinien für Wiedergabebeschränkungen ignoriert. Um geografische Beschränkungen für einen privaten Kanal durchzusetzen, überprüfen Sie den Standort des Benutzers innerhalb Ihrer Token-Generierungslogik, bevor Sie ein Wiedergabe-Token ausgeben.

## Anleitung für die Konsole
<a name="private-channels-auth-console"></a>

So aktivieren Sie die Autorisierung beim Erstellen eines Kanals:

1. Öffnen Sie die [Amazon-IVS-Konsole](https://console.aws.amazon.com/ivs). Wählen Sie die Region Ihres Senders aus, wenn Sie sich nicht bereits darin befinden.

1. Wählen Sie im Feld **Erste Schritte** (oben rechts) die Option **Kanal erstellen**.

1. Klicken Sie auf der Seite **Kanal erstellen** **Benutzerdefinierte Konfiguration**.

1. Aktivieren Sie im Abschnitt **Wiedergabeauthentifizierung** die Option **Token-Authentifizierungsanforderung für die Videowiedergabe aktivieren**.

1. Befolgen Sie die restlichen Eingabeaufforderungen, um einen Kanal zu erstellen. (Siehe [Erste Schritte mit IVS-Streaming mit niedriger Latenz](getting-started.md).)

So aktivieren Sie die Autorisierung durch Aktualisieren eines vorhandenen Kanals:

1. Öffnen Sie die [Amazon-IVS-Konsole](https://console.aws.amazon.com/ivs). Wählen Sie die Region Ihres Senders aus, wenn Sie sich nicht bereits darin befinden.

1. Wählen Sie im linken Navigationsmenü **Kanäle**.

1. Wählen Sie das Kontrollkästchen für den Kanal aus, den Sie aktualisieren möchten, und klicken Sie auf **Bearbeiten**. 

1. Aktivieren Sie im Abschnitt **Wiedergabeauthentifizierung** die Option **Token-Authentifizierungsanforderung für die Videowiedergabe aktivieren**.

1. Klicken Sie auf **Änderungen speichern**.

## CLI-Anweisungen
<a name="private-channels-auth-cli"></a>

So aktivieren Sie die Autorisierung beim Erstellen eines Kanals:

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

Sie können `--region <aws-region>` auslassen, wenn sich die Region in Ihrer lokalen AWS Konfigurationsdatei befindet.

Hier ein Beispiel für eine Antwort: Beachten Sie, dass `authorized` gleich `true` ist.

```
{
    "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"
    }
}
```

So aktivieren Sie die Autorisierung durch Aktualisieren eines vorhandenen Kanals:

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

Dies ist nur ein Beispiel; Sie müssen Ihren eigenen Kanal-ARN nach spezifizieren `--arn`. Wie beim Anlegen eines Kanals ist `authorized` in der Update-Antwort `true`.

## API-Anfragen (Erstellen und Aktualisieren)
<a name="private-channels-auth-api"></a>

Nutzungsinformationen finden Sie unter [CreateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_CreateChannel.html) und [UpdateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_UpdateChannel.html) in der *Referenz zur API von IVS-Streaming mit niedriger Latenz*. 

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

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