# Habilitar a autorização de reprodução em canais do IVS
<a name="private-channels-enable-playback-auth"></a>

O requisito de autorização de um canal pode ser configurado quando o canal é criado ou posteriormente (usando uma operação de atualização). Observe que as etapas são as mesmas se você deseja habilitar ou desabilitar a autorização de reprodução.

Observe que as políticas de restrição de reprodução (como bloqueio geográfico) não podem ser usadas simultaneamente com a autorização de reprodução. Se a autorização de reprodução estiver habilitada para um canal, todas as políticas de restrição de reprodução configuradas serão ignoradas. Para impor restrições geográficas em um canal privado, valide a localização do usuário dentro de sua lógica de geração de token antes de emitir um token de reprodução.

## Instruções do console
<a name="private-channels-auth-console"></a>

Para habilitar a autorização ao criar um canal:

1. Abra o [console do Amazon IVS](https://console.aws.amazon.com/ivs). Escolha a região do seu canal, se ainda não estiver nela.

1. Na caixa **Get started** (Conceitos básicos) (canto superior direito), selecione **Create channel** (Criar canal).

1. Na página **Channel create** (Criação do canal), escolha **Custom configuration** (Configuração personalizada).

1. Na seção **Playback authentication** (Autenticação de reprodução), habilite **Enable token-authentication requirement for video playback** (Ativar requisito de autenticação de token para reprodução de vídeo).

1. Siga o restante dos prompts para criar um canal. (Consulte [Conceitos básicos do streaming de baixa latência do IVS](getting-started.md).)

Para habilitar a autorização atualizando um canal existente:

1. Abra o [console do Amazon IVS](https://console.aws.amazon.com/ivs). Escolha a região do seu canal, se ainda não estiver nela.

1. No menu de navegação à esquerda, selecione **Users** (Usuários).

1. Marque a caixa de seleção do canal que você deseja atualizar e escolha **Edit** (Editar). 

1. Na seção **Playback authentication** (Autenticação de reprodução), habilite **Enable token-authentication requirement for video playback** (Ativar requisito de autenticação de token para reprodução de vídeo).

1. Clique em **Save changes** (Salvar alterações).

## Instruções da CLI
<a name="private-channels-auth-cli"></a>

Para habilitar a autorização ao criar um canal:

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

É possível omitir `--region <aws-region>` se a região estiver em seu arquivo de configuração local da AWS.

Este é um exemplo de resposta: Note que `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"
    }
}
```

Para habilitar a autorização atualizando um canal existente:

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

Este é apenas um exemplo; você deve especificar seu próprio ARN de canal após `--arn`. Como ao criar um canal, `authorized` é `true` na resposta de atualização.

## Solicitações de API (Criar e atualizar)
<a name="private-channels-auth-api"></a>

Para obter informações de uso, consulte [CreateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_CreateChannel.html) e [UpdateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_UpdateChannel.html) na *Referência de API do streaming de baixa latência do IVS*. 

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

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