NAME

       samlsign - sign and verify XML documents

SYNOPSIS

       samlsign <options>

DESCRIPTION

       samlsign signs or verifies signed XML documents.  To sign a document, use -s.  To verify a
       document, omit -s.  One of the -c, -R, or -T options are required when verifying.  Either
       -k or -R is required when signing.

       By default, samlsign signs or verifies standard input.  Pass -u or -f to retrieve the
       document from a URL or file path.  Signed documents are always printed to standard output.

OPTIONS

       -u URL The URL of the document to sign or verify.

       -f PATH
              The full path of the document to sign or verify.

       -id ID Rather than acting on the entire document, only act on the object with the
              specified ID.  Only that object (with its new signature) will be printed to
              standard output.

       -s     Sign, rather than the default action of verify.

       -k KEY Specifies the full path to the key to use for signing.

       -c CERT
              Specifies the full path to the certificate to use for verification.

       -R RESOLVER
              Specifies a credential resolver to use for either signing or verification.

       -T TRUST
              Specifies the trust engine for TrustEngine-based verification.

       -M METADATA
              Specifies the metadata for TrustEngine-based verification.

       -i ISSUER
              Specifies the issuer for verification.

       -p PROT
              Specifies the protocol for TrustEngine-based verification.  This option allows
              specification of an arbitrary protocol by name, but more commonly one would use one
              of the options listed below for standard protocol names.

       -r RNAME
              Specifies the resource name for TrustEngine-based verification.  This option allows
              specification of an arbitrary resource name by name, but more commonly one would
              use one of the options listed below for standard resource names.

       -ns RNS
              Specifies the namespace for TrustEngine-based verification.  If not given, the
              default is SAML20MD_NS.

       -saml10
              Use the SAML1.0 protocol for TrustEngine-based verification.

       -saml11
              use the SAML1.1 protocol for TrustEngine-based verification.

       -saml2 use the SAML2.0 P NS protocol for TrustEngine-based verification.

       -idp   Set the resouce name to IDPSSODescriptor for TrustEngine-based verification.

       -aa    Set the resource name to AttributeAuthorityDescriptor for TrustEngine-based
              verification.

       -pdp   Set the resource name to PDPDescriptor for TrustEngine-based verification.

       -sp    Set the resource name to SPSSODescriptor for TrustEngine-based verification.

       -V     Validate the document while signing or verifying it.  The path to the schemas used
              for validation can be overridden by setting the OPENSAML_SCHEMAS environment
              variable.

       -alg algorithm
              Specifies the signature algorithm to use, overriding the default.  Only used when
              signing.  -dig algorithm Specifies the digest algorithm to use, overriding the
              default.  Only used when signing.

EXIT STATUS

       0      Success.

       -1     An error in how samlsign was called (incorrect arguments, for example).

       -2     An error occurred when initializing the configuration.

       -10    An exception was caught.

EXAMPLES

       To sign SAML 2.0 metadata, use:

           samlsign -k /path/to/key -c /path/to/cert -f /path/to/metadata

AUTHOR

       This manpage were written by Ferenc Wágner and Russ Allbery for Debian GNU/Linux.

COPYRIGHT

       Copyleft (C) 2008 Ferenc Wágner
       This is free software in the public domain.