All agents
IT

Unlock User Account

Restores access for locked-out users across all integrated identity providers through a single verified, automated flow
One run, end to endResolved
  1. 1Triggered when a user requests their account to be unlocked
  2. 2Verifies the requester's identity through a secure authentication step
  3. 3Checks for active security flags or suspicious activity on the account
  4. 4Unlocks the account across the configured identity systems
  5. 5Confirms restored access with the user through their preferred communication channel
  6. 6Updates the ticket with the full outcome for audit and traceability

Overview

What Unlock User Account does

Unlock User Account is Harmony's automated workflow for restoring access to an employee's work account after it has been locked out - typically due to too many failed login attempts. The employee asks the helpdesk chatbot, Harmony checks the account status to confirm it's actually locked, verifies the employee's identity, unlocks the account in the identity provider, and terminates any stale sessions - all without IT needing to touch the IdP admin console.

Who it's for

Who Unlock User Account Is For

Persona

Employees who are locked out of their work account and can't log in even though they know their password.

Pain point

Account lockouts are urgent and disruptive - an employee can't work until their account is unblocked. Without automation, this requires an IT agent to locate the account, verify the request is legitimate, and manually unlock it in the IdP. Harmony handles the entire loop automatically, so the employee's access is restored in minutes rather than waiting in an IT queue.

How it works

How Unlock User Account Works

Trigger

An employee tells the helpdesk chatbot they can't log into their work account. The chatbot checks the account status first to confirm it's actually locked (not a password or MFA issue).

  1. 1

    Status-based routing

    If the account is locked, the chatbot explains what the unlock will do and asks for confirmation. If the account is active, password-expired, or in an escalation state, the chatbot routes to the appropriate workflow or opens a regular IT ticket instead.

  2. 2

    Identity verification

    The workflow verifies the employee via OTP (one-time passcode) or Okta Verify, using recovery contact information from the IdP. If verification fails or times out, the ticket is escalated to IT.

  3. 3

    Account unlock

    On successful verification, the workflow calls the IdP to unlock the account. If the unlock succeeds, the flow continues; if it returns a non-"UNLOCKED" status, the ticket is escalated.

  4. 4

    Session cleanup

    After unlocking, the workflow terminates all active sessions in the IdP to ensure the employee starts fresh.

Outcome

A success notification is sent to the employee via DM with instructions to sign in using their existing credentials. The ticket is resolved.

Capabilities

Capabilities

Check account status before acting

Always verifies the account is actually locked (not just password-expired or in an unknown state) before offering or triggering the unlock flow.

Verify identity before unlocking

Sends an OTP or uses Okta Verify to confirm the employee's identity before making any changes in the IdP.

Unlock accounts in Okta

Directly removes the lockout state from the employee's Okta account (the confirmed supported IdP for account unlock).

Terminate active sessions after unlock

Clears all active IdP sessions after the unlock so the employee signs in fresh with clean state.

Status-based routing

The agent interprets account status ("locked", "active", "password_expired", "requires_escalation") and routes to the right workflow or escalates rather than attempting an unlock for the wrong state.

Context-aware escalation path

If password reset or MFA reset workflows are enabled for the tenant, the agent offers those for non-locked states rather than just opening a general IT ticket.

Post-unlock guidance

If the employee still can't log in after a successful unlock (such as due to a separate MFA issue), the agent instructs them to start a new conversation for the next step.

Use cases

Main use cases

01

Employee Locked Out After Too Many Failed Attempts

An employee tried the wrong password several times and their Okta account got locked. They know their password - they just can't get past the lockout. The chatbot checks the account status, confirms it's locked, verifies the employee's identity via OTP, unlocks the account in Okta, terminates stale sessions, and sends a confirmation DM - all without an IT agent.

02

Employee Who Thinks They're Locked Out but Actually Forgot Their Password

An employee says "my account is locked" but the status check shows the account is active - they've actually forgotten their password. The chatbot reads the status check result, doesn't trigger an unlock (which would do nothing), and routes the employee to the Password Reset workflow instead.

03

Employee Locked Out Who Also Has MFA Concerns

An employee unlocks successfully but then finds they also can't complete MFA because they got a new phone. The post-unlock success message explains that if they still can't sign in, they should start a new conversation - the chatbot then handles the MFA reset as a separate workflow in the next conversation.

Integrations

IntegrationRole in the agent flow
OktaAccount status check, account unlock, and session termination - the confirmed supported IdP for this workflow
Service Desk (internal)HIGH-priority ticket created at request time; updated throughout; resolved on successful unlock or escalated on failure
Notifications system (Slack/Teams)Delivers OTP for identity verification; sends success confirmation or escalation notice via DM

FAQ

It's both. The AI Helpdesk chatbot handles the conversation - checking account status, explaining what the unlock will do, and asking for confirmation. Once the ticket is created, a deterministic workflow takes over: identity verification, account unlock in the IdP, session termination, and ticket resolution.

See Unlock User Account on your own requests

Connect your stack and we will walk you through a real run in a 30-minute session.