Che cos'è un messaggio SAML?

SAML (Security Assertion Markup Language) 2.0 è alla base di molte configurazioni di accesso singolo (SSO). Quando accedi a un'app tramite il provider di identità della tua azienda, ad esempio Okta, Microsoft Entra ID, Google Workspace o Keycloak, l'app invia una richiesta al provider di identità (un AuthnRequest) e il provider di identità invia una risposta che indica chi sei (una Response con un'Assertion). Entrambi sono documenti XML, ma vengono trasmessi codificati, quindi nel log di rete del browser appaiono come lunghi blocchi di lettere casuali.

Come decodificarne uno

Incolla il messaggio in uno dei formati in cui è probabile che tu lo abbia:

  • Il valore di un campo SAMLRequest o SAMLResponse, copiato dalla scheda di rete degli strumenti per sviluppatori del browser o da un'estensione per il tracciamento SAML.
  • Un URL completo oppure il corpo di un modulo, ad esempio SAMLResponse=…&RelayState=…, che contiene un campo di questo tipo. Vengono mostrati anche RelayState e, per un redirect firmato, l'algoritmo di firma.
  • Il codice XML stesso, per leggerne i campi.

Il decodificatore determina autonomamente la codifica:

  • Il binding HTTP-POST invia il codice XML codificato in Base64 in un campo nascosto del modulo.
  • Il binding HTTP-Redirect comprime il codice XML con DEFLATE, lo codifica in Base64 e codifica il risultato nell'URL, in modo che possa essere inserito in un link. Il decodificatore annulla tutti e tre i passaggi.

Vengono gestiti anche le interruzioni di riga, Base64 compatibile con gli URL e i segni più convertiti in spazi dalla decodifica del modulo.

Cosa viene mostrato

  • Binding e parametro: come è stato codificato il messaggio e se si tratta di una richiesta o di una risposta.
  • Messaggio: i campi che si controllano di solito durante la configurazione o la risoluzione dei problemi di SSO. Includono l'emittente (chi lo ha inviato), la destinazione, lo stato (Success oppure un errore come Responder / AuthnFailed), l'ID del nome (chi ha effettuato l'accesso) e il relativo formato, il destinatario (l'app a cui è destinata l'asserzione) e l'intervallo di validità (non valido prima di una certa data e non valido a partire da una certa data). Includono anche il contesto di autenticazione, l'indice della sessione e l'indicazione se il messaggio, l'asserzione o, per il binding HTTP-Redirect, l'URL contiene una firma.
  • Attributi: gli attributi utente rilasciati dal provider di identità, come email, nome e gruppi, con tutti i valori di ciascun attributo.
  • XML decodificato: l'intero messaggio, con rientri, pronto per essere copiato o scaricato.

Da sapere

  • Il decodificatore indica se è presente una firma, ma non la verifica: per farlo servono il certificato del provider di identità ed è responsabilità del provider di servizi.
  • Un'asserzione cifrata (EncryptedAssertion) può essere letta solo con la chiave privata del provider di servizi. Perciò il decodificatore segnala che è presente, ma non può mostrarne il contenuto.
  • Gli orari nei messaggi SAML sono espressi in UTC. Una causa frequente degli errori di accesso è una differenza tra gli orologi dei server, che si manifesta quando l'orario di inizio validità è nel futuro o quello di fine validità è già trascorso.
  • Tutto avviene nel browser. Ciò che incolli non viene inviato da nessuna parte, un aspetto importante perché una risposta SAML può contenere dati personali.

Funzionalità

  • Decodifica i messaggi HTTP-Redirect (compressi con DEFLATE) e HTTP-POST (Base64)
  • Accetta valori, URL completi, corpi di moduli e codice XML semplice
  • Elenca emittente, stato, soggetto, condizioni e dettagli di autenticazione
  • Mostra tutti gli attributi e i relativi valori
  • XML con rientri, da copiare o scaricare
  • Funziona nel browser