Mensagens de erro de apps SAML

Se você encontrar mensagens de erro do app de Linguagem de marcação para autorização de segurança (SAML), confira algumas etapas de solução de problemas que podem ajudar.

Codificar ou decodificar solicitações e respostas SAML

Para ajudar na solução de problemas, use a ferramenta de codificação/decodificação SAML para processar uma solicitação e uma resposta SAML em formato legível por humanos do arquivo HTTP Archive Format (HAR). Consulte https://toolbox.googleapps.com/apps/encode_decode/.

Erros de criação do app SAML

Ao criar um app SAML no Admin Console, talvez você veja o seguinte erro 400:

400 código de entidade duplicado

Você vai receber essa mensagem se tentar criar um aplicativo com um ID da entidade que já existe.

Para resolver o erro 400 de ID de entidade duplicado:

Use o aplicativo já configurado ou um código de entidade diferente.

Erros 500 referentes à criação do app SAML

Ao criar um app SAML no Admin Console, talvez você veja os seguintes erros 500:

  • Na seção Detalhes do provedor de identidade do Google, se você clicar no botão Fazer o download do certificado ou Fazer o download dos metadados quando o serviço de back-end do serviço de certificados estiver indisponível, um erro 500 vai aparecer na parte de cima da tela.
  • Ao carregar os esquemas em Mapeamento de NameID ou Mapeamento de atributos, se o serviço de esquema expirar ou exibir uma exceção de back-end, um erro 500 vai aparecer na parte de cima da tela.
  • Se o serviço Configuração do provedor de serviços estiver indisponível, um erro 500 vai aparecer na parte de cima da tela quando você clicar em Concluir.

Para resolver erros 500 na criação de apps SAML:

Aguarde um pouco e tente novamente. Se os erros persistirem, entre em contato com o Suporte do Google Cloud.

Erros de tempo de execução do SAML

Os seguintes cenários de erro podem ocorrer quando você testa um fluxo de Logon único (SSO) SAML em fluxos iniciados pelo provedor de identidade (IdP) ou pelo provedor de serviços (SP):

403 app_not_configured

Esse erro pode ocorrer nestes casos:

  • Em um fluxo iniciado pelo provedor de serviços, o aplicativo correspondente ao ID da entidade mencionado na solicitação não foi criado no Admin Console.
  • Em um fluxo iniciado pelo SP, o ID da entidade fornecido na SAMLRequest não corresponde a nenhum dos IDs de entidade dos apps instalados no momento. Se alguém alterar o ID do aplicativo (ID do SP) mencionado no URL iniciado pelo IdP, você vai receber um erro app_not_configured.

Para resolver o erro 403 app_not_configured:

  1. Verifique se o aplicativo correspondente ao ID da entidade mencionado na solicitação foi instalado antes de iniciar a solicitação.
  2. Verifique se o ID da entidade fornecido em SAMLRequest está correto e corresponde ao que você especificou durante a criação do app.
  3. Verifique se o ID do provedor de serviços transmitido no URL da solicitação é o mesmo do app-id app_not_enabled.

403 app_not_configured_for_user

Para resolver o erro 403 app_not_configured_for_user:

Verifique se o valor na tag saml:Issuer na SAMLRequest corresponde ao valor do ID da entidade configurado na seção Detalhes do provedor de serviços SAML no Admin Console. Esse valor diferencia maiúsculas de minúsculas.

403 app_not_enabled_for_user

Para resolver o erro 403 app_not_enabled_for_user:

  1. No Google Admin Console, acesse Menu e depois Apps e depois Apps da Web e para dispositivos móveis.

    É preciso ter o privilégio de administrador Gerenciamento de dispositivos móveis.

  2. Na lista de apps, localize o app SAML que está gerando o erro.
  3. Clique no app para abrir a página "Configurações".
  4. Clique em Acesso do usuário.
  5. Ative o app para todo mundo ou para a organização do usuário.

400 saml_invalid_user_id_mapping

Se um SP enviar um parâmetro NAMEID na SAMLRequest, esse parâmetro precisará ser igual ao configurado no IdP. Caso contrário, a SAMLRequest vai falhar com esse erro.

Para resolver o erro 400 saml_invalid_user_id_mapping:

  1. Acesse Detalhes básicos e verifique o parâmetro NAMEID.
  2. Verifique se o parâmetro NAMEID transmitido na SAMLRequest é o mesmo configurado no IdP.

400 saml_invalid_sp_id

Esse erro ocorre quando o ID do provedor de serviços no URL do fluxo do IdP está incorreto, devido a uma configuração incorreta ou adulteração do URL.

Para resolver o erro 400 saml_invalid_sp_id:

  1. Acesse Detalhes básicos e verifique o campo app-id.
  2. Verifique se o ID do provedor de serviços transmitido no URL da solicitação é o mesmo do app-id.

A resposta SAML retorna um status NEGADO para os cenários a seguir. Talvez você veja uma das três mensagens de erro relacionadas a seguir.

Solicitação inválida de fluxo iniciado pelo provedor de serviços, o URL do ACS em $parameter na solicitação não corresponde ao $parameter do URL do ACS configurado.

Nesse caso, o URL do ACS especificado na SAMLRequest e o URL do ACS configurado no Admin Console para o aplicativo correspondente não são iguais.

Para resolver o erro "O URL do ACS na solicitação $parameter não corresponde ao URL do ACS configurado $parameter":

  1. Acesse Detalhes do provedor de serviços.
  2. Verifique se o URL do ACS é o mesmo de SAMLRequest.

Código do IdP inválido fornecido no URL

O ID do IdP (um ID de cliente ofuscado) fornecido no URL foi adulterado e está incorreto.

Para resolver o erro de ID do IdP inválido no URL:

  1. No Google Admin Console, acesse Menu e depois Segurança e depois Autenticação e depois SSO com apps SAML.

    Para realizar essa tarefa, você precisa fazer login como superadmin.

  2. Encontre a string idpid no final do URL do ID da entidade.
  3. Verifique se o ID do IdP no URL da solicitação é o mesmo que o do URL do ID da entidade.

Código do IdP inválido de fluxo iniciado pelo IdP fornecido na solicitação.

O usuário autor da chamada adulterou o URL de SSO iniciado pelo IdP e alterou o ID do IdP para outro ID de cliente (ofuscado).

Para resolver o erro de ID do IdP inválido na solicitação:

  1. No Google Admin Console, acesse Menu e depois Segurança e depois Autenticação e depois SSO com apps SAML.

    Para realizar essa tarefa, você precisa fazer login como superadmin.

  2. Encontre a string idpid no final do URL do ID da entidade.
  3. Verifique se o ID do IdP no URL de solicitação é o mesmo do URL do ID da entidade.

Erros 500 ao testar um fluxo de SSO SAML

Quando os usuários estão testando um fluxo de SSO SAML em fluxos iniciados por IdP ou SP, eles podem encontrar um dos vários erros 500 devido à indisponibilidade de processos de back-end.

Para resolver erros 500 ao testar um fluxo de SSO via SAML:

Aguarde e teste o fluxo novamente. Se isso ainda não funcionar, entre em contato com o suporte do Google Cloud.

Mensagens de erro de acesso ao app SAML

1000 no acesso à página do app SAML

Para resolver o erro de acesso à página do app SAML:

Entre em contato com o suporte do Google Cloud.

1000 no acesso às configurações do app SAML

Para resolver o erro de acesso às configurações do app SAML:

Entre em contato com o suporte do Google Cloud.

Mensagem de erro de exclusão do esquema de usuário do app SAML

400

Esse erro ocorre se você estiver tentando excluir um esquema personalizado associado como um mapeamento de atributos para um app SAML que já foi excluído. Se você criou o esquema antes de o problema ser corrigido, esse erro pode ocorrer.

Para resolver o erro de exclusão do esquema de usuário dos apps SAML:

Entre em contato com o suporte do Google Cloud.