Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.
Version: 11.3.0

Connecting to Your HYPR Tenant

Supervisors approve agent actions with a passkey from the HYPR mobile app. That path runs through your HYPR Authenticate tenant, so you connect the HYPR AgentPass™ gateway to it once. When you finish this page, a held request reaches a supervisor's phone, and comes back approved or denied.

Before You Begin​

In HYPR Control Center, you need:

  • An application for the gateway, with an API access token scoped to it. Control Center shows the token once, when you generate it. See Access Tokens.
  • FIDO2 enabled on that application. See FIDO2 Settings.
  • The HYPR mobile app on each supervisor's device, signed in as that supervisor.

In the gateway, you need a role that permits changing settings.

Connect the Tenant​

  1. Open Advanced → Gateway Settings, and click the Passkeys (FIDO2) tab.
  2. In HYPR FIDO2 Integration, enter the values described in the following table.
  3. Click Save beside each field. The card reports Ready once all four required fields are set.
  4. Click Check connection to confirm the gateway reaches your HYPR tenant.
FieldValue
HYPR tenant base URLThe address of your HYPR tenant. If it is on your internal network, also turn on Allow private network addresses. See Allow a Private Network Address
RP API access tokenThe application's API access token, from Control Center
RP Application IDThe application you created for the gateway
Gateway public originThe public origin of the gateway: the address supervisors' phones reach
HYPR mobile APK key-hashesOptional. The key-hashes of the HYPR Android app

Associate the Mobile Apps​

In Mobile App Associations, enter the identifiers of the HYPR mobile apps your supervisors use:

  • For iOS, the App IDs
  • For Android, the Package name and Signing-cert SHA-256 fingerprints

Confirm the values with your HYPR representative. The card reports Ready once both platforms are set.

Decide Which Passkeys Count​

Passkey approval policy decides which passkeys may approve an agent action.

PolicyAccepts
Strict (HYPR Mobile only)Passkeys enrolled from the HYPR mobile app
Any passkeyAny passkey the supervisor has enrolled
Custom allowlistPasskeys whose authenticator is on your own list

Under Strict (HYPR Mobile only), enter the HYPR Mobile AAGUIDs in HYPR Mobile AAGUIDs. Your HYPR representative provides them. Until the list has an entry, no passkey can approve.

Require signed approvals decides whether an approval must carry the supervisor's passkey signature:

  • Optional (soak), while you roll the app out
  • Required (production), once every supervisor is enrolled

Each choice asks you to confirm, and takes effect when you do.

Deliver Approval Requests​

Held requests reach the phone as push notifications. Configure the push channel, and the events that must never be muted, on Notifications.

Enroll the Supervisors​

Each supervisor enrolls a passkey from My Passkeys in the console. Point them at Setting Up Your Approval Passkey. Nothing else is needed on their side.

Validate​

  1. Point one agent at a connector whose onboarding mode is Require Approval, and send a request.
  2. Check that the request appears under Needs your attention in Oversight → Approvals.
  3. Check that the supervisor's phone receives it.
  4. Have the supervisor choose Approve or Deny on the phone. The decision closes the request in the console. See Approvals in the Console.