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

Supervisor Identity

A supervisor is the person responsible for an agent. HYPR AgentPass™ learns who they are from your identity provider, gives each one a role, and attributes their agents' traffic to them. The Humans tab of Oversight → People lists everyone the gateway knows.

Where People Come From​

The gateway discovers people automatically, from sign-ins and syncs:

  • Console sign-in. Anyone who signs in through SSO becomes a human, with the roles their token's values are mapped to, or the default role. See Signing In to the Console.
  • Directory provisioning. Users and groups pushed over SCIM appear before their first sign-in. See Gateway Settings → Directory / SCIM.
  • Provider syncs. Syncing an AI provider connector's keys creates the owner of each key. See Agent Identity.

Each row shows the person, where the gateway learned about them, their groups, their roles, how many agents they own, and when they were last active. Tiles above the list count everyone, the people who have enrolled a passkey, the people with an invitation outstanding, and the people who were offboarded.

When the identity provider does not carry a person's roles, assign or change them here. Roles assigned in the console are not overwritten at the next sign-in. See Roles and Permissions.

What a Supervisor Carries​

Each supervisor brings three things to their agents:

  • Their roles, which decide what they see in the console and which tools their agents may call.
  • A passkey, used to approve agent actions from the HYPR mobile app. See Setting Up Your Approval Passkey.
  • Their agents. A supervisor's sign-in can open a real-time messaging channel for an agent they own. The channel uses the supervisor's identity, and remains subject to the agent's Mobile access setting.

Find a Person​

On the Humans tab, type a name or email address, or part of one, in the Search by name or email field. The list narrows to the people who match.

Open a Person's Details​

Click Details on a person's row. A drawer shows these details.

FieldWhat it shows
EmailThe address the person is known by
Gateway rolesThe person's AgentPass roles. When an administrator assigned them, Use identity provider roles hands the person back to their identity provider. See Roles and Permissions
AI provider roleThe person's role in the AI provider that surfaced them, when there is one
AI provider IDThe person's user ID in that AI provider
SourceWhere the gateway learned about the person, such as SCIM, OAuth, Anthropic, OpenAI or Manual
DiscoveredWhen the gateway first learned about the person
Last seenWhen the person was last active

Below the details, Agents lists each agent the person supervises. A person with no agents shows This person has no agents.

Invite a Person to Enroll a Passkey​

A supervisor needs a passkey to approve agent actions from the HYPR mobile app. An administrator can send the person an activation link from their row.

  1. On the Humans tab, open the person's actions menu (⋮).
  2. Choose how to deliver the activation link:
    • Send invite emails the link to the person. Once an invitation is outstanding, the menu offers Send reminder instead.
    • Copy invite link copies the link to your clipboard, so you can share it with the person yourself.

The link stays valid for the Invite link lifetime (hours) set on the Invitations card in Advanced → Gateway Settings, seven days by default. See Gateway Settings → Email / Invitations.

Offboard a Person​

Offboard a person when they leave your organization or must lose access now. Offboarding is an administrator action.

  1. On the Humans tab, open the person's actions menu (⋮), and choose Offboard.
  2. Review what the dialog says will be affected: the person's agents, credentials, group memberships and pending approvals.
  3. Click Offboard to confirm.

Offboarding takes effect immediately. It:

  • Revokes the person's access to every agent assigned to them
  • Ends any agent sessions they have in progress
  • Disconnects all their tool connections, such as mail or chat accounts
  • Removes them from every group and every agent assignment

The person's past activity and audit trail are kept, and AgentPass records which administrator offboarded them. Deactivating or deleting the person in your directory over SCIM offboards them the same way.

Offboarded people leave the list. Select Show offboarded to see them. Invite again in an offboarded person's actions menu brings them back, but their agents and credentials do not return. For a person your identity provider manages, re-enable them there instead.

Service agents keep running

Offboarding does not stop the service agents a person owns. A service agent authenticates with its own credential, so it keeps working after its owner is offboarded. Review the service agents the person owns, and reassign or disable each one. See Reviewing Your Service Agents.