Qu’est-ce qu’un message SAML ?

SAML (Security Assertion Markup Language) 2.0 est utilisé par de nombreuses configurations d’authentification unique (SSO). Lorsque vous vous connectez à une application par l’intermédiaire du fournisseur d’identité de votre entreprise, comme Okta, Microsoft Entra ID, Google Workspace ou Keycloak, l’application envoie une requête au fournisseur d’identité (une AuthnRequest), qui renvoie une réponse indiquant qui vous êtes (une Response contenant une Assertion). Les deux sont des documents XML, mais ils sont transmis sous forme encodée. Ils apparaissent donc comme de longues suites de caractères aléatoires dans le journal réseau de votre navigateur.

Comment en décoder un

Collez le message sous l’une des formes que vous êtes susceptible d’avoir :

  • La valeur d’un champ SAMLRequest ou SAMLResponse, copiée depuis l’onglet Réseau des outils de développement de votre navigateur ou depuis une extension de traçage SAML.
  • Une URL complète ou le corps d’un formulaire, comme SAMLResponse=…&RelayState=…, contenant un tel champ. Le RelayState et, dans le cas d’une redirection signée, l’algorithme de signature sont également affichés.
  • Le XML lui-même, pour consulter ses champs.

Le décodeur détermine automatiquement l’encodage :

  • La liaison HTTP-POST transmet le XML encodé en Base64 dans un champ de formulaire masqué.
  • La liaison HTTP-Redirect compresse le XML avec DEFLATE, l’encode en Base64, puis encode le résultat dans une URL pour qu’il puisse être intégré à un lien. Le décodeur annule ces trois étapes.

Les sauts de ligne, le Base64 adapté aux URL et les signes plus transformés en espaces par le décodage du formulaire sont également pris en charge.

Ce qui s’affiche

  • Liaison et paramètre : comment le message a été encodé et s’il s’agit d’une requête ou d’une réponse.
  • Message : les champs que l’on vérifie généralement lors de la configuration ou du débogage du SSO. Ils comprennent l’émetteur (qui l’a envoyé), la destination, le statut (Success ou une erreur comme Responder / AuthnFailed), l’identifiant de nom (qui s’est connecté) et son format, l’audience (l’application à laquelle l’assertion est destinée) et la période de validité (Not before et Not on or after). Ils comprennent également le contexte d’authentification, l’index de session et indiquent si le message, l’assertion ou, dans le cas de la liaison HTTP-Redirect, l’URL porte une signature.
  • Attributs : les attributs utilisateur transmis par le fournisseur d’identité, comme l’adresse e-mail, le nom et les groupes, avec toutes les valeurs de chacun.
  • XML décodé : le message complet, avec indentation, prêt à être copié ou téléchargé.

Bon à savoir

  • Le décodeur indique si une signature est présente, mais ne la vérifie pas : cette vérification nécessite le certificat du fournisseur d’identité et relève du fournisseur de services.
  • Une assertion chiffrée (EncryptedAssertion) ne peut être lue qu’avec la clé privée du fournisseur de services. Le décodeur indique donc sa présence, mais ne peut pas en afficher le contenu.
  • Les heures des messages SAML sont exprimées en UTC. Un décalage entre les horloges des serveurs est une cause fréquente d’échec de connexion : il se manifeste par une heure Not before dans le futur ou une heure Not on or after déjà passée.
  • Tout se passe dans votre navigateur. Rien de ce que vous collez n’est envoyé ailleurs, ce qui est important, car une réponse SAML peut contenir des données personnelles.

Fonctionnalités

  • Décode les messages HTTP-Redirect (compressés) et HTTP-POST (Base64)
  • Accepte les valeurs, les URL complètes, les corps de formulaire et le XML brut
  • Répertorie l’émetteur, le statut, le sujet, les conditions et les détails d’authentification
  • Affiche tous les attributs et leurs valeurs
  • XML indenté à copier ou à télécharger
  • Fonctionne dans votre navigateur