Administrative Tools
The 
Administrative Tools allow you to add all the objects you need to write access request policies, such as users, accounts, and assets. From this view, you can also configure all of the Safeguard for Privileged Passwords settings.
NOTE: You must have administrator permissions to use the Administrative Tools and the administrator permissions you have determine what you can view and modify.
The navigation pane along the left side of the console gives you access to these administrative tools.
Table 14: Administrative Tools
| Toolbox |
Where you can gain quick access to all the tasks you can perform from a single portal |
Users with any Safeguard administrator privileges |
| Accounts |
Where you associate account identities with managed systems |
Asset Administrator or Auditor |
| Account Groups |
Where you define sets of accounts that you can add to the scope of an access request policy |
Auditor or Security Policy Administrator |
| Assets |
Where you add computers, servers, network devices, or applications to be managed by a Safeguard for Privileged Passwords Appliance |
Asset Administrator or Auditor |
| Asset Groups |
Where you define sets of assets that you can add to the scope of an access request policy |
Auditor or Security Policy Administrator |
| Discovery |
Where you configure asset and account discovery jobs which apply a set of rules to discover and automatically add assets and accounts to Safeguard for Privileged Passwords |
Auditor or Asset Administrator |
| Entitlements |
Where you specify the access request policies that restrict system access to authorized users |
Auditor or Security Policy Administrator |
| Partitions |
Where you define collections of assets that can be used to segregate assets for delegation |
Asset Administrator, Auditor, or delegated partition owner |
| Settings |
Where you configure Safeguard for Privileged Passwords to run backups, install updates, manage clusters, manage certificates, enable event notifications, configure external integration, define profile configurations settings, define user password rules, define discovery rules, and run troubleshooting tools. |
Users with any Safeguard administrator privileges; however, the settings available depend on the administrative permissions assigned. |
| Users |
Where you set up users who can log in to Safeguard for Privileged Passwords. |
Bootstrap, Asset Administrator, Auditor, Authorizer Administrator, Help Desk Administrator, Security Policy Administrator, or User Administrator |
| User Groups |
Where you define sets of Safeguard for Privileged Passwords users that you can add to an entitlement. |
Bootstrap, Auditor, Authorizer Administrator, Security Policy Administrator, or User Administrator |
All of the Administrative Tools views have the following components, except for the Toolbox and Settings:
- Toolbar options across the top of the view.
- Object list (left pane)
- Search box at the top of the object list.
- Details pane (right pane)
Toolbar options
The toolbar at the top of the views (except for the Toolbox and Settings), contain these options, depending on your Administrator permissions and the administrative tool you are in.
These buttons are available:
- Apply to apply the changes and keep the dialog open
- OK to apply the changes and close the dialog.
- Cancel to ignore any changes made, if any, and close the dialog.
Toolbar options include the following.
Add: Add objects to the Safeguard for Privileged Passwords appliance.
Delete: Remove objects from the appliance.
-
Refresh the screen.
NOTE: Whenever you add, modify, or delete an object in Administrative Tools, the changes you make cannot be seen by other administrators running Safeguard for Privileged Passwords on other clients unless they click Refresh.
Import : Only available for Accounts, Assets, and Users. Add a set of objects from a .csv file. For more information, see Importing objects.
User Security: Only available for Users. Menu options include Set Password and Unlock accounts. For more information about these options, refer to Setting a local user's password and Unlocking a user's account.
- Account Security: Only available for Accounts. Menu options include: Set Password, Check Password, and Change Password. For more information, see Checking, changing, or setting an account password.
Permissions: Only available for Users. Set administrator permissions for users. For more information, see Administrator permissions.
Set as Default: Only available for Partitions. Set a partition as the default. For more information, see Setting a default partition and Setting a default partition profile.
Download SSH Key: Only available for Assets. Add the SSH Key to the selected asset. For more information, see Downloading a public SSH key.
Password Archive: Only available for Accounts. Display the password history for the selected account. For more information, see Viewing password archive.
Access Requests: Only available for Accounts and Assets. Enable or disable access request services for the selected account or asset.
Show Disabled: Display the accounts or assets marked as disabled.
Hide Disabled: Hide the accounts or assets marked as disabled.
Sync Now: Only available for Assets. Run the directory addition and deletion synchronization process on demand. In addition, it runs through the discovery, if there are discovery rules and configurations set up.
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:
- 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
- Enter a text string in the Search box. As you type, the list displays items whose string attributes contain the text that was entered.
Examples:
- 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.
-
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 attribute and Select 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 more information about the API, see Using the API.
Entering the search string
-
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.
-
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.
-
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.
Accounts
- Name
- Description
- Asset
- Domain Name
- Profile
- Partition
- Tag
Account Groups
Assets
- Name
- Description
- Platform
- Forest Root Domain
- Network Address
- Partition
- Is Directory
- Tag
Asset Groups
Entitlements
- Priority
- Name
- Description
- Users Display Name
- Users Name
Partitions
Users
- User Name
- Description
- First Name
- Last Name
- Email Address
- Domain Name
User Groups
