falcosuessgott / saml2-metadata-verifier

Verify and lint SAML2.0 Metadata

saml2-metadata-verifier

verify SAML SP and IDP metadata

Table of Contents

• saml2-metadata-verifier
• Table of Contents
  • How it works
  • Dependencies
    • libxml2 from sources
    • CentOS/RHEL
    • Debian/Ubuntu
  • Installation
  • Usage
  • Usage with Docker
  • Example
  • Credits

How it works

saml2-metadata-verifier parses the provided metadata-xml-file and validates it to the SAML2.0 xsd-files using xmllint. If the metadata file has values or options that are invalid for the SAML2.0 standard it prints out the errors.

Dependencies

You will need xmllint. You can install the dependency from sources, rpm or apt packages:

libxml2 from sources

curl -L ftp://xmlsoft.org/libxml2/LATEST_LIBXML2 -o ./LIBXML2_LATEST.tar.gz
tar -xf ./LIBXML2_LATEST.tar.gz
cd ./libxml2*
./configure --prefix=/usr  --enable-static --with-threads --with-history
make
sudo make install

CentOS/RHEL

yum install libxml2-devel

Debian/Ubuntu

apt-get install libxml2-utils

Installation

git clone https://github.com/FalcoSuessgott/saml2-metadata-verifier.git
make

Usage

saml2-metadata-verifier -h                             
Usage: saml2-metadata-verifier [OPTIONS...]

OPTIONS:
  -f, --file               path to metadata file
  -v, --verbose            verbos

Usage with Docker

docker run --rm -v ${PWD}/metadata.xml:/saml/metadata.xml gottziehtalles/saml2-metadata-verifier metadata.xml 
# change -v ${PWD}/metadata.xml to your metadata file

Example

./saml2-metadata-verifier.sh -f test/invalid_metadata.xml
-:77: element ContactPerson: Schemas validity error : Element '{urn:oasis:names:tc:SAML:2.0:metadata}ContactPerson', attribute 'contactType': [facet 'enumeration'] The value 'developer' is not an element of the set {'technical', 'support', 'administrative', 'billing', 'other'}.
- fails to validate

Credits

Shotouts to @joostd

https://gist.github.com/joostd/6057099

saml2-metadata-verifier's Issues

verifiying fails if file has multiple entityIDs

test/invalid-metadata.xml:52: parser error : Extra content at the end of the document
<md:EntityDescriptor entityID="https://sp.example.com/shibboleth"
^