Okta
Okta コネクタを使用すると、ユーザー、グループ、ロール、アプリのレコードの作成、読み取り、更新、削除を行うことができます。また、ユーザーまたはグループをロールやアプリケーションに割り当てたり、割り当てを解除したりすることもできます。
始める前に
Google Cloud プロジェクトで次のタスクを行います。
- ネットワーク接続が設定されていることを確認します。ネットワーク パターンの詳細については、Network Connectivity をご覧ください。
- コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
- コネクタに使用するサービス アカウントに、
roles/secretmanager.viewerとroles/secretmanager.secretAccessorの IAM ロールを付与します。 - 次のサービスを有効にします。
secretmanager.googleapis.com(Secret Manager API)connectors.googleapis.com(Connectors API)
サービスを有効にする方法については、サービスを有効にするをご覧ください。以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときに有効にするよう求められます。
Okta 接続を作成する
接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。
- Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。
- [+ 新規作成] をクリックして [接続の作成] ページを開きます。
- [ロケーション] セクションで、接続のロケーションを選択します。
- リージョン: プルダウン リストからロケーションを選択します
サポートされているすべてのリージョンのリストについては、ロケーションをご覧ください。
- [次へ] をクリックします。
- リージョン: プルダウン リストからロケーションを選択します
- [接続の詳細] セクションで、次の操作を行います。
- [コネクタ] リストから [Okta] を選択します。
- [Connector version] リストからコネクタのバージョンを選択します。
- [接続名] フィールドに、接続インスタンスの名前を入力します。接続名には、小文字、数字、ハイフンを使用できます。名前の先頭は英字、末尾は英字または数字にします。名前は 49 文字を超えないようにしてください。
- 必要に応じて、接続インスタンスの [説明] を入力します。
- 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは
Errorに設定されています。 - サービス アカウント: 必要なロールを持つサービス アカウントを選択します。
- (省略可)接続ノードの設定を構成します。
- ノードの最小数: 接続ノードの最小数を入力します。
- ノードの最大数: 接続ノードの最大数を入力します。
- Domain: Okta インスタンスに接続する Okta ドメインを入力します。
- 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
- [次へ] をクリックします。
ノードは、トランザクションを処理する接続の単位(またはレプリカ)です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、 接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され(可用性を高めるため)、最大ノード数は 50 に設定されます。
-
[認証] セクションで、認証の詳細を入力します。
- [認証タイプ] を選択し、関連する詳細を入力します。
Okta 接続でサポートされる認証タイプは次のとおりです。
- OAuth 2.0 - 認証コード
- JWT Bearer を使用した OAuth 2.0 クライアント認証情報
- [次へ] をクリックします。
これらの認証タイプの構成方法については、認証を構成するをご覧ください。
- [認証タイプ] を選択し、関連する詳細を入力します。
- Review: 接続と認証の詳細を確認します。
- [作成] をクリックします。
認証を構成する
使用する認証に基づいて詳細を入力します。
-
OAuth 2.0 - 認証コード
- クライアント ID: アクセス トークンのリクエストに使用されるクライアント ID。
- スコープ: 必要なスコープのカンマ区切りのリスト。
- クライアント シークレット: アクセス トークンのリクエストに使用されるクライアント シークレット。
- 認証 URL: クライアントの作成時に生成された認証 URL
Authorization code 認証タイプの場合は、接続を作成した後、認証を構成するためにいくつかの追加手順を行う必要があります。詳しくは、接続作成後の追加手順をご覧ください。
-
OAuth 2.0 - JWT Bearer を使用したクライアント認証情報
- クライアント ID: アクセス トークンのリクエストに使用されるクライアント ID。
- スコープ: 必要なスコープのカンマ区切りのリスト。
- 秘密鍵: PEM 形式の秘密鍵ファイルの内容を格納する Secret Manager のシークレット。秘密鍵は公開鍵 / 証明書と一致する必要があります。
接続作成後の追加手順
認証に OAuth 2.0 - Authorization code を選択した場合は、接続の作成後に次の追加の手順を行う必要があります。
- 接続ページで、新しく作成された接続を見つけます。
新しいコネクタの [ステータス] は [承認が必要] になります。
- [承認が必要] をクリックします。
これにより、[承認の編集] ペインが表示されます。
- [リダイレクト URI] の値を外部アプリケーションにコピーします。
- 認可の詳細を確認します。
- [Authorize(承認)] をクリックします。
認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。
認証コードの再認可
Authorization code 認証タイプを使用していて、構成を変更した場合は、Okta 接続を再認可する必要があります。接続を再認可するには、次の手順を行います。
- [接続] ページで必要な接続をクリックします。
これにより、[接続の詳細] ページが開きます。
- [編集] をクリックして、接続の詳細を編集します。
- [認証] セクションで [OAuth 2.0 - 認証コード] の詳細を確認します。
必要に応じて必要な変更を加えます。
- [保存] をクリックします。接続の詳細ページに移動します。
- [認証] セクションで [承認の編集] をクリックします。これにより、[承認] ペインが表示されます。
- [Authorize(承認)] をクリックします。
認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。
システムの上限
Okta コネクタは、ノードごとに 1 秒あたり最大 1 件のトランザクションを処理でき、この上限を超えるトランザクションはすべてスロットルされます。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます(可用性を高めるため)。
Integration Connectors に適用される上限の詳細については、上限をご覧ください。
統合で Okta 接続を使用する
接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。
- Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
- Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
操作
このセクションでは、Okta コネクタでサポートされているアクションについて説明します。アクションの構成方法については、アクションの例をご覧ください。
ReactivateUser アクション
このアクションを行うと、ユーザーが再び有効になります。
ReactivateUser アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| UserID | 文字列 | 正しい | ユーザーの ID。 |
ReactivateUser アクションの構成方法の例については、ActivateUser の例をご覧ください。
ActivateUser アクション
このアクションはユーザーを有効にします。
ActivateUser アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| UserID | 文字列 | 正しい | ユーザーの ID。 |
ActivateUser アクションの構成方法の例については、ActivateUser の例をご覧ください。
DeactivateUser アクション
このアクションを行うと、ユーザーが無効になります。
DeactivateUser アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| UserID | 文字列 | 正しい | ユーザーの ID。 |
DeactivateUser アクションの構成方法の例については、DeactivateUser の例をご覧ください。
Assignusertogroup アクション
このアクションにより、ユーザーがグループに割り当てられます。
Assignusertogroup アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| UserID | 文字列 | 正しい | ユーザーの ID。 |
| GroupID | 文字列 | 正しい | グループの ID。 |
Assignusertogroup アクションの構成方法の例については、Assignusertogroup の例をご覧ください。
UnassignUsertoRole アクション
このアクションを行うと、ユーザーのロールへの割り当てが解除されます。
UnassignUsertoRole アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| UserID | 文字列 | 正しい | ユーザーの ID。 |
| RoleAssignmentId | 文字列 | 正しい | ロールの ID。 |
UnassignUsertoRole アクションの構成方法の例については、UnassignUsertoRole の例をご覧ください。
AssignUsertoRole アクション
このアクションにより、ユーザーがロールに割り当てられます。
AssignUsertoRole アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| UserID | 文字列 | 正しい | ユーザーの ID。 |
| RoleId | 文字列 | 正しい | ロールの ID。 |
AssignUsertoRole アクションの構成方法の例については、AssignUsertoRole の例をご覧ください。
AssignUsertoApp アクション
このアクションにより、ユーザーがアプリに割り当てられます。
AssignUsertoApp アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| UserID | 文字列 | 正しい | ユーザーの ID。 |
| AppId | 文字列 | 正しい | アプリの ID。 |
AssignUsertoApp アクションの構成方法の例については、AssignUsertoApp の例をご覧ください。
UnassignUsertoGroup アクション
このアクションを行うと、グループからユーザーの割り当てが解除されます。
UnassignUsertoGroup アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| UserID | 文字列 | 正しい | ユーザーの ID。 |
| GroupID | 文字列 | 正しい | グループの ID。 |
UnassignUsertoGroup アクションの構成方法の例については、UnassignUsertoGroup の例をご覧ください。
UnassignUsertoApp アクション
このアクションを行うと、アプリからユーザーの割り当てが解除されます。
UnassignUsertoApp アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| UserID | 文字列 | 正しい | ユーザーの ID。 |
| AppID | 文字列 | 正しい | アプリの ID。 |
UnassignUsertoApp アクションの構成方法の例については、UnassignUsertoApp の例をご覧ください。
Assigngrouptoapp アクション
このアクションは、グループをアプリに割り当てます。
Assigngrouptoapp アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| GroupId | 文字列 | 正しい | グループの ID。 |
| AppID | 文字列 | 正しい | アプリの ID。 |
Assigngrouptoapp アクションの構成方法の例については、Assigngrouptoapp の例をご覧ください。
AssignGrouptoRole アクション
このアクションは、グループをロールに割り当てます。
AssignGrouptoRole アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| GroupId | 文字列 | 正しい | グループの ID |
| RoleId | 文字列 | 正しい | ロールの ID |
| TypeId | 文字列 | 正しい | タイプの ID |
AssignGrouptoRole アクションの構成方法の例については、AssignGrouptoRole の例をご覧ください。
UnassignGrouptoApp アクション
このアクションにより、アプリからグループの割り当てが解除されます。
UnassignGrouptoApp アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| グループ | 文字列 | 正しい | GroupId の ID |
| AppID | 文字列 | 正しい | アプリの ID |
UnassignGrouptoApp アクションの構成方法の例については、UnassignGrouptoApp の例をご覧ください。
UnassignGrouptoRole アクション
このアクションにより、グループのロール割り当てが解除されます。
UnassignGrouptoRole アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| グループ | 文字列 | 正しい | GroupId の ID |
| AppID | 文字列 | 正しい | AppId の ID |
UnassignGrouptoRole アクションの構成方法の例については、UnassignGrouptoRole の例をご覧ください。
SuspendUser アクション
このアクションを行うと、ユーザーが停止されます。
SuspendUser アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| グループ | 文字列 | 正しい | GroupId の ID。 |
| AppID | 文字列 | 正しい | AppId の ID。 |
SuspendUser アクションの構成方法の例については、SuspendUser の例をご覧ください。
UnsuspendUser アクション
このアクションを行うと、ユーザーの停止が解除されます。
UnsuspendUser アクションの入力パラメータ
| パラメータ名 | データ型 | 必須 | 説明 |
|---|---|---|---|
| グループ | 文字列 | 正しい | GroupId の ID。 |
| AppID | 文字列 | 正しい | AppId の ID。 |
UnsuspendUser アクションの構成方法の例については、UnsuspendUser の例をご覧ください。
アクションの例
例 - ユーザーを再開する
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
ReactivateUser] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ulgqf2s4Zs5Ohge5d7" }
アクションが成功すると、ReactivateUser タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success",
"ActivationToken": "PKeQTJMUW9vg0wyh8czA",
"ActivationUrl": "https://dev-99779501.okta.com/tokens/PKeQTJMUW9vg0wyh8czA/verify"
}
例 - ユーザーを有効にする
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
ActivateUser] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ulgqf2s4Zs5Ohge5d7" }
アクションが成功すると、ActivateUser タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success",
"activationurl": null,
"activationtoken": null
}
例 - ユーザーを無効にする
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
DeactivateUser] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ulgqf2s4Zs5Ohge5d7" }
アクションが成功すると、DeactivateUser タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success",
"activationurl": null,
"activationtoken": null
}
例 - ユーザーをグループに割り当てる
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
Assignusertogroup] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ulgqf2s4Zs5Ohge5d7", "GroupId": "7463874b834938475d" }
アクションが成功すると、Assignusertogroup タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success",
}
例 - ロールからユーザーの割り当てを解除する
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
UnassignUsertoRole] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ukxucmpl25SNLP65d7", "RoleAssignmentId": "irblawnjpom1bLBcJ5d7" }
アクションが成功すると、UnassignUsertoRole タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success",
}
例 - ユーザーをロールに割り当てる
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
AssignUsertoRole] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ukxucmpl25SNLP65d7", "RoleId": "cr0l2n9ay0pCCxLgG5d7", "ResourceSet": "iaml81kep6zefR4Oq5d7", "Type": "CUSTOM" }
アクションが成功すると、AssignUsertoRole タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success",
"Id": "irblawfe99RsUfILD5d7",
"Label": "UserCreatorByabhishkePostman",
"Type": "CUSTOM",
"Created": "2024-11-21 07:33:05.0",
"LastUpdated": "2024-11-21 07:33:05.0",
"AssignmentStatus": "ACTIVE",
"AssignmentType": "USER",
"resource-set": "iaml81kep6zefR4Oq5d7",
"role": "cr0l2n9ay0pCCxLgG5d7",
"_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7",
"_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7",
"_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7/permissions",
"_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l2n9ay0pCCxLgG5d7/members/irblawfe99RsUfILD5d7",
"_links_assignee_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"
}
例 - ユーザーをアプリに割り当てる
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
AssignUsertoApp] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ukxucmpl25SNLP65d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
アクションが成功すると、AssignUsertoApp タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success",
"Id": "00ukxucmpl25SNLP65d7",
"Created": "2024-11-21 07:08:40.0",
"LastUpdated": "2024-11-21 07:08:45.0",
"Scope": "USER",
"AssignmentStatus": "ACTIVE",
"externalid": null,
"statuschanged": "2024-11-21T07:08:40.000Z",
"passwordchanged": null,
"syncstate": "DISABLED",
"credentials_username": "baklavainthebalkans@gmail.com",
"profile_street_address": null,
"profile_country": null,
"profile_website": null,
"profile_zoneinfo": "America/Los_Angeles",
"profile_birthdate": null,
"profile_gender": null,
"profile_formatted": null,
"profile_profile": null,
"profile_locality": null,
"profile_given_name": "Baklavainthe",
"profile_middle_name": null,
le_phone_number": null,
"profile_region": null,
"profile_postal_code": null,
"profile_family_name": "Balkans",
"profile_email": "baklavainthebalkans@gmail.com",
"_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7",
"_links_user_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"
}
例 - グループからユーザーの割り当てを解除する
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
UnassignUsertoGroup] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ukxucmpl25SNLP65d7", "GroupId": "0oakn3j0bfGPR1Esk5d7" }
アクションが成功すると、UnassignUsertoGroup タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success"
}
例 - アプリからユーザーの割り当てを解除する
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
UnassignUsertoApp] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ukxucmpl25SNLP65d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
アクションが成功すると、UnassignUsertoApp タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success"
}
例 - アプリにグループを割り当てる
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
Assigngrouptoapp] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "GroupId": "00gl5wovm8GuLr8vg5d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
アクションが成功すると、Assigngrouptoapp タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success",
"Id": "00gl5wovm8GuLr8vg5d7",
"LastUpdated": "2024-11-21 08:42:53.0",
"Priority": 0,
"_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7",
"_links_self_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7/groups/00gl5wovm8GuLr8vg5d7", "_links_group_href": "https://dev-99779501.okta.com/api/v1/groups/00gl5wovm8GuLr8vg5d7"
}
例 - グループにロールを割り当てる
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
AssignGrouptoRole] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "GroupId": "00gl9xqojqXq0TJgS5d7", "RoleId": "cr0l5tqddvkDtcfPl5d7", "Type": "CUSTOM", "ResourceSet": "iaml81kep6zefR4Oq5d7" }
アクションが成功すると、AssignGrouptoRole タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success",
"Id": "irbla1k8uy8XxDDFF5d7",
"Label": "ReadAdmin_Altostrat",
"Type": "CUSTOM",
"Created": "2024-11-20 12:28:33.0",
"LastUpdated": "2024-11-20 12:28:33.0",
"AssignmentStatus": "ACTIVE",
"AssignmentType": "GROUP",
"resource-set": "iaml81kep6zefR4Oq5d7",
"role": "cr0l5tqddvkDtcfPl5d7",
"_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7",
"_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7", "_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7/permissions", "_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l5tqddvkDtcfPl5d7/members/irbla1k8uy8XxDDFF5d7", "_links_assignee_href": "https://dev-99779501.okta.com/api/v1/groups/00gl9xqojqXq0TJgS5d7"
}
例 - アプリからグループの割り当てを解除する
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
UnassignGrouptoApp] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "GroupId": "00gl5wovm8GuLr8vg5d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
アクションが成功すると、UnassignGrouptoApp タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success"
}
例 - ロールからグループの割り当てを解除する
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
UnassignGrouptoRole] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "GroupId": "00gl5wovm8GuLr8vg5d7", "RoleAssignmentId": "irbl94sbyit77SGpg5d7" }
アクションが成功すると、UnassignGrouptoRole タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success"
}
例 - ユーザーを停止する
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
SuspendUser] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ulkdsubxO6W6LgJ5d7" }
アクションが成功すると、SuspendUser タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success"
}
例 - ユーザーの停止を解除する
- [
Configure connector task] ダイアログで、[Actions] をクリックします。 - [
UnsuspendUser] アクションを選択してから、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、
connectorInputPayloadをクリックし、Default Valueフィールドに次のような値を入力します。{ "UserId": "00ulkdsubxO6W6LgJ5d7" }
アクションが成功すると、UnsuspendUser タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。
{
"Status": "Success"
}
エンティティ オペレーションの例
このセクションでは、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。
例 - すべてのユーザーを一覧表示する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 Entityリストから [Users] を選択します。- [
List] オペレーションを選択し、[完了] をクリックします。 - [コネクタ] タスクの [タスク入力] セクションで、要件に応じて filterClause を設定できます。
フィルタ句の値は、単一引用符(')で囲む必要があります。フィルタ句を使用すると、列に基づいてレコードをフィルタできます。
例 - ユーザーを取得する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからUsersを選択します。- [
Get] オペレーションを選択し、[完了] をクリックします。 - エンティティ ID を「20001」に設定します。これは渡されるキーです。エンティティ ID を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに
"20001"を入力し、EntityId をローカル変数として選択します。
エンティティ ID は直接渡す必要があります(「20001」など)。ここで、「20001」は一意の主キー値で、
エンティティ ID を渡すとエラーがスローされるクエリでは、2 つの複合キー(id='20001' など)が存在するため、フィルタ句を使用する必要があります。
例 - ユーザーを削除する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからUsersを選択します。- [
Delete] オペレーションを選択し、[完了] をクリックします。 - エンティティ ID を「00ul7l5fdyTdHDfSj5d7」に設定します。これは渡されるキーです。エンティティ ID を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに
"20001"を入力し、EntityId をローカル変数として選択します。エンティティに 2 つの複合ビジネスキーまたは主キーがある場合、entityId を指定する代わりに、filterClause を
id='00ul7l5fdyTdHDfSj5d7'に設定することもできます。
例 - ユーザーを作成する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからUsersを選択します。- [
Create] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editorをクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "ProfileFirstName": "Test", "ProfileLastName": "Test User", "ProfileEmail": "Test@gmail.com", "ProfileLogin": "Test11@example.com" }アクションが成功すると、
VendorタスクのconnectorOutputPayloadレスポンス パラメータの値は次のようになります。{ "Id": "00ula502hjbwWYsO25d7" }
例 - グループを作成する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからGroupsを選択します。- [
Create] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editorをクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "ProfileDescription": "Googlecloud group", "ProfileName": "Goolecloud created grp\n" }アクションが成功すると、
APBillタスクのconnectorOutputPayloadレスポンス パラメータの値は次のようになります。{ "Id": "00gl7lb5gniIAOMwA5d7" }
例 - アプリを作成する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからAppsを選択します。- [
Create] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editorをクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Label": "Googlecloud generated app", "SignOnMode": "AUTO_LOGIN", "AutoSubmitToolbar": false, "Settings": "{\"signOn\":{\"redirectUrl\":\"https://www.example.com\",\"loginUrl\":\"https://www.example.com\"}}" }この例では、Vendtype を作成します。アクションが成功すると、
VendtypeタスクのconnectorOutputPayloadレスポンス パラメータの値は次のようになります。{ "Id": "0oal9vwooxEXXpdjS5d7" }
例 - ロールを作成する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからRolesを選択します。- [
Create] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editorをクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Label": "new role2", "Description": "GABA Role1", "Permissions": "\"okta.users.read\", \"okta.groups.read\"" }アクションが成功すると、
CustomerタスクのconnectorOutputPayloadレスポンス パラメータの値は次のようになります。{ "Id": "cr0l824rbiTvtJDoi5d7" }
例 - ユーザーを更新する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからUsersを選択します。- [
Update] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データマッパー] セクションで、
Open Data Mapping Editorをクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "ProfileFirstName": "ShubhGillL" } - データマッパーでエンティティ ID をユーザーのエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
20044に設定することもできます。この例を実行すると、コネクタ タスクの
connectorOutputPayload出力変数で次のようなレスポンスが返されます。{ "Id": "00ul7u8cyobt8SGRK5d7" }
例 - グループを更新する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからGroupsを選択します。- [
Update] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データマッパー] セクションで、
Open Data Mapping Editorをクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "ProfileName": "Updated Googlecloud group" } - データマッパーでエンティティ ID をグループのエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
1371に設定することもできます。この例を実行すると、コネクタ タスクの
connectorOutputPayload出力変数で次のようなレスポンスが返されます。{ "Id": "00gl92veg4VSQQb5A5d7" }
例 - アプリを更新する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからAppsを選択します。- [
Update] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データマッパー] セクションで、
Open Data Mapping Editorをクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Label": "Googlecloud updated label" } - データマッパーでエンティティ ID をアプリのエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
Customerid='10100'\nに設定することもできます。この例を実行すると、コネクタ タスクの
connectorOutputPayload出力変数で次のようなレスポンスが返されます。{ "Id": "0oal9vwooxEXXpdjS5d7" }
例 - ロールを更新する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityからRolesを選択します。- [
Update] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データマッパー] セクションで、
Open Data Mapping Editorをクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Label": "Googlecloud updated label" } - データマッパーでエンティティ ID をロールのエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
1に設定することもできます。この例を実行すると、コネクタ タスクの
connectorOutputPayload出力変数で次のようなレスポンスが返されます。{ "Id": "cr0l7dqeatRuIrn5x5d7" }
Google Cloud コミュニティの助けを借りる
Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。次のステップ
- 接続を一時停止して再開する方法を確認する。
- コネクタの使用状況をモニタリングする方法を確認する。
- コネクタログを表示する方法を確認する。