To create a reference to an existing external authentication domain from a database:

1. Select Authentication Domain Settings from the main navigation button.
2. This brings up the External Authentication Domains section.
3. Click Action > Create Authentication Domain.
4. This brings up the Entry Dialog window.

   

5. In the Domain Name field, enter a name used to define this external domain.
6. From the Authentication Source drop-down list, select the domain provider schema to use.
7. In the Template section, select the pre-defined template that matches your desired domain type.
8. Click OK.
9. The external domain reference will be created in DataSplice, and additional details will be displayed to the right in the Basic Options area. Complete the fields appropriately. In general, only the Connection Profile field will need to be selected.

   

   Option Name	Option Value
   Connection Profile	This is the connection profile being used to obtain database users and groups from. Note: This should be the name of the connection profile as it has been configured in the Database Connection Profiles section of the ADO.NET Data Source Plug-in configuration.
   Query Database Users	SQL statement used to retrieve the list of database users. The default statement assumes that the user name column is aliased to user_name and the users table is aliased to users_table.
   Query Database Groups	SQL statement used to retrieve the list of database groups. The default statement assumes that the group name column is aliased to group_name and the group table is aliased to groups_table.
   Query Database User-Group Associations	SQL statement used to retrieve the list of user-group associations. The default statement assumes that the user name is aliased to user_name and the group name column is aliased to group_name. It also assumes that the corresponding users table is aliased to users_table and the groups table is aliased to groups_table.

10. Click the Save Changes button .

To create a reference to an existing Active Directory domain:

1. Select Authentication Domain Settings from the main navigation button.
2. This brings up the External Authentication Domains section.
3. Click Action > Create Authentication Domain.
4. This brings up the Entry Dialog window.

   

5. In the Domain Name field, enter a name used to define this external domain.
6. From the Authentication Source drop-down list, select Windows Authentication Plug-in.
7. In the Template section, select Default.
8. Click OK.
9. The new external domain will be created, and additional details will be displayed to the right in the Basic Options area. Enter the field values appropriately.

   

   Option Name	Option Value
   User Name	A user of the desired Active Directory domain to be used to list the users and groups the domain contains. Note: For the domain setup to function correctly, this user must be a member of the intended domain and have appropriate access to the list of users and groups it contains.
   Password	The associated password for the user specified in the previous field.
   AD Domain Name	The drop-down list of accessible Active Directory domains. This list should be pre-populated with all visible Active Directory domains.

10. Active Directory properties, such as email, can be assigned to DataSplice attributes. If desired, this behavior is configured in the following Directory Attributes section. Click the Add button to create a new attribute definition entry. In the Attribute Name field, enter the DataSplice attribute to be assigned. In the Property Name field, enter the Active Directory property of interest.
11. Click the Save Changes button .

To create a reference to an existing MAXIMO® 5.x domain when using the integration plug-in version 2.x:

1. Select Authentication Domain Settings from the main navigation button.
2. This brings up the External Authentication Domains section.
3. Click Action > Create Authentication Domain.
4. This brings up the Entry Dialog window.

   

5. In the Domain Name field, enter a name used to define this external domain.
6. From the Authentication Source drop-down list, select MAXIMO 5.x Integration Plug-in.
7. In the Template section, select Default.
8. Click OK.
9. The new external domain will be created, and additional details will be displayed to the right in the Basic Options area. Enter the field values as desired.

   

   Option Name	Option Value
   User Name	A MAXIMO® user with adequate permissions to be able to list the users and groups in the system.
   Password	The associated password for the user specified in the previous field.
   Host	The MAXIMO® server name.
   Site	The MAXIMO® site.

10. Click the Save Changes button .

To display a MAXIMO® 5.x or 6.x domain when using the integration plug-in version 4.x:

1. Select Authentication Domain Settings from the main navigation button.
2. This brings up the External Authentication Domains section. Notice the read-only domain entry corresponding to the name given in the Authentication Domain Name field in the basic options section of the MAXIMO® integration plug-in.