Find 25.1
Find Administration Guide

# Configure Default User Roles

You can configure Find to set some default roles for users that do not have a valid Find role in the Community component.

You can use this option if you are using a Community component that authenticates by using a third-party repository (such as LDAP). In this case, the third-party repository handles the authentication, and Community creates the Find user when they log in for the first time.

NOTE: You cannot use this option to set default roles if you have configured Find to run with a reverse proxy (that is, when you set the `-Dserver.reverseProxy` system property. See Configure Find with a Reverse Proxy.

When you define default roles, Find applies the configured default roles to the new user when they log in for the first time. Find applies these roles in addition to any existing roles in Community.

NOTE: Find applies default roles only if the user does not have enough permissions in the Community component to log on to Find.

For example, if the user has only the `FindBI` role in Community, Find applies the default roles (for example `FindUser`) so that the user can log on. However, if the user has the `FindUser` role in Community, Find does not apply your default roles (even if the default role list also contains other roles).

To configure default user roles in Find

- Start Find with the Java run command, and include the following arguments:

      -Dfind.defaultRoles=list_of_roles

  where `list_of_roles` is a comma-separated list of the user roles that you want to assign by default to new users.

  For example:

      java -Dfind.defaultRoles=FindUser -Didol.find.home=C:\ProgramData\Find -Dserver.port=8080 -jar find.war -uriEncoding utf-8

If you run Find as a service on Windows, you can also add the same arguments to the `find.xml` file.

If you run Find as a service on Linux, you can add the argument to the existing arguments variable in `find.sh` for SystemV, `find.conf` for Upstart, or `find.service` for systemd.

When you modify the Find configuration by modifying the XML file or start scripts, you must restart Find to apply your configuration changes.

On Upstart, you must also run `initctl reload-configuration` before you restart, to apply the init file changes. You can then run `service find restart` to restart the service.

For more information on installing and running Find as a service on Windows or Linux, see Install Find.

Copyright 2015-2024 Open Text
Version 25.1 | Last updated January 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Find 25.1

Topic Title: Configure Default User Roles