The API Gateway user store contains the configuration data for managing API Gateway user information. This topic introduces the concepts of API Gateway users, groups, and attributes. It explains how to manage these components on the Users screen in the Policy Studio.
Note | |
---|---|
API Gateway users provide access to the messages and services protected by the API Gateway. Whereas Admin Users provide access to the API Gateway configuration management features available in Policy Studio, Configuration Studio, and API Gateway Manager. For more details, see the Managing Admin Users topic. |
API Gateway users specify the user identity in the user store. This includes details such as the user name, password, and X.509 certificate. API Gateway users must be a member of at least one user group. In addition, users can specify optional attributes, and inherit attributes at the group level.
To view all existing users, select the Users and Groups -> Users node in the tree. The users are listed in the table on the main panel. You can find a specific user by entering a search string in the Filter field.
You can create API Gateway users on the Users page. Click the Add button on the right to view the Add User dialog.
Adding User Details
To specify the new user details, complete the following fields on the General tab:
-
User Name
Enter a name for the new user.
-
Password
Enter a password for the new user.
-
Confirm Password
Re-enter the user's password to confirm.
-
X.509 Cert
Click the X.509 Cert button to load the user's certificate from the Certificate Store.
Adding User Attributes
You can specify optional user attributes on the Attributes tab, which is explained in the next section.
You can specify attributes at the user level and at the group level on the Attributes tab. Attributes specify user configuration data (for example, attributes used to generate SAML attribute assertions).
Adding Attributes
The Attributes tab enables you to configure user attributes as simple name-value pairs. The following are examples of user attributes:
-
role=admin
-
email=niall@oracle.com
-
dept=eng
-
company=oracle
You can add user attributes by clicking the Add button. Enter the
attribute name, type, and value in the fields provided. The Encrypted
type refers to a string value that is encrypted using a well-known encryption
algorithm or cipher.
API Gateway user groups are containers that encapsulate one or more users. You can specify attributes at the group level, which are inherited by all group members. If a user is a member of more than one group, that user inherits attributes from all groups (the superset of attributes across the groups of which the user is a member).
To view all existing groups, select the Users and Groups -> Groups node in the tree. The user groups are listed in the table on the main panel. You can find a specific group by entering a search string the Filter field.
You can create user groups on the Groups page. Click the Add button on the right to view the Add Group dialog.
Adding Group Details
To specify the new group details, complete the following fields on the General tab:
-
Group Name
Enter a name for the new group.
-
Members
Click the Add button to display the Add Group Member dialog, and select the members to add to the group.
Adding Group Attributes
You can specify optional attributes at the group level on the Attributes tab. For more details, see the section called “Attributes”.
To edit details for a specific user or group, select it in the list, and click the Edit button on the right. Enter the updated details in the Edit User or Edit Group dialog.
To delete a specific user or group, select it in the list, and click the Remove button on the right. Alternatively, to delete all users or Groups, click the Remove All button. You are prompted to confirm all deletions.