dacs.java(7) [linux man page]

DACS.JAVA(7)						  DACS Miscellaneous Information					      DACS.JAVA(7)

NAME

       dacs.java - DACS Java support

DESCRIPTION

       This document describes support for Java provided by DACS.

       To enable Java support, DACS must be configured using the --enable-java flag. It may also be necessary to specify the location of the Java
       commands and include files. See dacs.install(7)[1].

	   Note
	   Java support is currently very limited and should be considered experimental. It is currently only possible to call dacsauth(1)[2] and
	   dacscheck(1)[3] using the Java Native Interface (JNI) provided. The command line arguments to both of these commands are exactly as
	   documented in their manual pages. Each argument is passed as a String.

	   The code is not thread-safe and is probably not suitable for being called many times within a particular process due to assumptions it
	   makes about dynamic memory allocation.

	   There are no immediate plans to improve or extend Java support. Using the existing capability to build the JNI layer, however, it
	   should not be difficult for an experienced Java programmer to build upon the example Java code provided.

       With Java support enabled, building DACS will copy the JNI shared library and a .jar file to the library directory (default:
       /usr/local/dacs/lib), and the JNI include files to the include directory (default: /usr/local/dacs/include).

       The tools/java/jni distribution directory contains a simple script called javarun that demonstrates how to run dacsauth or dacscheck as a
       Java application. For example, to validate the Unix password for user somebody, run (as root):

	   ./javarun dacsauth -m unix suff -user somebody -prompt

DIAGNOSTICS

       The return codes are as documented in the command's manual page.

AUTHOR

       Distributed Systems Software (www.dss.ca[4])

COPYING

       Copyright2003-2012 Distributed Systems Software. See the LICENSE[5] file that accompanies the distribution for licensing information.

NOTES

	1. dacs.install(7)
	   http://dacs.dss.ca/man/dacs.install.7.html

	2. dacsauth(1)
	   http://dacs.dss.ca/man/dacsauth.1.html

	3. dacscheck(1)
	   http://dacs.dss.ca/man/dacscheck.1.html

	4. www.dss.ca
	   http://www.dss.ca

	5. LICENSE
	   http://dacs.dss.ca/man/../misc/LICENSE

DACS 1.4.27b							    10/22/2012							      DACS.JAVA(7)

DACS_STS(8)						     DACS Web Services Manual						       DACS_STS(8)

NAME

       dacs_sts - Secure Token Service for managed Information Cards

SYNOPSIS

       dacs_sts [dacsoptions[1]]

DESCRIPTION

       This program is part of the DACS suite.

       The dacs_sts web service is the Secure Token Service for DACS's managed Information Cards.

       Refer to dacs_managed_infocard(8)[2] for additional information.

	   Security
	   Depending on the application, consider adding a custom access control rule for dacs_sts (e.g., to limit access to a particular host or
	   subnet, or even certain identities).

   Configuration
       The following configuration variables are available:

       infocard_sts_password
	   For managed InfoCards generated with a INFOCARD_STS_AUTH_TYPE[3] of "passwd" and an INFOCARD_STS_PASSWORD_METHOD[4] of "sts", this is
	   the global user password that must be provided. Changing this password affects all managed InfoCard accounts.

OPTIONS

   Web Service Arguments
       None.

DIAGNOSTICS

       The program exits 0 if everything was fine, 1 if an error occurred.

BUGS

       Secure token replay detection is not yet implemented.

       As this is a relatively new and complicated feature, please test carefully.

SEE ALSO

       dacsinfocard(1)[5], dacs.conf(5)[6], dacs_authenticate(8)[7], dacs_infocard(8)[8], dacs_managed_infocard(8)[2], dacs_mex(8)[9], Using
       InfoCards With DACS[10]

AUTHOR

       Distributed Systems Software (www.dss.ca[11])

COPYING

       Copyright2003-2012 Distributed Systems Software. See the LICENSE[12] file that accompanies the distribution for licensing information.

NOTES

	1. dacsoptions
	   http://dacs.dss.ca/man/dacs.1.html#dacsoptions

	2. dacs_managed_infocard(8)
	   http://dacs.dss.ca/man/dacs_managed_infocard.8.html

	3. INFOCARD_STS_AUTH_TYPE
	   http://dacs.dss.ca/man/dacs.conf.5.html#INFOCARD_STS_AUTH_TYPE

	4. INFOCARD_STS_PASSWORD_METHOD
	   http://dacs.dss.ca/man/dacs.conf.5.html#INFOCARD_STS_PASSWORD_METHOD

	5. dacsinfocard(1)
	   http://dacs.dss.ca/man/dacsinfocard.1.html

	6. dacs.conf(5)
	   http://dacs.dss.ca/man/dacs.conf.5.html

	7. dacs_authenticate(8)
	   http://dacs.dss.ca/man/dacs_authenticate.8.html

	8. dacs_infocard(8)
	   http://dacs.dss.ca/man/dacs_infocard.8.html

	9. dacs_mex(8)
	   http://dacs.dss.ca/man/dacs_mex.8.html

       10. Using InfoCards With DACS
	   http://dacs.dss.ca/man/using-infocards-with-dacs.html

       11. www.dss.ca
	   http://www.dss.ca

       12. LICENSE
	   http://dacs.dss.ca/man/../misc/LICENSE

DACS 1.4.27b							    10/22/2012							       DACS_STS(8)