Configuring a Local User Registry

A Local User Registry (LUR) can be configured to provide user authentication for both Cloud Manager and API Manager.

About this task

Local User Registries (LURs) are the default user registries included in API Connect. LURs are local databases included with API Connect. Two default LURs are installed and configured during installation of API Connect. They cannot be deleted. The default Admin user account is stored in the Provider LUR.

You can create and configure a new LUR. After you create it, you must set it as active in Settings > User Registries. See Selecting user registries for Cloud Manager and API Manager.

One of the following roles is required to configure user registries:

  • Administrator
  • Owner
  • Topology Administrator
  • Custom role with the Settings: Manage permissions

Procedure

Follow these steps to configure a new LUR:

  1. In the Cloud Manager, click Resources.
  2. Click Create in the User Registries section.
  3. Select Local User Registry as the type for the user registry and enter the following information:
    Field Description
    Title (required) Enter a descriptive name for use on the screen.
    Name (required) The name that is used in CLI commands. The name is auto-generated. For details of the CLI commands for managing user registries, see apic user-registries.
    Display Name (required) The name that is displayed for selection by the user when logging in to a user interface, or activating their API Manager account.

    For details of user interface log in, and account activation, see Accessing the Cloud Manager user interface, Accessing the API Manager user interface, and Activating your API Manager user account.

    Note: The Developer Portal uses the Title of the User Registries when rendering them at the login page, rather than the Display Name.
    Summary (optional) Enter a brief description.
    Case sensitive Select this setting if user names are case-sensitive.
    Note:

    The Developer Portal does not support case sensitive usernames.

    Note: After at least one user has been onboarded into the registry, you cannot change this setting.
  4. Click Save.

Results

The user registry is saved and is available to be configured for user authentication in Cloud Manager or API Manager by selecting it in Settings > User Registries. See Selecting user registries for Cloud Manager and API Manager.