SAML Raider is a Burp Suite extension for testing SAML infrastructures. It contains two core functionalities: Manipulating SAML Messages and manage X.509 certificates.
This software was created by Roland Bischofberger and Emanuel Duss during a bachelor thesis at the Hochschule für Technik Rapperswil (HSR). Our project partner and advisor was Compass Security Schweiz AG . We thank Compass for the nice collaboration and support during our bachelor thesis.
The extension is divided in two parts. A SAML message editor and a certificate management tool.
Features of the SAML Raider message editor:
- Sign SAML Messages
- Sign SAML Assertions
- Remove Signatures
- Edit SAML Message
- Preview eight common XSW Attacks
- Execute eight common XSW Attacks
- Send certificate to SAMl Raider Certificate Management
- Undo all changes of a SAML Message
- Supported Profiles: SAML Webbrowser Single Sign-on Profile, Web Services Security SAML Token Profile
- Supported Bindings: POST Binding, Redirect Binding, SOAP Binding
Features of the SAML Raider Certificate Management:
- Import X.509 certificates (PEM and DER format)
- Import X.509 certificate chains
- Export X.509 certificates (PEM format)
- Delete imported X.509 certificates
- Display informations of X.509 certificates
- Import private keys (PKCD#8 in DER format and traditional RSA in PEM Format)
- Export private keys (traditional RSA Key PEM Format)
- Cloning X.509 certificates
- Cloning X.509 certificate chains
- Create new X.509 certificates
- Editing and self-sign existing X.509 certificates
Start the Burp Suite and click at the
Add. Choose the SAML Raider JAR file to install the extension.
Installation from BApp Store
The easy way to install SAML Raider is using the BApp Store. Open Burp and click in the
Extendertab on the
BApp Storetab. Select
SAML Raiderand hit the
Installbutton to install our extension.
Don't forget to rate our extension with as many stars you like.
To test SAML environments more comfortable, you could add a intercept rule in the proxy settings. Add a new rule which checks if a Parameter Name
SAMLResponseis in the request. We hope the usage of our extension is mostly self explaining.
Clone the repository and build the JAR file using Maven:
Use the JAR file in
$ mvn install
target/saml-raider-1.0-SNAPSHOT-jar-with-dependencies.jaras a Burp extension.
Run SAML Raider inside Eclipse
To start the Extension directly from Eclipse, import the Repository into Eclipse. Note that the Eclipse Maven Plugin
Place the Burp Suite JAR file into the
libfolder and add the Burp JAR as a Library in the Eclipse Project (
Open the Burp JAR under
Referenced Librariesin the Package Explorer and right click in the Package
Java Applicationto start Burp and load the Extension automatically.
To enable the Debug Mode, set the
DEBUGFlag in the Class
Flagsfrom the Package
true. This will write all output to the
SAMLRaiderDebug.loglogfile and load example certificates for testing.
Test with fake SAML Response
To send a SAML Response to Burp, you can use the script
scripts/samltestdirectory. It sends the SAML Response from
saml_responseto Burp (
localhost:8080) and prints out the modified response from our plugin.