Creating Organization in LDAP Repository

CA AuthMinder Administration Guide › Managing Organizations › Creating and Activating Organizations › Creating Organization in LDAP Repository

Creating Organization in LDAP Repository

To support LDAP user directories, create an organization in AuthMinder repository and then map the AuthMinder attributes with the LDAP attributes.

Perform the following steps:

Ensure that you are logged in with the required permissions and scope to create the organization.
Activate the Organizations tab.
Under the Manage Organizations section, click the Create Organization link to display the Create Organization page.
Enter the details of the organization, as discussed in the following table:

Field	Description

Organization Information
Organization Name	Enter the unique ID for the organization that you want to create. Note: You can use the Administration Console to log in to this organization, by specifying this value, not the Display Name of the organization.
Display Name	Enter a unique descriptive name for the organization. Note: This name appears on all other Administration Console pages and reports.
Description	Provide a description for the administrators who will manage this organization. Note: You can provide additional details for later reference for the organization by using this field.
Administrator Authentication Mechanism	Select the mechanism that will be used to authenticate administrators belonging to this organization. Administration Console supports the following three types of authentication mechanisms: Basic User Password This is the in-built authentication mechanism that is provided by Administration Console. If you select this option, then administrators log in to the Console by specifying their ID and plain text password. LDAP User Password The authentication policy is defined in the LDAP directory service. If you select this option, then administrators must use the credentials that are stored in LDAP to log in to the Console. WebFort Password This is the WebFort password authentication method. If you select this option, then the administrator credentials are issued and authenticated by AuthMinder Server.
Key Label Configuration
Use Global Key	This option is selected by default. Deselect this option if you want to override the Global Key Label you specified in the bootstrap process and specify a new label for software-based encryption.
Key Label	If you deselected the Use Global Key option, then specify the new key label that you want to use for the organization.
Storage Type	Indicates whether the encryption key is stored in the database (Software) or the HSM (Hardware).
Localization Configuration
Use Global Configuration	Select this option to use the localization parameters that are configured at the global level.
Date Time Format	If you deselected the Use Global Configuration option, then specify the Date Time format that you want to use.
Preferred Locale	If you deselected the Use Global Configuration option, then select a preferred locale.
User Data Location
Repository Type	Select Enterprise LDAP. By specifying this option, the user and administrator details for the new organization will be stored in the AuthMinder repository.
Custom Attributes
Name	Name of the custom attribute.
Value	Value of the custom attribute.

Click Next.
The Create Organization page to collect the LDAP repository details appears.
Enter the details, described in the following table, to connect to the LDAP repository.

Field	Description
Host Name	Enter the host name of the system where the LDAP repository is available.
Port Number	Enter the port number on which the LDAP repository service is listening.
Schema Name	Specify the LDAP schema used by the LDAP repository. This schema specifies the types of objects that an LDAP repository can contain, and specifies the mandatory and optional attributes of each object type. Typically, the schema name for Active Directory is user and for SunOne Directory it is user and inetorgperson.
Base Distinguished Name	Enter the base Distinguished Name of the LDAP repository. This value indicates the starting node in the LDAP hierarchy to search in the LDAP repository. For example, to search or retrieve a user with a DN of cn=rob laurie, ou=sunnyvale, o=arcot, c=us, you must specify the base DN as the following: ou=sunnyvale, o=arcot, c=us Note: Typically, this field is case-sensitive and searches all sub-nodes under the provided base DN.
Redirect Schema Name	Specify the name of the schema that provides the definition of the "member" attribute. This is an optional field. You can search for users in the LDAP repository using the Base DN defined for an organization. But this search only returns users belonging to the specific Organization Unit (OU). An LDAP administrator might want to create a group of users belonging to different Organization Units for controlling access to an entire group, and might want to search for users from different groups. When the administrator creates groups, user node DNs are stored in a "member" attribute within the group node. By default, UDS does not allow search and DN resolution based on attribute values. Redirection enables you to search for users belonging to different groups within LDAP, based on specific attribute values for a particular node. Typically, the redirect schema name for Active Directory is group and for SunOne directory it is groupofuniquenames.
Connection Type	Select the type of connection that you want to use between the Administration Console and the LDAP repository. Supported types are: TCP One-way SSL Two-way SSL
Login Name	Enter the complete distinguished name of the LDAP repository user who has the permission to log in to the repository server and manage the Base Distinguished Name. For example, uid=gt,dc=arcot,dc=com
Login Password	Enter the password of the user provided in the Login Name.
Server Trusted Root Certificate	Enter the path for the trusted root certificate who issued the SSL certificate to the LDAP server, by using the Browse button. This field is applicable if you selected One-way SSL or Two-way SSL in the Connection Type field.
Client Key Store Path	Enter the path for the key store that contains the client certificate and the corresponding key by using the Browse button. This field is applicable only if you selected Two-way SSL in the Connection Type field. Note: Upload either PKCS#12 or JKS key store type.
Client Key Store Password	Enter the password for the client key store, if the required SSL option is selected. This field is applicable only if you selected Two-way SSL in the Connection Type field.

Click Next to proceed.
The page to map the repository attributes appears.
On this page:
1. Select an attribute from the Arcot Database Attributes list, then select the appropriate attribute from the Enterprise LDAP Attributes list that must be mapped with the Arcot attribute, and click Map.
  Important! Mapping of the UserName attribute is compulsory. If you are using Active Directory, then map UserName to sAMAccountName. If you are using SunOne Directory, then map UserName to uid.
  For Active Directory, you must map STATUS to userAccountControl.
2. Repeat the process to map multiple attributes, until you finish mapping all the required attributes.
  Note: You do not need to map all the attributes in the Arcot Database Attributes list. Map only the attributes that you will use.
  
  The attributes that you have mapped are moved to the Mapped Attributes list.
  
  If required, you can unmap the attributes. If you want to unmap a single attribute at a time, then select the attribute and click Unmap. However, if you want to clear the Mapped Attribute list, then click Reset to unmap all the mapped attributes.
3. If you specified the Redirect Schema Name in the previous page, select the search attribute from the Redirect Search Attribute list.
  Typically, the attribute for Active Directory is member and for SunOne directory, it is uniquemember.
Click Next to proceed.
The Select Attribute(s) for Encryption page appears.
In the Attribute(s) for Encryption section, perform one of the following:
- Select Use Global Configuration if you want to use the global settings for your attribute encryption set configuration.
- Select the attributes that you want to encrypt from the Available Attributes for encryption list to add them to the Attributes Selected for encryption list.
  Click the > button to move selected attributes to the desired list. You can also click the >> button to move all attributes to the desired lists.
  
  Note: Hold the Ctrl key to select more than one attribute at a time.
Click Next.
The Add Administrators page appears.

Note: This page is not displayed, if all the administrators currently present in the system have scope to manage all organizations.

From the Available Administrators list, select the administrators who will manage the organization and click the > button to add the administrator to the Managing Administrators list.

The Available Administrators list displays all the administrators who can manage the new organization.

Note: If some administrators have scope to manage all organizations in the system, then the corresponding entries for those administrators are not displayed in this list.

The Managing Administrators list displays the administrators that you have selected to manage this organization.
Click Next to proceed.
The Configure Account Type page appears only if the logged-in administrator has account types to manage. If the logged-in administrator does not have any account types to manage, then the Configure Email/Telephone Type page appears.
1. In the Assign Account Types section, select account types from the Available list and click the > button to move them to the Selected list.
  The Configure Account Custom Attributes page appears.
2. Specify one or more attributes for the account.
Click Next to proceed.
The Activate Organization page appears.
Click Enable to activate the new organization.
A warning message appears.
Click OK to complete the process.
Refresh all deployed AuthMinder Server instances. See "Refreshing a Server Instance" for instructions about how to perform this procedure.

Information! If you have configured the attribute encryption set, account types, and email and telephone types while creating the organization, ensure that you refresh both the system configuration and organization cache. If you do not refresh the organization-level cache, the system gets into an unrecoverable state.