One Identity Safeguard for Privileged Passwords 2.9 - Administration Guide

Search box

The search box located at the top of the object list pane 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.
• 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 objects or object details

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.

   For example, enter T in the search box to search for items that contain the letter "T", or 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, 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

Accounts

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

Account Groups

• Name
• Description
• Dynamic

Assets

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

Asset Groups

• Name
• Description
• Dynamic

Entitlements

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

Partitions

• Name
• Description

Users

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

User Groups

• Name
• Description

Select a drop-down to sort

By default the objects are listed in alphabetical order; however, you can use the controls located above the list to sort the object list.

To sort the object lists

1. Select Ascending or Descending under the Search box to sort the list in either alphabetical or reverse-alphabetical order.
2. To sort the list of Accounts, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
   • Name (Default)
   • Description
   • Asset
   • Domain Name
   • Profile
   • Partition

3. To sort the list of Account Groups, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:

   • Name (Default)
   • Description
   • Dynamic
4. To sort the list of Assets, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
   • Name (Default)
   • Description
   • Platform
   • Network Address
   • Partition

5. To sort the list of Asset Groups, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:

   • Name (Default)
   • Description
   • Dynamic
6. To sort the list of Entitlements, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
   • Priority (Default)
   • Name
   • Description

7. To sort the list of Partitions, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:

   • Name (Default)
   • Description
8. To sort the list of Users, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
   • User Name (Default)
   • Description
   • First Name
   • Last Name
   • Email Address
   • Domain Name
9. To sort the list of User Groups, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
   • Name (Default)
   • Description
   • Type (Sorts by local and directory groups.)

Dashboard

The Dashboard contains operational information that allows administrators with the proper permissions to view and manage access requests and accounts failing tasks from a single location.

• Access Requests: Displays information about access requests in different stages of the workflow.
• Account Automation: Displays information about accounts that are failing different types of tasks.