Synchronizing a Datasource with Bentley IMS
Synchronization with Bentley IMS is optional.
You can synchronize the user list of a datasource with Bentley IMS when you want to quickly create new user accounts in ProjectWise that are based on existing Bentley IMS accounts in your organization.
These are the basic steps to synchronize:
- Request a special Bentley IMS account to be created, just for your organization, that has the ServiceIdentity role.
- Configure the service identity information in the DMSKRNL.CFG file.
- Synchronize.
Request a Bentley IMS Account with the Service Identity Role
In order to synchronize with Bentley IMS, you must contact Bentley and request to have a special Bentley IMS account created just for your organization to use with ProjectWise. This account must be associated with your organization, and it must have the Service Identity role. ProjectWise will then use this IMS account to search Bentley IMS for just the IMS accounts that belong to your organization.
The naming convention of the special Bentley IMS account will be:
<product/service>-<account name>ServiceIdentity@bentley.com
For example:
PWDI-ACMECOServiceIdentity@bentley.com
Enter the Service Identity Information in the DMSKRNL.CFG
Once you obtain the name (email address) and key (password) of this special IMS account from Bentley, enter that information in your ProjectWise server's the DMSKRNL.CFG file.
- Open a text editor with elevated privileges and open the DMSKRNL.CFG file.
- Find this section near the
bottom of the file:
;[imsSi1] ;IdentityProvider=<URL of identity provider: https://ims.bentley.com/> ;ImsServiceIdentityName=<YourImsServiceIdentity@bentley.com> ;ImsServiceIdentityKey=<Service Identity password> ;ImsServiceIdentityKeyDecrypt=<crypt type (set by server, enter 0 to reencrypt a plaintext service identity password)>
- Uncomment these lines
(remove the semi-colon) and define each line as needed.
For example:
[imsSi1] IdentityProvider=https://ims.bentley.com/ ImsServiceIdentityName=PWDI-ACMECOServiceIdentity@bentley.com ImsServiceIdentityKey=serviceIDpassword ImsServiceIdentityKeyDecrypt=0
- Once the service identity
section is configured, add the line
ImsServiceIdentities=imsSi1 to the
datasource-specific settings at the bottom of the
DMSKRNL.CFG
file:
[db0] Description=pwds Type=Microsoft SQL Server InterfaceType=ODBC Name=pwds_odbc DBUserName=pwuser DBUsrPwdDecrypt=5 DBUserPassword=AQAAANCMnd8BFdERjHoAwE/Cl+sB<..>AACR48NeiZIT+BN8TuYtQM7alw4z8A== SSO=1 STS=1 ImsServiceIdentities=imsSi1
Synchronize
- In
ProjectWise Administrator, right-click the
Users
node of your datasource and select
Synchronize Bentley IMS
Users.
A new Bentley IMS-based account is created in the datasource for each Bentley IMS account that belongs to your organization (the organization that is associated to the special Bentley IMS account that was used to synchronize with Bentley IMS).