Creating a DNS Integrity Gateway user in Address Manager - Platform - BlueCat Gateway - 18.2.1

Gateway Installation Guide

BlueCat Gateway

Create an administrative user in Address Manager for the DNS Integrity Gateway.

Prerequisites: Before performing this task ensure you have already created the PortalGroup UDF for the Named User Object Type in Address Manager.

Create an DNS Integrity Gateway administrative user in Address Manager with access to the API and GUI. You must assign the user either the all or admin PortalGroup UDF value in order for the user to be able to view workflows on the DNS Integrity Gateway user interface.

By default, the PortalGroup UDF all value gives users access to all Gateway workflows; the admin value only permits access to a small subset of workflows.

To create a DNS Integrity Gateway user:

  1. Log in to Address Manager as an administrator.
  2. Select the Administration tab.
  3. Under User Management, click Users and Groups then click New.
  4. Under User, enter the name of the DNS Integrity Gateway user in the Username field.
  5. Under Authentication, type and confirm the user’s Address Manager password in the Password and Confirm Password fields.
  6. If you have defined authenticators, an Other check box and a drop-down menu open. To select an external authenticator, click Other and select an authenticator from the menu.
    If an external authenticator is used, the name in the Username field must match the user name on the remote authentication system.
  7. Under Extra Information, set the following:
    • E-mail Address—the user’s email address (required).
    • Phone Number—the user’s phone number.
  8. Under User Access, define the user type, security and history privileges, and access type:
    • Type of User—select Administrator or Non-Administrator.
      Note: Only Administrators can be added to DNS Integrity Gateway User Groups which allow for quick granting of permissions to DNS Integrity Gateway workflows and operations (optional).
      Note: The Security Privilege and History Privilege drop-down menus become unavailable upon section of the Administrator user type.
    • Access Type—select GUI and API.
    • X.509 Required—leave blank.
  9. Under Additional information, type all in the PortalGroup UDF field.
    Note: The PortalGroup UDF value can be any string. By default, DNS Integrity Gateway permissions include all and admin PortalGroup UDF values. You must enter the PortalGroup UDF value when granting workflow or REST endpoint permissions to DNS Integrity Gateway users via the DNS Integrity Gateway user interface or by modifying the permissions.json file in the <dns_integrity_gateway> directory.
  10. Under Change Control, add comments to describe the changes. By default, this step is optional but might be set as a requirement.
  11. Click Add to create the user and return to the Users and Groups page, or click Add Next to add another user.

The newly created DNS Integrity Gateway administrator will now be able to log in to the DNS Integrity Gateway user interface and have immediate access to the default workflows. For details, refer to Logging in to the DNS Integrity Gateway.