Skip to navigation

Provisioning methods for entitlements

View as Markdown

Every entitlement has a provisioning action (how access is granted) and a de-provisioning action (how access is revoked). When an employee’s access request is approved, the AccessOps Manager coworker carries out the provisioning action you set here.

Not every app has an identity provider (IdP) group behind it. Besides IdP groups, you can grant and revoke access by running a script from your Code library, or by assigning the access request to a group or agent.

You pick the method from three tabs:

TabMethodsUse it when
Add to IdP groupAdd to Okta group, Add to Entra group, Add to Google Workspace groupThe app’s access is managed through an IdP group.
Custom actionRun code scriptThe app has an API but no IdP group. A published script calls the API.
Assign ticketAssign to group, Assign to agentA team, a person or an AI Coworker should fulfill the request.

Before you begin

  • Permissions: You need permission to manage applications (Settings > Access management > Applications).
  • AccessOps Manager: The AccessOps Manager coworker must be published. See Setting up agentic access provisioning.
  • For Run code script: The script must be published in the Code library. See Code library.
  • For Assign ticket: The group or agent must be in the workspace you pick.

Open an entitlement’s provisioning settings

  1. Go to Settings > Access management > Applications and open an app from the Managed tab.
  2. Open the Entitlements tab and click an entitlement. To create one, click Add.
  3. In the Edit entitlement dialog, fill in Basic details, then go to Provisioning.
  4. Under Provisioning action, open Method. Pick a tab, then pick a method. You can also search.

Grant access with a code script

Use this for apps you can reach through an API but that have no IdP group, such as internal tools or SaaS apps without a connector.

1

Choose Run code script

On the Custom action tab, pick Run code script (“Grant access by running a published code script.”).

Custom action tab in the Method picker, showing Run code script

2

Pick the script

Under Code script, pick a published script from your Code library.

3

Choose how access is revoked

Leave De-provisioning action is same as the provisioning action selected to revoke with the same script, or clear it to choose another method. See Set a separate revoke method.

4

Collect information (optional)

Under Collect information (optional), click Add a question for anything the requester needs to tell you, such as a team name or a license tier.

5

Save

Click Save.

Run code script with a script selected and the de-provisioning checkbox selected

If you keep De-provisioning action is same as the provisioning action selected, write the script so it handles revoking as well as granting. Atomicwork doesn’t undo a script’s changes on its own.

To keep secrets out of your script, see Use saved credentials in code.

Grant access by assigning the access request

Use this when a team, a person or an AI Coworker should do the provisioning.

1

Choose a method

On the Assign ticket tab, pick one:

  • Assign to group: “Assign the access request to a group for fulfillment.”
  • Assign to agent: “Assign the access request to an agent for fulfillment.”

Assign ticket tab in the Method picker, showing Assign to group and Assign to agent

2

Pick the workspace and target

Pick the Workspace, then the Group or agent in that workspace.

3

Choose how access is revoked, then save

Set the de-provisioning action, add any Collect information (optional) questions and click Save.

Assign to group for provisioning and de-provisioning, each with a workspace and group

When a request for the entitlement is approved, the access request is assigned to the group or agent you picked so they can fulfill it.

Set a separate revoke method

Clear De-provisioning action is same as the provisioning action. A De-provisioning action section appears with the same choices:

  • Remove from IdP group
  • Custom action: Run code script (“Revoke access by running a published code script.”)
  • Assign ticket: Assign to group or Assign to agent, which assign the revocation request

For example, you can grant access with a script and remove it from an Entra group.

Separate De-provisioning action: grant with a code script, revoke by removing from an Entra group

Set methods with AI Assist

You can also ask AI Assist to set how an existing entitlement is granted or revoked. It can set Run code script, Assign to group and Assign to agent, and asks you to confirm before it makes the change. To use an IdP group, set it in the entitlement dialog. See AI Assist.

Good to know

  • Existing entitlements keep working. Entitlements set up before these methods were added keep their current configuration.
  • Pending requests use the current method. If you change an entitlement’s method, requests still waiting to be fulfilled use the new one.