Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt

Use this file to discover all available pages before exploring further.

Connect Okta to automate application access requests and user provisioning through Okta groups. Sync Okta users, groups, and applications, then enable workflow actions to manage group memberships and provision application access.

What you can do

Group management

Add/remove users from Okta groups and check group memberships

Application access

Provision and deprovision application access automatically

Workflow interpolation

Use Okta user metadata in workflow conditions and actions

User profile data

Ravenna syncs Okta user profiles for org hierarchy, approval workflows, and workflow interpolation.

Available fields

FieldDescription
titleJob title
departmentDepartment name
organizationOrganization name
userTypeUser type classification
primaryPhonePrimary phone number
mobilePhoneMobile phone number
cityCity
stateState or region
countryCodeCountry code
managerEmailCustom Okta profile field for manager’s email address (checked first for manager relationships)
managerIdManager’s email address or Okta user ID (checked second for manager relationships)
managerManager’s email address (checked last for manager relationships)
Ravenna checks managerEmail first, then managerId, then manager when establishing manager-employee relationships. Using email addresses ensures accurate matching across systems.

Auto-provisioning during sync

When Ravenna syncs users from Okta, any Okta user who doesn’t already have a matching Ravenna account is automatically created as an Organization Guest. This ensures your Ravenna directory stays in sync with your identity provider without requiring manual user creation.
The managerEmail field is optional and requires a custom Okta profile field configuration. If your Okta organization uses a custom profile field for manager email addresses, configure it in your Okta admin console and ensure it’s named managerEmail.

Using profile data in workflows

Access these fields through the user’s Okta metadata when building workflow conditions or actions:
  • Route approval requests based on department or organization
  • Apply different access policies by user type
  • Include contact information in notifications
  • Build location-based access rules using city, state, or country