Getting the HYPR App on iOS
The HYPR app for iOS gives supervisors AgentPass on their phone: assigned agents, approvals, conversations and managed-agent automations. You install the app through the AgentPass early access program, switch AgentPass on, make HYPR your phone's passkey provider, and enroll an approval passkey. You then open AgentPass from the button on the main screen.
Install the app, switch AgentPass on, and make HYPR your passkey provider here. Then enroll your passkey in Setting Up Your Approval Passkey, and return to Connect to AgentPass.
Your organization uses one of two iPhone apps. Ask your administrator which one.
- The HYPR app, installed through TestFlight. This page covers it from start to finish.
- An AgentPass app in your organization's own name, which your organization signs and distributes. It opens straight into AgentPass, so there is nothing to switch on, and your phone's password manager keeps the passkey. Install it the way your organization tells you, enroll your passkey with your phone's camera, then tap Sign in in the app and continue from Use AgentPass on iPhone. See Signing and Deploying Your AgentPass App on iOS.
Before You Begin
You need these in place.
| You need | Detail |
|---|---|
| A supported iPhone | iOS 17 or later |
| The HYPR app | From the AgentPass early access program, on the phone that will receive approvals |
| Your organization's testing link | Provided by your HYPR representative |
| Your work account | It signs you in to the console, where you enroll your passkey. An agent becomes yours when you onboard it |
| Your console address | Your administrator provides the address used during passkey setup |
The early access build signs in only to the gateways HYPR has set it up for. Before supervisors sign in, confirm with your HYPR representative that the build supports your organization's gateway.
Install the HYPR App
AgentPass on iPhone is distributed through an early access program, using Apple's TestFlight. The version of HYPR in the public App Store does not include AgentPass.
- Install TestFlight from the App Store. It is free, and it is Apple's own app for early access builds.
- Ask your HYPR representative for your organization's AgentPass testing link.
- Open that link on the iPhone you will use. It opens TestFlight.
- Tap Accept, then Install. If you have installed a build before, the button reads Update.
- Open the app.
Anyone who opens your link is admitted, so keep it inside your organization, and do not forward it. To add more people, ask your HYPR representative.
Apple gives each build 90 days from when it was uploaded, and TestFlight shows the days remaining under the app name. An expired build stops opening, and you install the current one the same way. Installing the early access build also replaces the App Store version of HYPR on that phone. An orange dot beside the app name marks it as a beta.
Switch AgentPass On
AgentPass is switched off until you turn it on. The setting applies to that phone and survives app updates, so you do this once.
-
Open the HYPR app.
-
Double-tap the version number. Before you register the phone, the version number is on the welcome screen. Afterward, open the side menu, where it is at the bottom.
-
Tap OK in the AgentPass enabled alert.
-
Close the side menu, if you opened it. A round AgentPass button now sits at the bottom right of the screen.
Double-tap the version number again to hide the button, and the app confirms with AgentPass hidden. Turning it back on does not ask you to sign in again.
On iOS 16 or earlier, the double-tap shows AgentPass unavailable instead, and no button appears. AgentPass needs iOS 17 or later. The rest of the HYPR app is unaffected.
Make HYPR Your Passkey Provider
AgentPass signs you in, and signs your approvals, with a passkey held by the HYPR app. iOS saves new passkeys in its own Passwords app unless HYPR is turned on as a passkey provider, so do this before you enroll.
- Open the Settings app.
- Go to General → AutoFill & Passwords. On iOS 17, go to Passwords → Password Options.
- Turn on HYPR. You can leave Passwords turned on as well.
When you enroll, save the passkey to HYPR if your phone asks where to save it. Enable HYPR as your passkey provider also covers the Enable HYPR Passkeys banner, which turns HYPR on from inside the app.
Your gateway accepts approvals only from passkeys held by the HYPR app, unless your administrator chose a different passkey approval policy. A passkey saved in the Passwords app or another password manager cannot approve agent actions.
Connect to AgentPass
-
On your computer, enroll an approval passkey from the console, with HYPR set as your passkey provider.
-
Return to the HYPR app.
-
Tap the AgentPass button at the bottom right of the main screen.
-
Tap Sign in.
-
Approve the device authentication prompt. AgentPass opens the list of agents assigned to you, and any requests that need your attention.
Later visits reuse the protected gateway session, until you need to sign in again.
Use AgentPass on iPhone
AgentPass on iPhone has these areas.
| Area | What you can do |
|---|---|
| Agents | Open an assigned agent, review its status, and see recent activity. Each tile shows the agent's full name and a status tag: Needs attention when the agent has a request waiting for you, Running while one of its automations runs, Disabled when it is switched off, and Active otherwise. Agent lists elsewhere in the app also show Disabled for an agent that is switched off. |
| Needs you | Review a request, then tap Approve to sign it with your approval passkey, or Deny to reject it. Deny needs no passkey. When a request needs you to sign in to a connected service first, the button reads Authenticate. |
| Conversations | Continue a workstation conversation, or start a supported managed-agent chat |
| Approvals | Review the agent's recent approval history |
| Recent activity | Review the approvals you decided and recent scheduled runs |
| Automations | Review and manage supported managed-agent automations, their run history and transcripts |
Tap a request under Needs you to open Review request. It can show the time left and the policy that held it. See What Reaches You.
To return to the HYPR app, tap the close button at the top left. To sign out, tap the settings button at the top right, then Sign out. Your next sign-in asks for your passkey again.
Opening an AgentPass notification takes you to the related request or conversation. See Approving and Denying Agent Actions for the decision flow, and Having Conversations with Your Agent for messaging.
If Something Is Missing
Start with what you see:
- There is no AgentPass button. It is hidden until you switch AgentPass on. Follow Switch AgentPass On, and double-tap the version number itself.
- The double-tap shows AgentPass unavailable. The phone is on iOS 16 or earlier. Update it to iOS 17 or later, and install the current early access build if needed.
- The App Store version has none of this. The public App Store listing does not include AgentPass. You need the early access build.
- The testing link does not open TestFlight. Install TestFlight first, then open the link again on the same phone. Opening it on a computer installs nothing on your phone.
- Sign-in shows This app can't sign in to followed by your gateway's address. The early access build is not set up for your organization's gateway. Contact your HYPR representative.
- Sign-in fails, or shows Sign-in failed. Try again. Check that the iPhone has network access. Then follow Make HYPR Your Passkey Provider, enroll the phone through Setting Up Your Approval Passkey, and try again.
- Approve is refused. The passkey you approved with is not one your gateway accepts for approvals, for example one saved outside HYPR. Follow Make HYPR Your Passkey Provider, then enroll the phone again.
- No agents appear. An agent appears once you onboard it, or once an administrator assigns one to you. See Onboarding Your Agent.
- The problem continues. Contact HYPR Support.
Related
- Setting Up Your Approval Passkey — connect this app to your gateway
- Approving and Denying Agent Actions — review and sign a decision
- Having Conversations with Your Agent — message agents from the app or console