Skip to content
Find the control you need
Public Preview

Identity: user and agent identities, groups, policies

Explains how Duale AI distinguishes user and Agent Identity, and links to credential lifecycle, groups, policies, and identity limits.

This page covers Tenant identity types, credential lifecycle, group-based access, policies, and identity limits.

  • Two Tenant identity types and their authentication methods.
  • Credential lifecycle, members and groups, and library access.
  • Policies, default policies, and identity limits.
  • Group-based access and permission delegation.

Summaries were generated by AI.

Every Tenant action comes from a person or an Agent Identity. Your application runs as an Agent Identity, and people administer access in the Dashboard.

Find the control you need

  • Credential lifecycle: create an Agent Identity, rotate its tokens, contain a leaked token, and retire the identity safely.
  • Members and groups: invite a person into an existing custom group or change that group’s membership.
  • Policies: choose what a policy allows and bind it to a custom group.
  • Default policies: see the policies that Duale AI supplies and the changes it makes to them.
  • Identity limits: look up identity, access, and sign-in limits.
  • Library access: control who can and cannot use one Library.

Distinguish the two Tenant identities

IdentityWho it isHow it authenticates
user:<user_id>A person in the Tenant, identified by their user IDSigns in to the Dashboard
agent:<agent_id>The identity your application runs asUses its API token

Who it is

user:<user_id>agent:<agent_id>
A person in the Tenant, identified by their user IDThe identity your application runs as

How it authenticates

user:<user_id>agent:<agent_id>
Signs in to the DashboardUses its API token

Duale AI records each request under the person or Agent Identity that made it. A Task runs as its Agent Identity; Agent harness explains how an Agent carries out a Task.

An audit record can also show the actor system: a change that Duale AI made to a supplied policy or to the supplied group that holds it. Default policies explains how to read that record, and Evidence and audit explains what audit records and their proofs show and who can read them.

Duale AI decides each request from the verified identity

Duale AI decides each request only from the verified identity, the Tenant, the action, and the resource.

A person and an Agent Identity with the same permission get the same access.

To manage access, a person or Agent Identity needs the required permissions and sign-in level. It can give others only the permissions that it holds.

Give access through groups

Bind a policy to a custom group to give its permissions to every member of that group, person or Agent Identity. Policies explains how permissions add up. To give one process narrower access, use a separate Agent Identity.