Create an Integration User

You can create a dedicated user for integrations between other products and OMi. This user enables a product that uses the OMi client SDK to be authenticated in the server SDK and execute the APIs. Applications written with this API set must log on with integration user credentials.

To create an integration user:

1. Launch the Web browser and enter the server address, as follows:

   http://<OMi_RTSM_Server_DNS_Name>:21212/jmx-console.

   You may have to log in with a user name and password.

2. Under UCMDB, click service=UCMDB Authorization Services.

3. Locate the createUser operation. This method accepts the following parameters:

   • customerId. The customer ID.

   • username. The integration user's name.

   • userDisplayName. The integration user's display name.

   • userLoginName. The integration user's login name.

   • password. The integration user's password.

4. Click Invoke.

5. Locate the grantRolesToUserForAllTenants method and enter the following parameters to assign the role in connection with all tenants:

   • userName. The integration user's name.

   • roles. SuperAdmin.

   Click Invoke.

   Alternatively, to assign the role in connection with specific tenants, invoke the grantRolesToUserForTenants method, using the same userName and roles parameter values. For the tenantNames parameter, enter the required tenants.

6. Either create more users, or close the JMX console.

7. Log on to OMi as an administrator.

8. From the Administration tab, run Package Manager.

9. Click the Create custom package icon.

10. Enter a name for the new package, and click Next.

11. In the Resource Selection tab, under Settings, click Users.

12. Select a user or users that you created using the JMX console.

13. Click Next and then Finish. Your new package appears in the Package Name list in Package Manager.

14. Deploy the package to the users who will run the API applications.

    For details, see the section Deploy a Package .

Note

The integration user is per customer. To create a stronger integration user for cross-customer usage, use a systemUser with the isSuperIntegrationUser flag set to true. Use the systemUser methods (removeUser, resetPassword, UserAuthenticate, and so on).

There are two out-of-the-box system users. It is recommended to change their passwords after installation using the resetPassword method.

• sysadmin/sysadmin

• UISysadmin/UISysadmin (this user is also the SuperIntegrationUser).

  If you change the UISysadmin password using resetPassword, you must do the following:

  1. In the JMX Console, locate the UCMDB-UI:name=UCMDB Integration service.

  2. Run setCMDBSuperIntegrationUser with the user name and new password of the integration user.