Provided by: dacs_1.4.28b-3ubuntu1_amd64 
NAME
dacs.services - DACS web services
SYNOPSIS
dacswebservice [dacsoptions[1]]
DESCRIPTION
These web services are part of the DACS suite.
The following is a list of DACS web services with a brief description of each. General
aspects of DACS and its web services are discussed in dacs(1)[2]. Individual web services
are discussed in more detail elsewhere. By default, these CGI programs are installed in
the dacs subdirectory of the Apachecgi-bin directory.
By convention, DACS web service names use underscores as word separators. Some web
services have command counterparts; their names omit the underscores.
•
dacs_admin
A low-level administration tool for DACS.
[dacs_admin(8)[3]]
•
dacs_auth_agent
Authenticate by delegating responsibility to a trusted identity.
[dacs_auth_agent(8)[4]]
•
dacs_auth_transfer
Transfer credentials between federations.
[dacs_auth_transfer(8)[5]]
•
dacs_authenticate
The DACS authentication service.
[dacs_authenticate(8)[6]]
•
dacs_conf
Process and display DACS configuration files.
[dacs_conf(8)[7]]
•
dacs_current_credentials
Display elements of each set of credentials sent with the request.
[dacs_current_credentials(8)[8]]
•
dacs_group
A DACS group administration tool.
[dacs.groups(5)[9]]
•
dacs_list_jurisdictions
Display information about all jurisdictions in a federation.
[dacs_list_jurisdictions(8)[10]]
•
dacs_notices
Notice presentation and acknowledgement handler.
[dacs_notices(8)[11]]
•
dacs_passwd
Administration tool for passwords used by local_passwd_authenticate.
[dacs_passwd(8)[12]]
•
dacs_signout
Typically called from a browser, this web services causes one or more
cookies (each representing a DACS identity) to be deleted.
Cookies are automatically deleted when a browser terminates, but it
is sometimes useful to explicitly logoff.
[dacs_signout(8)[13]]
•
dacs_version
Display version information.
[dacsversion(8)[14]]
•
dacs_vfs
Manage items in the DACS virtual filestore.
[dacs_vfs(8)[15]]
•
local_*_authenticate
Authentication modules used by dacs_authenticate(8)[6].
Each one implements a particular authentication method and optionally
returns role information.
•
local_*_roles
Roles modules used by dacs_authenticate(8)[6].
Standard CGI Arguments for DACS Web Services
The following set of CGI arguments are recognized by most DACS web services. When the
document for a DACS web service says that it accepts "the standard CGI arguments", it is
referring to the following arguments; not all of these arguments are necessarily
meaningful to all web services, however.
In general, duplicate CGI argument names are not allowed; i.e., you cannot pass an
argument named DACS_JURISDICTION more than once when calling a DACS web service, even if
each occurrence of the argument has the same value.
DACS_JURISDICTION
This argument is required by most web services. It specifies the name of the
jurisdiction to which the request is being sent. Web services will verify that the
jurisdiction that receives the request is the same as the intended recipient.
DACS_VERSION
If this argument is present, it specifies the major DACS version number (e.g., 1.4)
expected by the client. The service request will fail if the DACS software does not
support this version number. If not provided, no compatibility checks are performed.
FILE
Reserved for future use for file uploading. Requests content type
application/x-dacs-credentials.
FORMAT
This optional argument requests a particular output format. The default value varies,
but it is usually HTML. Not all formats are supported by every web service; refer to
the manual page for details. The following values are recognized:
HTML
Requests content type text/html;
JSON
Requests content type application/json (JavaScript Object Notation, see
www.json.org[16] and RFC 4627[17]);
PHP
Used by the dacs_list_jurisdictions(8)[10] web service when its output is to
processed by PHP;
PLAIN
Requests content type text/plain;
TEXT
Like PLAIN except that no content type is specified;
XML
Requests content type text/xml. If the DTD_BASE_URL directive is configured, a
DOCTYPE element with the keyword SYSTEM followed by a value derived from
DTD_BASE_URL is emitted; e.g.,
<!DOCTYPE foo SYSTEM "http://fedroot.com/dacs/dtd-xsd/foo.dtd">
If DTD_BASE_URL is not configured, an internal DTD is emitted. A default xmlns
attribute is emitted in both cases;
XMLDTD
Requests content type text/xml This emits an internal DTD and default xmlns
attribute;
XMLSCHEMA
Requests content type text/xml. If the XSD_BASE_URL directive is configured,
xmlns:xsi and xsi:schemaLocation attributes are emitted, the former having a
compile-time value (e.g., "http://www.w3.org/2001/XMLSchema-instance") and the
latter being a pair, the first having the same value as the value of the xmlns
attribute and the second having a value derived from XSD_BASE_URL; e.g.,
<foo xmlns="http://fedroot.com/dacs/v1.4"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://fedroot.com/dacs/v1.4
http://amd.dss.bc.ca/dacs/dtd-xsd/foo.xsd">
The default xmlns attribute is also emitted. If XSD_BASE_URL is not configured,
only the default xmlns attribute is emitted; and
XMLSIMPLE
Requests content type text/xml Neither a DTD (no DOCTYPE) nor a default xmlns
attribute is emitted.
Also see the -format[18] command line flag (one of the dacsoptions[1]).
DIAGNOSTICS
Programs usually exit 0 if everything was fine, 1 if an error occurred.
AUTHOR
Distributed Systems Software (www.dss.ca[19])
COPYING
Copyright2003-2012 Distributed Systems Software. See the LICENSE[20] file that accompanies
the distribution for licensing information.
NOTES
1. dacsoptions
http://dacs.dss.ca/man/dacs.1.html#dacsoptions
2. dacs(1)
http://dacs.dss.ca/man/dacs.1.html
3. dacs_admin(8)
http://dacs.dss.ca/man/dacs_admin.8.html
4. dacs_auth_agent(8)
http://dacs.dss.ca/man/dacs_auth_agent.8.html
5. dacs_auth_transfer(8)
http://dacs.dss.ca/man/dacs_auth_transfer.8.html
6. dacs_authenticate(8)
http://dacs.dss.ca/man/dacs_authenticate.8.html
7. dacs_conf(8)
http://dacs.dss.ca/man/dacs_conf.8.html
8. dacs_current_credentials(8)
http://dacs.dss.ca/man/dacs_current_credentials.8.html
9. dacs.groups(5)
http://dacs.dss.ca/man/dacs.groups.5.html
10. dacs_list_jurisdictions(8)
http://dacs.dss.ca/man/dacs_list_jurisdictions.8.html
11. dacs_notices(8)
http://dacs.dss.ca/man/dacs_notices.8.html
12. dacs_passwd(8)
http://dacs.dss.ca/man/dacs_passwd.8.html
13. dacs_signout(8)
http://dacs.dss.ca/man/dacs_signout.8.html
14. dacsversion(8)
http://dacs.dss.ca/man/dacs_version.8.html
15. dacs_vfs(8)
http://dacs.dss.ca/man/dacs_vfs.8.html
16. www.json.org
http://www.json.org
17. RFC 4627
http://www.rfc-editor.org/rfc/rfc4627.txt
18. -format
http://dacs.dss.ca/man/dacs.1.html#format-arg
19. www.dss.ca
http://www.dss.ca
20. LICENSE
http://dacs.dss.ca/man/../misc/LICENSE