This guide applies to Mac computers and Windows devices
Product Name Update: Throughout this guide, you may notice references to both “Kandji” and “Iru Endpoint.” Our product is now called Iru Endpoint, but some integration interfaces may still display the previous name. This is a temporary situation that will be resolved as our integration partners update their systems.
About Authorizing Your Iru Endpoint Tenant for Okta Workflows
Authorizing your Iru Endpoint tenant for Okta Workflows enables you to use the Iru Endpoint connector to integrate device management with Okta Workflows, automating critical user lifecycle components.How It Works
The Iru Endpoint connector integrates device management with Okta Workflows, helping to automate critical user lifecycle components that are prone to friction or manual error. This integration allows you to create workflows that automatically respond to user lifecycle events and device management tasks.Prerequisites
Before you begin, ensure you have:- Okta Workflows admin credentials
- Iru Endpoint administrator access
- API access enabled in your Iru Endpoint tenant
Authorizing Your Iru Endpoint Tenant
When you add an Iru Endpoint card to a Workflow for the first time, you’ll be prompted to configure the connection. This will enable you to connect your Iru Endpoint API token, save your token information, and reuse the connection for future Workflows.You can create and manage multiple connections from your Connections page.
Creating an Iru Endpoint Connection
Prerequisites:- Okta Workflows admin credentials
- Iru Endpoint Connection nickname
- Iru Endpoint API key
- Iru Endpoint domain (following the format accuhive.api.kandji.io or accuhive.api.eu.kandji.io)
| Permission | Description |
|---|---|
| Devices: Device Information: Device list | Get a list of all devices in the Iru Endpoint tenant |
| Devices: Device Information: Device details | Get the full details for a specific device |
Creating an API Token in Iru Endpoint
To create an API token to use for the Iru Endpoint connector:1
Verify API Access
Confirm that your Iru Endpoint tenant has API enabled. If it doesn’t, contact your Customer Success Manager.
2
Access Iru Endpoint
Sign in to the Iru Endpoint web app with administrator credentials.
3
Navigate to Settings
In the left sidebar, click Settings.
4
Access API Settings
Click Access.
5
Add API Token
In the API Token section, if your tenant doesn’t already have an API Token, click Add API Token Otherwise, click Add Token.
6
Configure Token Name
In the Name field, enter a name such as Okta Workflows.
7
Add Token Description
In the Description field, enter a description such as Allow Okta Workflows to use the Iru Endpoint API.
8
Create Token
Click Create.
9
Copy API Token
In the Copy your API token dialog, click Copy Token.
10
Store Token Securely
Store the copied token in a safe place. If you lose the text for the token, you can delete it before you use it and create a new one with the steps above. You’ll use this token in step 3 of the next section.
11
Confirm Token Copy
Select the checkbox for I have copied the token and understand that I will not be able to see these details again.
12
Continue Setup
Click Next.
13
Configure Permissions
In the Manage API Permissions dialog, click Configure.
14
Select Permissions
In the Permissions section, select the checkbox for each area to which you want Okta Workflows to have access. For example, select the checkbox for Blueprints Management to enable all permissions for inspecting and modifying Blueprints. Note: You can click the disclosure triangle to the right of the permission type to display more specific permissions.
15
Review Permissions
Review the permissions you’ve configured for the API token.
16
Save Configuration
Click Save then Close.
17
Verify Token Creation
In the API Token section, confirm that your new token is displayed.
18
Copy API URL
In your organization’s API URL field, copy or make a note of your Iru Endpoint domain.
Setting Up a Connection
1
Create New Connection
In Okta Workflows, from the Connections page or any card, click New Connection.
2
Select Kandji Connector
In the New Connection window, scroll if necessary, then select Kandji.
3
Configure Connection Nickname
In the Connection Nickname field, enter a unique name that will help you distinguish multiple Iru Endpoint tenants or multiple Iru Endpoint API keys.
4
Enter API Key
In the API key field, enter or paste the text of the API token you generated in step 10 of the previous section.
5
Enter Domain
In the Kandji domain field, enter your full Iru Endpoint domain (from step 18 of the previous section).
6
Create Connection
Click Create.
Using the Connection in Workflows
1
Create New Flow
In Workflows go to the Flows section and click +New Flow.
2
Add App Action
Click Add app action.
3
Select Kandji
In the My Connected Apps section, click Kandji.
4
Choose Connector Card
Select a connector card.
5
Configure and Continue
Configure the card and continue building your workflow.
