Add a role for an LDAP user

When an LDAP user has been assigned LDAP groups, at least one of those groups must map to a role in OpsCenter. Otherwise, the user cannot log in to OpsCenter.

Add a parallel role in OpsCenter that mirrors the name of one of the LDAP groups assigned to a user. OpsCenter grants the matching role to the user.

If the list of a user’s LDAP groups map to more than one role in OpsCenter, the user will be granted each of the listed roles, and their resulting OpsCenter permissions will be the merging of permissions for all of their OpsCenter roles.

The group_search_type property indicates which method is used to determine LDAP group membership:

  • If using directory_search, the group_search_filter_with_dn must return a list of LDAP roles that matches at least one of the OpsCenter roles.

  • If using memberof_search, the list of LDAP roles from the user’s memberof attribute must match at least one of the OpsCenter roles.

When LDAP is enabled, only role editing is supported in OpsCenter role-based security. Creating or editing users is disabled when LDAP is enabled because the users originate from LDAP and are managed therein. When creating or editing user roles, OpsCenter LDAP supports non-ASCII character sets for the role name. Because LDAP supports non-ASCII character sets for users, OpsCenter also supports non-ASCII character sets for users logging in to OpsCenter.

Only an OpsCenter admin can add roles.

  1. Configure the admin role in the opscenterd.conf file by setting the admin_group_name configuration option.

    For package installations, opscenterd.conf is located at /etc/opscenter/opscenterd.conf, and for tarball installations, it is located at INSTALL_DIRECTORY/conf/opscenterd.conf.

  2. Log in to OpsCenter with a user mapped to the admin role so you can add any needed roles.

  3. Click Settings > Roles.

    The Manage Roles dialog appears.

  4. Click Add Role.

  5. Select the cluster.

  6. Enter a role name.

  7. Select the appropriate permissions.

  8. Click Save.

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2025 | Privacy policy | Terms of use Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: Contact IBM