You can use the ASDomainController example as a security domain controller when running the rest of the ActiveSpaces examples with security.
ASDomainController uses a security policy file to connect to a metaspace and become a security domain controller for the metaspace.
The ASDomainController example does not connect to any spaces or provide any functionality besides what is needed to act as a security domain controller. Once
ASDomainController successfully connects to a metaspace, it loops, waiting for user input to tell it to shut down.
The following examples show how to invoke ASDomainController for each of the API sets. If you do not start the example from the security subdirectory of the examples, be sure to enter the full path of the
example_policy.txt file.
Once the ASDomainController example starts, you can then start other examples using security.
ASDomainController acts as the security domain controller for the metaspace it connects to. In the above example invocation, the default metaspace named
ms is connected to by
ASDomainController. To have
ASDomainController act as the security domain controller for a different metaspace, use the
-metaspace command line argument to specify the name of the desired metaspace.
Once ASDomainController has started, it will displayed a short menu of options. The following options are allowed:
h - display command line help information
Using the example security policy file, example_policy.txt, you can easily enable user authentication using your local operating system for authentication. When user authentication is enabled, any of the examples, which are started with security using the security token file
exdomain_token.txt will prompt the user for their domain name, user name and password when trying to connect to a metaspace in the 'exdomain' security domain.