Torii workflow is a powerful feature that brings powerful automation capabilities without the need to write any code.
- A workflow consists of a trigger and a set of actions
- The trigger is what sets the workflow in motion through defined criteria. Actions are executed in sequential order once the workflow has been triggered
- Workflows are triggered when the defined criteria are met
- There is no limit to how many actions a single workflow can contain
How Workflow Criteria are Evaluated
It is essential to understand that workflow criteria are evaluated against Torii data which can also be viewed in Torii's UI console. As Torii syncs data from external sources every 24 hours, Torii's data and the source data might not always be in sync.
For example, assume you have a workflow with the following criteria:
This workflow would trigger when the status of a user in Google Workspace (G-Suite) is suspended.
You should expect this workflow to be triggered only when Google Workspace data has been synced to Torii and Torii workflow criteria have been evaluated.
When are Workflow Criteria Evaluated?
Torii syncs data from the integrations every 24 hours at 2:00 am GMT.
Workflow trigger criteria are evaluated every hour on the half-hour (e.g. 9:30, 10:30, 11:30, ...)
7:00 pm GMT - Google Workspace user
email@example.com been set to "Suspended" on Google Workspace
2:00 am GMT - Torii syncs data from Google Workspace
2:30 am GMT - Torii evaluates the criteria and finds that
firstname.lastname@example.org the criteria and triggers the workflow
Using "User" groups as workflow trigger criteria
One of Torii's workflow triggers capabilities is to use a user's attribution to certain user groups (such as Okta groups or Google Workspace groups) to trigger workflows.
Use Torii's filter to focus your workflow with multivalue groups.
This can be very useful in cases such as onboarding and offboarding workflows, where you can provision or deprovision applications to a user based on which user group they belong to.
Currently, we support this capability for Okta and Google Workspace groups, and more will be added in the future.
To use a user group in a workflow trigger:
- From the workflow, simply select the application and the application group field, in this example, "Okta Groups."
- Select the specific group you want the workflow to apply to.
- You can click Preview to test the process and see who this workflow will currently lt apply to.
- Click Next to continue setting up the workflow.
Workflow Criteria Preview
By clicking the
Preview button in the workflow criteria filter, you can view the entities that currently meet the criteria. This preview helps you fine-tune your criteria to match only the needed entities.
Pay attention that the preview only shows entities that match the criteria as of that moment and will not necessarily cause the workflow to be triggered once activated. Read about how to run workflow retroactively in this article.
A: If an app integration has no workflow actions available within Torii, it will not appear in the workflows actions list.