Chat now with support
Chat with Support

One Identity Safeguard for Privileged Passwords 7.4.1 - Administration Guide

Introduction System requirements and versions Using API and PowerShell tools Using the virtual appliance and web management console Cloud deployment considerations Setting up Safeguard for Privileged Passwords for the first time Using the web client Home page Privileged access requests Appliance Management
Appliance Backup and Retention Certificates Cluster Global Services External Integration Real-Time Reports Safeguard Access Appliance Management Settings
Asset Management
Account Automation Accounts Assets Partitions Discovery Profiles Tags Registered Connectors Custom platforms Importing objects
Security Policy Management
Access Request Activity Account Groups Application to Application Cloud Assistant Asset Groups Entitlements Linked Accounts User Groups Security Policy Settings
User Management Reports Disaster recovery and clusters Administrator permissions Preparing systems for management Troubleshooting Frequently asked questions Appendix A: Safeguard ports Appendix B: SPP and SPS join guidance Appendix C: Regular Expressions

Account Discovery

Account Discovery jobs include the rules SPP uses to perform account discovery against assets. When you add an Account Discovery job, you can identify whether or not to automatically manage found accounts, whether to discover services, and whether to automatically configure dependent systems.

The accounts in the scope of the discovery job may include accounts that were previously added (manually) to the Safeguard partition. For more information, see Adding an account..

To configure and schedule Account Discovery jobs, perform one of the following:

  • You can create or edit an Account Discovery job, then associate assets to the Account Discovery job via the Occurrences button.

    IMPORTANT: You must click Occurrences to associate assets to the Account Discovery job. If you do not associate the assets to the Account Discovery job, the accounts will not be found.

  • You can create or edit an asset and, in the process, assign or create an Account Discovery job. For more information, see Adding an asset.
Supported platforms

SPP supports account discovery on the following platforms:

  • AIX
  • HP-UX
  • Linux / Unix (based)
  • MAC OS X
  • Solaris
  • Starling Connect
  • Windows (services and tasks)
  • MySQL
  • Postgres
  • SQL Server
  • Oracle
  • iDrac
  • HP iLO
  • HP iLO MP
Properties and toolbar

Go to Account Discovery:

  • web client: Navigate to Asset Management > Discovery > Accounts.

Use these toolbar buttons to manage the Account Discovery jobs.

Table 137: Account Discovery: Toolbar
Option Description
New Account Discovery Job

Add an Account Discovery job. For more information, see Adding an Account Discovery job.

Delete

Delete the selected Account Discovery job.

View Details

Modify the selected Account Discovery job. You can also double-click a row to open the edit dialog.

Discover Accounts

Discover the accounts on the selected Account Discovery job. Select the asset on the Asset dialog. A Task pop-up displays which shows the progress and completion.

Discover Services

Discover the services on the selected Account Discovery job. Select the asset on the Asset dialog. A Task pop-up displays which shows the progress and completion.

Occurrences

Add, delete, or refresh the assets associated with the Account Discovery job.

IMPORTANT: You must associate the assets to the Account Discovery job for the accounts to be found.

Export

Use this button to export the listed data as either a JSON or CSV file. For more information, see Exporting data.

Refresh

Update the list of Account Discovery jobs.

Search

Enter the character string to be used to search for a match. For more information, see Search box..

Account Discovery jobs display in the grid.

Table 138: Account Discovery: Account Discovery job grid
Name Name of the discovery job.
Created By The creator of the job.
Discovery Type The type of discovery performed, for example, Windows, Unix, Starling Connect, or Directory.
Directory The directory on which the discovery job runs.
Partition

The partition in which to manage the discovered assets or accounts.

Schedule

Designates when the discovery job runs.

Discover Services

A check mark displays if the job will discover service accounts.

Auto Configure

A check mark displays if the accounts that are discovered in the Service Discovery job are automatically configured as dependent accounts on the asset.

Assets

Total number of assets assigned to the Account Discovery job. A Caution displays if no accounts are assigned to the Account Discovery job therefore no data will be discovered.

Description

The description of the discovery job.

Account Discovery job workflow

SPP's Account Discovery jobs discover accounts of the assets that are in the scope of a profile. Account Discovery jobs can be assigned to multiple assets in the same partition. Account Discovery jobs can include service discovery.

You can configure, schedule, test, and run Account Discovery jobs. After the job has run, you can select whether to manage the account, if it was not identified to be automatically managed.

  1. Create an Account Discovery job and associate assets or create an asset and associate the Account Discovery job. For more information, see Adding an Account Discovery job and Adding an asset.

  2. Account Discovery jobs can be scheduled to run automatically. In addition, you can manually launch these jobs in any of the following ways:

    • From Asset Management > Discovery > Accounts, click Discover Accounts or Discover Services.

    • From Asset Management > Assets > View Details, click Discover Accounts.

  3. After the Account Discovery job runs, you can mark the managed accounts from Discovery > Discovered Items > Accounts:

    • Click Disable to prevent SPP from managing the selected account.

    • Click Enable to manage the selected account and assign it to the scope of the default profile.

For information about discovery jobs that have run, search the Activity Center. SPP lists the account discovery events in the Account Discovery Activity category.

Adding an Account Discovery job

It is the responsibility of the Asset Administrator or the partition's delegated administrator to configure the rules that govern how SPP performs account discovery. For more information, see Account Discovery job workflow..

To add an Account Discovery job

  1. Navigate to Asset Management > Discovery > Accounts.
  2. Click  New Account Discovery Job to open the New Account Discovery Job dialog.
  3. On the General tab, enter the following information:
    • Name: Enter a name for the account discovery job.
    • Description: Enter a description of the account discovery job.

    • Partition: Use Browse to select the partition in which to manage the discovered accounts. You can also add a new partition from the Select a Partition dialog (accessed via the Browse button) by clicking New Partition.

      IMPORTANT: You cannot change the partition after you save this discovery job.

  4. On the Information tab, enter the following information:

    • Discovery Type: Select the platform (Directory, Role Based, SPS, Starling Connect, Unix, or Windows). Make sure the Discovery Type is valid for the assets associated with the partition selected on the General tab.

    • Discover Services: (For Windows accounts only and deselected by default) Select this check box so that when the discovery job is run, services are discovered.

      If Discover Services is selected, the Automatically Configure Dependent Systems check box is also available. Select this check box so that any directory accounts that are discovered in the Service Discovery job are automatically configured as dependent accounts on the asset where the service or task was discovered. Once dependencies are found they can only be removed manually from Account Dependencies tab (asset).

  5. The Account Discovery Rules tab is only available after an account discovery job has been created. For more information, see Adding an Account Discovery rule.

  6. On the Schedule tab, enter the following information:

    • Select a time frame:

      • Never: The job will not run according to a set schedule. You can still manually run the job.
      • Minutes: The job runs per the frequency of minutes you specify. For example, Run Every 30/Minutes runs the job every half hour over a 24-hour period. It is recommended you do not use the frequency of minutes except in unusual situations, such as testing.

      • Hours: The job runs per the minute setting you specify. For example, if it is 9 a.m. and you want to run the job every two hours at 15 minutes past the hour starting at 9:15 a.m., select Run Every 2/Hours/@ minutes after the hour 15.

      • Days: The job runs on the frequency of days and the time you enter.

        For example, Run Every 2/Days/Starting @ 11:59:00 PM runs the job every other evening just before midnight.

      • Weeks The job runs per the frequency of weeks at the time and on the days you specify.

        For example, Run Every 2/Weeks/Starting @ 5:00:00 AM and Repeat on these days with MON, WED, FRI selected runs the job every other week at 5 a.m. on Monday, Wednesday, and Friday.

      • Months: The job runs on the frequency of months at the time and on the day you specify.

        For example, If you select Run Every 2/Months/Starting @ 1:00:00 AM along with Day of Week of Month/First/Saturday, the job will run at 1 a.m. on the first Saturday of every other month.

    • Select Use Time Windows if you want to enter the Start and End time. You can click Add or Remove to control multiple time restrictions. Each time window must be at least one minute apart and not overlap.

      For example, for a job to run every ten minutes every day from 10 p.m. to 2 a.m., enter these values:

      Enter Run Every 10/Minutes and set Use Time Windows:

      • Start 10:00:00 PM and End 11:59:00 PM

      • Start 12:00:00 AM and End 2:00:00 AM

        An entry of Start 10:00:00 PM and End 2:00:00 AM will result in an error as the end time must be after the start time.

      If you have selected Days, Weeks, or Months, you will be able to select the number of times for the job to Repeat in the time window you enter.

      For a job to run two times every other day at 10:30 am between the hours of 4 a.m. and 8 p.m., enter these values:

      For days, enter Run Every 2/Days and set Use Time Windows as Start 4:00:00 AM and End 8:00:00 PM and Repeat 2.

    If the scheduler is unable to complete a task within the scheduled interval, when it finishes execution of the task, it is rescheduled for the next immediate interval.

  7. Click OK.

    NOTE: Once you have a saved the new account discovery job, the Account Discovery Rules tab will be available and you can add, delete, edit or copy rules. For more information, see Adding an Account Discovery rule..

  8. Select the assets to which the account discovery rule applies using one of these approaches:

Adding an Account Discovery rule

Use the Account Discovery Rule dialog to define the search criteria to be used to discover directory accounts.

You can dynamically tag an account from Active Directory. In addition, you can add a dynamic account group based on membership in an Active Directory group or if the account is in a organizational unit (OU) in Active Directory.

NOTE: For Unix, all search terms return exact matches. A user name search for ADM only returns ADM, not AADMM or 1ADM2. To find all names that contain ADM, you must include ".*" in the search term; like this: .*ADM.*.

For Windows and Directory, the search terms is contained in the result. A user name search for ADM returns ADM, AADMM, and 1ADM2.

All search terms are case sensitive. On Windows platforms (which are case insensitive), to find all accounts that start with adm, regardless of case, you must enter [Aa][Dd][Mm].*.

To add an Account Discovery rule

  1. Navigate to Asset Management > Discovery > Accounts.
  2. Select an existing account discovery job, and click View Details.
  3. On the Account Discovery Rules tab, click  Edit.
  4. Click Add to open the New Account Discovery Rule dialog.
  5. Name: Enter a unique name for the account discovery rule. Limit: 50 characters.

  6. Find By: Select one of the types of search below.

    If the Discovery Type on the previous Account Discovery dialog is Windows, Unix, or Role Based; you can search by Constraints or Find All. The search options Name, Group, and LDAP Filter are only available if the Discovery Type is Directory.

      • Name: Select this option to search by account name.
        • For a regular search (not directory), in Contains enter the characters to search.
        • If you are searching a directory:
          • Select Start With or Contains and enter the characters used to search subset within the forest.
            When using Active Directory for a search, you can use a full ambiguous name resolution (ANR) search. Type a full or partial account name. You can only enter a single string (full or partial account name) at a time. For example, entering "t" will return all account names that begin with the letter "t": Timothy, Tom, Ted, and so on. But entering "Tim, Tom, Ted" will return no results.
          • Click Browse to select the container to search within the directory. The location displays in Filter Search Location.
          • Select Include objects from sub containers to include sub containers in the search.
          • Click Preview then verify the search result in the Accounts dialog including Name and Domain Name.
      • Group: Select this option to search by group name.
        • Click  Add to launch the Group dialog.

        • Starts withor Contains: Enter a full or partial group name and click Search. You can only enter a single string (full or partial group name) at a time.

        • Filter Search Location. Click Browse to select a container to search within the directory.
        • Include objects from sub containers: Select this check box to include child objects.
        • Select the group to add: The results of the search displays in this grid. Select one or more groups to add to the discovery job.
        • Click Preview then verify the search result in the Accounts dialog including Name and Domain Name.

      • Constraints: Select this option to search for accounts based on an account's property. All are limited to 255 numeric characters.

        IMPORTANT: Some Property Constraint selections may give slow results. Using Group is especially discouraged.

        NOTE: Not all constraints will be available for all platforms. For example, while both MySql and Oracle are Role Based discovery types, MySql only supports searching on Permissions while Oracle supports both Roles and Permissions.

        • Selections:

          • RID (ranges): Applies to Windows and Directory (Windows Active Directory). Enter one or more Relative Identifier numbers. To enter multiple IDs or ID ranges, you must enter each element of the list separated by a space. For example, type in 1000 followed by a space, then type in 5000-7000.

          • GID (ranges): Applies to Windows, Directory (Windows Active Directory), and Unix. Enter one or more Group Identifier numbers. To enter multiple IDs or ID ranges, you must enter each element of the list separated by a space. For example, type in 8 followed by a space, then type in 10-12.

          • UID (ranges): Applies to Windows, Directory (Windows Active Directory), and Unix. Enter one or more User Identifier numbers. To enter multiple IDs or ID ranges, you must enter each element of the list separated by a space. For example, type in 1 followed by a space, then type in 5-7.

          • Name (RegEx): Applies to Windows, Directory (Windows Active Directory and LDAP), Unix, and Role Based (MySQL, Postgres, Oracle, SQL Server, Oracle, iDrac, Hp iLO, and HP iLO MP). Using Name (RegEx) is discouraged as it may slow your results. It is recommended you use Name (described earlier) to search by account name.

            For an LDAP asset, only substring matching is available (for example, a search term like abc*). Matching is case-insensitive. To use, enter a single regular expression pattern. For more information, see Regular expressions..

          • Group (RegEx): Applies to Windows, Directory (Windows Active Directory and LDAP), and Unix. Using Group (RegEx) is discouraged as it may slow your results. It is recommended you use Group (described earlier) to search by group name.

            For an LDAP asset, only substring matching is available (for example, a search term like abc*). Matching is case-insensitive. To use, enter a single regular expression pattern. For more information, see Regular expressions..

          • Role (RegEx): Applies to Role Based (Oracle and Postgres). Enter one or more roles. For an LDAP asset, only substring matching is available (for example, a search term like abc*). Matching is case-insensitive. To use, enter a single regular expression pattern. For more information, see Regular expressions..

          • Permission (RegEx): Applies to Role Based (MySQL, Postgres, Oracle, SQL Server, Oracle, iDrac, Hp iLO, and HP iLO MP). Enter one or more permissions. For an LDAP asset, only substring matching is available (for example, a search term like abc*). Matching is case-insensitive. To use, enter a single regular expression pattern. For more information, see Regular expressions..

        • If you are searching a directory:

          • Click Browse to select the container to search within the directory. The location displays in Filter Search Location.

          • To include sub containers in your search, select Include objects from sub containers.

          • Click Preview then verify the search result in the Accounts dialog including Name and Domain Name.

  7. Automatically Manage Found Accounts: Select to automatically add the discovered accounts to SPP. When selected, you can select Set default password then enter the password.
  8. Password Sync Group: Click Browse to select a password sync group to control validation and reset across all associated accounts. You can also use  Add to add a new sync group. See: Password sync groups.
  9. Password Profile: If a profile was not automatically assigned for a sync group (previous step), click Browse to select a password profile to identify the configuration settings for the discovered accounts. You can also use  New Profile to add a new password profile. For more information, see Password Profiles tab (partitions)..

  10. Set default password: If Set default password is selected, the password you enter is a placeholder for the discovered asset until the password is changed for the first time on the asset. If Set default password is not selected, no password is stored until the password is changed for the first time on the asset. If the account is requested before the password is changed, an error may result.
    The default password is set in Safeguard for Privileged Passwords but not on the asset.

    NOTE: If an Account Discovery Rule is configured to set a password, and a password profile (selected via the Assign to Password Profile option) is also configured to automatically change passwords, the change password schedule takes precedence and the account will have its password changed upon discovery.

  11. SSH Key Sync Group: Click Browse to select the SSH key sync group. For more information, see SSH Key Sync Groups settings..
  12. SSH Key Profile: If a profile was not automatically assigned for a sync group, cFor more information, see SSH Key Profiles tab (partitions)..

  13. Set default SSH Key: Select to set a default SSH key. On the Import an SSH Key dialog, you can import a private key file for an SSH key that has been generated outside of SPP and assign it to the account. Click Browse to import the key file, enter a Password, then click OK.
    When importing an SSH key that has already been manually configured for an account on an asset, it is recommended that you first verify that the key has been correctly configured before importing the key. For example, you can run an SSH client program to check that the private key can be used to login to the asset: ssh -i <privatekeyfile> -l <accountname> <assetIp>. Refer to the OpenSSH server documentation for the target platform for more details on how to configure an authorized key.

    NOTE:SPP does not currently manage the options for an authorized key. If an imported key has any options configured in the authorized keys file on the asset, these options will not be preserved when the key is rotated by SPP.

  14. Enable Password Request: This check box is selected by default, indicating that password release requests are enabled for this account. Clear this option to prevent someone from requesting the password for this account. By default, a user can request the password for any account in the scope of the entitlements in which they are an authorized user.

  15. Enable Session Request: This check box is selected by default, indicating that session access requests are enabled for this account. Clear this option to prevent someone from requesting session access using this account. By default, a user can make an access request for any account in the scope of the entitlements in which they are an authorized user.
  16. Enable SSH Key Request: This check box is selected by default, indicating that SSH key release requests are enabled for this account. Clear this option to prevent someone from requesting the SSH key for this account. By default, a user can request the SSH key for any account in the scope of the entitlements in which they are an authorized user.

  17. Enable API Key Request: This check box is selected by default, indicating that API key release requests are enabled for this account. Clear this option to prevent someone from requesting the API key for this account. By default, a user can request the API key for any account in the scope of the entitlements in which they are an authorized user.

  18. (For directory accounts only) Available for use across all partitions (Global Access): When selected, any partition can use this account and the password is given to other administrators. For example, this account can be used as a dependent account or a service account for other assets. Potentially, you may have assets that are running services as the account, and you can update those assets when the service account changes. If not selected, partition owners and other partitions will not know the account exists. Although archive servers are not bound by partitions, this option must be selected for the directory account for the archive server to be configured with the directory account.
  19. Tags: This tab allows you to select tags or add new tags with rules.
  20. Click Apply.
  21. Click OK to save the Account Discovery job.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating