User Offboarding V2 Crate
If you’re new to Crates, read through our introductory Crate documentation here. The User Offboarding V2 Crate can be found in our Crate Marketplace.
What does the User Offboarding V2 Crate do?
Our User Offboarding V2 Crate offers a robust logging system and greater flexibility than our original V1 of the Crate. It was designed with standardization and simplification in mind. Each of the workflow tasks and functions are contained within a subworkflow that contains a log message with the results and status of the subworkflow. This allows for easier troubleshooting, and even modification of the workflow.
Why use the User Offboarding Crate?
Offboard users that are in the following Active Directory configurations:
Azure Active Directory
On-premises
Hybrid Synced - Active Directory sync
Hybrid Not Synced - No Active Directory sync
Increase time savings and decrease the potential for user error
Maintain compliance and security standards
Generate an audit trail by logging actions and their result within your PSA
Crate prerequisites
Required integrations:
The Microsoft Cloud integration bundle must be set up. This enables Microsoft Graph API access for Azure AD and M365 deprovisioning.
Optional integrations:
For on-premises setup, you’ll need an RMM integration or Agent Smith to run commands against the domain controller.
PSA Integration must be setup. This is required for automated ticket creation and ticket updates.
Documentation Integrations must be set up if you wish to create documentation in your knowledge base.
Required organization variables
default_psa
Identifies the PSA that you use
default_rmm
Identifies the RMM that you use
primary_identity_provider
Specify where users are created for the organization, either on premise or in Entra
psa_default_board_id
The default PSA board (or other organizing feature) that Rewst will use to create tickets on when running automations
psa_default_ticket_status
The default ticket status that Rewst will use when updating tickets. This is the status that Rewst will use when actively working on a ticket. It usually set to "In Progress" or a similar status.
psa_ticket_status_completed_task
The default ticket status that Rewst will use when we finish an automation. Consider this the "quality check" status to make sure everything ran properly.
Optional organization variables
no_ticket_time
Set this when you don't want automation to put time_worked in tickets. The "Yes" option will add notes in the ticket we create when running an automation. The "No" option will let us impersonate a technician to apply time under there name for automations that run. We do this because we can't apply time via the API for most PSAs.
require_approval_for_offboarding_users
set ‘true’ to require approval for offboarding a user.
offboarding_user_approval_email
set this to the person who needs to approve the user being offboarded.
preferred_domain_controller
Choose this DC instead of letting automation decide
rmm_preferred_adconnect_server
If your ADConnect is on a specific server, specify it here
onprem_no_adsync
If there is no ADSync configured between on-prem and M365 (needs to be added manually)
psa_default_tech_id
Tech Id to user when updating ticket time
psa_default_ticket_urgency
Sets the tickets urgency (PSA specific)
psa_default_ticket_source
Sets the tickets source (PSA specific)
psa_default_ticket_priority
Sets the tickets priority (PSA specific)
psa_default_ticket_impact
Sets the tickets impact (PSA specific)
psa_default_tech_worktype
Sets the tickets worktype (PSA specific)
nable_device_filter_id
if using n-able rmm, this is required to properly match the preferred domain controller.
automation_task_offboard_user_time
Default time for the "Offboard User" workflow, to add to the ticket at completion
Unpack the User Offboarding V2 Crate
Navigate to Crates > Marketplace in the Rewst platform.
Click on the Crate tile to begin unpacking.
Click Unpack Crate.
Click Continue.
If you wish, update the workflow name.
Add your Time Saved.
Click Unpack to install the workflows, triggers, and forms. A dialog will appear with the in-progress Crate unpacking. Note that this is a large Crate, and the process may take a few minutes.
Test the Crate
Navigate to Automations > Forms.
Search for
user offboarding
to find the form unpacked from the Crate.Click the ⋮ next to the form.
Click usages, then View direct URLs.
Select the form of the customer for which you wish to test.
Run through the form and test offboarding a user.
Considerations when migrating between Crate versions
If you're considering migrating from V1 of this Crate to V2, follow the steps found on the page below:
Migrating between Crate versionsNote: Rewst-managed workflows that contain the above functionality will automatically be updated when v1 is officially deprecated.
How is this different from v1?
While there are numerous bug fixes and enhancements to V2, below is a list of the most requested changes.
Improved ticketing functionality and control
Support for the following Active Directory configurations:
Azure AD
On-premises (NEW)
Hybrid Synced (ENHANCED)
Hybrid Not Synced (ENHANCED)
Ability to offboard email-only users when the primary identity provider is on-premises AD.
New modular design that allows for rapid enhancements, fixes, and customizations.
Expanded error handling allowing for task-specific logging
Improved parallel action execution addressing bugs that prevented the use of workflow listeners.
Troubleshoot the User Offboarding V2 Crate
Common issues include:
Missing org variables can cause the workflow to fail or not work as expected.
Missing trigger overrides can cause errors in the workflow.
Tips:
This workflow contains a robust logging system, and can be checked for detailed information on sub-workflow success and data output. This can be used to diagnose issues in the workflow.
The notes section of this workflow is one of its most powerful features. You can search the notes tab for functions such as
disable account
ormailbox
and quickly be taken to that section of the workflow. This can be useful to find specific parts of the workflow that you want to adjust or view.
Got an idea for a new Crate? Rewst is constantly adding new Crates to our Crate Marketplace. Submit your idea or upvote existing ideas here in our Canny feedback collector.
Last updated
Was this helpful?