Tchater maintenant avec le support
Tchattez avec un ingénieur du support

One Identity Safeguard for Privileged Passwords 2.11 - User Guide

Search box

Whether you are using the desktop client or web client, the search box can be used to filter the data being displayed. When you enter a text string into the search box, the results include items that have a string attribute that contains the text that was entered. This same basic search functionality is also available for many of the detail panes and selection dialogs, allowing you to filter the data displayed in the associated pane or dialog.

When searching for objects in the object lists, an attribute search functionality is also available where you can filter the results, based on a specific attribute. That is, the search term matches if the specified attribute contains the text. To perform an attribute search, click the icon to select the attribute to be searched.

Rules for using the search functionality:

  • Search strings are not case-sensitive. Exception: in the web client, the Approvals and Reviews searches are case sensitive.
  • Wild cards are not allowed.
  • Try using quotes and omitting quotes. As you use the product, you will become familiar with the search requirements for the search fields you frequent. Safeguard may perform a general search (for example, omits quotes) or a literal search (for example, includes quotes). Example scenarios follow:

    • On the Settings pane, search strings must be an exact match because a literal search is performed. Do not add quotes or underlines. For example, from the Settings pane, enter password rules to return Safeguard Access | Password Rules. If you enter "password rules" or password_rules, the following message is returned: No matches found.
    • On the Users pane search box:

      • A general search does not return anything if you use quotes because it uses a literal search (searches for the quotes). For example: searching for "ab_misc2" returns the message: There is nothing to show here.
      • You can use quotes in an attribute search if there are spaces in the search name. For example, entering the following in the search box Username: "ab_misc2" returns: AB_misc2.
  • When multiple search strings are included, all search criteria must be met in order for an object to be included in the results list.
  • When you combine a basic search and an attribute search, the order they are entered into the search box matters. The attribute searches can be in any order, but the basic search must come after the attribute searches.
  • In large environments, you will see a result number to tell you how many objects match the criteria; however, only the first 200 objects will be retrieved from the server. When you scroll down the list, more objects will be retrieved (paged) as needed.

To search for accounts

  1. Enter a text string in the Search box. As you type, the list displays items whose string attributes contain the text that was entered.


    • Enter T in the search box to search for items that contain the letter "T".
    • Enter sse to list all items that contain the string "sse," (such as "Asset")

    Note:The status bar along the bottom of the console shows the number of items returned.

  2. To clear the search criteria, click  Clear.

    When you clear the search criteria, the original list of objects are displayed.

You can also Search by attributeSelect a drop-down to sort.

Search by attribute

The attributes available for searching are dependent on the type of object being searched. The search drop-down menu lists the attributes that can be selected.

API attributes can be searched

The drop-down menu lists a limited number of attributes that can be searched; however, you can perform an attribute search using the English name of any attribute as it appears in the API. Nested attributes can be chained together using a period (.). To see a list of all the attributes, see the API documentation. For information about the API, see How do I access the API.

Entering the search string

  1. Click the icon and select the attribute to be searched.

    The selected attribute is added to the search box. For example, if you select Last Name then LastName: is added to the search box.

  2. In the search box, enter the text string after the colon in the attribute label.

    You can specify multiple attributes, repeating these steps to add an additional attribute to the search box. Do not add punctuation marks, such as commas or colons, to separate the different attributes. When multiple attributes are included, all search criteria must be met in order for an object to be included in the results list.

    As you type, the list displays items whose selected attributes contain the text that was entered.

    Note:The status bar along the bottom of the console shows the number of items returned.

  3. To clear the search criteria, click Clear.

    When you clear the search criteria, the original list of objects are displayed.

Attributes in each Search box

The following attributes are available when you click the icon. In addition, API attributes can be searched in the search box.


  • Name
  • Description
  • Asset
  • Domain Name
  • Profile
  • Partition
  • Tag

Account Groups

  • Name
  • Description
  • Dynamic


  • Name
  • Description
  • Platform
  • Forest Root Domain
  • Network Address
  • Partition
  • Is Directory
  • Tag

Asset Groups

  • Name
  • Description
  • Dynamic


  • Priority
  • Name
  • Description
  • Users Display Name
  • Users Name


  • Name
  • Description


  • User Name
  • Description
  • First Name
  • Last Name
  • Email Address
  • Domain Name

User Groups

  • Name
  • Description

Using the web client

The web client is functionally similar to the desktop client end-user view and useful for requestors, reviewers, and approvers. Many administration functions are available as well. The web client uses a responsive UI design to adapt to the user's device, from desktops to tablets or mobile phones.

NOTE: In this documentation, you will see the following icons which denote the interface:

(web client)

(desktop client)

In the web client, to add or change your photo in the upper right, click the user avatar. Select the image file, then click Open.

The pages available to you display on the left. You will see Home and, based on your role, you may also see My Requests, Approvals, Reviews, Settings, or a combination of those.

You can show less of the left menu. In the upper left of the page, click to collapse or expand the menu.

You can customize the information you see on the pages. From the Home page, click Settings. For more information, see Settings, version, and Windows client (web client).

Home page

Click Home to go to the home page. Based on your role, the dashboard displays My Requests, Approvals, and Reviews, the number tasks in each queue, and the status of each task (for example, Available, Denied, Pending) as well as whether the task is Due Today.

You can perform the following from the Home page:

My Requests (web client)

If you are a requester, click My Requests to make a request or see information about requests.

To make a request

You must be an authorized user of an entitlement to create a request for the assets and accounts you need.

  1. Click My Requests to go to the My Request page.
  2. Follow the workflow steps. For more information, see Requesting a password release.

To create a favorite

You can create favorites for requests you make often. For more information, see Favorites (web client).

To view and manage requests

On the My Requests page, you can view the requests. Control the display using the following approaches:

  • Click Sort By then select to sort by Account Name, Asset Name, Due Next, Expiring Next, Most Recent, or Status.
  • Click sort up or sort down to sort in ascending or descending order.
  • Click Filters to filter by the status.
    • All: Requests in all states.
    • Available: Approved requests that are ready to view or copy.
    • Pending Approval: Requests that are waiting for approval
    • Approved: Requests that have been approved, but the checkout time has not arrived. Or, for pending accounts restored when using the Safeguard for Privileged Passwords suspend feature.
    • Revoked: Approved requests retracted by the approver. The approver can revoke a request after the request has become available.
    • Expired: Requests for which the checkout duration has elapsed.
    • Denied: Requests denied by the approver.
  • For more information, see Search box.
Documents connexes