- Duale AI
- Documentation
- Identity
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
| Identity | Who it is | How it authenticates |
|---|---|---|
user:<user_id> | A person in the Tenant, identified by their user ID | Signs in to the Dashboard |
agent:<agent_id> | The identity your application runs as | Uses its API token |
Who it is
user:<user_id> | agent:<agent_id> |
|---|---|
| A person in the Tenant, identified by their user ID | The identity your application runs as |
How it authenticates
user:<user_id> | agent:<agent_id> |
|---|---|
| Signs in to the Dashboard | Uses 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.