グループの検索

検索パラメーターに指定されたプロパティを基にして、Oktaグループを検索します。

グループ検索の詳細については、「OktaグループAPI」を参照してください。

入力フィールドに値を指定しないでこのカードを実行すると、使用しているOkta orgにあるすべてのグループの情報が返されます。

スコープ

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

オプション

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

Result Set(結果セット)

検索結果のフィルタリング方法を選択します。

  • First Matching Record:一致する最初のレコードを返します。

  • First 200 Matching Records:最初に一致する200レコードを返します。

  • Stream Matching Records:一致するすべてのレコードを親フローからヘルパーフローに渡します。

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

ドロップダウン

TRUE

多数のレコードを返す方法については、「ヘルパーフローを使ったレコードのストリーミング一致」を参照してください。

入力

カードの入力フィールドは、インスタンスのグループプロファイルのプロパティに基づいて動的に生成されます。

カードは、[Custom Search Criteria(カスタム検索条件)]以外の入力値に対してeq(同等)比較を行います。

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

ID

OktaのグループのID。

テキスト

FALSE

Created(作成日時)

グループが作成されたタイムスタンプ。

テキスト

FALSE

Last Updated(最終更新日時)

グループのプロファイルが最後に更新された日時のタイムスタンプ。

テキスト

FALSE

Last Membership Updated(最終メンバーシップ更新日時)

グループのメンバーシップが最後に更新された時点のタイムスタンプ。

テキスト

FALSE

Type(タイプ)

グループのプロファイルやメンバーシップの管理に使用されている以下の方法:

  • OKTA_GROUP:グループのプロファイルやメンバーシップが、Oktaで静的割り当てを通して直接的、またはグループルールを用いて間接的に管理されます。

  • APP_GROUP:グループのプロファイルやメンバーシップがインポートされ、グループをインポートしたアプリ(Active DirectoryやLDAPなど)内で管理されます。

  • BUILT_INOktaがグループのプロファイルやメンバーシップを管理し、編集はできません。

テキスト

FALSE

Name(名前)

グループの名前。

テキスト

FALSE

Description(説明)

グループの説明。

テキスト

FALSE

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

カスタム文字列を入力してswewなどの比較演算子を使用し、グループプロパティに対して検索を実行します。詳細と例については、「OktaグループAPI」に記載の「検索パラメーター」を参照してください。

フィルターqのクエリパラメーターを使用してグループを検索したい場合には、Custom API Actionカードを使用します。

テキスト

FALSE

ストリーミング

Flow(フロー)

[Choose Flow(フローの選択)]をクリックして検索結果をストリーミングするヘルパーフローを参照および選択し、[Choose(選択)]をクリックして確定します。

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

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

フロー

TRUE

Search Criteria(検索条件)

Record Limit(レコード制限)

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

  • フィールドを0未満に設定すると、カードはエラーを返します。

  • フィールドを0または0より大きい値に設定すると、ストリームは指定された最大数までを返します。

  • フィールドを空またはnullにする、または選択しない場合、ストリームは全レコードを返します。

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

  • 有効な範囲は01000000です。

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

数値

FALSE

出力

フィールド 定義 タイプ

Raw Object(未加工オブジェクト)

Okta APIから返される未加工のペイロード。

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

オブジェクト

Groups(グループ)

[Result Set(結果セット)]オプションでFirst 200 Matching Recordsを選択した場合に表示されます。

ID

OktaのグループのID。

テキスト

Created(作成日時)

オブジェクトが作成された日時。

テキスト

Last Updated(最終更新日時)

グループプロファイルが最後に更新された時点のタイムスタンプ。

テキスト

Last Membership Updated(最終メンバーシップ更新日時)

グループのメンバーシップが最後に更新された時点のタイムスタンプ。

テキスト

Object Class(オブジェクトクラス)

グループのプロファイルの限定詞。

テキストのリスト

Type(タイプ)

グループのプロファイルやメンバーシップの管理に使用されている以下の方法:

  • OKTA_GROUP
  • APP_GROUP
  • BUILT_IN

テキスト

プロファイル

Name(名前)

グループの名前。

テキスト

Description(説明)

グループの説明。

テキスト

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

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

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

数値

関連項目

Oktaコネクター

Workflows要素

Oktaコネクターに関するガイダンス

Okta APIドキュメント