Okta

Pull user, application, assignment info and more to connect across tools.

Overview

Use the Okta integration to identify problems with your users, applications, groups and assignments before they occur. Integrating with Okta enables you to build boards that correlate fields within Okta and with other connected tools. You can also run actions on fetched data without ever leaving Stitchflow.

Generate API key

To create a new API Token you must be a Super Admin or have delegated permissions.

1. Navigate to Security > API in Okta

2. Click Tokens

3. Click Create token

4. Enter token name and click Create

5. Copy token value to connect in Stitchflow

Configure

Enable the Okta integration from Connections in the left sidenav. Click Connect and enter your subdomain and API key. Before connecting, Okta will sync for a few minutes while fetching data. Once connected, you can click the ... menu on the Okta integration tile to manage permissions or disconnect the integration.

Manage permissions

Okta actions allow you to run operations on fetched data without ever leaving Stitchflow. All actions are enabled by default and will be accessible on every board, but can be disabled by clicking the ... menu and selecting Manage permissions.

Disconnecting Okta will also permanently delete any boards in which it is used.

Data model

Fields

We automatically fetch and relate the following objects from Okta resources.

Supported objects

• Applications

• Devices

• Groups

• Policies

• Users

• Users + Apps

Custom fields

Please note custom fields sync and get fetched every 24 hours or if you re-authenticate your Okta connection.

We also support custom attributes on the user profile. To add a custom attribute to a user profile in Okta, you can:

1. In the Admin Console, go to Directory > Profile Editor

2. Click Okta in the Filters list

3. For Okta User (default), click Profile. If Profile is unavailable, click User (default)

4. Click Add Attribute

Supported attribute types:

• String: A chain of zero or more unicode characters (letters, digits, and/or punctuation marks)

• Number: A floating-point decimal in Java's 64-bit Double format. See Platform Specification

• Boolean: Stores true, false, or null data values

• Integer: Whole numbers in 64-bit Java's Long format

• Array: A sequential collection of data types

Actions

We support the following actions in Okta.

Supported actions

• Remove app

• Activate app

• Deactivate app

• Remove user from app

• Add app to group

• Remove app from group

• Add group

• Remove group

• Add user to group

• Remove user from group

• Activate user

• Reactivate user

• Deactivate user

• Suspend user

• Unsuspend user

• Delete user

• Delete device

• Activate device

• Deactivate device

• Suspend device

• Unsuspend device

• Unlock user

• Reset password

• Expire password

• Reset factors

• Clear current user sessions

• Forgot password

• Change password

• Create user without credentials

• Create user with recovery question

• Create user with password

• Create user with password and recovery question

• Create policy

• Delete policy

• Activate policy

• Deactivate policy

• Create rule

• Delete rule

• Activate rule

• Deactivate rule

• Unenroll factor

• Activate factor

Boards

When building a board, you can select any supported Okta resource as your object to indicate the data you want to surface on your board. We automatically determine the primary field for each object. The primary field is meant to be a unique representation of each record in a board.

An object in Stitchflow is a data type that is used to treat several different pieces of data as one unit.

Adding fields

Click Add field to select fields from both within Okta and across your other connected tools. We only show fields that can be joined with your chosen object.

Triggering actions

Click Integration actions in the top right of any board to view all available actions across your connected integrations. When selecting an action, you'll be prompted to fill out all required inputs necessary to run the action. Changes and updates made via actions will persist to all boards.

Stitchflow fetches Okta data every 24 hours.