Search Devices(デバイスを検索)

Oktaに登録されているデバイスを検索し、デバイスに関する情報を返します。

オプション

フィールド 定義 タイプ 必須

Result Set(結果セット)

検索結果を表示するために次のオプションのいずれかを選択します。

  • [First Matching Record(最初の一致レコード)]:検索クエリに一致する最初のレコードのみを返します。

  • [First 200 Matching Records(最初に一致する200レコード)]

  • [Stream Matching Records(一致レコードのストリーミング)]:一致するすべてのレコードが親フローからヘルパーフローに渡されます。

    このオプションを選択すると、[Streaming(ストリーミング)]入力セクションがカードに追加され、ストリーミングのためのヘルパーフローを選択してカスタム拡張可能フィールドを追加できます。

ドロップダウン

TRUE

入力

複数の検索条件を指定すると、それを組み合わせてクエリが作成されます。結果出力は、すべての条件に一致するグループとなります。

ただし、検索条件を指定しない場合、カードは利用可能なレコードのすべてのフィールドを返します。

フィールド 定義 タイプ 必須

Profile(プロファイル)

Disk Encryption Type(ディスク暗号化タイプ)

デバイスで使用される暗号化のタイプ。

テキスト

FALSE

Manufacturer(メーカー)

デバイスメーカーの名前。

テキスト

FALSE

Model(モデル)

デバイスのモデル。

テキスト

FALSE

OS Version(OSバージョン)

デバイスオペレーティングシステムのバージョン。

テキスト

FALSE

Platform(プラットフォーム)

デバイスのOSプラットフォーム。次の値が考えられます。

  • MACOS

  • WINDOWS

  • ANDROID

  • IOS

テキスト

FALSE

Registered(登録済み)

デバイスがOktaで登録されているかどうかを示します。

テキスト

FALSE

Secure Hardware Present(セキュアハードウェアの存在)

デバイスにセキュアハードウェア機能が含まれるかどうかを示します。

True/False

FALSE

Status(ステータス)

デバイスの現在のステータス。次の値が考えられます。

  • CREATED

  • ACTIVE

  • SUSPENDED

  • DEACTIVATED

テキスト

FALSE

Custom Search Criteria(カスタム検索条件)

結果をフィルタリングするSCIM式。

検索には、すべてのデバイスプロファイルプロパティ、デバイスID、ステータス、最終更新プロパティが含まれます。

テキスト

FALSE

Streaming(ストリーミング)

Flow(フロー)

[Choose Flow(フローを選択)]をクリックして、検索結果ストリームを受信する宛先ヘルパーフローを選択します。[Choose(選択)]をクリックして確定します。

オプションとして、[Click or drop here to create(クリックまたはここにドロップして作成)]の下の空のフィールドをクリックし、データをヘルパーフローに渡すカスタム拡張可能フィールドを追加します。これらのフィールドは、ヘルパーフロー内の[State(状態)]出力オブジェクトの下にキーと値のペアとして追加されます。

このフィールドは、[Result Set(結果セット)]フィールドで[Stream Matching Records(一致レコードのストリーミング)] が選択されている場合に表示されます。

Flow(フロー)

TRUE

Record Limit(レコード制限)

ストリーミングするレコードの最大数を指定します。

  • [Record Limit(レコード制限)]フィールドに0または負の値を設定すると、カードはエラーを返します。

  • [Record Limit(レコード制限)]フィールドに0より大きい値を設定すると、最大で指定した最大数のレコードが返されます。

  • [Record Limit(レコード制限)]フィールドが空、null、または未選択の場合、すべてのレコードが返されます。

  • デフォルト値は1000000(100万)です。

  • 有効な範囲は01000000です。

このフィールドは、[Result Set(結果セット)]オプションで[一致レコードのストリーミング]を選択した場合に表示されます。

数値

FALSE

出力

フィールド 定義 タイプ

Device(デバイス)

各オブジェクトには個々のデバイスの詳細が含まれます。

このフィールドは、[Result Set(結果セット)]オプションで[最初に一致した200レコード]を選択した場合に表示されます。

オブジェクトのリスト

ID

デバイスの一意の識別子。

テキスト

Created(作成日)

デバイスが作成された時点のタイムスタンプ。

日時

Last Updated(最終更新日)

デバイスレコードが最後に更新された時点のタイムスタンプ。

更新は、認証時にOktaがデバイス信号を収集および保存する際と、デバイスのライフサイクル状態が変化した際に行われます。

日時

Profile(プロファイル)

Disk Encryption Type(ディスク暗号化タイプ)

デバイスで使用される暗号化のタイプ。

テキスト

Display Name(表示名)

デバイスの表示名。

テキスト

International Mobile Equipment ID

デバイスのInternational Mobile Equipment Identity(IMEI)。

テキスト

Integrity Jailbreak(統合性ジェイルブレイク)

デバイスがジェイルブレイクまたはルート化されているかどうかを示します。iOSおよびAndroidプラットフォームにのみ適用されます。

True/False

Manufacturer(メーカー)

デバイスメーカーの名前。

テキスト

Mobile Equipment ID(モバイル機器ID)

デバイスのモバイル機器ID。

テキスト

Model(モデル)

デバイスのモデル。

テキスト

OS Version(OSバージョン)

デバイスOSのバージョン。

テキスト

プラットフォーム

デバイスのOSプラットフォーム。次の値が考えられます。

  • MACOS

  • WINDOWS

  • ANDROID

  • IOS

テキスト

Registered(登録済み)

デバイスがOktaで登録されているかどうかを示します。

True/False

Secure Hardware Present(セキュアハードウェアの存在)

デバイスにセキュアハードウェア機能が含まれるかどうかを示します。

True/False

Serial Number(シリアル番号)

デバイスのシリアル番号。

テキスト

Security ID(セキュリティID)

デバイスのWindowsセキュリティID。

テキスト

Trusted Platform Module Hash(信頼できるプラットフォームモジュールハッシュ)

Windowsの信頼できるプラットフォームモジュールハッシュの値。

テキスト

Unique Device ID(一意のデバイスID)

macOSの一意のデバイスID。

テキスト

Resource Alternate ID(リソース代替ID)

テキスト

Resource Display Name(リソース表示名)

Value(値)

表示名のテキスト。

テキスト

Sensitive(大文字/小文字の区別)

表示名の大文字と小文字が区別される場合はtrueが返されます。

True/False

Resource ID(リソースID)

IDの代替キー。

テキスト

Resource Type(リソースタイプ)

デフォルト値はUDDevice

テキスト

Status(ステータス)

デバイスの現在のステータス。次の値が考えられます。

  • CREATED

  • ACTIVE

  • SUSPENDED

  • DEACTIVATED

テキスト

Links(リンク)

アプリケーションの状態で利用できるリンク関係(「Webリンキング」を参照)をJSON Hypertext Application Language仕様に従って指定します。

このオブジェクトは、リソースおよびライフサイクル操作の動的な検出に利用されます。

オブジェクト

Result(結果)

Records Streamed(ストリーミングされたレコード)

ストリーミングフロー内でストリーミングされたレコードの数。

このフィールドは、[Result Set(結果セット)]オプションで[一致レコードのストリーミング]を選択した場合に表示されます。

数値

関連項目

Okta Devicesコネクター

Okta Devices API

デバイスライフサイクル

フロー内のカード