Overview
Just-in-Time User Provisioning lets you automate the creation and management of users in your MoEngage workspace. This feature creates users directly from your Identity Provider on their first login.Advantages
- Faster onboarding: New team members can access MoEngage immediately without waiting for a manual invitation.
- Dynamic role assignment: Roles can be automatically assigned or updated from the identity provider (if enabled in MoEngage).
- Temporary access: Provide session-based access to your users, where they can be automatically deleted after their session ends (if enabled in MoEngage).
Access Just-in-Time User Provisioning
- On the left navigation menu in your MoEngage workspace, navigate to Settings > Account > Security > Login.
- Click Single Sign On (SSO) only.
Note: Ensure SSO is configured. For more information, refer to how to configure SSO. - Scroll to the Automate user provisioning section.

Permissions to Access
The following table describes the permissions required to access and use JIT provisioning:| Permission Component | Permission Name | Details |
|---|---|---|
| Security Settings | Setup & Manage | Allows you to view, enable, update, or disable user provisioning. |
Step 1: Enable Just-in-Time User Provisioning
- Turn the Automate user provisioning toggle on.

The Configure provisioning method dialog box appears. - Select JIT Provisioning as your configuration type.

Step 2: Configure and Save
- Provide the following fields:
Field Required Description Default role Yes - MoEngage requires a fallback role. If the role is not passed from the Identity Provider (via the SAML assertion call) or does not contain the role value, the user is assigned this default role to access the workspace.
- All default and custom roles are available for selection as the default role.
Update user’s role Optional If checked, the user’s role in the workspace is updated based on the value received from the Identity Provider in each SAML assertion call.
Note: If unchecked, and the user’s role received from the Identity Provider is different from the role in the workspace, the user is granted access based on the role received from the Identity Provider for that particular session only, without any permanent changes to their role in the workspace.Delete user at the end of the session Optional If checked, the user is deleted and removed from that workspace either when the session expires (for example, user logout or force logout) or after 24 hours, whichever happens first. - Click Save.

The Save your configuration dialog box appears, prompting you to confirm your configuration. - Click Confirm.

The enabled successfully message appears.
Identity Provider (IdP) Setup
JIT provisioning supports the following Identity Providers:- Okta
- Microsoft Azure
- OneLogin
- Any Identity Provider that supports Just-in-Time User Provisioning
- Okta
- Azure
Step 1: Add the Role Attribute to the MoEngage SSO Application
- Navigate to the Okta Admin Console.
- On the left navigation menu, click Directory > Profile Editor.

- On the Profile Editor page, select the MoEngage SSO application you created, or use the Search for people, apps, and groups box to find it.

- Click Add Attribute.

The Add Attribute dialog box appears. - In the Data type list, select string.
- In the Display name box, enter role.
- In the Variable name box, enter role.
- In the Description box, enter role.
- Click Save.
Step 2: Configure SAML Attribute Statements
- Navigate to Applications > Applications and click the MoEngage SSO application.

- Click the Sign On tab and scroll down to the Attribute Statements (Optional) section.
- Click Show legacy configuration to expand the section.
- Click Edit adjacent to the Profile attribute statements section and enter the following details:
Field Value Name role Name format Basic Value appuser.role - Click Save.

Step 3: Assign the User and Define the Role
- Navigate to Applications > Applications and click your MoEngage SSO application.

- On the Assignments tab, click Assign > Assign to People.

- In the assignment attributes modal, locate the Role field and enter the exact role name (for example, Admin, Manager, Marketer, or a custom role) as defined in your MoEngage workspace.
- Click Save and Go Back, and then click Done.

- To update an existing user:
- In the Assignments tab, click the pencil icon
next to the user. - Edit the role and click Save.

- In the Assignments tab, click the pencil icon
Step 4: Validation
After the setup is complete, log in to MoEngage through your Identity Provider (IdP). To verify that roles are passed correctly, inspect the ACS payload and confirm that the role attribute contains the expected value as passed in the Identity Provider and defined in MoEngage (for example, Admin). This confirms that users are assigned the appropriate role upon redirection.Update or Disable JIT Provisioning Configuration
Update Configuration
- Navigate to the Automate user provisioning section.
- Click Edit.

- Modify the required settings as needed.
- Click Save.

The Save your configuration dialog box appears, prompting you to confirm your configuration. - Click Confirm to apply the changes.

Disable Configuration
- Navigate to the Automate user provisioning section.
- Turn the Automate user provisioning toggle off.

The Disable user provisioning dialog box appears. - Click Confirm.

The JIT provisioning disabled successfully message appears to confirm the action.
Security and Logs
- 2FA and firewall: Existing firewall rules apply to the users created via Just-in-Time User Provisioning. If 2FA is enforced for the workspace, these users must set up and enter a 2FA code upon login.
- Audit logs: All activities, including enable, disable, and update operations and user create, delete, and update operations, are recorded in the Audit Logs under Login settings.
- Notifications: Admins receive email notifications whenever Just-in-Time User Provisioning is enabled or disabled, or when a new user is created via Just-in-Time User Provisioning.
FAQs
What happens if I try to enable Just-in-Time User Provisioning while SCIM is enabled?
What happens if I try to enable Just-in-Time User Provisioning while SCIM is enabled?
What happens if the Delete user at the end of the session checkbox is NOT selected?
What happens if the Delete user at the end of the session checkbox is NOT selected?
What happens if the Delete user at the end of the session checkbox IS selected?
What happens if the Delete user at the end of the session checkbox IS selected?
What happens if I switch from using SCIM to JIT?
What happens if I switch from using SCIM to JIT?
What happens if multiple role values are received in the SAML assertion call for a user?
What happens if multiple role values are received in the SAML assertion call for a user?
What happens to a user if I perform user management operations via the Team Management > Members page while JIT is configured?
What happens to a user if I perform user management operations via the Team Management > Members page while JIT is configured?
- Invite: The user is invited to the workspace.
- Update Role: The user’s role can be updated. However, it is only effective if the option to update users’ roles under JIT configuration is not selected.
Note: This option is provided to facilitate role updates for users who are not part of the JIT application in the Identity Provider but are part of the SSO application, or are admins logging in via password (and not part of any application in the Identity Provider). - Revoke Access: The user can be deleted or access can be revoked using the same page. However, if the user is part of the IdP application where JIT is configured, the user can log in again.









