Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Azure AD（Entra ID）

Azure AD（Entra ID）コネクタを使用すると、Azure Active Directory に対して挿入、削除、更新、読み取りオペレーションを実行できます。

始める前に

Azure AD（Entra ID）コネクタを使用する前に、次の作業を行います。

Google Cloud プロジェクトで次の操作を行います。
- ネットワーク接続が設定されていることを確認します。ネットワークパターンの詳細については、Network Connectivity をご覧ください。
- コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
- コネクタに使用するサービスアカウントに、次の IAM ロールを付与します。
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  サービスアカウントは特別なタイプの Google アカウントで、Google API のデータにアクセスするのに認証を受ける必要がある人間以外のユーザーを表します。サービスアカウントがない場合は、サービスアカウントを作成する必要があります。コネクタとサービスアカウントは同じプロジェクトに属している必要があります。詳細については、サービスアカウントを作成するをご覧ください。
- 次のサービスを有効にします。
  - secretmanager.googleapis.com（Secret Manager API）
  - connectors.googleapis.com（Connectors API）
  サービスを有効にする方法については、サービスを有効にするをご覧ください。
以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。
Azure AD（Entra ID）接続を作成する前に、Azure Portal/Microsoft Entra ID でアプリケーションを作成します。詳細については、クイックスタート: Microsoft Identity Platform にアプリケーションを登録すると Microsoft Entra ID にクライアントアプリケーションを登録するをご覧ください。

コネクタを構成する

接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。
[接続] ページに移動
[+ 新規作成] をクリックして [接続の作成] ページを開きます。
[ロケーション] セクションで、接続のロケーションを選択します。
1. リージョン: プルダウンリストからロケーションを選択します
  コネクタをサポートしているリージョンは次のとおりです。
  サポートされているすべてのリージョンの一覧については、ロケーションをご覧ください。
2. [次へ] をクリックします。
[接続の詳細] セクションで、次の操作を行います。
1. コネクタ: 使用可能なコネクタのプルダウンリストから [Azure AD（Entra ID）] を選択します。
2. コネクタのバージョン: 使用可能なバージョンのプルダウンリストからコネクタのバージョンを選択します。
3. [接続名] フィールドに、接続インスタンスの名前を入力します。
  接続名は次の条件を満たす必要があります。
  - 接続名には英字、数字、ハイフンを使用できます。
  - 文字は小文字のみを使用できます。
  - 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
  - 接続名は 49 文字以内で指定してください。
4. 必要に応じて、接続インスタンスの [説明] を入力します。
5. サービスアカウント: 必要なロールを持つサービスアカウントを選択します。
6. 必要に応じて、接続ノードの設定を構成します。
  - ノードの最小数: 接続ノードの最小数を入力します。
  - ノードの最大数: 接続ノードの最大数を入力します。
  ノードは、トランザクションを処理する接続の単位（またはレプリカ）です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され（可用性を高めるため）、最大ノード数は 50 に設定されます。
7. イベントサブスクリプションの接続を使用するには、[イベントサブスクリプションを有効にする] を選択します。これを選択すると、次のオプションが表示されます。
  - エンティティとアクションを使用したイベントサブスクリプションを有効にする: このオプションを選択すると、イベントサブスクリプションとコネクタオペレーション（エンティティとアクション）の両方に対して接続が使用されます。
  - イベントサブスクリプションのみを有効にする: イベントサブスクリプションに対してのみ接続を使用するには、このオプションを選択します。このオプションを選択した場合は、[次へ] をクリックして、イベントサブスクリプションを構成します。
8. Azure テナント: データへのアクセスに使用されている Microsoft Online テナント。指定しない場合は、デフォルトのプロジェクトが使用されます。
9. ユーザーの拡張機能プロパティを取得: 拡張機能プロパティを取得するかどうかを決定します。
10. 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
11. [次へ] をクリックします。
[認証] セクションで、認証の詳細を入力します。
1. [認証タイプ] を選択し、関連する詳細を入力します。
  Azure AD（Entra ID）接続でサポートされる認証タイプは次のとおりです。
  - Azure AD（認証コード付与タイプ）
  - OAuth 2.0 クライアント認証情報
  - JWT Bearer を使用した OAuth 2.0 クライアント認証情報
2. [次へ] をクリックします。
Review: 接続と認証の詳細を確認します。
[作成] をクリックします。

認証を構成する

使用する認証に基づいて詳細を入力します。

Azure AD（認証コード付与タイプ）
- クライアント ID: アクセストークンのリクエストに使用されるクライアント ID。
- スコープ: 必要なスコープのカンマ区切りのリスト。
- クライアントシークレット: アクセストークンのリクエストに使用されるクライアントシークレット。
- シークレットのバージョン: クライアントシークレットのバージョン。
- 認証 URL: OAuth クライアントの作成時に生成する認証 URL。URL を https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent の形式で入力します。例: https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent。
サードパーティの OAuth アプリケーションを構成するときは、次の承認済みリダイレクト URI（コールバック URL）を使用します。
https://console.cloud.google.com//connectors/oauth?project=PROJECT_ID

PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。

OAuth 2.0 クライアント認証情報
- クライアント ID: 作成したアプリに Azure AD（Entra ID）から提供されたクライアント ID。
- クライアントシークレット: 作成した接続されているアプリのクライアントシークレットを含む Secret Manager のシークレットです。
- シークレットのバージョン: クライアントシークレットのバージョン。

JWT Bearer を使用した OAuth 2.0 クライアント認証情報
- 秘密鍵: PEM 形式の秘密鍵ファイルの内容を格納する Secret Manager のシークレット。秘密鍵は公開鍵 / 証明書と一致する必要があります。
- 秘密鍵パスワード: 秘密鍵ファイルのパスワード（言い回し）を含む Secret Manager の Secret。
- シークレットのバージョン: 秘密鍵シークレットのバージョン。
- クライアント ID: アクセストークンのリクエストに使用されるクライアント ID。

接続構成のサンプル

このセクションでは、Azure AD（Entra ID）接続を作成するときに構成するさまざまなフィールドのサンプル値を示します。

Azure AD（認証コード付与タイプ）の接続タイプ

フィールド名	詳細
ロケーション	europe-west1
コネクタ	Azure AD（Entra ID）
コネクタのバージョン	1
接続名	azure-ad-connection
Cloud Logging を有効にする	○
サービスアカウント	XXXX@serviceaccount
Azure テナント	9b25e811-f983-4982-82e4-263c1ca48112
ノードの最小数	2
ノードの最大数	50
認証	○
Azure AD	○
クライアント ID	XXXX
範囲	https://graph.microsoft.com/user.read
クライアントシークレット	XXXX
シークレットのバージョン	1
認証 URL	https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent

スコープフィールドの値を指定する前に、次のことを確認します。

接続レベルと Azure アプリレベルで User.Read.All 権限と User.Write.All 権限を付与する必要があります。
残りのスコープは、要件に応じて Azure AD アプリの登録レベルと接続レベルの両方で追加できます。
委任された権限とアプリケーション権限の両方で、権限がアプリケーションレベルで追加されていることを確認します。次のスコープがよく使用されます。

OAuth 2.0 クライアント認証情報の接続タイプ

フィールド名	詳細
ロケーション	us-central1
コネクタ	Azure AD（Entra ID）
コネクタのバージョン	1
接続名	azure-ad-client-credentials
Cloud Logging を有効にする	○
サービスアカウント	XXXX@serviceaccount
Azure テナント	9b25e811-f983-4982-82e4-263c1ca48112
ノードの最小数	2
ノードの最大数	50
認証	○
OAuth 2.0 - クライアントシークレットを使用するクライアント認証情報	○
クライアント ID	XXXX
クライアントシークレット	XXXX
シークレットのバージョン	1

JWT Bearer 接続タイプを使用した OAuth 2.0 クライアント認証情報

フィールド名	詳細
ロケーション	europe-west1
コネクタ	Azure AD（Entra ID）
コネクタのバージョン	1
接続名	azure-jwt
Cloud Logging を有効にする	○
サービスアカウント	XXXX@serviceaccount
Azure テナント	9b25e811-f983-4982-82e4-263c1ca48112
ノードの最小数	2
ノードの最大数	50
認証	○
OAuth 2.0 - JWT ベアラーを使用したクライアント認証情報	○
秘密鍵	XXXX
シークレットのバージョン	1
クライアント ID	XXXX

JWT ベアラー接続タイプで OAuth 2.0 クライアント認証情報を使用する場合は、次のタスクを完了します。

自己署名証明書を作成し、秘密鍵証明書と公開鍵の両方をダウンロードします。詳細については、自己署名証明書を作成するをご覧ください。
Azure AD アプリケーションの [Certificates & Secrets] で公開鍵証明書をアップロードします。
秘密鍵フィールドで、秘密鍵に秘密鍵証明書の値と公開鍵証明書の両方の値を渡します。秘密鍵と公開鍵に個別のシークレットを作成する必要はありません。

Postman を使用して接続を確立する方法については、API を使用した JWT 接続をご覧ください。

認証コードの再認可

Authorization code 認証タイプを使用しているユーザーが、Azure AD アプリケーションの構成を変更した場合は、Azure AD（Entra ID）接続を再認可する必要があります。接続を再認可するには、次の手順を行います。

[接続] ページで必要な接続をクリックします。
これにより、[接続の詳細] ページが開きます。
[編集] をクリックして、接続の詳細を編集します。
[認証] セクションで [OAuth 2.0 - 認証コード] の詳細を確認します。
必要に応じて必要な変更を加えます。
[保存] をクリックします。接続の詳細ページに移動します。
[認証] セクションで [承認の編集] をクリックします。これにより、[承認] ペインが表示されます。
[Authorize（承認）] をクリックします。
認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。

接続作成後の追加手順

認証に OAuth 2.0 - Authorization code を選択した場合は、接続の作成後に次の追加の手順を行う必要があります。

接続ページで、新しく作成された接続を見つけます。
新しいコネクタの [ステータス] は [承認が必要] になります。
[承認が必要] をクリックします。
これにより、[承認の編集] ペインが表示されます。
[リダイレクト URI] の値を外部アプリケーションにコピーします。
認可の詳細を確認します。
[Authorize（承認）] をクリックします。
認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。

イベントサブスクリプションを構成する

イベントサブスクリプションを有効にしている場合は、[イベントサブスクリプションの詳細] セクションに次の値を入力します。

認証の詳細を入力します。
1. クライアント ID: アクセストークンのリクエストに使用されるクライアント ID。
2. クライアントシークレット: アクセストークンのリクエストに使用されるクライアントシークレット。
3. シークレットバージョン: シークレットバージョンを選択します。
4. クライアントの状態: クライアントの状態を含む Secret Manager のシークレット。これは、変更通知の認証に使用されます。
Azure テナント: データへのアクセスに使用されている Microsoft Online テナント。テナントを指定しない場合は、デフォルトのテナントが使用されます。
必要に応じて、バックエンドシステムのレスポンスに付加される情報を追加するには、[データ拡充を有効にする] を選択します。
追加情報は、イベントを構成したエンティティに固有のものです。詳細については、イベント通知のデータ拡充をご覧ください。

注: この接続をイベントサブスクリプションにのみ構成している場合、このオプションを有効にできません。データ拡充を有効にするには、イベントサブスクリプションとコネクタオペレーション（エンティティとアクション）の両方に対して接続を構成する必要があります。
バックエンドアプリケーションと接続間を安全に接続するには、[プライベート接続を有効にする] を選択します。このオプションを選択した場合は、接続の作成後に追加の構成手順を実行する必要があります。詳細については、イベントサブスクリプションのプライベート接続をご覧ください。
デッドレター構成を入力します。デッドレターを構成すると、指定された Pub/Sub トピックに未処理のイベントが書き込まれます。次の詳細情報を入力します。
1. デッドレタープロジェクト ID: デッドレター Pub/Sub トピックを構成した Google Cloud プロジェクト ID。
2. デッドレタートピック: 未処理イベントの詳細を書き込む Pub/Sub トピック。
プロキシを使用してバックエンドに接続する場合（イベントサブスクリプションの場合）は、次の詳細を入力します。

Proxy SSL Type: プロキシサーバーへの接続時に使用する SSL タイプ。次のいずれかの認証タイプを選択します。
- 常に: イベントサブスクリプションの接続は常に SSL 対応です。
- なし: イベントサブスクリプションの接続は SSL に対応していません。
Proxy Auth Scheme: プロキシサーバーで認証する認証タイプを選択します。次の認証タイプがサポートされています。
- 基本: 基本的な HTTP 認証。
Proxy User: プロキシサーバーでの認証に使用されるユーザー名を入力します。
Proxy Password: ユーザーのパスワードの Secret Manager シークレットを選択します。
Secret のバージョン: Secret のバージョンを選択します。
[Proxy Server] セクションで、プロキシサーバーの詳細を入力します。
1. [+ 宛先を追加] をクリックし、[宛先タイプ] として [ホストアドレス] を選択します。
2. プロキシサーバーのホスト名または IP アドレスと、プロキシサーバーのポート番号を入力します。

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベースコネクタでは、テーブルがエンティティであり、ファイルサーバーコネクタでは、フォルダがエンティティです。また、メッセージングシステムコネクタでは、キューがエンティティです。
ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。
オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。
- リスト
- 取得
- 作成
- 更新
- 削除
使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティオペレーションをご覧ください。ただし、コネクタがいずれかのエンティティオペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。
アクション: コネクタインターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

システムの上限

Azure AD（Entra ID）コネクタは、ノードごとに 1 秒あたり 5 件のトランザクションを処理することができ、この上限を超えるトランザクションはすべてスロットルされます。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます（可用性を高めるため）。

Integration Connectors に適用される上限の詳細については、上限をご覧ください。

注: Integration Connectors ノードの数は、使用状況に応じて動的に自動スケーリングされます。ただし、自動スケーリングを待たずに大量の容量を確保する場合は、接続の最小ノード値を調整できます。1 つの接続により多くのトランザクションを処理するには、より多くのノードが必要です。逆に、接続が処理するトランザクションが少ない場合は、必要なノードの数が少なくなります。ノードの値を構成するには、次の手順を行います。

従量課金制をご利用のお客様は、接続の編集ページでノードの最小値と最大値を構成します。
サブスクリプションベースで利用されているお客様は、サポートにお問い合わせください。

ノードが処理できる最大トランザクションは、さまざまな要因によって異なります。そのため、スループットを高めるために最小ノードを調整する前に、バックエンドシステムが必要なトラフィックを処理するために最適に設定されているかどうかを確認することをおすすめします。

アクション

このセクションでは、コネクタでサポートされているアクションを一覧表示します。アクションの構成方法については、アクションの例をご覧ください。

AddGroupMember アクション

このアクションは、グループにメンバーを追加します。

AddGroupMember アクションの入力パラメータ

パラメータ名	データ型	必須	説明
MemberId	文字列	○	メンバーの固有識別子。
GroupId	文字列	○	グループの固有識別子。

このアクションの構成方法の例については、アクションの例をご覧ください。

RemoveGroupMember アクション

このアクションにより、グループからメンバーが削除されます。

RemoveGroupMember アクションの入力パラメータ

パラメータ名	データ型	必須	説明
MemberId	文字列	○	メンバーの固有識別子。
GroupId	文字列	○	グループの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

AddGroupMember（ゲストアカウント）アクション

このアクションは、グループにメンバーを追加します。

AddGroupMember アクションの入力パラメータ

パラメータ名	データ型	必須	説明
MemberId	文字列	○	メンバーの固有識別子。
GroupId	文字列	○	グループの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

RemoveGroupMember（ゲストアカウント）アクション

このアクションにより、グループからメンバーが削除されます

RemoveGroupMember アクションの入力パラメータ

パラメータ名	データ型	必須	説明
MemberId	文字列	○	メンバーの固有識別子。
GroupId	文字列	○	グループの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

AddUserApplicationRoleAssignment アクション

このアクションにより、ユーザーがアプリケーションロールの割り当てに追加されます。

AddUserApplicationRoleAssignment アクションの入力パラメータ

パラメータ名	データ型	必須	説明
ResourceId	文字列	○	リソースの固有識別子。
AppRoleId	文字列	○	アプリロールの固有識別子。
UserId	文字列	○	ユーザーの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

RemoveUserApplicationRoleAssignment アクション

このアクションを行うと、アプリケーションロールの割り当てからユーザーが削除されます。

RemoveUserApplicationRoleAssignment アクションの入力パラメータ

パラメータ名	データ型	必須	説明
AppRoleAssignmentId	文字列	○	アプリロールの割り当ての固有識別子。
UserId	文字列	○	ユーザーの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

AddGroupApplicationRoleAssignment アクション

このアクションにより、グループがアプリケーションロールの割り当てに追加されます。/p>

AddGroupApplicationRoleAssignment アクションの入力パラメータ

パラメータ名	データ型	必須	説明
ResourceId	文字列	○	リソースの固有識別子。
AppRoleId	文字列	○	アプリロールの固有識別子。
GroupId	文字列	○	グループの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

RemoveGroupApplicationRoleAssignment アクション

このアクションにより、アプリケーションロールの割り当てからグループが削除されます。

RemoveGroupApplicationRoleAssignment アクションの入力パラメータ

パラメータ名	データ型	必須	説明
AppRoleAssignmentId	文字列	○	アプリロールの割り当ての固有識別子。
GroupId	文字列	○	グループの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

ActivateDirectoryRole アクション

この操作を行うと、ディレクトリロールが有効になります。

ActivateDirectoryRole アクションの入力パラメータ

パラメータ名	データ型	必須	説明
RoleTemplateId	文字列	○	ロールの基礎となった directoryRoleTemplate の ID。

このアクションの構成方法の例については、例をご覧ください。

VerifyDomain アクション

このアクションはドメインを検証します。

VerifyDomain アクションの入力パラメータ

パラメータ名	データ型	必須	説明
ID	文字列	○	検証するドメインの ID。

このアクションの構成方法の例については、例をご覧ください。

ChangePassword アクション

このアクションを行うと、ユーザーのパスワードが変更されます。

ChangePassword アクションの入力パラメータ

パラメータ名	データ型	必須	説明
NewPassword	文字列	○	ユーザーの新しいパスワード。
CurrentPassword	文字列	○	ユーザーの現在のパスワード。

このアクションの構成方法の例については、例をご覧ください。

ResetPassword アクション

このアクションを行うと、ユーザーのパスワードが再設定されます。

ResetPassword アクションの入力パラメータ

パラメータ名	データ型	必須	説明
パスワード	文字列	○	ユーザーが送信したパスワード。このパスワードに再設定されます。空白のままにすると、システム生成のパスワードが作成されます。
UserId	文字列	○	ユーザーの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

AssignLicense アクション

このアクションを行うと、ユーザーにライセンスが割り当てられます。

AssignLicense アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserPrincipalName	文字列	○	ライセンスを割り当てるユーザーのプリンシパル名。ログインに使用したユーザー名は指定しないでください。
UserId	文字列	○	ライセンスを割り当てる必要があるユーザーの ID。ログインに使用したユーザー名は提供しないでください。
AddLicenseSkuId	文字列	○	SKU の固有識別子。
DisabledPlans	文字列	×	無効化されたプランのカンマ区切りの固有識別子のコレクション。
RemoveLicenses	文字列	×	削除するライセンスを識別する GUID のカンマ区切りリストのコレクション。

このアクションの構成方法の例については、例をご覧ください。

RemoveLicense アクション

このアクションを行うと、ユーザーに割り当てられたライセンスが削除されます。

RemoveLicense アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserPrincipalName	文字列	○	ライセンスを割り当てる必要があるユーザーのプリンシパル名。ログインに使用したユーザー名は提供しないでください。
UserId	文字列	○	ライセンスを割り当てる必要があるユーザーの ID。ログインに使用したユーザー名は提供しないでください。
AddLicenseSkuId	文字列	×	SKU の固有識別子。
DisabledPlans	文字列	×	無効化されたプランのカンマ区切りの固有識別子のコレクション。
RemoveLicenses	文字列	○	削除するライセンスを識別する GUID のカンマ区切りリストのコレクション。

このアクションの構成方法の例については、例をご覧ください。

FetchAdditionalUserFields アクション

このアクションは、必須の属性フィールドを取得します。

FetchAdditionalUserFields アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserId	文字列	○	ユーザーの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

AddGroupOwner アクション

このアクションは、グループにオーナーを追加します。

AddGroupOwner アクションの入力パラメータ

パラメータ名	データ型	必須	説明
GroupId	文字列	○	グループの固有識別子。
OwnerId	文字列	○	オーナーの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

RemoveGroupOwner アクション

このアクションにより、グループオーナーが削除されます。

RemoveGroupOwner アクションの入力パラメータ

パラメータ名	データ型	必須	説明
GroupId	文字列	○	グループの固有識別子。
OwnerId	文字列	○	オーナーの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

InviteExternalUser アクション

この操作を行うと、外部ユーザーが組織に招待されます。

InviteExternalUser アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserEmailAddress	文字列	○	招待するユーザーのメールアドレス。
RedirectURL	文字列	○	特典利用後にユーザーがリダイレクトされる URL。

このアクションの構成方法の例については、例をご覧ください。

AddPhoneAuthenticationMethod アクション

このアクションにより、ユーザーは特定のタスクを実行できます

AddPhoneAuthenticationMethod アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserID	文字列	○	スマートフォン認証方法を追加するユーザーの ID。
PhoneNumber	文字列	○	認証方法の電話番号。
PhoneType	文字列	○	認証方法の電話タイプ。有効な値は、mobile、alternateMobile、office です。

このアクションの構成方法の例については、例をご覧ください。

RemovePhoneAuthenticationMethod アクション

このアクションを行うと、ユーザーのスマートフォン認証方法が削除されます。

RemovePhoneAuthenticationMethod アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserID	文字列	○	スマートフォン認証方法を削除するユーザーの ID。ログインに使用したユーザー名は提供しないでください。
ID	文字列	○	phoneType に対応する電話メソッド ID。

このアクションの構成方法の例については、例をご覧ください。

UpdatePhoneAuthenticationMethod アクション

このアクションにより、ユーザーのスマートフォン認証方法が更新されます。

UpdatePhoneAuthenticationMethod アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserID	文字列	○	スマートフォン認証方法を更新するユーザーの ID。
ID	文字列	○	phoneType に対応する電話メソッド ID。
PhoneNumber	文字列	○	認証方法の電話番号。

このアクションの構成方法の例については、例をご覧ください。

AddPrivilegedRole アクション

このアクションにより、ユーザーの権限ロールが追加されます。

AddPrivilegedRole アクションの入力パラメータ

パラメータ名	データ型	必須	説明
PrincipalId	文字列	○	ロールの利用資格が付与されたプリンシパルの ID。
RoleDefinitionId	文字列	○	プリンシパルに割り当てられる unifiedRoleDefinition オブジェクトの識別子。
理由	文字列	○	ユーザーと管理者が提供するメッセージ。
ScheduleInfo	文字列	○	ロールの利用資格の期間。

このアクションの構成方法の例については、例をご覧ください。

RemovePrivilegedRole アクション

このアクションにより、ユーザーの権限ロールが削除されます。<

RemovePrivilegedRole アクションの入力パラメータ

パラメータ名	データ型	必須	説明
PrincipalId	文字列	○	ロールの利用資格が付与されたプリンシパルの ID。
RoleDefinitionId	文字列	○	プリンシパルから削除される unifiedRoleDefinition オブジェクトの識別子。
理由	文字列	○	ユーザーと管理者が提供するメッセージ。

RetrieveUserPhoto アクション

このアクションは、ユーザーの写真を取得します。

RetrieveUserPhoto アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserId	文字列	○	ダウンロードするファイルの ID。
FileLocation	文字列	×	ファイルの保存場所。ファイルの完全なパスとファイル名を指定します。
エンコード	文字列	×	FileData 入力のエンコードタイプ。
FileStream	文字列	×	ファイルデータが書き込まれる出力ストリームのインスタンス。FileLocation が指定されていない場合にのみ使用されます。

このアクションの構成方法の例については、例をご覧ください。

UpdateUserPhoto アクション

このアクションを行うと、ユーザーの写真が更新されます。

UpdateUserPhoto アクションの入力パラメータ

パラメータ名	データ型	必須	説明
LocalFile	文字列	×	アップロードする写真を含むローカルファイルの場所。ファイルのフルパスとファイル名を指定します。
ContentStream	文字列	×	localpath または folderpath が指定されていない場合にアップロードする InputStream としてのコンテンツ
UserId	文字列	○	ユーザの ID
コンテンツ	文字列	○	アップロードする写真コンテンツ。

このアクションの構成方法の例については、例をご覧ください。

RemoveUserPhoto アクション

このアクションを行うと、ユーザーの写真が削除されます。

RemoveUserPhoto アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserId	文字列	○	ユーザの ID

このアクションの構成方法の例については、例をご覧ください。

AssignManager アクション

このアクションを行うと、特定のユーザーにマネージャーが割り当てられます。

AssignManager アクションの入力パラメータ

パラメータ名	データ型	必須	説明
ObjectId	文字列	○	オブジェクトの固有識別子。
ObjectName	文字列	○	追加する directoryObject、ユーザー、または組織の連絡先オブジェクト。
UserId	文字列	○	ユーザーの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

RemoveManager アクション

このアクションを行うと、ユーザーに割り当てられたマネージャーが削除されます。

RemoveManager アクションの入力パラメータ

パラメータ名	データ型	必須	説明
UserId	文字列	○	ユーザーの固有識別子。

このアクションの構成方法の例については、例をご覧ください。

RetrieveManagerChain アクション

このアクションは、ユーザーのマネージャーを取得します。

RetrieveManagerChain アクションの入力パラメータ

パラメータ名	データ型	必須	説明
レベル	文字列	○	取得するマネージャーのレベル数。max を指定すれば、すべてのマネージャーを返します。
UserId	文字列	○	ユーザーの ID。

このアクションの構成方法の例については、例をご覧ください。

AddProfileCardProperty アクション

このアクションは、組織の新しい ProfileCardProperty を追加します。

AddProfileCardProperty アクションの入力パラメータ

パラメータ名	データ型	必須	説明
DirectoryPropertyName	文字列	○	profileCardProperty リソースを識別します。
アノテーション	文字列	○	管理者がディレクトリプロパティのカスタム表示ラベルを設定できるようにします。

このアクションの構成方法の例については、例をご覧ください。

次の表に、profilecardproperties で List オペレーションと Get オペレーションを実行するために必要な権限を示します。

権限	タイプ
People.Read.All	アプリケーション
PeopleSettings.Read.All	委任
PeopleSettings.Read.All	アプリケーション

次の表に、profilecardproperties で Create アクションを実行するために必要な権限を示します。

権限	タイプ
PeopleSettings.ReadWrite.All	アプリケーション
PeopleSettings.ReadWrite.All	委任

RemoveProfileCardProperty アクション

このアクションにより、組織の ProfileCardProperty が削除されます。

RemoveProfileCardProperty アクションの入力パラメータ

パラメータ名	データ型	必須	説明
DirectoryPropertyName	文字列	○	profileCardProperty リソースを識別します。

このアクションの構成方法の例については、例をご覧ください。

アクションの例

このセクションでは、このコネクタでいくつかのアクションを実行する方法について説明します。

例 - AddGroupMember

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AddGroupMember] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }
  
```

このアクションは、AddGroupMember の確認メッセージを返します。アクションが成功すると、AddGroupMember タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - RemoveGroupMember

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemoveGroupMember] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }
  
```

アクションが成功すると、RemoveGroupMember タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - AddGroupMember（ゲストアカウント）

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AddGroupMember] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }
  
```

アクションが成功すると、AddGroupMember タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - RemoveGroupMember(ゲストアカウント)

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemoveGroupMember] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }
  
```

アクションが成功すると、RemoveGroupMember タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - AddUserApplicationRoleAssignment

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AddUserApplicationRoleAssignment] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

{
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
  "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217"
  }

アクションが成功すると、AddUserApplicationRoleAssignment タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - RemoveUserApplicationRoleAssignment

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemoveUserApplicationRoleAssignment] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "AppRoleAssignmentId": "bspYNS4s00GoVL-SSaPJE0xC2--0GxxIu8uS4aeindU"
  }
  
```

アクションが成功すると、RemoveUserApplicationRoleAssignment タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - AddGroupApplicationRoleAssignment

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AddGroupApplicationRoleAssignment] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

{
  "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
  "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

アクションが成功すると、AddGroupApplicationRoleAssignment タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - RemoveGroupApplicationRoleAssignment

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemoveGroupApplicationRoleAssignment] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "AppRoleAssignmentId": "p3luD3g1tEid3t7Pu3uxAMT7DwI3p29HlrxMuZ143eU"
  }
  
```

アクションが成功すると、RemoveGroupApplicationRoleAssignment タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - ActivateDirectoryRole

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ActivateDirectoryRole] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
 {
  "RoleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033"
  } 
  
```

アクションが成功すると、ActivateDirectoryRole タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "id": "c865d9cb-57da-416c-97a3-753e733da678",
  "roleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033",
  "displayName": "Service Support Administrator",
  "description": "Can read service health information and manage support tickets."
  }]

例 - VerifyDomain

[Configure connector task] ダイアログで、[Actions] をクリックします。
[VerifyDomain] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "Id": "eternalsolarsolutions.com"
  } 
  
```

アクションが成功すると、VerifyDomain タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - ChangePassword

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ChangePassword] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "NewPassword": "XXX@9876",
  "CurrentPassword": "XXX@123"
  }
  
```

アクションが成功すると、ChangePassword タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - ResetPassword

[Configure connector task] ダイアログで、[Actions] をクリックします。
[ResetPassword] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "Password": "XXX@9876",
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
  }
  
```

アクションが成功すると、ResetPassword タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - AssignLicense

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AssignLicense] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

{
  "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
  "AddLicenseSkuId": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
  }

アクションが成功すると、AssignLicense タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - RemoveLicense

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AssignLicense] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

{
  "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
  "RemoveLicenses": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
  }

アクションが成功すると、RemoveLicense タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - FetchAdditionalUserFields

[Configure connector task] ダイアログで、[Actions] をクリックします。
[FetchAdditionalUserFields] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  } 
  
```

アクションが成功すると、FetchAdditionalUserFields タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
    "id": "9630c9d7-cf15-4406-8d21-598e41a058cc",
    "deleteddatetime": null,
    "accountenabled": "true",
    "agegroup": null,
    "businessphones": "",
    "city": null,
    "companyname": null,
    "consentprovidedforminor": null,
    "country": null,
    "createddatetime": "2024-04-12T10:24:42Z",
    "creationtype": null,
    "department": null,
    "displayname": "Azure_AD_Test",
    "employeehiredate": null,
    "employeeid": null,
    "employeeleavedatetime": null,
    "employeetype": null,
    "externaluserstate": null,
    "externaluserstatechangedatetime": null,
    "faxnumber": null,
    "givenname": null,
    "imaddresses": "",
    "isresourceaccount": null,
    "jobtitle": null,
    "lastpasswordchangedatetime": "2024-05-14T05:07:15Z",
    "legalagegroupclassification": null,
    "mail": null,
    "mailnickname": "Azure_AD_Test",
    "mobilephone": null,
    "officelocation": null,
    "onpremisesdistinguishedname": null,
    "onpremisesdomainname": null,
    "onpremisesimmutableid": null,
    "onpremiseslastsyncdatetime": null,
    "onpremisessamaccountname": null,
    "onpremisessecurityidentifier": null,
    "onpremisessyncenabled": null,
    "onpremisesuserprincipalname": null,
    "othermails": "",
    "passwordpolicies": null,
    "postalcode": null,
    "preferreddatalocation": null,
    "preferredlanguage": null,
    "proxyaddresses": "",
    "securityidentifier": "S-1-12-1-2519779799-1141296917-2388205965-3428360257",
    "showinaddresslist": null,
    "signinsessionsvalidfromdatetime": "2024-05-14T05:07:15Z",
    "state": null,
    "streetaddress": null,
    "surname": null,
    "usagelocation": "IN",
    "userprincipalname": "Azure_AD_Test@z8474.onmicrosoft.com",
    "usertype": "Member",
    "aboutme": null,
    "birthday": "0001-01-01T08:00:00Z",
    "hiredate": "0001-01-01T08:00:00Z",
    "interests": "",
    "mysite": null,
    "pastprojects": "",
    "preferredname": "",
    "responsibilities": "",
    "schools": "",
    "skills": "",
    "assignedlicenses": "",
    "assignedplans": "[\r\n  {\r\n    \"assignedDateTime\": \"2024-05-16T10:17:45Z\",\r\n    \"capabilityStatus\": \"Deleted\",\r\n    \"service\": \"DynamicsNAV\",\r\n    \"servicePlanId\": \"3f2afeed-6fb5-4bf9-998f-f2912133aead\"\r\n  }\r\n]",
  "authorizationinfo_certificateuserids": "",
  "identities": "[\r\n  {\r\n    \"signInType\": \"userPrincipalName\",\r\n    \"issuer\": \"z8474.onmicrosoft.com\",\r\n    \"issuerAssignedId\": \"Azure_AD_Test@z8474.onmicrosoft.com\"\r\n  }\r\n]",
  "licenseassignmentstates": "",
  "onpremisesextensionattributes_extensionattribute1": null,
  "onpremisesextensionattributes_extensionattribute2": null,
  "onpremisesextensionattributes_extensionattribute3": null,
  "onpremisesextensionattributes_extensionattribute4": null,
  "onpremisesextensionattributes_extensionattribute5": null,
  "onpremisesextensionattributes_extensionattribute6": null,
  "onpremisesextensionattributes_extensionattribute7": null,
  "onpremisesextensionattributes_extensionattribute8": null,
  "onpremisesextensionattributes_extensionattribute9": null,
  "onpremisesextensionattributes_extensionattribute10": null,
  "onpremisesextensionattributes_extensionattribute11": null,
  "onpremisesextensionattributes_extensionattribute12": null,
  "onpremisesextensionattributes_extensionattribute13": null,
  "onpremisesextensionattributes_extensionattribute14": null,
  "onpremisesextensionattributes_extensionattribute15": null,
  "onpremisesprovisioningerrors": "",
  "provisionedplans": "",
  "serviceprovisioningerrors": "",
  "customsecurityattributes": "{\r\n  \"ConnectorTesting\": {\r\n    \"@odata.type\": \"#microsoft.graph.customSecurityAttributeValue\",\r\n    \"FavouriteSport\": \"cricket\",\r\n    \"FavouriteMovie\": \"3 idiots\"\r\n  }\r\n}",
  "signinactivity_lastsignindatetime": "2024-05-14T07:04:51Z",
  "signinactivity_lastsigninrequestid": "ed35b322-d0d9-4fcb-8e71-f9ee7e065e00",
  "signinactivity_lastnoninteractivesignindatetime": "2024-05-15T09:00:02Z",
  "signinactivity_lastnoninteractivesigninrequestid": "0d4ce88b-710a-440f-a612-f590954d6800",
  "signinactivity_lastsuccessfulsignindatetime": "2024-05-15T06:45:42Z",
  "signinactivity_lastsuccessfulsigninrequestid": "64643e9d-3468-4e4d-b7c3-8bd316956600"
  }

例 - AddGroupOwner

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AddGroupOwner] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }
  
```

アクションが成功すると、AddGroupOwner タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - RemoveGroupOwner

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemoveGroupOwner] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }
  
```

アクションが成功すると、RemoveGroupOwner タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - InviteExternalUser

[Configure connector task] ダイアログで、[Actions] をクリックします。
[InviteExternalUser] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "UserEmailAddress": "taleprajyot97@gmail.com",
  "RedirectURL": "https://www.example.com"
  }
  
```

このアクションは、InviteExternalUser の確認メッセージを返します。アクションが成功すると、InviteExternalUser タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True",
  "Id": "70905aef-361f-4cb1-8d04-41f9e377ebd3",
  "ReedemURL": "https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3d9b25e811-f983-4982-82e4-263c1ca48112%26user%3d70905aef-361f-4cb1-8d04-41f9e377ebd3%26ticket%3dx5aOZc%25252bE9XslKcOdb101qLnoe2V%25252b8%25252beeFlNhYA5WvTg%25253d%26ver%3d2.0",
  "InvitedUserId": "d5eeb199-a544-4985-b726-e3073751050c"
  }]

例 - AddPhoneAuthenticationMethod

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AddPhoneAuthenticationMethod] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "PhoneType": "mobile",
  "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
  "PhoneNumber": "+91 9898989890"
  }
  
```

アクションが成功すると、AddPhoneAuthenticationMethod タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - RemovePhoneAuthenticationMethod

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemovePhoneAuthenticationMethod] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "PhoneType": "mobile",
  "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
  "PhoneNumber": "+91 9898989890"
  }
  
```

アクションが成功すると、RemovePhoneAuthenticationMethod タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - UpdatePhoneAuthenticationMethod

[Configure connector task] ダイアログで、[Actions] をクリックします。
[UpdatePhoneAuthenticationMethod] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "securityComplianceNotificationPhones": "9899999999",
  "securityComplianceNotificationMails": "abc@gmail.com"
  }
  
```

アクションが成功すると、UpdatePhoneAuthenticationMethod タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - AddPrivilegedRole

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AddPrivilegedRole] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

{
  "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
  "Justification": "Add Privileged Role",
  "ScheduleInfo": "{\n\"StartDateTime\" : \"2022-09-09T21:31:27.91Z\",\n\"Expiration\"    : {\n\"Type\"        : \"Eligible\"}\n}"
  }

アクションが成功すると、AddPrivilegedRole タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - RemovePrivilegedRole

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemovePrivilegedRole] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

{
  "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
  "Justification": "Removing Privileage Role"
  }

アクションが成功すると、RemovePrivilegedRole タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "Success": "True"
  }]

例 - RetrieveUserPhoto

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RetrieveUserPhoto] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "UserId": "8e22c728-c523-436b-8f46-3b21cc1b5f80"
  } 
  
```

アクションが成功すると、RetrieveUserPhoto タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
    "Status": "Success",
    "FileData": "77+9UE5HDQoaCgAAAA1JSERSAAADUgAAAjYIBgAAAFo077+977+9AAAAAXNSR0IA77+977+9HO+/vQAAAARnQU1BAADvv73vv70L77+9YQUAAAAJcEhZcwAADu+/vQAADu+/vQHvv71v77+9ZAAA77+977+9SURBVHhe77+977+9ZXwcV9K+LWlmZCbvv71O77+977+977+9ZO+/vcmG77+9Ge+/vThmZmZm77+9OO+/vcmG77+977+9MTMzM++/vS0z77+977+977+9eu+/ve+/vXTvv71o77+9KAvvv73vv73vv71w77+9DjRO77+977+9Vl3vv70677+9KWsrR2zvv71zEe+/ve+/vUTvv73vv717KGrvv709EO+/ve+/vWjvv71RG01777+977+9Me+/ve+/vWjvv73vv719OmJLyqfZuu+/vRHvv71ZK++/vQ7Uj9iJ77+977+9du+/vUXEslrvv73vv73vv70uzbzvv70pFu+/vUrvv709Yl4P77+9eu+/vSDvv73vv71n77+977+977+9Gu+/ve+/vV3vv71sP2Vm77+977+9be+/vWbvv707RmxV77+9VFvvv70u77+9Fu+/ve+/vdqi77+9aTbvv71N77+977+9Re+/ve+/vWPvv70tYe+/vRXvv73vv70677+9bu+/vTRbS++/ve+/ve+/vWxkP1vvv71FbWt377+977+9LdW277+977+977+977+977+9ae+/ve+/vXvvv73vv73vv70Z77+9Xe+/vSLvv73vv70X77+977+9E++/vT1ob1/vv71+ae+/ve+/vWx3by1P77+9XT3vv71sL++/ve+/ve+/vWbvv73vv73vv71m77+9F+e0s2vvv712dErvv73vv73vv73vv73vv73vv71p77+977+9Le+/vW/vv73vv71oZ0vvv73vv70577+9R3tb77+92b7vv70R77+977+9KmIHKQ/vv73vv73agdapdu+/vU3vv73vv73vv73vv73vv71zXe+/ve+/ve+/ve+/ve+/vRTvv70777+977+977+96pqK77+9LO+/vXN077+9PO+/ve+/ve+/vVp2f++/vdOgNO+/ve+/veyBlO+/ve+/vQdQ77+9cO+/vTc477+9bBDvv71S77+977+977+977+9Zu+/ve+/vW8I77+977+977+9ZQ8paFnvv70LWnxwYe+/ve+/vVEWNBvvv71O77+977+9eQMKW++/vV8x77+977+9FO+/vd6k77+977+9LmHvv70eRS3erQBiG++/vXXvv71DzLI577+9LO+/vT3vv73vv71077+9Ze+/ve+/ve+/vTcebe+/vWbvv73vv71E77+9UEPvv71r77+9NMus77+9Zu+/ve+/vUVsXe+/ve+/ve+/ve+/ve+/vWZr77+9c29qRG0177+9VdWi77+977+9eu+/ve+/ve+/vUlfTe+/ve+/vW/vv73NujVTbX3vv73vv73vv73vv70V77+9He+/ve+/vXUj77+977+9AdeeMe+/ve+/ve+/ve+/ve+/ve+/vQHvv73vv70Y77+9aFcj77+9Y2Pvv700Zjtpb2vvv73vv73vv73vv73ZmHvXnHvvv70Y77+904Lvv73vv70y77+977+9EO+/ve+/vRjvv73vv71077+9dDvbs++/ve+/vXsX4bqU77+9Wu+/vVsH77+977+977+977+9P1vvv73vv70y77+9fO+/ve+/vV8pZd6rJe+/vXvvv70cy6Yef++/ve+/vWXvv71U1LJf77+9Wg3vv73vv71j1otF77+9NO+/ve+/vQTvv73vv70A77+9SO+/vWZHD++/vQ3vv71ta++/ve+/ve+/veO+rmDvv73vv73vv71c77+9cD1+77+9Hu+/ve+/vSpG77+977+9Y++/ve+/vWfvv73vv73vv70zMXvvv73vv73vv73
  ...[too long to view on UI. Please use the API to view the full content.]

例 - UpdateUserPhoto

[Configure connector task] ダイアログで、[Actions] をクリックします。
[UpdateUserPhoto] アクションを選択してから、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

{
  "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc",
  "Content": "iVBORw0KGgoAAAANSUhEUgAAA1IAAAI2CAIAAADVVi6oAAAgAElEQVR4AZy9d3Rc1dX3r3POHVmWrG6ckIQHN0gCCYEkT/IkJA89lARc1Xsf1ZlR78W2iis4BFuybMAFMMW4qctFknu31XvvzTbu0tx9fmufOzMWJe+b97fWXmede2ekBYs/8sm3bJm1uLAry9jJt2jFq9Khl6XDL0vFr0ilr0pHXlMdf52ee5tdXU5b3diAN50IYHdCyYMINh1FIJpCnJmcRCGFQSqBdDNIJzhp5H4Su5FIx5PYYDzrjaVdcaxRS+qjyWWNdFlHL2jZBR27ECNdiqNX41l9HG1MYI0JtCWBtSTSjiTWnSz1pNCuZNKXKvWl0e4U0p/GhtLZcDodz2QjmWw0i42soiOZdDiDDaXToVQ6ms76k2lvEuuKZ71xbCBJ6o+nA7F0IIb260ifhg5p6EAkHdGycS0bjaJjGjYWxSY17IZOmtCQ61p6P0a6HU1vRtPbsfRePH2QQO8lkXtJdDqN4aRTfRbRryaQQ+Ucqs+mshj9GiqvocpLyKU8h0CueMwmPJtCDoE8CtlMn2cxnWsh51pCnrWca8FzzSHPAtZYyqusIdMG0s15hq2cOkdOniUnW8hxVI5V6WPpdDSd1kn3IsndKPZNOL2hZteD6HgAHfSnff6s1ZM1u9NmD9biKTW500Z3qdGDNnmxFi+pyYO2+7BWL9Lmy9q8WbuP1OHHegJZVwDr8qc9gawvkPYF0cEgOhTMhkPYcKhqIIj2BpP+IDoQQkfD2WgEG4mgY5EqPCPodS27FUfvJ5lPpVnJGVaQbS9n28o5c+V1j+rXzYWN8+RN9vCuLWyep99kL2901G+Yo19rAevw33p6vdX9XPM72Wwiiw2l0v5U1p9Ge1Kk1gRaH8dOR7Ayf/alh2qnk7RjhWrbUmnLO6p332DrX6fZr0iZL7KUF1jCn1TaP86K/P2siN9Zhj43R/1b68DfWPv+ysbrlw5uT9g6L7JducjeeZGjy6J5zo/buyxwdF9g77nIwfcJ+9Bfzo34pX3MMw4Jv7LP/K3tpj/b5L9gu/0Fq89fn130zpzyFXNOONuecZ1z0WtOnd+ctiDrjkCbwTDH4Qjrm9qf3on9yd34H02n/Jc+9TFIf1xOX6hPexwyF0Da49NJj00nPXYndt7tuB9N6hyGImx71datfrOueNHTrtKR5axkmVS2fHaN67wLvovq1c+26f7cl/zqZPbye5u99NuC4JMI2B8LFelwIodffg/qtkBzIbTthI5dvHMP7/4cp+dL3vcVH9jPBw/CUDEfKYPRMj5Wzscq+dgRPirOh5dK8VH5d04YKYVR8YOj5TBSir9kpIwPlcJwKQyXwHAJFwNDxfg4VGx6lAcP8YGHA/0H8bH/EO8Tl76DeOk7CP378Z+wfx/v3wf9+6Dva7kXT+jbB31fQe9X0P0V79mH0/0V71LmS979BXR9bjp59xe86wve+Tl07OWdnxtnL+/cCx2fKcM7PoP2T6H9Uy5OaPuEt38C7Z/wtj3Qsou37sZp2cNb9sgte3gzDjTv4U27efNO3vwxb/4Ip0lM807etBMaP4KGHdCwgzd+iO8bP+SNH0KT4aXhfcN2qC/k9dvlum1Qvw3qxGPdNj5joN74WFsw8z3eDW8KeJ34qLYA3xhHrsuH+nxel89r83ndVsPP1hZA7VbAx628Lh8atvLGfF6/Va4v4LVbceryeaPxfWM+NObzhgLegC+VAeXeUIAX/KgA3xu/gL+wYSv+lGmMH+GbpgLT4HdmPP7f780FvHnrw2nZyvHNNpyWfN4i7k3boLmAt4pp2cZbC7npbNnGWwrxo5Z8aM0X39kGbQWG6djK2/OhrYC35z+cjnxow/e8Ix/E8M4C6MjnnQUPp2sb79qGj8rZOeOufPS9E7rF
  ...[too long to view on UI. Please use the API to view the full content.]

アクションが成功すると、UpdateUserPhoto タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 [{
  "Status": "Success"
  }]

例 - RemoveUserPhoto

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemoveUserPhoto] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
 {
  "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  } 
  
```

アクションが成功すると、RemoveUserPhoto タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 [{
  "Status": "Success"
  }]

例 - AssignManager

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AssignManager] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "ObjectId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "ObjectName": "users"
  }
  
```

アクションが成功すると、AssignManager タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 [{
  "Status": "True"
  }]

例 - RemoveManager

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemoveManager] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
  } 
  
```

アクションが成功すると、RemoveManager タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 [{
  "Status": "True"
  }]

例 - RetrieveManagerChain

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RetrieveManagerChain] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
  "UserId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "Levels": "max"
  }
  
```

アクションが成功すると、RetrieveManagerChain タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

[{
  "id": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "displayName": "test1",
  "manager": "{\r\n  \"@odata.type\": \"#microsoft.graph.user\",\r\n  \"id\": \"9630c9d7-cf15-4406-8d21-598e41a058cc\",\r\n  \"deletedDateTime\": null,\r\n  \"accountEnabled\": true,\r\n  \"ageGroup\": null,\r\n  \"businessPhones\": [],\r\n  \"city\": null,\r\n  \"companyName\": null,\r\n  \"consentProvidedForMinor\": null,\r\n  \"country\": null,\r\n  \"createdDateTime\": \"2024-04-12T10:24:42Z\",\r\n  \"creationType\": null,\r\n  \"department\": null,\r\n  \"displayName\": \"Azure_AD_Test\",\r\n  \"employeeId\": null,\r\n  \"employeeHireDate\": null,\r\n  \"employeeLeaveDateTime\": null,\r\n  \"employeeType\": null,\r\n  \"externalUserState\": null,\r\n  \"externalUserStateChangeDateTime\": null,\r\n  \"faxNumber\": null,\r\n  \"givenName\": null,\r\n  \"isLicenseReconciliationNeeded\": false,\r\n  \"jobTitle\": null,\r\n  \"legalAgeGroupClassification\": null,\r\n  \"mail\": null,\r\n  \"mailNickname\": \"Azure_AD_Test\",\r\n  \"mobilePhone\": null,\r\n  \"onPremisesDistinguishedName\": null,\r\n  \"onPremisesDomainName\": null,\r\n  \"onPremisesImmutableId\": null,\r\n  \"onPremisesLastSyncDateTime\": null,\r\n  \"onPremisesSecurityIdentifier\": null,\r\n  \"onPremisesSamAccountName\": null,\r\n  \"onPremisesSyncEnabled\": null,\r\n  \"onPremisesUserPrincipalName\": null,\r\n  \"otherMails\": [],\r\n  \"passwordPolicies\": null,\r\n  \"officeLocation\": null,\r\n  \"postalCode\": null,\r\n  \"preferredDataLocation\": null,\r\n  \"preferredLanguage\": null,\r\n  \"proxyAddresses\": [],\r\n  \"refreshTokensValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"imAddresses\": [],\r\n  \"isResourceAccount\": null,\r\n  \"showInAddressList\": null,\r\n  \"securityIdentifier\": \"S-1-12-1-2519779799-1141296917-2388205965-3428360257\",\r\n  \"signInSessionsValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"state\": null,\r\n  \"streetAddress\": null,\r\n  \"surname\": null,\r\n  \"usageLocat
  ...[too long to view on UI. Please use the API to view the full content.]

例 - AddProfileCardProperty

[Configure connector task] ダイアログで、[Actions] をクリックします。
[AddProfileCardProperty] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
 {
"Annotations": "[{"displayName": "Attributes"}]",
"DirectoryPropertyName": "CustomAttribute15"
}
```

アクションが成功すると、AddProfileCardProperty タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。

 [{
"Status": "True"
}]

例 - RemoveProfileCardProperty

[Configure connector task] ダイアログで、[Actions] をクリックします。
[RemoveProfileCardProperty] アクションを選択してから、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。
```
{
"DirectoryPropertyName": "CustomAttribute12"
} 
```

RemoveProfileCardProperty

connectorOutputPayload

 [{
"Status": "True"
}]

エンティティオペレーションの例

このセクションでは、このコネクタでエンティティオペレーションの一部を実行する方法について説明します。

例 - グループを一覧参照する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから [Groups] を選択します。
[LIST] オペレーションを選択し、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、お客様の要件に応じて filterClause を設定できます。

フィルタ句の値は単一引用符（'）で囲む必要があります。フィルタ句を使用すると、列に基づいてレコードをフィルタできます。

LIST オペレーションは、次のエンティティに対しても実行できます。

ユーザー
GroupMembers
ドメイン
RoleAssignments
Applications
デバイス
連絡先
DirectoryRoleTemplates
DirectoryRoles
AdministrativeUnits
SubscribedSKUs
PhoneAuthenticationMethod
Organization
DeviceLocalCredentials
ProfileCardProperties

例 - グループから単一のレコードを取得する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから [Groups] を選択します。
[GET] オペレーションを選択し、[完了] をクリックします。
エンティティ ID を「bb4756c7-38c0-426b-97aa-03b6443e7f16」に設定します。これは渡されるキーです。エンティティ ID を設定するには、[データマッピング] の [データマッパー] セクションで [データマッピングエディタを開く] をクリックし、[入力値] フィールドに "bb4756c7-38c0-426b-97aa-03b6443e7f16" を入力し、EntityId をローカル変数として選択します。

GET オペレーションは、次のエンティティに対しても実行できます。

ユーザー
GroupMembers
ドメイン
RoleAssignments
Applications
デバイス
連絡先
DirectoryRoleTemplates
DirectoryRoles
AdministrativeUnits
PhoneAuthenticationMethod
Organization
UserManagers
DeviceLocalCredentials

例 - グループからレコードを削除する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから [Groups] を選択します。
[DELETE] オペレーションを選択し、[完了] をクリックします。
エンティティ ID を「62008bbe-effa-4341-9d29-eac7f67b84fe」に設定します。これは渡されるキーです。エンティティ ID を設定するには、[データマッピング] の [データマッパー] セクションで [データマッピングエディタを開く] をクリックし、[入力値] フィールドに "62008bbe-effa-4341-9d29-eac7f67b84fe" を入力し、EntityId をローカル変数として選択します。
複合キーまたは主キーが 2 つ存在する場合、エンティティ ID を渡すとエラーがスローされることがあります。このような場合は、 id='62008bbe-effa-4341-9d29-eac7f67b84fe' などのフィルタ句を使用できます。

DELETE オペレーションは、次のエンティティに対しても実行できます。

ユーザー

ドメイン

Applications

デバイス

例 - グループ（Microsoft 365）エンティティを作成する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから [Groups] を選択します。
[Create] オペレーションを選択し、[完了] をクリックします。
[データマッピング] タスクの [データマッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。
```
{
"securityEnabled": true,
"displayName": "GoogleGCP",
"description": "This Group is creating for gcp testing.",
"mailEnabled": false,
"mailNickname": "GoogleGCP",
"groupTypes": "Unified"
}
```
この例では、Groups レコードを作成します。統合が成功すると、Groups タスクの connectorOutputPayload レスポンスパラメータの値は次のようになります。
```
{
"id": "30fc13b3-79b3-4ac5-a3ba-684d4e887ecc"
} 
```

例 - ユーザーを更新する

[Configure connector task] ダイアログで、[Entities] をクリックします。
Entity リストから [Users] を選択します。
[Update] オペレーションを選択し、[完了] をクリックします。
[データマッピング] タスクの [データマッパー] セクションで、Open Data Mapping Editor をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。
```
{
"jobTitle": "Software Engineer"
}
```
データマッパーでエンティティ ID をユーザーのエンティティに設定します。エンティティ ID を設定するには、[Open Data Mapping Editor] をクリックし、[Input Value] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。
[entityId] を指定する代わりに、[filterClause] を 7ad59ec3-1c37-4932-be51-7513fe98c3c3 に設定することもできます。

この例を実行すると、コネクタタスクの connectorOutputPayload 出力変数で次のようなレスポンスが返されます。
```
{
"id": "7ad59ec3-1c37-4932-be51-7513fe98c3c3"
} 
```

統合で Azure AD（Entra ID）接続を使用する

接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。

Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

Google Cloud コミュニティの助けを借りる

Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

Azure AD（Entra ID）

始める前に

コネクタを構成する

認証を構成する

接続構成のサンプル

Azure AD（認証コード付与タイプ）の接続タイプ

OAuth 2.0 クライアント認証情報の接続タイプ

JWT Bearer 接続タイプを使用した OAuth 2.0 クライアント認証情報

認証コードの再認可

接続作成後の追加手順

イベント サブスクリプションを構成する

エンティティ、オペレーション、アクション

システムの上限

アクション

AddGroupMember アクション

AddGroupMember アクションの入力パラメータ

RemoveGroupMember アクション

RemoveGroupMember アクションの入力パラメータ

AddGroupMember（ゲスト アカウント）アクション

AddGroupMember アクションの入力パラメータ

RemoveGroupMember（ゲスト アカウント）アクション

RemoveGroupMember アクションの入力パラメータ

AddUserApplicationRoleAssignment アクション

AddUserApplicationRoleAssignment アクションの入力パラメータ

RemoveUserApplicationRoleAssignment アクション

RemoveUserApplicationRoleAssignment アクションの入力パラメータ

AddGroupApplicationRoleAssignment アクション

AddGroupApplicationRoleAssignment アクションの入力パラメータ

RemoveGroupApplicationRoleAssignment アクション

RemoveGroupApplicationRoleAssignment アクションの入力パラメータ

ActivateDirectoryRole アクション

ActivateDirectoryRole アクションの入力パラメータ

VerifyDomain アクション

VerifyDomain アクションの入力パラメータ

ChangePassword アクション

ChangePassword アクションの入力パラメータ

ResetPassword アクション

ResetPassword アクションの入力パラメータ

AssignLicense アクション

AssignLicense アクションの入力パラメータ

RemoveLicense アクション

RemoveLicense アクションの入力パラメータ

FetchAdditionalUserFields アクション

FetchAdditionalUserFields アクションの入力パラメータ

AddGroupOwner アクション

AddGroupOwner アクションの入力パラメータ

RemoveGroupOwner アクション

RemoveGroupOwner アクションの入力パラメータ

InviteExternalUser アクション

InviteExternalUser アクションの入力パラメータ

AddPhoneAuthenticationMethod アクション

AddPhoneAuthenticationMethod アクションの入力パラメータ

RemovePhoneAuthenticationMethod アクション

RemovePhoneAuthenticationMethod アクションの入力パラメータ

UpdatePhoneAuthenticationMethod アクション

UpdatePhoneAuthenticationMethod アクションの入力パラメータ

AddPrivilegedRole アクション

AddPrivilegedRole アクションの入力パラメータ

RemovePrivilegedRole アクション

RemovePrivilegedRole アクションの入力パラメータ

RetrieveUserPhoto アクション

RetrieveUserPhoto アクションの入力パラメータ

UpdateUserPhoto アクション

UpdateUserPhoto アクションの入力パラメータ

RemoveUserPhoto アクション

RemoveUserPhoto アクションの入力パラメータ

AssignManager アクション

AssignManager アクションの入力パラメータ

RemoveManager アクション

RemoveManager アクションの入力パラメータ

RetrieveManagerChain アクション

RetrieveManagerChain アクションの入力パラメータ

AddProfileCardProperty アクション

AddProfileCardProperty アクションの入力パラメータ

RemoveProfileCardProperty アクション

RemoveProfileCardProperty アクションの入力パラメータ

アクションの例

例 - AddGroupMember

例 - RemoveGroupMember

例 - AddGroupMember（ゲスト アカウント）

イベントサブスクリプションを構成する

AddGroupMember（ゲストアカウント）アクション

RemoveGroupMember（ゲストアカウント）アクション

例 - AddGroupMember（ゲストアカウント）

例 - RemoveGroupMember(ゲストアカウント)

エンティティオペレーションの例