Skip to main content

Administrating MarkLogic Server

Creating a Role

To create a role, follow these steps:

  1. Click Security in the left tree menu. A list of security items appears.

  2. Click Roles.

  3. Click the Create tab.

  4. Type in a name for the role in the Role Name field.

  5. Type in a description for the role (optional).

  6. If you want to place the role into the named compartment, enter name of the compartment in the Compartment field. Compartments provide an additional level of organization and control by grouping together related roles. They act as a higher-level container for roles and can be used to define access privileges for a specific set of resources. For example, you may have a compartment called "Finance" that contains roles such as "Finance Manager," "Accountant," and "Auditor."

    If a document has any permissions (role/capability pairs) with roles that have a compartment, then the user must have those roles with each of the compartments (regardless of which permission they are in) to perform any of the capabilities.

  7. If the role is to be mapped to an LDAP group or an OAuth group, enter one or more group names in the External Names section. For details on external authorization, see External Security in Securing MarkLogic Server.

  8. Under the Roles section, select the roles from which this role will inherit.

  9. Under the Execute Privileges section, select from the available execute privileges to associate with the role.

  10. Under the URI Privileges section, select the available URI privileges to associate with the role.

  11. Create default permissions for this role (optional). Select a role and pair the role with the appropriate capability (read, insert, update). If there are more than 3 default permissions you want to add for this role, you can do so on the next screen after you click OK.

  12. Create default collections for this role (optional). Type in the collection URI for each collection you want to add to the role’s default collections. If there are more than 3 default permissions you want to add for this user, you can do so on the next screen after you click OK.

  13. Click OK.

The role is now added to the system and the Role Configuration page appears. If you want to add more default permissions or collections to the role, scroll down to the section for default permissions or collections.