Escolher uma política de segurança para o domínio personalizado da API REST no API Gateway

Para ter maior segurança do domínio personalizado do Amazon API Gateway, é possível escolher uma política de segurança no console do API Gateway, a AWS CLI ou um AWS SDK.

Uma política de segurança é uma combinação predefinida da versão mínima do TLS e dos pacotes de criptografia oferecida pelo Amazon API Gateway. É possível escolher uma política de segurança do TLS versão 1.2 ou do TLS versão 1.0. O protocolo TLS trata problemas de segurança de rede, como violação e interceptação entre um cliente e o servidor. Quando seus clientes estabelecem um handshake do TLS para a API por meio do domínio personalizado, a política de segurança aplica as opções do pacote de criptografia e da versão do TLS que seus clientes podem optar por usar.

Nas configurações do domínio personalizado, uma política de segurança determina duas configurações:

Se escolher uma política de segurança TLS 1.0, a política de segurança aceitará tráfego TLS 1.0, TLS 1.2 e TLS 1.3. Se você escolher uma política de segurança TLS 1.2, a política de segurança aceitará tráfego TLS 1.2 e TLS 1.3 e rejeitará tráfego TLS 1.0.

Como especificar uma política de segurança para domínios personalizados

Ao criar um nome de domínio personalizado, especifique a política de segurança para ele. Para saber como criar um domínio personalizado, consulte Configurar um nome de domínio personalizado otimizado para borda no API Gateway ou Configurar um nome de domínio regional personalizado no API Gateway.

Para alterar a política de segurança do seu nome de domínio personalizado, atualize as configurações do domínio personalizado. Você pode atualizar as configurações de nome do domínio personalizado usando o AWS Management Console, a AWS CLI ou um AWS SDK.

Ao usar a API REST do API Gateway ou AWS CLI, especifique a nova versão do TLS, TLS_1_0 ou TLS_1_2, no parâmetro securityPolicy. Para saber mais, consulte domainname:update na Referência da API REST do Amazon API Gateway ou update-domain-name na Referência daAWS CLI.

A operação de atualização pode levar alguns minutos para ser concluída.

Políticas de segurança, versões do protocolo TLS e criptografias compatíveis com domínios personalizados otimizados para borda

A tabela a seguir descreve as políticas de segurança que podem ser especificadas para nomes de domínio personalizados otimizados para bordas.

A tabela a seguir descreve as criptografias TLS disponíveis para cada política de segurança.

Políticas de segurança, versões do protocolo TLS e criptografias compatíveis com domínios de região personalizados

A tabela a seguir descreve as políticas de segurança para nomes de domínio de região personalizados.

A tabela a seguir descreve as criptografias TLS disponíveis para cada política de segurança.

Versões e cifras do protocolo TLS com suporte para APIs privadas

A tabela a seguir descreve os protocolos TLS compatíveis com APIs privadas. Não há suporte para especificar uma política de segurança para APIs privadas.

A tabela a seguir descreve as criptografias TLS disponíveis para a política de segurança TLS_1_2 para APIs privadas.

Nomes das criptografias OpenSSL e RFC

OpenSSL e IETF RFC 5246 usam nomes diferentes para as mesmas cifras. A tabela a seguir mapeia o nome do OpenSSL para o nome do RFC para cada criptograma.

Informações sobre APIs HTTP e APIs de WebSocket

Para saber mais sobre APIs HTTP e APIs de WebSocket, consulte Política de segurança para APIs HTTP no API Gateway e Política de segurança para APIs de WebSocket no API Gateway.