table of contents
DACS_LIST_JURISDICTI(8) | DACS Web Services Manual | DACS_LIST_JURISDICTI(8) |
NAME¶
dacs_list_jurisdictions - display information about DACS jurisdictions
SYNOPSIS¶
dacs_list_jurisdictions [dacsoptions[1]]
DESCRIPTION¶
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.
The FORMAT argument (see dacs.services(8)[2]) determines the type of output, with the default being HTML, using the style sheet dacs_list_jurisdictions.css[3]. The various flavours of XML, a PHP format (see below), JSON (RFC 7159[4]), 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. If FORMAT is PHP, a list of each jurisdiction that provides an authentication service is emitted (as text/plain, one jurisdiction per line. Each line has the format:
jurisdiction[]=jname&host[]=url&jname
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
The html/examples/login.php[5] template demonstrates this feature. If XML output is selected, a document conforming to dacs_list_jurisdictions.dtd[6] is returned.
When returned as an XML attribute, a public encryption key is a base-64 encoding of the PEM formatted key.
Note
This program is also available as a DACS utility, dacslist(1)[7]. Because dacs_admin(8)[8] provides the same functionality and more, dacs_list_jurisdictions may be removed in a future release.
Web Service Arguments¶
In addition to the standard CGI arguments[9], dacs_list_jurisdictions understands the following CGI arguments:
JURISDICTION
PUB_KEY_ONLY
Note
In the current implementation, a jurisdiction's public key can only be provided by one of the jurisdictions configured on the same host.
FILES¶
dacs_list_jurisdictions.css[3]
DIAGNOSTICS¶
The program exits 0 if everything was fine, 1 if an error occurred.
SEE ALSO¶
dacs(1)[14], dacskey(1)[15], dacslist(1)[7], dacs.groups(5)[16]
AUTHOR¶
Distributed Systems Software (www.dss.ca[17])
COPYING¶
Copyright © 2003-2014 Distributed Systems Software. See the LICENSE[18] file that accompanies the distribution for licensing information.
NOTES¶
- 1.
- dacsoptions
- 2.
- dacs.services(8)
- 3.
- dacs_list_jurisdictions.css
- 4.
- RFC 7159
- 5.
- html/examples/login.php
- 6.
- dacs_list_jurisdictions.dtd
- 7.
- dacslist(1)
- 8.
- dacs_admin(8)
- 9.
- standard CGI arguments
- 10.
- RFC 1421
- 11.
- RFC 1422
- 12.
- RFC 1423
- 13.
- RFC 1424
- 14.
- dacs(1)
- 15.
- dacskey(1)
- 16.
- dacs.groups(5)
- 17.
- www.dss.ca
- 18.
- LICENSE
08/23/2020 | DACS 1.4.40 |