O que é uma mensagem SAML?

SAML (Security Assertion Markup Language) 2.0 é a tecnologia usada por muitas configurações de autenticação única (SSO). Quando você entra em um aplicativo por meio do provedor de identidade da sua empresa, como Okta, Microsoft Entra ID, Google Workspace ou Keycloak, o aplicativo envia uma solicitação ao provedor de identidade (uma AuthnRequest), e o provedor de identidade envia uma resposta informando quem você é (uma Response com uma Assertion). Ambas são documentos XML, mas são transmitidas codificadas, por isso parecem longos blocos de letras aleatórias no registro de rede do navegador.

Como decodificar uma mensagem

Cole a mensagem em qualquer um dos formatos em que você provavelmente a encontrará:

  • O valor de um campo SAMLRequest ou SAMLResponse, copiado da aba de rede das ferramentas de desenvolvedor do navegador ou de uma extensão SAML tracer.
  • Uma URL completa ou o corpo de um formulário, como SAMLResponse=…&RelayState=…, que contenha esse campo. O RelayState e, em um redirecionamento assinado, o algoritmo de assinatura também são exibidos.
  • O próprio XML, para consultar seus campos.

O decodificador identifica automaticamente a codificação:

  • A vinculação HTTP-POST envia o XML codificado em Base64 em um campo oculto do formulário.
  • A vinculação HTTP-Redirect compacta o XML com DEFLATE, codifica-o em Base64 e codifica o resultado para URL, para que caiba em um link. O decodificador desfaz essas três etapas.

Quebras de linha, Base64 seguro para URL e sinais de mais convertidos em espaços durante a decodificação do formulário são tratados.

O que você verá

  • Vinculação e parâmetro: como a mensagem foi codificada e se é uma solicitação ou uma resposta.
  • Mensagem: os campos que as pessoas costumam verificar ao configurar ou depurar o SSO. Eles incluem o emissor (quem a enviou), o destino, o status (Success ou um erro como Responder / AuthnFailed), o identificador do nome (quem entrou) e seu formato, o público (para qual aplicativo a assertion se destina) e o período de validade (Not before e Not on or after). Também incluem o contexto de autenticação, o índice da sessão e se a mensagem, a assertion ou, no caso da vinculação HTTP-Redirect, a URL contém uma assinatura.
  • Atributos: os atributos do usuário fornecidos pelo provedor de identidade, como e-mail, nome e grupos, com todos os valores de cada um.
  • XML decodificado: a mensagem completa, indentada e pronta para copiar ou baixar.

É bom saber

  • O decodificador indica se há uma assinatura, mas não a verifica: isso requer o certificado do provedor de identidade e é responsabilidade do provedor de serviço.
  • Uma assertion criptografada (EncryptedAssertion) só pode ser lida com a chave privada do provedor de serviço. Por isso, o decodificador informa que ela está presente, mas não pode exibir seu conteúdo.
  • Os horários nas mensagens SAML estão em UTC. Uma causa comum de falhas de autenticação é a diferença entre os relógios dos servidores, que pode aparecer como um horário Not before no futuro ou um horário Not on or after já passado.
  • Tudo acontece no seu navegador. Nada do que você cola é enviado a lugar algum, o que é importante porque uma resposta SAML pode conter dados pessoais.

Recursos

  • Decodifica mensagens HTTP-Redirect (comprimidas) e HTTP-POST (Base64)
  • Aceita valores, URLs completas, corpos de formulários e XML puro
  • Lista o emissor, o status, o assunto, as condições e os detalhes de autenticação
  • Exibe todos os atributos e seus valores
  • XML indentado para copiar ou baixar
  • Funciona no seu navegador