Administer > Create a UCMDB Integration User

Create a UCMDB Integration User

You can create a dedicated user for integrations between other products and UCMDB. This user enables a product that uses the UCMDB 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.

Caution It is also possible to connect with a regular UCMDB user (for instance, admin). However, this option is not recommended. To connect with a UCMDB user, you must grant the user API authentication permission.

To create an integration user:

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

    https://localhost:8443/jmx-console

    You may have to log in with a user name and password (the default user name is sysadmin).

  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.

      The default password policy requires the password to include at least one of each of the four following types of characters:

      • Uppercase alphabetic characters
      • Lowercase alphabetic characters
      • Numeric characters
      • Symbol characters ,\:/. _?&%=+-[]()|

      It also requires the password to adhere to the minimum length, which is set by the Password minimum length infrastructure setting.

  4. Click Invoke.

  5. Locate the setRolesForUser method and enter the following parameters:

    • userName. The integration user's name.

    • roles. SuperAdmin.

    Click Invoke.

  6. Locate the setUserServerAdministratorValue method and enter the following parameters:

    • customerID. The customer ID.
    • userLoginName. The integration user's login name.
    • serverAdministratorValue. Select True.

    Click Invoke.

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

  8. 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. The system user should have the same user name and password as the integration user.