> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NHI ownership assignment

> How Oleria discovers unowned non-human identities (NHIs), the signals it uses to assign an owner automatically, and the reviewer and fallback-owner path for the ones it can't resolve on its own.

Every non-human identity (NHI) - a service account, API key, bot, managed identity, or AI agent - needs an accountable owner behind it. An unowned NHI is a secret nobody is watching: nobody notices if its access grows, nobody rotates it, and nobody answers for what it did. The **NHI ownership assignment** policy closes that gap for the applications you turn it on for, through three stages: automatic detection, human review, and an optional time-bound fallback.

An AI agent's own record - what it's built to do, how it runs, and who owns it - lives on the [Agents](https://docs.oleria.com/governance/agents-overview.md) page. This page covers the accounts an agent runs as, alongside every other NHI.

> [!NOTE]
>
> Non-Human Identities must be enabled for your workspace, and the Ownership page enabled within it. Configuring ownership for an application requires permission to view and manage NHI ownership settings - only Administrators have it by default. Contact us at [support@oleria.com](mailto:support@oleria.com) if you do not see this page or its settings.

## Ownership dashboard

Go to **Non-Human Identities** -> **Ownership** for a workspace-wide view:

| Card | What it counts |
| :- | :- |
| Ownership coverage | The share of NHIs with an accountable owner, overall. |
| Orphans | NHIs nobody is accountable for. |
| Elevated privilege orphans | Orphaned NHIs whose privilege is Elevated - the ones that do the most damage, unwatched. |
| Dormant orphans | Orphaned NHIs with no recent activity - exploitable, and nobody would notice. |
| Single human owner | NHIs with exactly one human owner - orphaned the moment that person leaves. |

Below the summary, a table breaks ownership down by application instance - total NHIs, owned NHIs, orphan NHIs, and whether an ownership policy is **Configured** for that instance, with a button to **Manage** or **Configure** it.

![The Ownership dashboard, with coverage summary cards and a per-application-instance table showing total, owned, and orphan NHIs](https://mintcdn.com/oleria/MVKuWHC7j6wQYBf0/images/governance/nhi-ownership-assignment-overview/ownership-dashboard.png?fit=max\&auto=format\&n=MVKuWHC7j6wQYBf0\&q=85\&s=a30caef3fa04126e4fc668090466b186)

## Two levels of rule

Oleria checks every NHI daily against two rules, in this order:

1. **App-based rule** - if the NHI's application has its own ownership policy configured, that policy decides.
2. **Global rule** - otherwise, the workspace-wide default applies.

Both levels start with the same [automatic signal detection](#automatic-signal-detection). They differ in what happens when no signal finds an owner: an app-based policy can route the NHI to a reviewer, and fall back to a configured owner if no one decides in time. The global rule has neither of those - an NHI it can't resolve automatically just stays unowned, rechecked on the next daily run, until an app-based policy covers it or someone assigns an owner by hand.

## Automatic signal detection

Oleria first looks for direct evidence of ownership in your connected applications. It checks a fixed set of signals in priority order, from strongest to weakest, and stops at the first priority level that identifies an owner - it does not fall back to a weaker guess once a strong signal is found.

| Signal | What it means |
| :- | :- |
| Source owner (shown on owners as "Owner assigned by source system") | The application already records an explicit owner for this identity - a user, group, or role. |
| Creator (shown on owners as "Created by this user") | The application records which user created the identity. |
| Group or role owner (shown on owners as "Manages its group or role"; on Microsoft Entra ID, shown as "Manages the group this NHI belongs to" or "Manages the role this NHI belongs to") | A user owns a group or role the NHI belongs to, including through nested groups. If the owner is itself a group or role, its members are credited. In Microsoft Entra ID, if the group has no owner, Oleria credits the Groups Administrator role (then Application Administrator); for a role with no owner, the Privileged Role Administrator role. |
| Administers its Google Cloud resource (Google Cloud only; shown on owners as "Administers the GCP resource containing this NHI") | A user holds an administrative IAM role on the project, folder, or organization that contains the service account. Google Cloud uses this in place of group or role ownership. Oleria checks the service account's home project first, then its folder, then its organization, stopping at the first level with an admin. At each level, Owner has priority over Service Account Admin; the folder and organization levels also fall back to Folder Admin, and the organization level falls back further to Organization Administrator. |
| Delegated access (shown on owners as "Can act as this user"; on Microsoft Entra ID, shown as "Can act as this user in Entra ID") | The NHI has permission to act on behalf of this user - for example, through delegated access or impersonation rights. When the delegation is OAuth-based rather than tied to one specific person, Oleria credits the application's admins instead. |
| Microsoft Entra ID admin role (Microsoft Entra ID only; shown on owners as "Application Administrator for this instance" for internal Microsoft applications, "Manages this Managed Identity via admin role" for managed identities, or "Agent ID Administrator for this agent account" for Entra agent identities) | For Microsoft internal applications, managed identities, and Entra agent identities, Oleria credits members of the Entra role that administers that kind of identity: Application Administrator, Cloud Application Administrator (then Application Administrator), or Agent ID Administrator. |
| User name match with NHI (shown on owners as "Matching name") | The NHI's name contains, or is contained in, the name of a user account in the same application (ignoring case). |

Not every signal applies to every application. Signals marked for one provider only run for identities from that provider, and Google Cloud service accounts don't use "Can act as this user."

> [!NOTE]
>
> If a signal points to an account that is disabled, or has had no activity for longer than your workspace's dormant account threshold, Oleria assigns that person's manager instead. The manager comes from your HR or identity provider data and must have an account that's enabled, not deleted, and in the same application. If there's no such manager, that signal doesn't produce an owner and Oleria moves on to the next signal.

A single clear signal is enough to assign ownership - Oleria doesn't require multiple signals to agree. If a signal, or several signals at the same priority level, identify more than one person, Oleria assigns all of them as owners - for example, every admin of the application when access is delegated through OAuth.

NHIs resolved this way are assigned automatically, with no review needed.

## Manual review when no signal is found

If none of the applicable signals identify an owner, what happens next depends on the application. If the application has its own ownership settings, the NHI is routed to the reviewers configured there - a specific reviewer, or an admin, group, or role. If it doesn't, the NHI stays unowned and Oleria checks it again on its next daily run.

If more than one reviewer is assigned, the first decision made resolves the review and closes any other pending reviews for that NHI.

> [!NOTE]
>
> Oleria keeps checking for signals in the background while a review is pending. If a clear signal appears before a reviewer acts, the NHI is assigned automatically and the pending review closes on its own.

## Fallback assignment when the review period expires

Fallback assignment covers two cases: an NHI with no matched owner at all, and an auto-assigned owner who rejects the assignment. Either way, if you've enabled fallback assignment for an application, reviewers have a set number of days to act. If a review isn't completed within that window, ownership is assigned automatically to the fallback owner configured for that application.

This assignment is recorded as a system action, distinct from a human reviewer's decision, with the reason logged as the review period expiring without a decision. If no fallback owner is configured for an application, the NHI stays unowned rather than being assigned to an arbitrary default.

## Configure ownership for an application

Go to **Non-Human Identities** -> **Ownership**, then select **Configure** (or **Manage**, on an application that's already set up) on an application row to open its **Configure Ownership** page:

**1. Enable fallback assignment**

Turn on **Enable fallback assignment** so NHIs with no matched owner, or an auto-assigned owner who rejects it, are reassigned automatically instead of staying unowned.

**2. Activate fallback after**

Set the number of days reviewers have to act before ownership passes to the fallback owner.

**3. Fallback owners**

Choose who the fallback owner is: a specific owner, a group, a role, or a specific person who holds an admin role for that application.

**4. Reviewers**

Under **Select reviewers**, choose who reviews NHIs that reach this point, using the same options: a specific person, a group, a role, or a specific person who holds an admin role.

**5. Notify assigned owners**

Choose how assigned owners are notified - by email, always on, and by direct message too if your workspace has Slack or Microsoft Teams connected under **Settings** -> **Messaging**.

> [!NOTE]
>
> A workspace-wide global rule, configured under **Settings** -> **Policies** -> **Ownership**, is available when enabled for your workspace. Configuring it needs the permission to update workspace settings, which only Administrators have by default. An older **Settings** -> **NHI Policies** link redirects to this same page.
>
> When available, that page lists application-specific rules below the global rule, each with the same fields as the **Configure Ownership** page above but in a different order - **Reviewers** first, then **Fallback owner** - and with the assignee options **Groups** and **Roles** (plural), not **Group** and **Role**. The global rule itself is a simpler form above that list: choose how reviewers and new owners are notified, then select **Activate** to turn it on workspace-wide - the button reads **Save** on later visits. It has no fallback or reviewer fields of its own; those live only in the application-specific rules below it.

## Contact us

For questions, contact us at [support@oleria.com](mailto:support@oleria.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.