|DACS_LIST_JURISDICTIONS(8)||DACS Web Services and CGI||DACS_LIST_JURISDICTIONS(8)|
dacs_list_jurisdictions — display information about DACS jurisdictions
This web service is part of the DACS suite.
The dacs_list_jurisdictions web service displays information, relative to the jurisdiction that receives the request, about its federation and other jurisdictions in that federation. Included are the federation's public encryption key and its unique instance identifier.
determines the type of output, with the default being HTML,
using the style sheet
The various flavours of XML,
a PHP format (see below),
and plain text (
TEXT) are supported.
One application of dacs_list_jurisdictions is to
assist middleware to generate a menu of jurisdictions for user authentication.
FORMAT is PHP,
a list of each jurisdiction that provides an authentication service is emitted
text/plain, one jurisdiction per line.
Each line has the format:
The string jname is the DACS jurisdiction name and url is the complete URL prefix for DACS web services at the jurisdiction. For example, invoking this URL:
might return the following response:
jurisdiction=INFOCARDS&host=https://example.com/infocards/cgi-bin/dacs&INFOCARDS jurisdiction=DEMO&host=https://example.com/demo/cgi-bin/dacs&DEMO jurisdiction=TEST&host=https://test.example.com/cgi-bin/dacs&TEST
When returned as an XML attribute, a public encryption key is a base-64 encoding of the PEM formatted key.
In addition to the standard CGI arguments, dacs_list_jurisdictions understands the following CGI arguments:
Limit the output to the specified jurisdiction name. As a special case, if the argument does not specify a jurisdiction name, only federation-scoped information will be returned.
If this argument is "
yes" (case insensitive)
only the federation's or a jurisdiction's public key (if known)
will be returned.
JURISDICTION is given and is not the empty string,
that jurisdiction name is selected;
JURISDICTION is given and is the empty string,
the federation is selected;
and if the argument is absent, the current jurisdiction is selected.
This argument currently requires
FORMAT to be
formatted key is returned.
Distributed Systems Software (www.dss.ca)
Copyright © 2003-2018 Distributed Systems Software.
file that accompanies the distribution
for licensing information.
|DACS Version 1.4.45||20-Jan-2021||DACS_LIST_JURISDICTIONS(8)|
|Table of Contents||
$Id: dacs_list_jurisdictions.8.xml 3016 2018-08-17 18:12:46Z brachman $