table of contents
DACS_ADMIN(8) | DACS Web Services Manual | DACS_ADMIN(8) |
NAME¶
dacs_admin - DACS administration serviceSYNOPSIS¶
dacs_admin
[ dacsoptions[1]]
DESCRIPTION¶
This program is part of the DACS suite. The dacs_admin web service is a tool for administering various DACS resources at a jurisdiction. Providing both a browser-based interface and a simple, REST-oriented[2] HTTP interface that can be used by middleware, scripts, and web browsers, dacs_admin allows inspection (and sometimes modification) of a jurisdiction's access control rules, configuration directives, group definitions, DACS user accounts, revocation list, version information, authorization cache, DACS log files, user tracking records, and more. An administrator can manage a different jurisdiction simply by aiming a browser or other HTTP client at that jurisdiction's dacs_admin web service. Probably the best way to understand the tool is to simply use it interactively to browse through a jurisdiction's resources.•Some features of this program may
require JavaScript to be enabled in the browser.
•dacs_admin will eventually unify
and replace several existing different DACS administrative web
services. It may also include federation-wide functions, such as the
capability of adding a new jurisdiction.
Web Service Arguments¶
The following web service argument is always recognized: FORMATBy default, output is emitted in HTML. Several
varieties of XML output can be selected, however, using the FORMAT
argument (please refer to dacs(1)[4]).
Resources and Methods¶
The interface provided by dacs_admin allows various DACS resources to be examined and modified using standard HTTP methods (see RFC 2616[5]). Not all DACS resources may be accessible using dacs_admin and not all methods may be valid for some resources. In keeping with the REST architectural style, every persistent resource is identified by a URI ( RFC 2396[6] and RFC 3986[7]). Invoking the GET method on https://www.example.com/cgi-bin/dacs/dacs_admin, for example, will (assuming appropriate configuration and permission) return a list of root-level resources managed by dacs_admin. Invoking the GET method on a resource either returns a listing (by default, formatted as an HTML list or table) or an unadorned value (by default, formatted as an HTML encoded string). For instance, this URL might return a list of configuration directives and their current values:OPTIONS¶
Only the standard dacsoptions[1] command line arguments are recognized.FILES¶
dacs_admin.css[9]DIAGNOSTICS¶
The program exits 0 if everything was fine, 1 if an error occurred.SEE ALSO¶
dacsacl(1)[10], dacspasswd(1)[11], dacs.acls(5)[12], dacs_conf(8)[13], dacs_group(8)[14], dacs_list_jurisdictions(8)[15], dacs_passwd(8)[16], dacs_version(8)[17]AUTHOR¶
Distributed Systems Software ( www.dss.ca[18])COPYING¶
Copyright2003-2012 Distributed Systems Software. See the LICENSE[19] file that accompanies the distribution for licensing information.NOTES¶
- 1.
- dacsoptions
- 2.
- REST-oriented
- 3.
- ADMIN_IDENTITY
- 4.
- dacs(1)
- 5.
- RFC 2616
- 6.
- RFC 2396
- 7.
- RFC 3986
- 8.
- dacs_admin.dtd
- 9.
- dacs_admin.css
- 10.
- dacsacl(1)
- 11.
- dacspasswd(1)
- 12.
- dacs.acls(5)
- 13.
- dacs_conf(8)
- 14.
- dacs_group(8)
- 16.
- dacs_passwd(8)
- 17.
- dacs_version(8)
- 18.
- www.dss.ca
- 19.
- LICENSE
10/22/2012 | DACS 1.4.27b |