HYPR
Service provider configuration
Password Safe administration is performed using the BeyondInsight Management Console. Log in to the BeyondInsight Management Console web page with an administrative username and password. Follow the BeyondTrust instructions for setting it up as a SAML service provider.
Note
For more information about Password Safe and SAML configuration, see Configure SAML in BeyondInsight.
Note
The HYPR metadata information is available at this link: https:///auth/realms//protocol/saml/descriptor.
Important
Third-party documentation is subject to change. Updates might not be reflected in BeyondTrust documentation. For the most up-to-date information, visit <https://www.hypr.com/support> or https://www.keycloak.org.
Sample SAML configuration
Log in to BeyondInsight.
- From the left sidebar, click Configuration.
- Under Authentication Management, click SAML Configuration.
- Click Create new SAML Identity Provider.
- Fill in fields with the appropriate values.
Identity provider configuration (HYPR/Keycloak)
Create new client by importing the BeyondTrust metadata
- Log in to the Keycloak admin page and select the BeyondTrust realm in the dropdown.
- Click Clients in the left navigation menu.
- Once the Clients page opens, click Import client.
- Click Browse and select the SAML metadata file exported from Password Safe. The Client ID field will be filled automatically; you can also manually enter a Name. This example uses BeyondTrustPSClient.
- Click Save.
Configure new client settings
-
Log in to the Keycloak admin page and select the BeyondTrust realm from the dropdown.
-
Click Clients in the left navigation menu. A list of clients populates the main pane.
-
Select the client you just created.
-
A set of tabs displays for the client properties:
- Settings
- Keys
- Credentials
- Roles
- Client scopes
- Sessions
- Advanced
The following sections describe each tab and the subsections therein.
Configure general settings on the Settings tab
Field | Value |
---|---|
Client ID | The Client ID defined at creation. |
Name | The Name defined at creation. (BeyondTrustPSClient) |
Description | An optional field for additional information. |
Always display in UI | Off |
Configure access settings on the Settings tab
Leave all fields blank except for Valid redirect URIs and Valid post logout redirect URIs.
Field | Value |
---|---|
Valid redirect URIs | - |
Valid post logout redirect URIs | - |
Configure SAML capabilities on the Settings tab
Field | Value |
---|---|
Name ID format | username |
Force name ID format | Off |
Force POST binding | On |
Force artifact binding | Off |
Include AuthnStatement | On |
Include OneTimeUse Condition | Off |
Configure signature and encryption on the Settings page
Field | Value |
---|---|
Sign documents | Off |
Sign assertions | On |
Signature algorithm | RSA_SHA256 |
Configure login settings on the Settings tab
Field | Value |
---|---|
Login theme | Choose… (leave unchosen) |
Consent required | Off |
Display client on screen | Off |
Client consent screen text | (Leave blank) |
Configure logout on the Settings tab
Field | Value |
---|---|
Front channel logout | On |
Configure the Keys tab
No configuration changes are needed in this section.
Configure the Credentials tab
No configuration changes are needed in this section.
Configure the Roles tab
No configuration changes are needed in this section.
Configure the Client Scopes tab
Attribute mappings must be added here.
- Click the URL in the Assigned client scope column to open the Mappers dialog.
- Click Add mapper and complete the Group list properties for Group.
Field | Value |
---|---|
Mapper type | Group list |
Name | Group |
Group attribute name | Group |
Friendly Name | Group |
SAML Attribute NameFormat | Basic |
Single Group Attribute | On |
Full group path | Off |
- Click Save when complete.
- Click Add Mapper again and create a User Attribute called Name.
Field | Value |
---|---|
Mapper type | User Attribute |
Name | Name |
User Attribute | |
Friendly Name | Name |
SAML Attribute Name | Name |
SAML Attribute NameFormat | Basic |
Aggregate attribute values | Off |
- Click Save when complete.
Configure the Sessions tab
No configuration changes are needed in this section.
Configure the Advanced tab
Field | Value |
---|---|
Browser Flow | HYPR |
Log in to Password Safe with HYPR
Note
Make sure to install the HYPR Mobile App on your mobile device before proceeding.
SAML Kickoff URL:
https://.ps.beyondtrustcloud.com/eEye.RetinaCSSAML
- Launch the Password Safe login.
- Enter your username in the HYPR login page, then click Sign In.
- Complete the login using your HYPR Mobile App.
- You will receive a push notification on the HYPR Mobile App. Click Login. The HYPR Mobile App will verify your identity (with FaceID, TouchID, etc.); foll
Updated 6 days ago