Concepts / Offboarding and Identity Lifecycle Management

Offboarding and Identity Lifecycle Management

Role-based access control restricts what a clinician can reach according to their role, and in this implementation it was applied to a dedicated agent identity for each clinician.

  • Programming

Deciding Who May Open a Patient Record

Picture an electronic health record system used by a large group of clinicians. Each clinician needs to open the records of the patients in their own care, but nobody should be able to open the records of a colleague's patients simply because they happen to be logged into the same system. Deciding who may see what, and keeping that decision enforced automatically, is the job of access control.

This article follows one concrete implementation in which every clinician received a dedicated software identity that acted on their behalf. The system does not only check the human at the keyboard. It checks an agent identity created for that clinician, because the agent is the identity that acts inside the system when a request arrives.

What do you think happens?

When a clinician asks the system for a patient record, what must the system check, and what must it refuse?

Reveal answer
Answer:

The system must check whether the requested record falls inside the clinician's own scoped patient panel, and it must refuse any record that lies beyond that panel.

The source states that the clinician's agent can work with that clinician's patient panel and nothing beyond it. Everything else in this article is about how that boundary is set, kept current, removed, and recorded.

One Identity for Each Clinician

The first design decision is that each clinician had their own identity rather than sharing one identity across the group. The identity was built with Entra Agent ID, which the source names as the identity platform used for clinician identities. Because every clinician had a separate identity, every later decision about access could be tied to one specific person.

Definition

Role-based access control is a security approach that restricts what a user can do according to the role that user holds within an organization. In this implementation, the restricted party is the agent identity created for each clinician, and the role determines what that agent may reach.

Creating an identity is not the same as granting access. The identity exists first, and the reach is attached afterward. This separation matters because the two steps can be reasoned about, reviewed, and removed independently. An identity with no scope cannot reach anything useful, and a scope is only meaningful when it is attached to a specific identity.

Following an Agent Identity Through Its Stages

An agent identity does not stay in one unchanging state. The source describes a small set of stages: the identity is created at onboarding, it is scoped through role-based access controls, it is reviewed on a recurring schedule, and it is eventually revoked when the clinician leaves. The diagram below lays these stages out as states and the events that move an identity from one to the next. It is a map of what can happen to an identity over time, not a description of any particular software screen.

Createdat clinician onboardingScopedrole-based access controlsattachedIn Useacting for the clinicianUnder Reviewninety-day cadenceRevokedwhen the clinician leavesscope attachedidentity activeninety days elapsereview completedclinician leaves
What states does a clinician's agent identity pass through, and what triggers each move from one state to the next?

Read the diagram from left to right. The identity is created when the clinician is onboarded, and scoping follows. Once the identity is in use, it returns to the review step on the customer's standard access-review cadence of ninety days, so it is checked again on that schedule rather than trusted indefinitely. The only event the source ties to ending the identity is offboarding. A review does not end the identity's life; it confirms that the identity may continue.

Worked example

Tracing one clinician's identity from start to finish

A new clinician joins a clinic. Using only the lifecycle described in the source, describe what happens to that clinician's agent identity.

  1. 1
    Onboarding

    The implementation creates an agent identity for the new clinician, built with Entra Agent ID. It is the clinician's own identity, not a shared one.

  2. 2
    Scoping

    The identity's reach is set through the EHR's role-based access controls, so it can work with this clinician's patient panel and nothing beyond it.

  3. 3
    Periodic review

    While the clinician remains employed, the identity is rechecked on the ninety-day access-review cadence rather than being trusted without limit.

  4. 4
    Revocation

    When the clinician leaves, the offboarding process revokes the identity. Nothing in the source says the identity is reused for someone else.

Result

The identity moves through creation, scoping, repeated review, and finally revocation. Each stage has a distinct job, and only offboarding ends the identity.

Where the Role Boundary Is Attached

Scoping is the step where an abstract role becomes a concrete boundary. The source gives the example of a clinician whose agent can work with that clinician's patient panel and nothing beyond it. The scope is what the system consults when a request arrives, so it determines whether a request for a particular patient record is allowed or refused.

Worked example

Deciding whether a record request is allowed

Dr. Lee's agent identity is scoped to Dr. Lee's patient panel. Dr. Lee requests a record for a patient in a colleague's panel. What should the system do?

  1. 1
    Identify the identity

    The request arrives under Dr. Lee's dedicated agent identity, not under a shared group identity.

  2. 2
    Compare against scope

    The system checks the requested record against the patient panel attached to that identity.

  3. 3
    Decide

    The record lies outside Dr. Lee's panel, so the request is refused.

Result

The request is refused because the scope attached to Dr. Lee's identity does not reach the colleague's patient.

Tracing the Departure Timeline

Creating and scoping an identity protects the system while the clinician is employed. The harder question is what happens when the clinician leaves. The implementation handled this through its offboarding process, which automatically revoked the departing clinician's agent identity. The source reports that two months after go-live, a clinician left the system, and the identity was auto-revoked within four hours. The timeline below shows the order of those events.

Clinician leavestwo months after go-liveAccess still possibleuntil revocation runsIdentity revokedwithin four hoursoffboarding startsup to four hours
How much time passes between the clinician's departure and the removal of their access, and what happens during that gap?

The four-hour figure is the window the customer's security team chose deliberately to limit misuse. The source does not describe any activity during the gap, so the honest reading is that the window is the period during which a departed clinician's identity could still exist before revocation removes it. Shortening that window reduces the time in which misuse is possible.

Keeping Every Action Traceable to a Person

Scoping and revocation control who may act. A third requirement controls how actions are recorded. The audit log had to connect every agent action to a specific human clinician and to a specific timestamp. A record of activity is only useful if someone can answer which clinician's agent did something and when, and that answer depends on giving each clinician their own identity. Without individual identities, the log would point to a generic account rather than to a person.

Clinicianhuman who is responsibleAgent identitydedicated to this clinicianEHRchecks role-based scopeAudit logclinician and timestamp1. request made through identity2. action checked against scope3. action recorded
When an agent performs an action, how does the audit record link that action to the responsible human clinician?

Read the sequence from top to bottom. The clinician acts through their own agent identity. The EHR checks the action against the scope attached to that identity. The action is then written to the audit log together with the clinician it belongs to and the timestamp. Because the identity itself was dedicated to one clinician, the log entry can be traced back to that person.

Mistakes When Identities Are Shared

  • Common mistake

    Treating creation of an identity as the same thing as granting access

    What it looks like

    An identity is created for a new clinician, and the team assumes it can now open any patient record.

    Why it fails

    The source separates creating the identity from scoping it. Reach is set by attaching the role-based scope, which limits the identity to the clinician's patient panel.

    Do this instead

    Treat creation and scoping as two distinct steps, and confirm the scope before relying on the identity.

  • Common mistake

    Sharing one identity across a group of clinicians

    What it looks like

    Several clinicians act through the same account, and the log shows only that account.

    Why it fails

    The audit log can link an action to a specific clinician only because each clinician had their own identity. A shared identity removes that link.

    Do this instead

    Give each clinician a dedicated identity so every action can be traced to one person.

  • Common mistake

    Assuming a periodic review ends the identity

    What it looks like

    A review on day ninety is read as the end of the identity's life.

    Why it fails

    The source ties the end of the identity only to offboarding. The review rechecks the identity on a recurring schedule.

    Do this instead

    Use reviews to confirm the scope and continue the identity, and rely on offboarding for revocation.

  • Common mistake

    Leaving the revocation step for later, which extends the time a departed clinician's identity could still act

Practice Tracing a Departure

MEDIUM

A clinician named Priya was onboarded, given a dedicated agent identity, and scoped to her own patient panel. Two months later she leaves the organization. Using the lifecycle and timeline from this article, describe each state her identity passed through, state which event ended it, and explain why the gap before revocation matters. Then explain how an audit entry for an action taken during her time in the system would still point to her.

Hints
  • List the lifecycle states in order: created, scoped, in use with periodic review, and revoked.
  • The source says revocation happened within four hours of departure. Think about what the security team was trying to limit.
  • Ask what the audit log needs in order to name a person rather than a generic account.

Key Takeaways

  • Role-based access control limits what a clinician can reach by attaching a scope to a dedicated agent identity, so a request is allowed only inside that clinician's patient panel.
  • An agent identity is created at onboarding, scoped through the EHR's role-based access controls, rechecked on a ninety-day review cadence, and revoked when the clinician leaves.
  • Offboarding automatically revoked the departed clinician's identity within four hours, a window chosen deliberately to limit misuse.
  • The audit log ties every agent action to a specific clinician and timestamp, which depends on giving each clinician their own identity rather than sharing one.