デバイスを検索

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

スコープ

このカードで必要なOAuthスコープのリストは「アクションカード」を参照してください。

オプション

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

結果セット(Result Set)

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

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

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

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

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

ドロップダウン

入力

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

プロファイル(Profile)

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

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

テキスト FALSE

製造元(Manufacturer)

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

テキスト FALSE

モデル(Model)

デバイスのモデル。

テキスト FALSE

OSバージョン(OS Version)

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

テキスト 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を選択した場合に表示されます。

フロー

レコード制限(Record Limit)

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

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

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

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

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

  • 有効な範囲は01000000です。

このフィールドは、結果セット(Result Set)フィールドでStream Matching Recordsを選択した場合に表示されます。

数値 FALSE

出力

フィールド 定義 タイプ

デバイス(Device)

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

このフィールドは、結果セット(Result Set)オプションでFirst 200 Matching Recordsを選択した場合に表示されます。

オブジェクトのリスト

ID (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)

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

テキスト

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

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

テキスト

モデル(Model)

デバイスのモデル。

テキスト

OSバージョン(OS Version)

デバイスOSのバージョン

テキスト

プラットフォーム(Platform)

デバイスのOSプラットフォーム。以下の値を指定できます。

  • MACOS

  • WINDOWS

  • ANDROID

  • IOS

テキスト

登録済み(Registered)

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

True/False

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

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

True/False

シリアル番号(Serial Number)

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

テキスト

セキュリティID(Security ID)

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

テキスト

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

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

テキスト

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

macOSの一意のデバイスID。

テキスト

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

テキスト

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

値(Value)

表示名のテキスト。

テキスト

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

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

True/False

リソースID(Resource ID)

IDの代替キー。

テキスト

リソースタイプ(Resource Type)

デフォルト値はUDDevice

テキスト

ステータス(Status)

デバイスの現在のステータス。以下の値を指定できます。

  • 作成日(CREATED)

  • アクティブ(ACTIVE)

  • SUSPENDED

  • 無効化(DEACTIVATED)

テキスト

リンク(Links)

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

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

オブジェクト

結果(Result)

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

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

このフィールドは、結果セット(Result Set)オプションでStream Matching Recordsを選択した場合に表示されます。

数値