NAME

       shib-metagen - Generate metadata for a Shibboleth SP

SYNOPSIS

       shib-metagen [-12ADLNO] [-c cert [-c cert ...]]
           [-e entity-id] [-f format [-f format ...]]
           [-h host [-h host ...]] [-n host [-n host ...]]
           [-l host-file] [-o organization]
           [-a admin [-a admin ...]]
           [-s support [-s support ...]]
           [-t tech [-t tech ...]] [-u url]

DESCRIPTION

       Generate metadata for a Shibboleth SP.  The metadata is printed to standard output.  Most of the
       parameters are optional, but at least one of -h or -n must be given to specify the hostname to use in
       constructing URLs for the Shibboleth service for the SP.  Other metadata can be added by using the other
       command-line parameters.  Most parameters can be given multiple times.

OPTIONS

       -1  Generate  SAML 1.0 metadata.  The default, if neither -1 nor -2 is given, is to generate metadata for
           both SAML 1.0 and SAML 2.0.

       -2  Generate SAML 2.0 metadata.  The default, if neither -1 nor -2 is given, is to generate metadata  for
           both SAML 1.0 and SAML 2.0.

       -A  Include artifact metadata.

       -a admin
           An  administrative  contact  for  this  Shibboleth  SP.   This  option  may be omitted, in which case
           administrative contact metadata is not included, or may be given  multiple  times  to  list  multiple
           contacts.   admin  should be in the form "first/last/email" where first is the given name and last is
           the surname.

       -c cert
           Specifies the SSL certificate used to identify this Shibboleth SP.  This option may be given multiple
           times to specify multiple certificates.  If it is not given, the default certificate  is  sp-cert.pem
           in the current working directory.

       -D  Include  discovery service information in the metadata.  By default, discovery service information is
           not included.

       -e entity-id
           The entity ID for this SP.  This must be a unique identifier for this SP and must be a URL.  If -o is
           given and -u is not given, entity-id is used as the URL for the organization running this  Shibboleth
           SP.   If  it is not specified, it defaults to "https://host/shibboleth" where host is the argument to
           the first -h option.

       -f format
           Include this NameIDFormat in the metadata.  This option may be given more than once.

       -h host
           A hostname for this SP (possibly a virtual host).  Either this option,  the  -n  option,  or  the  -l
           option  must  be specified at least once.  It should be repeated for every virtual host that responds
           to the Shibboleth protocol.  -h should be used for hostnames or virtual hosts that use SSL.

       -L  Include Single Logout information in the metadata.  This is not included by default.

       -l host-list
           Read the list of hostnames for this SP from a file.  Each line of the file will be treated as  if  it
           were  passed  as  an argument to the -h option to specify a hostname or virtual host that responds to
           the Shibboleth protocol and uses SSL.

       -N  Include NameID management information in the metadata.  This is not included by default.

       -n host
           A hostname for this SP (possibly a virtual host).  Either this option, the -h, or the -l option  must
           be  specified  at  least  once.   It  should  be repeated for every virtual host that responds to the
           Shibboleth protocol.  -n should be used for hostnames or virtual hosts that do not use SSL to protect
           the Shibboleth communication.

       -O  Include XML namespace declarations in the generated metadata.  This is the default.

       -o organization
           The name of the organization that runs this Shibboleth SP.  This option may be given  only  once  and
           may  be omitted, in which case organization metadata is not included.  This is normally not necessary
           but may be used by other software systems for purposes such as  displaying  lists  of  entities  with
           human-readable names.

       -s support
           A  support contact for this Shibboleth SP.  This option may be omitted, in which case support contact
           metadata is not included, or may be given multiple times to list multiple contacts.   support  should
           be in the form "first/last/email" where first is the given name and last is the surname.

       -t tech
           A  technical  contact  for  this  Shibboleth SP.  This option may be omitted, in which case technical
           contact metadata is not included, or may be given multiple times to  list  multiple  contacts.   tech
           should be in the form "first/last/email" where first is the given name and last is the surname.

       -u url
           Sets  the  URL for the organization.  This information is only used if the -o option is also given to
           specify the name of the organization.  If -o is given and -u is not given, the entity  ID  (set  with
           -e) is used as the organization URL.

AUTHOR

       This manual page was written by Russ Allbery for Debian GNU/Linux.

COPYRIGHT

       Copyright  2009,  2011  Russ  Allbery.   This  manual page is hereby placed into the public domain by its
       author.

3.5.0                                              2025-01-12                                  SHIB-METAGEN.1(1)