Erros HTTP-4xx quando a implantação de API é criada com sucesso, mas as solicitações falham

Descubra como diagnosticar e solucionar erros HTTP-4xx quando uma implantação de API é criada com sucesso com o serviço API Gateway, mas as solicitações falham.

Depois de criar uma implantação de API com sucesso, você poderá encontrar erros HTTP-4xx ao chamá-la.

A chamada da implantação de API falha com um erro HTTP-4xx, e um erro "O certificado do cliente é inválido para este gateway" é gerado para o log

Ao chamar uma implantação de API que tenha o TLS mútuo ativado, talvez você veja a solicitação falhar com um erro HTTP-4xx e a seguinte saída de erro no log:

Client certificate is invalid for this gateway.

Esse erro ocorre quando o gateway de API que hospeda a implantação de API não pode verificar o certificado apresentado pelo cliente de API.

Para resolver esse problema, confirme se o certificado apresentado pelo cliente de API pode ser validado usando um pacote de CAs personalizado especificado para o gateway de API. Para obter mais informações, consulte Adicionando suporte a mTLS a Implantações de API.

A chamada da implantação de API falha com um erro HTTP-4xx, e um erro "falha de validação de SAN" é gerado para o log

Ao chamar uma implantação de API que tenha o TLS mútuo ativado, talvez você veja a solicitação falhar com um erro HTTP-4xx e a seguinte saída de erro no log:

SAN validation failure

Esse erro ocorre quando o gateway de API que hospeda a implantação de API pode verificar o certificado apresentado pelo cliente de API, mas os campos Nomes Alternativos de Assunto/Nomes Comuns (SANs/CNs) do certificado não contêm nenhum dos valores de SAN/CN permitidos especificados na política de solicitação mTLS da implantação de API.

Para resolver esse problema, execute um dos seguintes procedimentos:

  • Altere a lista SAN/CN permitida na política de solicitação mTLS para incluir os valores de SAN/CN no certificado apresentado pelo cliente da API.
  • Altere o certificado apresentado pelo cliente da API para incluir valores de SAN/CN da lista SAN/CN permitida na política de solicitação mTLS.

Para obter mais informações, consulte Adicionando suporte a mTLS a Implantações de API.