Search Devices

Search for devices registered in Okta and return information about the device.

Options

Field Definition Type Required

Result Set

Choose one of the following options to display your search results:

  • First Matching Record: Returns only the first record that matches the search query.

  • First 200 Matching Records

  • Stream Matching Records: Passes all matching records from your parent flow to a helper flow.

    Selecting this option adds a Streaming input section to the card where you can select a helper flow for streaming and add custom extensible fields.

Dropdown

TRUE

Input

If you specify multiple search criteria, they're combined to create the query. The resulting output is the group that matches all criteria.

However, if you don't specify any search criteria, the card returns all fields for available records.

Field Definition Type Required

Profile

Disk Encryption Type

The type of encryption used on the device.

Text

FALSE

Manufacturer

Name of the manufacturer of the device.

Text

FALSE

Model

Model of the device.

Text

FALSE

OS Version

Version of the device operating system.

Text

FALSE

Platform

OS platform of the device. These are the possible values:

  • MACOS

  • WINDOWS

  • ANDROID

  • IOS

Text

FALSE

Registered

Indicates if the device is registered at Okta.

Text

FALSE

Secure Hardware Present

Indicates if the device contains a secure hardware functionality.

True/False

FALSE

Status

Current status of device. These are the possible values:

  • CREATED

  • ACTIVE

  • SUSPENDED

  • DEACTIVATED

Text

FALSE

Custom Search Criteria

A SCIM expression that filters the results.

Searches include all device profile properties, the device ID, status, and last update properties.

Text

FALSE

Streaming

Flow

Click Choose Flow to browse and select a helper flow as the destination for the streamed search results. Click Choose to confirm.

Optionally, you can click the empty field under Click or drop here to create to add custom extensible fields that pass data to the helper flow. These fields are added as key and value pairs under the State output object in the helper flow.

This field appears when Stream Matching Records is selected from the Result Set field.

Flow

TRUE

Record Limit

Specify the maximum number of records to stream.

  • When the Record Limit field is set to 0 or a negative number, the card returns an error.

  • When the Record Limit field is set to greater than 0, the stream returns up to the maximum number specified.

  • When the Record Limit field is empty, null, or not selected, the stream returns all records.

  • The default value is 1000000 (1 million).

  • The valid range is from 0 to 1000000.

This field appears when Stream Matching Records is selected from the Result Set option.

Number

FALSE

Output

Field Definition Type

Device

Each object contains the details for an individual device.

This field appears when you select First 200 Matching Records from the Result Set option.

List of Objects

ID

Unique identifier of the device.

Text

Created

Timestamp when the device was created.

Date & Time

Last Updated

Timestamp when the device record was last updated.

Updates occur when Okta collects and saves device signals during authentication, and when the lifecycle state of the device changes.

Date & Time

Profile

Disk Encryption Type

Type of encryption used on the device.

Text

Display Name

The display name of the device.

Text

International Mobile Equipment ID

International Mobile Equipment Identity (IMEI) of the device.

Text

Integrity Jailbreak

Indicates if the device is jail-broken or rooted. Only applicable to iOS and Android platforms.

True/False

Manufacturer

Name of the manufacturer of the device.

Text

Mobile Equipment ID

Mobile equipment identifier of the device.

Text

Model

Model of the device.

Text

OS Version

Version of the device OS.

Text

Platform

OS platform of the device. These are the possible values:

  • MACOS

  • WINDOWS

  • ANDROID

  • IOS

Text

Registered

Indicates if the device is registered at Okta.

True/False

Secure Hardware Present

Indicates if the device contains a secure hardware functionality.

True/False

Serial Number

Serial number of the device.

Text

Security ID

Windows Security identifier of the device.

Text

Trusted Platform Module Hash

Windows Trusted Platform Module hash value.

Text

Unique Device ID

macOS Unique Device identifier.

Text

Resource Alternate ID

Text

Resource Display Name

Value

Text for the display name.

Text

Sensitive

Returns true if the display name is case-sensitive.

True/False

Resource ID

Alternate key for the ID.

Text

Resource Type

The default value is UDDevice.

Text

Status

Current status of device. These are the possible values:

  • CREATED

  • ACTIVE

  • SUSPENDED

  • DEACTIVATED

Text

Links

Specifies link relations (see Web Linking) available for the status of an application using the JSON Hypertext Application Language specification.

This object is used for dynamic discovery of related resources and lifecycle operations.

Object

Result

Records Streamed

Number of records streamed in a streaming flow.

This field appears when you select Stream Matching Records from the Result Set option.

Number

Related topics

Okta Devices connector

Okta Devices API

Device lifecycle

Cards in flows