Safeguard for Privileged Passwords can join with the cloud platform One Identity Starling. By joining with One Identity Starling, Safeguard for Privileged Passwords customers can take advantage of companion features from multiple Starling services.
Introduction
System requirements and versions
Web client system requirements
Web management console system requirements
Supported platforms
Licenses
Long Term Support (LTS) and Feature Releases
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
Step 1: Create the Authorizer Administrator
Step 2: Authorizer Administrator creates administrators
Step 3: Appliance Administrator configures the appliance
Step 4: User Administrator adds users
Step 5: Asset Administrator adds managed systems
Step 6: Security Policy Administrator adds access request policies
Using the web client
Home
Privileged access requests
Configuring alerts
Password release request workflow
Appliance Management
Requesting a password release
Approving a password release request
Reviewing a completed password release request
SSH key release request workflow
Requesting an SSH key release
Approving an SSH key release request
Reviewing a completed SSH key release request
Session request workflow
Appliance
Asset Management
Appliance Diagnostics
Appliance Information
Debug
Licensing settings
Factory Reset
Lights Out Management (BMC)
Network Diagnostics
Networking
Operating System Licensing
SSH Algorithms
Patch Updates
Power
Support bundle
Time
Time Zone
Backup and Retention
About backups
Archive servers
Audit Log Maintenance
Backup and Restore
Certificates
Run Now
Download a backup
Upload a backup
Restore a backup
Archive backup
Backup settings
Backup protection settings
Backup Retention
Authorize VM Compatible Backups
About Certificate Signing Requests (CSRs)
Audit Log Signing Certificate
Certificate Signing Request
Hardware Security Module Certificates
Cluster
Enable or Disable Services
External Integration
Installing a Hardware Security Module client certificate
Assigning a Hardware Security Module client certificate
Uploading a Hardware Security Module server certificate
SMTP Certificate
SSL/TLS Certificates
Creating an SSL/TLS Certificate Signing Request
Installing an SSL/TLS certificate
Assigning an SSL/TLS certificate to appliances
Syslog Client Certificate
Trusted CA Certificates
Email
Email Events
Email Templates
Hardware Security Module
SNMP
Starling
Syslog
Syslog Events
Ticket systems
Real-Time Reports
Safeguard Access
ServiceNow ticketing system integration
Remedy ticketing system integration
Not integrated with ticketing system
Trusted Servers, CORS, and Redirects
Messaging settings
Local Login Control
Local Password Rule
Identity and Authentication
Branding Customization
Appliance Management Settings
Account Automation
Accounts
Security Policy Management
Properties (account)
Owners tab (account)
Dependent Assets (account)
Check and Change Log tab (account)
Discovered Services tab (account)
Discovered SSH Keys (account)
History tab (account)
Managing accounts
Assets
Properties tab (asset)
Accounts tab (asset)
Account Dependencies tab (asset)
Owners tab (asset)
Discovered SSH Keys (asset)
Discovered Services tab (asset)
History tab (asset)
Managing assets
Partitions
Adding an asset
General tab (add asset)
Connection tab (add asset)
Checking an asset's connectivity
Assigning an asset to a partition
Assigning a profile to an asset
Manually adding a tag to an asset
Adding an account to an asset
Adding account dependencies
Adding users or user groups to an asset
Deleting an asset
Account Discovery tab (add asset)
Downloading a public SSH key
About service accounts
About Test Connection
SSH Key
Directory Account
Starling Connect
Local System Account
Password (local service account)
Access Key
None
Management tab (add asset)
Attributes tab (edit asset)
About profiles
Properties tab (partitions)
Assets tab (partitions)
Accounts tab (partitions)
Owners tab (partitions)
Password Profiles tab (partitions)
SSH Key Profiles tab (partitions)
History tab (partitions)
Managing partitions
Discovery
Adding a partition
Adding assets to a partition
Adding an account to a partition
Removing assets from a partition
Adding users or user groups to a partition
Creating a password profile
Creating an SSH key profile
Setting a default partition
Setting a default profile
Assigning assets or accounts to a password profile and SSH key profile
Deleting a partition
Asset Discovery
Profiles
Asset Discovery job workflow
Adding an Asset Discovery job
Asset Discovery Results
Account Discovery
Account Discovery Results
Discovered Accounts
Service Discovery Results
Discovered Services
SSH Key Discovery
General tab (asset discovery)
Information tab (asset discovery)
Asset Discovery Rules tab (asset discovery)
Deleting an Asset Discovery job
Add Condition (asset discovery)
Edit Connection Template (asset discovery)
Add Asset Profile (asset discovery)
Schedule tab (asset discovery)
Password Profiles (profiles)
Tags
Properties tab (profiles)
Assets tab (profiles)
Accounts tab (profiles)
View Password Profile Components (profiles)
Managing password profiles
Adding a password profile
Password Profiles
Setting a default password profile
Deleting a password profile
SSH Key Profiles (profiles)
Managing SSH key profiles
Adding a tag for tagging of assets or asset accounts
Deleting an asset or asset account tag
Modifying an asset or asset account tag
Copying an asset or asset account tag to another partition
Viewing asset and asset account tag assignments
Registered Connectors
Custom platforms
Access Request Activity
Account Groups
User Management
Properties tab (account group)
Accounts tab (account group)
Access Request Policies tab (account group)
History tab (account group)
Managing account groups
Application to Application
About Application to Application functionality
Setting up Application to Application
Adding an application registration
Deleting an application registration
Regenerating an API key
Making a request using the Application to Application service
Cloud Assistant
Asset Groups
Properties tab (asset group)
Assets tab (asset group)
Access Request Policies tab (asset group)
History tab (asset group)
Managing asset groups
Entitlements
General tab (entitlements)
Users tab (entitlements)
Access Request Policies tab (entitlements)
History tab (entitlements)
Managing entitlements
Linked Accounts
User Groups
Adding an entitlement
How Safeguard for Privileged Passwords evaluates policy when a user submits an access request
Creating an access request policy
General tab (create access request policy)
Security tab (create access request policy)
Scope tab (create access request policy)
Workflow tab (create access request policy)
Adding users or user groups to an entitlement
Deleting an access request policy
Modifying an access request policy
Copying an access request policy
Deleting an entitlement
Properties tab (user groups)
Users tab (user groups)
Entitlements tab (user groups)
History tab (user groups)
Managing user groups
Security Policy Settings
Users
Reports
Properties tab (user)
User Groups tab (user)
Entitlements tab (user)
History (user)
Managing users
User Groups
Properties tab (user groups)
Users tab (user groups)
Entitlements tab (user groups)
History tab (user groups)
Managing user groups
Time Zone
Activity Center
Disaster recovery and clusters
Applying search criteria
Saving search criteria and loading previously saved search criteria
Generating an activity audit log report
Scheduling an activity audit log report
Editing or deleting a saved search or scheduled report
Viewing event details
Auditing request workflow
Sorting report results
Entitlement reports
Exporting a detailed user entitlement report
Ownership reports
Enrolling replicas into a cluster
Unjoining replicas from a cluster
Maintaining and diagnosing cluster members
Administrator permissions
About Offline Workflow Mode
Failing over to a replica by promoting it to be the new primary
Activating a read-only appliance
Diagnosing a cluster member
Patching cluster members
Using a backup to restore a clustered appliance
Resetting a cluster that has lost consensus
Performing a factory reset
Unlocking a locked cluster
Troubleshooting tips
Appliance Administrator permissions
Asset Administrator permissions
Auditor permissions
Authorizer Administrator permissions
Help Desk Administrator permissions
Operations Administrator permissions
Security Policy Administrator permissions
User Administrator permissions
Preparing systems for management
Preparing ACF - Mainframe systems
Preparing Amazon Web Services platforms
Preparing Cisco devices
Preparing Dell iDRAC devices
Preparing VMware ESXi hosts
Preparing Fortinet FortiOS devices
Preparing F5 Big-IP devices
Preparing HP iLO servers
Preparing HP iLO MP (Management Processors)
Preparing IBM i (AS/400) systems
Preparing JunOS Juniper Networks systems
Preparing MongoDB
Preparing MySQL servers
Preparing Oracle databases
Preparing PAN-OS (Palo Alto) networks
Preparing PostgreSQL
Preparing RACF mainframe systems
Preparing SAP HANA
Preparing SAP Netweaver Application Servers
Preparing Safeguard for Privileged Sessions for credential management
Preparing Sybase (Adaptive Server Enterprise) servers
Preparing SonicOS devices
Preparing SonicWALL SMA or CMS appliances
Preparing SQL Servers
Preparing Top Secret mainframe systems
Preparing Unix-based systems
Preparing Windows systems
Preparing WinRM systems
Preparing Windows SSH systems
Minimum required permissions for Windows assets
Troubleshooting
Appliance is sick
Connectivity failures
Frequently asked questions
Change password or SSH key fails
Incorrect authentication credentials
Missing or incorrect SSH host key
No cipher supported error
Service account has insufficient privileges
Cannot connect to remote machine through SSH or RDP
Cannot delete account
Cannot play session message
Domain user denied access to Safeguard for Privileged Passwords
LCD status messages
My Mac keychain password or SSH key was lost
Password fails for Unix host
Password or SSH key is pending a reset
Password or SSH key profile did not run
Recovery Kiosk (Serial Kiosk)
Appliance information (Recovery Kiosk)
Power options
Admin password reset
Factory reset from the Recovery Kiosk
Support bundle
Replica not adding
System services did not update or restart after password or SSH key change
Test Connection failures
Test Connection failures on archive server
Certificate issue
Cipher support
Domain controller issue
Networking issue
Windows WMI connection
Timeout errors causing operations to fail
User locked out
User not notified
How do I audit transaction activity
How do I configure external federation authentication
Appendix A: Safeguard ports
Appendix B: SPP and SPS join guidance
Appendix C: Regular Expressions
About us
How do I add an external federation provider trust
How do I create a relying party trust for the STS
How do I add an external federation user account
How do I manage accounts on unsupported platforms
How do I modify the appliance configuration settings
How do I prevent Safeguard for Privileged Passwords messages when making RDP connections
How do I set up telnet and TN3270/TN5250 session access requests
How do Safeguard for Privileged Passwords database servers use SSL
What are the access request states
What do I do when an appliance goes into quarantine
When does the rules engine run for dynamic grouping and tagging
Why did the password or SSH key change during an open request
Starling
Join Starling
In order to use the Safeguard for Privileged Passwords features associated with Starling services, you must join Safeguard for Privileged Passwords to Starling. It is the responsibility of the Appliance Administrator to join Safeguard for Privileged Passwords to Starling.
For additional information and documentation regarding the Starling Cloud platform and services, see the One Identity Documentation.
Prerequisites
See the Starling Release Notes for currently supported platforms.
In order to use the companion features from Starling services, first configure the following:
-
Register a Starling organization. For more information on Starling, see the One Identity Starling User Guide.
IMPORTANT: Not all Starling services are available to organizations in both the United States and European Union data centers. Check the documentation for the Starling services to see if there are any data center restrictions.
- If your company requires the use of a proxy to access the internet, you must configure the web proxy to be used. For more information on configuring a web proxy to be used by Safeguard for Privileged Passwords for outbound web requests to integrated services, see Networking.
- To use the Cloud Assistant feature, you must subscribe to the Starling Cloud Assistant feature and configure the channel(s) that will be used.
Join Safeguard for Privileged Passwords with Starling
NOTE: You must be an Organization Admin for the Starling organization in order to join Safeguard for Privileged Passwords with Starling.
- Go to Starling:
web client: Navigate to External Integration > Starling.
- Notice that this pane also includes the following links, which provide assistance with Starling:
- Visit us online to learn more displays the Starling login page where you can create a new Starling account.
- Trouble Joining displays the Starling support page with information on the requirements and process for joining with Starling.
- Click Join to Starling and follow the prompts to complete the process.
The following additional information may be required:- If you do not have an existing session with Starling, you will be prompted to authenticate.
- If your Starling account belongs to multiple organizations, you will be prompted to select which organization Safeguard for Privileged Passwords will be joined with.
-
After the join has successfully completed, you will be returned to the Safeguard for Privileged Passwords client and the Starling pane will now show Joined to Starling. For information on the features that are now available, see After joining Starling. For information on unjoining from Starling, see Unjoin Starling.
IMPORTANT: In order to use the Cloud Assistant feature, once you have joined with Starling you must enable the Register as a sender with Cloud Assistant toggle on the External Integration > Starling pane.
After joining Starling
Once Safeguard for Privileged Passwords is joined to Starling, the following Safeguard for Privileged Passwords features are enabled:
Feature using Starling Connect
-
Starling Connect Registered Connectors
This feature integrates your Starling connectors with Safeguard for Privileged Passwords. This allows for the accounts stored in the connectors to be discovered and controlled by Safeguard for Privileged Passwords through the use of partitions which allow for rotating passwords to provide additional security for them. For more information, see Registered Connectors
Feature using Starling Cloud Assistant
-
Cloud Assistant
The Cloud Assistant feature integrates its access request workflow with Starling Cloud Assistant, allowing approvers to receive a notification through a configured channel when an access request is submitted. The approver can then approve (or deny) access requests through the channel without needing access to the Safeguard for Privileged Passwords web application.
The Cloud Assistant feature is enabled when you join Safeguard for Privileged Passwords to Starling. For more information, see Starling. Once enabled, it is the responsibility of the Security Policy Administrator to define the users who are authorized to use Cloud Assistant to approve access requests.
IMPORTANT: In order to use the Cloud Assistant feature, once you have joined with Starling you must enable the Register as a sender with Cloud Assistant toggle on the External Integration > Starling pane.
Feature using Connect for Safeguard Assets
-
Connect for Safeguard Assets
Within Starling, a Connect for Safeguard Assets service is available. Once added, this service allows for assets not connected to your corporate network to use the check and change passwords functionality of Safeguard for Privileged Passwords. For more information, see the Connect for Safeguard Assets User Guide available as part of the Safeguard for Privileged Passwords documentation.
IMPORTANT: Regardless of the version of Safeguard for Privileged Passwords you are using, the Connect for Safeguard Assets User Guide associated with the latest version of Safeguard for Privileged Passwords should always be used when configuring a new agent. This is available from the Safeguard for Privileged Passwords documentation site.
Starling as an identity provider
Once Safeguard for Privileged Passwords has joined with Starling, a Starling Identity and Authentication provider will automatically be added to Safeguard. This is indicated by the Realm(s) section under Starling. However, there won't be any users or groups available until an administrator adds a Microsoft Azure Active Directory tenant to their Starling organization via the Directories settings page in Starling.
Using Starling as an identity provider
-
Join Safeguard for Privileged Passwords with Starling. For more information, see Join Starling.
-
Enable a Microsoft Azure Active Directory tenant in your Starling organization (multiple Microsoft Azure Active Directory tenants can be added to Starling, but they will be available and treated as a single tenant when used by Safeguard). This is done via the Directories settings page in Starling. For more information, see the Starling User Guide.
-
In order for Safeguard users to authenticate against Starling, a Relying Party Trust Application must be created in Starling via the Applications settings page. For more information, see the Starling User Guide.
To create the application in Starling, you will need to Download Safeguard Federation Metadata from Identity and Authentication
NOTE: You cannot use the Add OpenID Connect Application with Safeguard for Privileged Passwords.
-
You will need to enter one or more values in the Realm(s) section to associate with the new Starling authentication provider. This will then allow users logging in to Safeguard to select External Federation and use Starling for their authentication.
-
When the Require User to Always Authenticate check box is selected, the user will always be required to enter their credentials on the external provider, regardless of whether they are already logged in.
Adding new users and groups to Safeguard that come from Starling follows the same process as with other directory based identity providers (such as, Active Directory and LDAP) and the user information will be periodically synchronized from Starling.
IMPORTANT: You may need to restart the client in order for Starling to appear as an available identity provider.
Unjoin Starling
It is the responsibility of the Appliance Administrator to unjoin Safeguard for Privileged Passwords from Starling.
For additional information and documentation regarding the Starling Cloud platform and services, see the One Identity Documentation.
To unjoin Safeguard for Privileged Passwords from Starling
- Go to Starling:
External Integration > Starling.
-
Click Unjoin Starling.
IMPORTANT: If there is an issue with the connection to Starling, a warning message will appear on the page and you will instead see a Force Unjoin button.
-
Safeguard for Privileged Passwords will no longer be joined to Starling, which means that Cloud Assistant,
IMPORTANT: If you attempt to unjoin from Starling while there are still Safeguard users or groups that use the Starling provider for identity and authentication, you will get an error. You must manually delete any users or groups first before unjoining from Starling.