Iris tool catalog
This page describes what Iris can answer and do, and which roles are offered each capability. Inside the product, every answer lists the tools that produced it under tools used.
Last synced with the product: 2026-10-14.
How Iris answers
Every data question Iris answers goes through one of:
- A named read tool — a pre-built query for one job (look up a user, list SoD violations, read the audit trail), with a few typed parameters.
compose_metric— one tool that computes any of the metrics below, optionally broken down by one dimension and narrowed by filters.iris_sql— a structured, read-only query over one curated view, for questions no named tool or metric covers.
Requests to change something (approve, revoke, suspend, create…) go to an action tool, which never runs until you confirm it.
Who is offered what. Iris offers each tool only to roles whose permissions cover it, and every tool checks your permissions again when it runs. “All roles” means every signed-in role, including End User.
Counts and breakdowns
compose_metric computes one metric, optionally broken down by one dimension (and, for activity, over a window of days). Each metric allows only the breakdowns that make sense for it; a combination that doesn’t is refused rather than guessed. Offered to all roles.
| Area | What you can count |
|---|---|
| Users | total, active, disabled and inactive users; users with and without MFA, and with recent MFA use |
| Access grants and roles | active, expiring and expired grants; stale and high-risk entitlements; active applications; roles and role assignments (active and revoked); orphan application accounts |
| Access requests | all, pending, approved, rejected, cancelled and stale requests |
| Certifications | all, completed, overdue, escalated and revoked reviews; active campaigns |
| Segregation of duties | open and resolved violations; rules (and blocking rules); active and pending exceptions |
| Revocation | pending and overdue revocations; revocations completed in a window |
| Agents and NHIs | agents; agents pending review or at high risk; agent action volume; NHIs |
| Credentials and break-glass | active and expired API keys; active and pending break-glass sessions |
| Audit and API usage | audit events, API calls and failed API calls in a window |
Breakdowns: by status, department, title, manager, application, integration type, severity or risk level, environment, priority, agent or account type, action or resource type, actor type, and the status of a request, entitlement, role, certification, revocation, SoD violation or exception, break-glass session or API key. Missing values are shown as their own bucket (for example Unassigned for department) rather than dropped. One breakdown per question.
Ready-made breakdowns are also offered to all roles: users by status, MFA coverage, grants expiring soon by application, SoD violations by risk level, certification reviews by status, users inactive for N days, grants and users per application, dormant versus active grants, audit volume over recent days by action, date or actor, and NHIs by rotation status.
iris_sql — structured view query
Offered to Identity Admin, Security Analyst, Compliance Officer, CISO and Super Admin. It does not accept SQL text: Iris describes the question in a fixed structure, and the server checks every name against the view and builds the parameterised query itself. One curated, read-only view per question — no joins, unions or subqueries — and a bounded number of rows.
The views cover user access (grants, applications reached and last login per person), application entitlements, separation-of-duties violations with their context, certification campaign progress, recent audit volume, NHI credential rotation health, workflow status, compliance posture, an IAM summary and entitlement dormancy.
It can be switched off per deployment; when it is, Iris says so and the other tools keep working.
Lookups by area
| Area | What Iris can look up | Offered to |
|---|---|---|
| Help and reports | how to do something in AtmanID; your reports | All roles |
| Access requests and workflows | a request’s status; where its approval workflow is; workflows that are stuck; available access bundles | All roles except Security Analyst and Agent Engineer |
| People and access | a person; entitlements; someone’s access now or as of a past date; a team’s access; the path by which someone reaches an application; a person’s risk profile; an application’s accounts and how they reconcile | All roles except End User |
| Compliance and audit | the audit trail; whether the audit chain verifies; a signed access snapshot for evidence; certification status, reviews, campaign progress and next actions; compliance posture; platform health | All roles except End User |
| Policy and SoD | SoD violations, exceptions and rules; a policy’s details; role-mining suggestions; a drafted risk rule (validated, not saved) | All roles except End User |
| Notifications | your own event subscriptions | All roles except End User |
| AI Hub | recommendations, adherence, outliers and the governance log | Identity Admin, Security Analyst, Compliance Officer, CISO, External Auditor, Super Admin |
| Lifecycle and infrastructure | an NHI; connector status; the revocation queue; joiner, mover and leaver events; reachability of an application | Identity Admin, Super Admin |
| Privileged access and APIs | vault status and privileged sessions; the API catalogue, its usage and its grants | Identity Admin, Super Admin |
| Credentials and break-glass | API keys, their usage and expiry; stale credentials; break-glass sessions, history and eligibility | Identity Admin, Super Admin |
| Agents | an agent’s status and risk; delegation chains; the approval queue for agent actions; discovered agents; what reclassifying an agent would remove | Agent Engineer, Super Admin |
Lookups return a bounded number of rows; ask a narrower question, or for a breakdown, when you need the whole picture.
Actions
Every action needs your explicit confirmation on a card before it runs, and each one checks your permissions at execution. Iris can, among others: create, approve or reject access requests and delegate your approvals; decide certification reviews and sign off campaigns; suspend, activate, transfer, offboard or onboard people; provision and revoke access and roles; create, approve and remediate SoD exceptions and run SoD scans; register, suspend and delegate to agents and rotate their credentials; create and rotate API keys; request and approve break-glass access; and manage just-in-time access, policies, workflows, connectors, vendors and reports.
Example questions
break down active users by departmentaccess requests by statusaudit events by action type, last 30 daysagents by risk bandCatalog growth
New metrics, breakdowns and tools are added as customers ask for them. If a question you ask often gets no good answer, tell us — the catalog grows from observed gaps.
Adjacent reading
- How Iris stays accurate — why choosing from a catalog beats generating queries
- Iris query patterns cookbook — patterns organised by use case
- Iris failure modes — what happens when no tool fits
- Building on Iris — programmatic options
© AtmanID · Privacy