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 resource 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.