Ir para o conteúdo

Como soluciono problemas de autenticação no meu Application Load Balancer?

9 minuto de leitura
0

Recebo um erro ao configurar a autenticação no meu Application Load Balancer.

Resolução

Configurações incorretas com o provedor de identidades (IdP) ou o Application Load Balancer podem causar erros ao configurar a autenticação para o Application Load Balancer. Para solucionar erros de autenticação, conclua as tarefas a seguir.

HTTP 400: Bad request

redirect_mismatch

Um erro redirect_mismatch resulta em HTTP 400 quando a configuração do URL de redirecionamento não corresponde entre seu IdP e o Application Load Balancer.

Se você usa o Amazon Cognito, defina o URL de retorno de chamada como https://domain/oauth2/idpresponse. Se você usar um IdP diferente, defina o URI de redirecionamento para https://domain/oauth2/idpresponse.

Observação: substitua o domínio pelo domínio usado para acessar o Application Load Balancer.

HTTP 401: Unauthorized

Para resolver o erro “HTTP 401: Unauthorized”, conclua as seguintes tarefas:

Problemas de configuração

Atualize as seguintes configurações para que correspondam ao seu Application Load Balancer e ao IdP:

  • Emissor
  • Endpoint de autorização
  • Endpoint do token
  • ID do cliente/segredo do cliente

Além disso, defina Action on unauthenticated request (Ação na solicitação não autenticada) como Allow (Permitir) ou Authenticate (client reattempt) (Autenticar (nova tentativa do cliente)) ou Deny (Negar) (return 401) com base no seu caso de uso.

Problemas de cookies de autenticação

Se o código de erro do seu log de acesso for “AuthInvalidCookie”, o cookie de autenticação não é válido ou está malformado. Limpe os cookies do navegador e tente autenticar novamente. Certifique-se de que seu cliente envie o cookie de autenticação durante o fluxo de trabalho.

Nonce de autenticação inválido ou ausente

Se o código de erro do log de acesso for “AuthInvalidAWSALBAuthNonce” ou “AuthMissingAWSALBAuthNonce”, o nonce no estado de autenticação não corresponde a um cookie do navegador. O cookie pode ser diferente ou pode estar ausente. Certifique-se de que seu cliente envie o cookie de nonce de autenticação durante o fluxo de trabalho.

Parâmetros de estado inválidos ou ausentes

Se o código de erro do log de acesso for “AuthInvalidStateParam” ou “AuthMissingStateParam”, o parâmetro state na resposta de autenticação não é válido ou está ausente. Configure seu IdP para retornar parâmetros de estado no fluxo de autenticação. Verifique se o estado não expirou.

Código de autorização ausente

Se o código de erro do log de acesso for “AuthMissingCodeParam”, o parâmetro do código de autorização está ausente na resposta de retorno de chamada do IdP. Configure seu IdP para retornar códigos de autorização com o tipo de concessão de código de autorização. Verifique seus logs de IdP para ver se há respostas de erro como “Service not found” ou “access_denied”.

Token de ID inválido

Se o código de erro do log de acesso for “AuthInvalidIdToken”, o token de ID do IdP não poderá ser validado. Verifique se o emissor no token de ID corresponde ao emissor configurado nas configurações de autenticação do Application Load Balancer. Verifique se a URL do endpoint do token, o ID do cliente e o algoritmo de assinatura do token estão corretos na configuração do Application Load Balancer.

Cabeçalho de host ausente

Se o código de erro do log de acesso for “AuthMissingHostHeader”, a resposta de autenticação do endpoint de autorização não terá um campo de cabeçalho do host. Verifique a configuração do IdP para garantir que ela inclua o cabeçalho do host nas respostas.

HTTP 500: Internal Server error

O balanceador de carga deve ser capaz de se comunicar com o endpoint do token IdP (TokenEndpoint) e com o endpoint de informações do usuário do IdP (UserInfoEndpoint). Os Application Load Balancers suportam somente IPv4 quando os balanceadores de carga se comunicam com esses endpoints.

Para resolver o erro “HTTP 500: Internal Server Error”, conclua as seguintes tarefas:

Problemas com nomes de domínio privados

Verifique se o nome do DNS do endpoint do IdP pode ser resolvido publicamente. O atributo de autenticação não pode resolver nomes de domínio privados.

Problemas com regras de saída

Adicione uma regra de saída ao grupo de segurança do balanceador de carga que permita o tráfego para os endpoints do IdP pela porta HTTPS 443.

Problemas de endpoint do IdP

Certifique-se de que a lista de controle de acesso (ACL) da sub-rede do balanceador de carga permita o tráfego de e para os endpoints do IdP:

  • Para regras de saída, você deve definir a especificação do IP de destino (endpoints de IdP) e da porta TCP de destino 443 como Permitir.
  • Para regras de entrada, você deve definir o IP de origem (endpoints de IdP) e o intervalo de portas TCP de destino 1024-65535 como Permitir.
  • Configure as tabelas de rotas da sub-rede do balanceador de carga para alcançar os endpoints do IdP:
    Para balanceadores de carga voltados para a Internet, configure uma rota padrão do gateway da internet para alcançar os endpoints públicos de IdP.
    Para balanceadores de carga internos ou balanceadores com um endereço IP dualstack-without-public-ipv4, configure um gateway NAT ou uma rota padrão da instância para alcançar endpoints de IdP públicos.
    Para todas as outras topologias de rede, você deve ter roteamento suficiente de ponta a ponta para alcançar os endpoints do IdP.

Problemas de tempo de resposta

Certifique-se de que o token IdP ou o endpoint de informações do usuário respondam em 5 segundos. Se o código de erro do log de acesso for “AuthTokenEpRequestTimeout” ou “AuthUserinfoEpRequestTimeout”, o balanceador de carga gerará um erro HTTP 500. Verifique se seus endpoints de IdP estão acessíveis e não estão enfrentando problemas de latência ou tempo limite de conexão. Monitore com a métrica ELBAuthLatency para identificar tempos de resposta lentos do IdP.

Problemas de limite de tamanho

Verifique se as reivindicações do usuário não excedem o limite de tamanho. Se o código de erro do log de acesso for “AuthUserinfoResponseSizeExceeded”, a declaração de usuário recebida do IdP pode ser muito grande. A declaração do usuário recebida do IdP deve ter 11 KB ou menos. Se a declaração exceder esse limite, reduza o número de declarações incluídas no token de ID ou na resposta às informações do usuário. Monitore com a métrica ELBAuthUserClaimsSizeExceeded do CloudWatch.

Problemas de resposta de token inválidos

Certifique-se de que o IDP não esteja fornecendo uma resposta de token inválida. Se o código de erro do log de acesso for “AuthInvalidTokenResponse”, a resposta do endpoint do token não é válida ou está malformada. Verifique se seu endpoint de token IdP retorna respostas de token OAuth2 formatadas corretamente.

Problemas com o código de autorização

Verifique se o IDP não está fornecendo um código de autorização inválido ou expirado. Se o código de erro do log de acesso for “AuthInvalidGrantError”, o código de autorização do IdP expirará ou será reutilizado. Certifique-se de que o código seja trocado por tokens antes de expirar e que não seja reutilizado. Verifique se seu IdP está configurado para usar o tipo de concessão do código de autorização, que é o único tipo de concessão do OAuth2 suportado pelos Application Load Balancers.

Problemas de resposta com informações de usuário inválidas

Se o código de erro do log de acesso for “AuthInvalidUserinfoResponse”, a resposta do endpoint de informações do usuário não é válida ou está incorreta. Ele pode conter argumentos de consulta NULL ou inválidos. Verifique se o endpoint de informações do usuário do IdP retorna respostas formatadas corretamente de acordo com a especificação do OpenID Connect.

HTTP 561: Erro não autorizado do endpoint do IdP

Os erros HTTP 561 ocorrem quando o Application Load Balancer recebe uma resposta de erro dos endpoints do IdP. Monitore esse erro com a métrica ELBAuthError do CloudWatch.

Para resolver erros de HTTP 561, conclua as seguintes tarefas:

Verificar a configuração do endpoint do IdP

  • Verifique se o URL do endpoint do token e o URL do endpoint de informações do usuário estão corretos na configuração do receptor do Application Load Balancer.
  • Certifique-se de que o ID do cliente e o segredo do cliente sejam válidos e correspondam à sua configuração de IdP.
  • Verifique se o segredo do cliente não expirou nem foi alterado sem atualizar a configuração do balanceador de carga.

Verifique a disponibilidade e a resposta do endpoint IdP

Se o código de erro do log de acesso for “AuthTokenEpRequestFailed” ou “AuthUserinfoEpRequestFailed”, verifique se o endpoint do token IdP e o endpoint de informações do usuário estão acessíveis. Eles devem retornar 2XX respostas de sucesso. Analise seus logs de IdP em busca de mensagens de erro como “invalid_client”, “invalid_request”, problemas de limitação de taxa ou interrupções no serviço.

Verificar a configuração do token e do escopo

Certifique-se de que o código de autorização não tenha expirado. Verifique se você concedeu os escopos necessários, incluindo openid, e-mail ou perfil.

Verifique se o certificado do endpoint IdP corresponde ao nome do host configurado

Se o código de erro do log de acesso for “AuthTokenEpRequestFailed” ou “AuthUserinfoEpRequestFailed”, o certificado fornecido pelo endpoint do IdP não incluirá o nome do host configurado. O Application Load Balancer valida se o nome do host na URL do endpoint do IdP configurado corresponde ao Nome Alternativo do Assunto (SAN) ou ao Nome Comum (CN) do certificado. Se o certificado fornecido pelo endpoint do IdP não incluir o nome do host configurado, o balanceador de carga rejeitará a conexão. Verifique se seu certificado de endpoint IdP inclui o nome do host configurado em sua SAN ou CN. Ou atualize a configuração do Application Load Balancer para usar um nome de host que corresponda ao seu certificado existente.

Monitore a autenticação com o CloudWatch

É possível monitorar o desempenho e os erros da autenticação com as seguintes métricas do Amazon CloudWatch:

  • ELBAuthSuccess: Rastreia ações de autenticação bem-sucedidas
  • ELBAuthFailure: Rastreia falhas de autenticação devido a credenciais inválidas ou acesso negado (erros HTTP 401)
  • ELBAuthError: Rastreia erros de autenticação devido à configuração incorreta ou problemas de conexão do IdP (erros HTTP 500/561)
  • ELBAuthUserClaimsSizeExceeded: Rastreia instâncias em que as reivindicações de usuários excedem 11 KB
  • ELBAuthLatency: Mede o tempo de resposta do IdP em milissegundos
  • ELBAuthRefreshTokenSuccess: Rastreia operações bem-sucedidas de atualização de tokens

Ative os logs de acesso para capturar o campo error_reason, que contém códigos de erro específicos para solução de problemas detalhada. Para obter mais informações, consulte Logs de acesso para seu Application Load Balancer.

Códigos de erro HTTP adicionais

Para solucionar problemas de códigos de erro HTTP adicionais gerados por Application Load Balancers, consulte O load balancer gera um erro de HTTP.

Informações relacionadas

Simplifique o logon com a autenticação integrada do Application Load Balancer

Autenticar usuários usando um Application Load Balancer

Configurações específicas da aplicação com clientes de aplicações

AWS OFICIALAtualizada há 6 meses