Copying UrbanCode Deploy authentication and authorization realms into UrbanCode Velocity#

Transfer authentication and authorization realm settings from UrbanCode Deploy to UrbanCode™ Velocity.

You must have both the authentication and authorization realms created in UrbanCode Deploy before you can copy them into UrbanCode Velocity. This task requires that you are an UrbanCode Deploy and UrbanCode Velocity administrator.

1. From the UrbanCode Deploy home page, click Settings > Authentication (Users), and then click the required authentication realm.

2. Click the arrow to the left of Edit to display the authentication realm fields to be copied into the UrbanCode Velocity fields.

3. From the UrbanCode Velocity home page, click Settings > User Authentication.

4. Copy information from the UrbanCode Deploy authentication realm fields to the UrbanCode Velocity fields, as described in the following table.

   UrbanCode Deploy authentication realm field	UrbanCode Velocity field
   Name	Name
   Description	Description
   LDAP URL	LDAP URL
   Search Anonymously	Search Anonymously Note: Match selection to UrbanCode Deploy field.
   Search Connection DN	Bind DN
   Search Connection Password	Bind credentials
   User Search Base	Search base
   User Search Filter	Search filter Note: Do not copy the User Search Filter field. In the Search filter field, enter mail={{username}}.
   Name Attribute	Name Attribute
   Email Attribute	Email Attribute

5. Match the Search User Subtree selection with the Scope when searching LDAP users selection.

   If Search User Subtree and Subtree are not selected, follow these guidelines for making a selection in the Scope when searching LDAP users field:

   Options
   One level indicates that only the immediate children of the entry that is specified as the search base are considered. The base entry itself is not considered, nor any descendants of the immediate children of the base entry.
   Base indicates that only the entry that is specified as the search base is considered. None of its subordinates are considered.

6. From the UrbanCode Deploy home page, click Settings > Authorization (Groups), and then click the required authorization realm.

7. Click Edit for the required authorization realm to display the fields to be copied into the UrbanCode Velocity fields.

   For the following steps, you will be copying information from the UrbanCode Deploy authorization realm fields displayed in the Create Authorization Realm fields to the UrbanCode Velocity fields.

8. Copy information from the UrbanCode Deploy authorization realm fields to the UrbanCode Velocity fields, as described in the following table.

   UrbanCode Deploy authorization realm field	UrbanCode Velocity field
   Group Search Base	Group Search Base
   Group Search Filter	Group Search Filter Note: Do not copy the Group Search Filter field, enter member={{dn}}
   Group Name	Group Name Attribute
   Search Group Subtree	Search Group Subtree Note: Match selection to UrbanCode Deploy field.
   User Group Attribute	User Group Attribute

9. Click Save on the User authentication page in UrbanCode Velocity.

Parent topic: Authenticating users with LDAP