Versions Compared

Old Version 19

changes.mady.by.user Phillip Hanegan

Saved on

compared with

New Version Current

changes.mady.by.user Kim Landis

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Div
classbreadcrumbs

/wiki/spaces/E2D/pages/29982926  /  Installation and Configuration  /  Connecting to Directory Systems  /  Current: Connecting to IBM Domino

Insert excerpt
Connecting to Google AppsConnecting to
Google Apps
nopaneltrue

Insert excerpt
Amazon Web Services
Amazon Web Services
nopaneltrue

EmpowerID IBM Domino connector allows organizations to bring the user and group data in their IBM Domino system to EmpowerID, where it can be managed and synchronized with data in any connected back-end user directories. Once connected, you can manage this data from EmpowerID in the following ways:

  • Create new users
  • Edit user attributes
  • Delete users
  • Reset user passwords
  • Create new groups
  • Manage group membership
  • Delete groups

Additionally, EmpowerID provides Provisioning policies or Resource Entitlements that allow you to automatically provision Domino accounts for any person within your organization based on your policy requirements.


Info
titlePrerequisites

In order to connect EmpowerID to Domino, the following prerequisites need to be met:

  • IBM Domino version 9.0 or above
  • IBM Domino client installed on a 32-bit machine
  • IIS
  • EmpowerID Domino Web Service installed on the same machine as the Domino client. The installer for the EmpowerID Domino Web Service is a separate package that needs to be requested from EmpowerID.


Insert excerpt
Connecting to Active DirectoryConnecting to
Active Directory
nopaneltrue


This topic demonstrates how to connect EmpowerID to IBM Domino and is divided into the following activities:

  • Installing the EmpowerID Domino Web Services
  • Connecting EmpowerID to your Domino directory
  • Configuring the Domino Account Store

To install the EmpowerID Domino Web Service

  1. On a 32-bit machine with IIS, double-click the Lotus Notes Connector Service X.X.X.X msi to launch the EmpowerID Lotus Notes Service Setup wizard.

  2. Click Next to begin the installation.

  3. Accept the terms of the license agreement and click Next.
  4. Select the destination folder and click Next.
  5. In the Lotus Notes Server Configuration screen, do the following:
    1. Type YourDominoServerName/Domain in the Registration Server field, replacing "YourDominoServerName" with the name of your actual Domino server and "Domain" with the server's domain.
    2. Type /Domain in the Certifier Name field, replacing "Domain" with the server's domain.
    3. Click the Ellipses (...) for the CertifierID File field, browse to the data folder of your Domino installation (located by default at "C:\Program Files\IBM\Domino\data") and select cert.id.
    4. Click the Ellipses (...) for the ID File Location field, browse to the Domino folder of your Domino installation (located by default at "C:\Program Files\IBM\Domino\data"), select the data folder and click OK.
    5. Specify whether the short name is unique in your system by selecting True (recommended) or False from the Unique ShortName drop-down.
    6. Specify whether you are using an ID File by selecting True or False (recommended) from the No ID File drop-down.
    7. Select your mail system from the Mail System drop-down. Notes is the default.
    8. Type the domain of the mail system in the Mail Domain field, if it differs from the Domino server domain.
    9. Click Next.

  6. In the IIS Settings screen, do the following:
    1. Type the user name and password of the service identity in the Username and Password fields, respectively. These credentials need to be those of a Domino administrator with read and write permissions to the Domino database.
    2. Type the name of the Web site for the service in the IIS Web Site field.
    3. Click Next.

  7. Click Install and then click Finish when the installation completes.

After installing the EmpowerID Domino Web service, the next step is to connect EmpowerID to your IBM Domino Lotus directory.


To connect EmpowerID to your IBM Domino Lotus directory

  1. Log in to the EmpowerID Management Console as an administrator.
  2. Click the application icon and select Configuration Manager from the menu.
  3. In Configuration Manager, select the Account Stores node and then click the Add New button above the grid.
  4. In the Add New Security Boundary window that opens, select the Lotus Notes Security Boundary type from the drop-down list and then click OK.
  5. In the Account Store Details window that appears, do the following:
    1. Type a name for the connector in the Name field.
    2. Type the user name of the Domino administrator in the Domino Admin UserName field. This should be the user name you specified when installing the EmpowerID Domino Web service.
    3. Type password for the Domino administrator in the Domino Admin Password field.

    4. Type the URL for the EmpowerID Domino Web service you installed above in the ServiceUrl field. When setting the URL, be sure to specify "https" as the scheme and the version of EmpowerID Domino Web service you are using. The URL should look similar to the following example:

      Code Block
      languagebash
      themeDJango
      https://192.168.15.99/LotusNotes/LotusNoteService.svc/v1


    5. Type the Domino certifier password in the CertifierPassword field.
    6. Click Save.

  6. Back in the main screen of Configuration Manager, search for the account store you just created and then double-click it or right-click it and select Edit from the context menu. This opens the Account Store Details screen for the account store, which is where you specify how you want EmpowerID to manage the account store.


To configure the Domino account store

The Account Store Details screen contains three panes—the General pane, the Inventory pane, and the Group Membership Reconciliation pane—each with settings for configuring a different aspect of the Domino account store you just created. To view reference information about a particular pane, expand the drop-down for that pane.


Rw ui expands macro


Rw ui expand macro
titleGeneral Pane


false

This pane is used to set general configuration information for the Account Store.

Not all settings that appear in this pane are used with the Domino connector. The below information only references the applicable settings.

  • Account Store Name — This is the name you gave to the account store when you created it. To change this name, click the Edit button, enter a new name in the Account StoreFriendly Name window that appears and then click OK to close the window.

  • Resource System Name — This is the name of the resource system EmpowerID created for the account store. To change this name, click the Edit button, enter a new name in the Resource System Friendly Name window that appears and click OK.

  • Resource System Type — This is the type associated with the resource system. In EmpowerID, resource systems contain objects specific to the type. For Domino, the resource system type is "Lotus Notes." This value should not be changed.

  • Maximum Accounts per Person — This specifies the maximum number of user accounts from this domain that an EmpowerID Person can have linked to them. This prevents the possibility of a runaway error caused by a wrongly configured Join rule. It is recommended that this value be set to 1 unless users will have more than 1 account and you wish them to be joined to the same person.

  • Icon — This is the image icon that represents this account store in the EmpowerID user interfaces.

  • Enable Pass-Through Authentication — This allows domain authentication to be used for logging in to EmpowerID. Unless Simple Search is enabled, the domain\username format needs to be used.

  • Enable Simple Username Search for Pass-Through Authentication — Simple search works in conjunction with pass-through authentication to allow users to log in without specifying a domain name. When this is enabled, EmpowerID first checks to see if the user name entered exists within its Identity Warehouse and if so attempts to authenticate as that user. If a matching logon name exists but the login fails, EmpowerID then searches through all Accounts Stores where simple username search is enabled to find the correct user name and password combination. To enable this function, click the Enable Simple Username Search button to the left of the line and toggle it so that the green check is visible.

  • Allow Password Sync — Enables or disables the synchronization of password changes to user accounts in the domain based on password changes for the owning person object or another account owned by the person. This setting does not prevent password changes by users running the reset user account password workflows. To enable this function, click the Allow Password Sync button to the left of the line and toggle it so that the green check is visible.

  • Allow Person Provisioning — Allows or disallows EmpowerID Persons to be created from the user records discovered during inventory.

  • Enable Attribute Flow — Allows or disallows attribute changes to flow between EmpowerID and the account store.



Rw ui expand macro
titleInventory Pane


false

This pane is used to enable or disable inventory of the Account Store as well as to set the run schedule for the EmpowerID Inventory Job.

Not all settings that appear in this pane are used with the Domino connector. The below information only references the applicable settings.

  • Inventory Schedule — This is the time span that occurs before EmpowerID performs a complete inventory of the resource system. The default value is 10 minutes. You can change this at any time by clicking the Edit button.

  • Enable Inventory — This allows EmpowerID to inventory the Account Store. The Inventory Job must be enabled for inventory to occur. This is discussed further in the below section.

  • Inventory Provision Request Workflow — This is the request workflow that is initiated when new accounts are discovered via the inventory feature. If you set this workflow, the Allow Automatic Person Provision and Allow Automatic Join Provision flags described below are ignored. You can enable this feature by clicking the Edit button.

  • Allow Automatic Person Provision on Inventory — This allows EmpowerID to provision EmpowerID people for new accounts discovered during the inventory process if they meet the Provision Rule specified by the Custom_Account_InventoryInboxGetAccountsToProvision SQL stored procedure. This setting is discussed further in the below section.

  • Allow Automatic Person Join on Inventory — This allows EmpowerID to join newly discovered accounts to people during the inventory process if they meet the Join Rule as specified by the Custom_Account_InventoryInboxJoinBulk SQL stored procedure. This setting is discussed further in the below section.

  • RBAC-Assign Initial Group Membership On First Inventory — This setting pertains to Active Directory account stores only.




Rw ui expand macro
titleGroup Reconciliation Pane


false

This pane is used to enable or disable and schedule group membership reconciliation for the domain. When this function is enabled, EmpowerID dynamically manages the membership of the Account Store's groups, adding and removing users to and from groups based upon policy-based assignment rules.

Not all settings that appear in this pane are used with the Domino connector. The below information only references the applicable settings.

  • Membership Schedule — This is the time span that occurs before EmpowerID runs the Group Membership Reconciliation Job. The default value is 10 minutes. You can change this at any time by clicking the Edit button.

  • Enable this Functionality — Enables and disables group membership reconciliation on the Account Store.




  1. From the General pane of the Account Store Details screen, enable each desired feature by toggling the icon to the right of each feature from a red sphere to a green check box. For example, if you want EmpowerID to provision an EmpowerID Person for each Domino user, toggle the red sphere to the right of Allow Person Provisioning to a green check box.




  2. From the Inventory pane of the Account Store Details screen, do the following:

    Info

    EmpowerID recommends using the Account Inbox to provision Person objects from user accounts. The below information is included to make you aware of the option to provision during inventory.


    1. Toggle Allow Automatic Person Provision On Inventory to reflect your policy for the account store (red sphere for disable and green checkbox for enable). When enabled (and Allow Person Provisioning is enabled for the account store), EmpowerID will provision Person objects for all new accounts discovered during inventory in real-time, if they meet the conditions of your Provision rules.

      Tip
      iconfalse




    2. Toggle  Allow Automatic Person Join On Inventory to reflect your policy for the account store (red sphere for disable and green checkbox for enable). When enabled (and Allow Person Provisioning is enabled for the account store), EmpowerID will attempt to join any new accounts discovered during inventory — if it finds one that matches the conditions of the Join rules for the account store. If this setting is not enabled, EmpowerID will not join secondary accounts to an EmpowerID Person, but will instead provision new EmpowerID Persons for each of those additional accounts.

The last action to perform on this screen is to enable inventory. However, before doing so, it is important to configure the attribute flow rules for the account store and to enable the Account Inbox if batch processing of those accounts is desired.


To configure Attribute Flow rules

Tip
iconfalse




  1. Open a browser and log in to the EmpowerID Web application.
  2. From the Navigation Sidebar, expand Admin > Applications and Directories and click Attribute Flow Rules.

  3. From the Attribute Flow Rules page, click the Advanced Search drop-down button, enter the name of the account store for which you want to configure the flow rules and then click Search to filter the rules shown in the grid.




    Info

    The attributes from the EmpowerID Person object are displayed in the left column with the corresponding attributes from the account store displayed in the right column.


  4. To change the flow for an attribute, click the Attribute Flow drop-down located between the Person Attribute column and the External Directory Attribute column, and select the desired flow direction from the context menu.




  5. To change the score for any of the available CRUD operations (Create, Update and Delete), enter the new score in the appropriate field. By default, scores are weighted evenly, which means that a change to an attribute originating in one connected external directory has the same authority as a change to an attribute occurring in another connected external directory.

    Info

    EmpowerID only considers scores for attribute CRUD operations when multiple account stores with the same user records are connected to EmpowerID, such as would be the case if an HR System and Google Apps were being inventoried by EmpowerID.


Now that the attribute flow has been set, the next steps includes turning on and monitoring inventory.


To turn on inventory

  1. Return to the Account Store Details screen in Configuration Manager.

  2. Look over your settings one last time and when satisfied, turn on inventory by toggling the Enable Inventory button from a red sphere to a green check box.

If you are using the Account Inbox to provision or join the user accounts in IBM Domino to Empower Persons, you need to turn on the Account Inbox. This is demonstrated in the below section.

To enable the Account Inbox permanent workflow

  1. From the Navigation Sidebar of the EmpowerID Web interface, expand Admin > EmpowerID Servers and Settings and click Permanent Workflows.
  2. From the Permanent Workflows page, click the Display Name link for Account Inbox.



  3. From the View One page for the workflow that appears, click the edit link for the workflow.



  4. From the Permanent Workflow Details form that appears, select Enabled and then click Save. Based on the default settings applied to the workflow, EmpowerID will process 1000 of the user accounts in the Account Inbox every ten minutes, provisioning Person objects from those user accounts and joining them together based on the Join and Provision rules applied to the account store.


To monitor inventory

  1. From Navigation Sidebar, expand System Logs > Policy Inbox Logs and click Account Inbox.

    The Account Inbox page appears. This page provides tabbed views of all information related to processing new user accounts discovered in a connected account store during inventory. An explanation of these tabs follows.


  • Dashboard - This tab provides a quick summary of account inbox activity.
  • Not Processed - This tab displays a grid view of all inventoried user accounts not yet used to provision a new EmpowerID Person or joined to an existing Person. Any accounts that fail to meet the Join and Provision rules are displayed here as well.
  • Failed - This tab displays a grid view of any account joining or provisioning failures.
  • Ignored - This tab displays a grid view of all accounts ignored by the account inbox. Accounts are ignored if they do not qualify as user accounts.
  • Joined - This tab displays a grid view of all accounts joined to an EmpowerID Person. Joins occur based on the Join rules applied to the account store.
  • Processed - This tab displays a grid view of all accounts that have been used to either provision a new EmpowerID Person or joined to an existing EmpowerID Person.
  • Provisioned - This tab displays a grid view of all accounts that have been used to provision an EmpowerID Person. Provisioning occurs based on the Provision rules applied to the account store.
  • Orphans - This tab displays a grid view of all user accounts without an EmpowerID Person.
  • All - This tab displays a grid view of all user accounts and the status of those accounts in relation to the Account Inbox.




Div
stylefloat: left; position: fixed; top: 70px; padding: 5px;
idtoc
classtopicTOC


Div
stylemargin-left: 40px; margin-bottom: 40px;

Live Search
spaceKeyE2D
placeholderSearch the documentation
typepage


Div
stylefont-size: 1rem; margin-bottom: -15px; margin-left: 40px;text-transform: uppercase;

In this article



Table of Contents
stylenone