

# IVS チャネルでの再生承認を有効にする
<a name="private-channels-enable-playback-auth"></a>

チャネルの承認要件は、チャネルの作成時または作成後に (更新オペレーションを使用して) 設定できます。再生承認を有効または無効にする手順は同じです。

再生制限ポリシー (地理的制限など) は、再生認可と同時に使用することはできません。チャネルに対して再生認可が有効になっている場合、設定された再生制限ポリシーは無視されます。プライベートチャネルに地理的制限を適用するには、再生トークンを発行する前に、トークン生成ロジック内のユーザーの位置を検証します。

## コンソールでの手順
<a name="private-channels-auth-console"></a>

チャネルの作成時に承認を有効にするには

1. [Amazon IVS コンソール](https://console.aws.amazon.com/ivs)を開きます。チャネルのリージョンを選択していない場合は、リージョンを選択します。

1. [**Get started (開始する)**] ボックス (右上) で [**Create channel (チャネルの作成)**] を選択します。

1. [**Create channel (チャネルの作成)**] ページで、[**Custom configuration (カスタム設定)**] を選択します。

1. [**Playback authentication (再生承認)**] セクションで、[**Enable token-authentication requirement for video playback (動画再生のトークン認証要件を有効にする)**] を有効にします。

1. 残りのプロンプトに従って、チャネルを作成します。(「[IVS 低レイテンシーストリーミングを開始する](getting-started.md)」を参照してください。)

既存のチャネルを更新して承認を有効にするには

1. [Amazon IVS コンソール](https://console.aws.amazon.com/ivs)を開きます。チャネルのリージョンを選択していない場合は、リージョンを選択します。

1. 左のナビゲーションメニューの [**Channels (チャネル)**] を選択します。

1. 更新するチャネルのチェックボックスを選択し、[**Edit (編集)**] を選択します。

1. [**Playback authentication (再生承認)**] セクションで、[**Enable token-authentication requirement for video playback (動画再生のトークン認証要件を有効にする)**] を有効にします。

1. [**Save changes (変更の保存)**] をクリックします。

## CLI の手順
<a name="private-channels-auth-cli"></a>

チャネルの作成時に承認を有効にするには

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

リージョンがローカルの AWS 設定ファイルにある場合、`--region <aws-region>` を省略できます。

レスポンスの例を次に示します。`authorized` は `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"
    }
}
```

既存のチャネルを更新して承認を有効にするには

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

これは一例です。`--arn` の後に独自のチャネル ARN を指定する必要があります。チャネルを作成する場合と同様に、更新レスポンスの `authorized` は `true` です。

## API リクエスト (作成と更新)
<a name="private-channels-auth-api"></a>

使用方法の詳細については、「*IVS 低レイテンシーストリーミング API リファレンス*」の「[CreateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_CreateChannel.html)」および「[UpdateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_UpdateChannel.html)」を参照してください。

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

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