Microsoft Entra ID を Google SecOps と統合する
このドキュメントでは、Microsoft Entra ID を Google Security Operations と統合する方法について説明します。
この統合では、1 つ以上のオープンソース コンポーネントを使用します。この統合の完全なソースコードのコピーを Cloud Storage バケットからダウンロードできます。
ユースケース
Microsoft Entra ID を Google SecOps と統合すると、次のユースケースを解決できます。
ユーザー アカウント管理: 侵害の疑いや従業員のオフボーディングなどのセキュリティ イベントに基づいて、Microsoft Entra ID でのユーザー アカウントの無効化と有効化を自動化します。
パスワードの再設定: 不正使用されたアカウントやアカウントからロックアウトされたユーザーのパスワードの再設定をオーケストレートします。パスワードをリセットすると、パスワードの復元プロセスを効率化し、ヘルプデスク チケットを減らすことができます。
グループ管理: Microsoft Entra ID グループの作成、変更、削除を自動化します。
条件付きアクセス ポリシーの適用: Google SecOps のハンドブック内で Microsoft Entra ID の条件付きアクセス ポリシーを使用して、コンテキストに基づいてアクセスを動的に制御し、場所、デバイス、ユーザーのリスクなどの要因に基づいてリソースへのアクセスをきめ細かく制御できます。
セキュリティ通知とインシデント対応: Microsoft Entra ID のセキュリティ通知を Google SecOps に統合して、インシデント対応ワークフローを自動化します。
始める前に
Google SecOps で統合を構成する前に、Microsoft 環境で次の要件を満たしていることを確認します。
Azure アプリの登録: Microsoft Entra 管理センターでアプリケーションを登録して、クライアント ID とテナント ID を取得します。詳細な手順については、Microsoft Entra ID でアプリケーションを登録するをご覧ください。
API 権限とロールの割り当て: 実行するアクションと、テナント全体またはスコープ付きアクセス境界が必要かどうかに基づいて、必要な Microsoft Graph 権限または Microsoft Entra ロールを付与します。
クライアント シークレット: 登録済みアプリケーションの [Certificates & secrets] セクションでクライアント シークレットを生成します。Microsoft Entra ID ではシークレットの値(シークレット ID ではない)が 1 回しか表示されないため、すぐにコピーします。
API 権限を構成する
デプロイモデルに必要な Microsoft Graph アプリケーション権限のみを付与し、管理者の同意を付与します。手順については、Microsoft のドキュメントでアプリケーションの権限を構成するをご覧ください。
- 読み取り専用アクション(すべてのデプロイ):
Directory.Read.Allを付与します。 - テナント全体の書き込みアクション(デフォルト): 実行する書き込みアクションに対して、次の表のテナント全体のアクセス Microsoft Graph アプリケーション権限を付与します。
- スコープ付き書き込みアクション(特定のユーザーまたはグループに制限): 読み取り権限(
Directory.Read.All、必要に応じてAuditLog.Read.All)のみを付与します。書き込みアプリケーション権限は付与しないでください。代わりに、管理単位を使用して、次の表のスコープ付きアクセス ディレクトリ ロールを割り当てます。
| 機能とアクション | テナント全体のアクセス(Microsoft Graph アプリケーション権限) | スコープ付きアクセス(Microsoft Entra ディレクトリ ロール) |
|---|---|---|
ベース ディレクトリの読み取りと拡充(すべてのアクションで必須) Ping、Enrich User、Enrich Host、Get Manager Contact Details、Is User in Group、List Groups、List Members in the Group、List Users Groups Membership、およびList Users |
Directory.Read.All(または User.Read.All、GroupMember.Read.All、Device.Read.All) |
ディレクトリ オブジェクトを解決するには、テナント スコープで Directory.Read.All(または Directory Readers ロール)が必要です。 |
MFA とログインの強化(省略可) ユーザーの拡充またはマネージャーの連絡先情報取得で |
AuditLog.Read.All |
テナント スコープで AuditLog.Read.All が必要です。 |
アカウントのステータス管理 アカウントを無効にする、アカウントを有効にする |
User.EnableDisableAccount.All(または User.ReadWrite.All) |
Helpdesk Administrator または User Administrator |
パスワードの管理 パスワードの更新を強制する、ユーザー パスワードを再設定する |
User-PasswordProfile.ReadWrite.All および Password Administrator ディレクトリ ロール |
Password Administrator、Helpdesk Administrator、User Administrator。 |
セッションの取り消し ユーザー セッションを取り消す |
User.RevokeSessions.All(または User.ReadWrite.All) |
Authentication Administrator または User Administrator。 |
グループ メンバーシップの管理 ユーザーをグループに追加する、ユーザーをグループから削除する |
GroupMember.ReadWrite.All(または Group.ReadWrite.All) |
Groups Administrator または User Administrator(管理ユニットにターゲット グループが含まれている必要があります)。 |
パスワード操作にテナント全体のロールを割り当てる
テナント全体の Microsoft Graph 権限を使用し、パスワードの強制更新またはユーザー パスワードのリセットを実行する場合は、テナント スコープで登録済みアプリケーションに Password Administrator ディレクトリ ロールを割り当てる必要があります。手順については、Microsoft のドキュメントで Microsoft Entra ロールを割り当てるをご覧ください。
権限のスコープとアクセス境界
Google SecOps は、OAuth 2.0 クライアント認証情報フローを使用して Microsoft Graph に対して認証を行います。認証後にグループまたは組織部門でアクションをフィルタすることはありません。Microsoft Entra ID は、すべてのアクセス境界を直接適用します。
.Allアプリケーション権限は常にテナント全体に適用されます:.Allで終わる Microsoft Graph アプリケーション権限(User.ReadWrite.AllやGroup.ReadWrite.Allなど)は、テナント全体にアクセス権を付与します。特定のグループや管理単位にスコープを設定することはできません。- エンタープライズ アプリケーションのユーザー割り当てでは、API スコープが制限されない: [割り当てが必要] を有効にするか、ユーザーとグループをエンタープライズ アプリケーションに割り当てると、インタラクティブなユーザー ログインのみが制御されます。アプリケーションのサービス プリンシパルが Microsoft Graph を介して変更できるディレクトリ オブジェクトは制限されません。
管理ユニットを使用して書き込みアクションを制限する
テナント全体ではなく、特定のユーザーまたはグループのサブセットに書き込みアクションを制限する場合にのみ、次の手順を完了します。
- 読み取りアプリケーション権限のみを付与する: アプリケーション登録に
Directory.Read.All(および必要に応じてAuditLog.Read.All)のみを付与します。テナント全体のアプリケーション権限は管理単位の境界をオーバーライドするため、書き込み.Allアプリケーション権限(User.ReadWrite.AllやGroup.ReadWrite.Allなど)を削除します。 - 管理ユニットを作成して入力する: Microsoft Entra ID で管理ユニットを作成し、Google SecOps が変更できるターゲット ディレクトリ オブジェクトを追加します。
- ターゲット ユーザーを追加して、ユーザー アクション(アカウントを無効にする、アカウントを有効にする、パスワードの更新を強制する、ユーザー パスワードをリセットする、ユーザー セッションを取り消す)を制限します。
- ターゲット グループを追加して、グループ メンバーシップのアクション(グループにユーザーを追加する、グループからユーザーを削除する)を制限します。グループを追加すると、統合によってそのグループのメンバーシップのみを変更できます。それらのユーザーが管理ユニットに直接追加されていない限り、そのグループ内のユーザー アカウントを管理する権限は付与されません。
- スコープ付きディレクトリ ロールを割り当てる: API 権限テーブルの [スコープ付きアクセス] 列から、登録済みアプリケーションに必要なロールを割り当てます。スコープは管理単位に制限されます。手順については、Microsoft のドキュメントで Microsoft Entra ロールを割り当てるをご覧ください。
統合のパラメータ
Microsoft Entra ID の統合には、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Login API Root |
省略可
Microsoft ID プラットフォームでの認証に使用される API ルート。 デフォルト値は |
API Root |
省略可
Azure Active Directory インスタンスの API ルート。 デフォルト値は |
Client ID |
必須
Microsoft Entra ID アカウントのアプリケーション(クライアント)ID 値。 |
Client Secret |
必須
Microsoft Entra ID アカウントのクライアント シークレット値。 |
Directory ID |
必須
Microsoft Entra ID アカウントのディレクトリ(テナント)ID 値。 |
Verify SSL |
省略可
選択すると、統合によって、Microsoft Entra ID サーバーへの接続に使用される SSL 証明書が有効かどうかが検証されます。 デフォルトで選択されます。 |
Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。
必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法については、複数のインスタンスのサポートをご覧ください。
操作
アクションの詳細については、デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。
アクションを実行する前に、各機能に必要な権限またはディレクトリ ロールが構成されていることを確認してください。詳細については、API 権限を構成すると権限のスコープ設定とアクセス境界をご覧ください。
ユーザーをグループに追加する
[Add User to a Group] アクションを使用して、特定の Microsoft Entra ID グループにユーザーを追加します。このアクションでは、username@domain 形式で User エンティティを構成する必要があります。
このアクションは、Google SecOps の User エンティティに対して実行されます。
アクションへの入力
Add User to a Group アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Group ID |
必須
ユーザーを追加する Microsoft Entra ID グループの ID( |
アクションの出力
Add User to a Group アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Add User to a Group アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Member could not be added successfully. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Add User to a Group] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
アカウントを無効にする
Microsoft Entra ID でアカウントを無効にするには、[Disable Account] アクションを使用します。このアクションでは、User エンティティを username@domain 形式で構成する必要があります。
このアクションは、Google SecOps の User エンティティに対して実行されます。
アクションへの入力
なし
アクションの出力
アカウントを無効にするアクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
アカウントを無効にするアクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Disable user account was not successful. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[アカウントを無効にする] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
アカウントを有効にする
Microsoft Entra ID でアカウントを有効にするには、[Enable Account] アクションを使用します。このアクションでは、User エンティティを username@domain 形式で構成する必要があります。
このアクションは、Google SecOps の User エンティティに対して実行されます。
アクションへの入力
なし
アクションの出力
Enable Account アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
アカウントを有効にするアクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Enable user account was not successful. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、アカウントを有効にするアクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ホストを拡充する
[Enrich Host] アクションを使用して、Microsoft Entra ID の情報で Google SecOps Host エンティティを拡充します。このアクションは、Microsoft Entra ID のデバイス displayName フィールドを使用して、指定された Host エンティティの一致を検索します。
このアクションは、Google SecOps の Host エンティティに対して実行されます。
アクションへの入力
なし
アクションの出力
Enrich Host アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| エンティティ拡充テーブル | 利用可能 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
エンティティ拡充テーブル
ホストを拡充アクションは、次のエンティティ拡充をサポートしています。
| 拡充フィールド | ロジック |
|---|---|
AAD_Name |
JSON の結果に存在する場合に返します。 |
AAD_Enabled |
JSON の結果に存在する場合に返します。 |
AAD_Property Device ID |
JSON の結果に存在する場合に返します。 |
AAD_OS |
JSON の結果に存在する場合に返します。 |
AAD_Version |
JSON の結果に存在する場合に返します。 |
AAD_Profile Type |
JSON の結果に存在する場合に返します。 |
AAD_Compliant |
JSON の結果に存在する場合に返します。 |
AAD_Last Sign In |
JSON の結果に存在する場合に返します。 |
JSON の結果
次の例は、Enrich Host アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"EntityResult": {
"deletedDateTime": "1234569",
"complianceExpirationDateTime": "1234567",
"profileType": "RegisteredDevice",
"key": "007",
"if":"889922-aaaa-123123"
},
"Entity": "us-lt-v13001"
}
]
出力メッセージ
Enrich Host アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Host details were not found. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Enrich Host アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ユーザーを拡充する
[Enrich User] アクションを使用して、Microsoft Entra ID の情報で Google SecOps User エンティティを拡充します。このアクションでは、User エンティティを username@domain 形式で構成する必要があります。
このアクションは、Google SecOps の Host エンティティに対して実行されます。
アクションへの入力
ユーザーを拡充するアクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Include MFA Details |
省略可。 選択すると、アクションはユーザーに関する MFA の詳細を返します。 |
Include Last Sign In Details |
省略可。 選択すると、このアクションはユーザーのログイン アクティビティ(インタラクティブなログイン タイムスタンプと非インタラクティブなログイン タイムスタンプの両方を含む)を取得します。 |
アクションの出力
Enrich User アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| エンティティ拡充テーブル | 利用可能 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
エンティティ拡充テーブル
Enrich User アクションは、次のエンティティの拡充をサポートしています。
| 拡充フィールド | ロジック |
|---|---|
AAD_Name |
JSON の結果に存在する場合に返します。 |
AAD_Mobile Phone |
JSON の結果に存在する場合に返します。 |
AAD_Preferred Language |
JSON の結果に存在する場合に返します。 |
AAD_Job Title |
JSON の結果に存在する場合に返します。 |
AAD_Username |
JSON の結果に存在する場合に返します。 |
JSON の結果
次の例は、Enrich User アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"Entity": "user@domain.com",
"EntityResult": {
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
"accountEnabled": true,
"ageGroup": null,
"businessPhones": [],
"city": "New York",
"companyName": "ExampleCorp",
"consentProvidedForMinor": null,
"country": "US",
"createdDateTime": "2025-01-01T00:00:00Z",
"creationType": null,
"department": "Security",
"displayName": "User Name",
"mail": "user@domain.com",
"employeeId": "12345",
"employeeHireDate": null,
"employeeType": null,
"externalUserStateChangeDateTime": null,
"faxNumber": null,
"givenName": "User",
"imAddresses": [],
"externalUserState": null,
"jobTitle": "Security Analyst",
"surname": "Surname",
"lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
"legalAgeGroupClassification": null,
"mailNickname": "usernickname",
"mobilePhone": "+11234567890",
"id": "user-id-12345",
"officeLocation": null,
"onPremisesSamAccountName": null,
"onPremisesDistinguishedName": null,
"onPremisesDomainName": null,
"onPremisesImmutableId": null,
"onPremisesLastSyncDateTime": null,
"onPremisesProvisioningErrors": [],
"onPremisesSecurityIdentifier": null,
"onPremisesSyncEnabled": null,
"onPremisesUserPrincipalName": null,
"otherMails": [],
"passwordPolicies": "None",
"preferredDataLocation": null,
"preferredLanguage": "en-US",
"proxyAddresses": [],
"signInSessionsValidFromDateTime": "2025-01-01T00:00:00Z",
"state": "NY",
"streetAddress": "123 Main St",
"usageLocation": "US",
"userPrincipalName": "user@domain.com",
"userType": "Member",
"postalCode": "10001",
"deletedDateTime": null,
"showInAddressList": null,
"isResourceAccount": null,
"refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
"employeeOrgData": null,
"passwordProfile": null,
"authorizationInfo": {
"certificateUserIds": []
},
"mfa_details": {
"id": "user-id-12345",
"userPrincipalName": "user@domain.com",
"userDisplayName": "User Name",
"userType": "member",
"isAdmin": false,
"isSsprRegistered": true,
"isSsprEnabled": true,
"isSsprCapable": true
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"methodsRegistered": [
"email",
"mobilePhone"
],
"defaultMfaMethod": "mobilePhone",
"isSystemPreferredAuthenticationMethodEnabled": false,
"systemPreferredAuthenticationMethods": [],
"userPreferredMethodForSecondaryAuthentication": "oath",
"lastUpdatedDateTime": "2026-01-01T00:00:00Z"
}
}
}
]
出力メッセージ
Enrich User アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Users list fetch was not successful. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Enrich User アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
パスワードの更新を強制する
[パスワードの更新を強制する] アクションを使用して、ユーザーにパスワードの更新を強制します。この操作を行うと、ユーザーは次回のログイン時にパスワードを変更する必要があります。
[Force Password Update] アクションでは、User エンティティを username@domain 形式で構成する必要があります。
このアクションは、Google SecOps の User エンティティに対して実行されます。
アクションへの入力
なし
アクションの出力
パスワードの更新を強制するアクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[パスワードの更新を強制する] 操作では、次の出力メッセージが返されることがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Attempt to Force user password update was not successful.
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[パスワードの更新を強制する] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
マネージャーの連絡先情報を取得する
[Get Manager Contact Details] アクションを使用して、ユーザーのマネージャーの連絡先情報を取得します。
Get Manager Contact Details アクションでは、User エンティティを username@domain 形式で構成する必要があります。
このアクションは、Google SecOps の User エンティティに対して実行されます。
アクションへの入力
Get Manager Contact Details アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Fields To Return |
省略可。 取得する特定のマネージャー プロファイル属性のカンマ区切りのリスト。 値を指定しない場合、アクションは API で定義されたデフォルトの属性セットを返します。 デフォルト値は |
Include MFA Details |
省略可。 選択すると、アクションはユーザーに関する MFA の詳細を返します。 |
Include Last Sign In Details |
省略可。 選択すると、このアクションはユーザーのログイン アクティビティ(インタラクティブなログイン タイムスタンプと非インタラクティブなログイン タイムスタンプの両方を含む)を取得します。 |
アクションの出力
[Get Manager Contact Details] アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| エンティティ拡充テーブル | 利用可能 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
Get Manager Contact Details アクションは、Google SecOps で次のテーブルを返すことができます。
テーブル名: Manager contact
列:
- 名前
- 電話番号
エンティティ拡充テーブル
[Get Manager Contact Details] アクションは、次のエンティティの拡充をサポートしています。
| 拡充フィールド | ロジック |
|---|---|
Display Name |
JSON の結果に存在する場合に返します。 |
Mobile Phone |
JSON の結果に存在する場合に返します。 |
@odata.context |
JSON の結果に存在する場合に返します。 |
AAD_Job Title |
JSON の結果に存在する場合に返します。 |
AAD_Username |
JSON の結果に存在する場合に返します。 |
JSON の結果
次の例は、マネージャーの連絡先情報取得アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"Entity": "user@example.com",
"EntityResult": {
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
"accountEnabled": true,
"ageGroup": null,
"businessPhones": [],
"city": "Anytown",
"companyName": "Example Corporation",
"consentProvidedForMinor": null,
"country": "US",
"createdDateTime": "2025-01-01T00:00:00Z",
"creationType": null,
"department": "Security Operations",
"displayName": "Internal User",
"mail": "user@example.com",
"employeeId": "ID-00001",
"employeeHireDate": null,
"employeeType": "Full-time",
"externalUserStateChangeDateTime": null,
"faxNumber": null,
"givenName": "Alex",
"imAddresses": [],
"externalUserState": null,
"jobTitle": "Security Lead",
"surname": "Doe",
"lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
"legalAgeGroupClassification": null,
"mailNickname": "alexdoe",
"mobilePhone": "+1 555-0100",
"id": "00000000-0000-0000-0000-000000000000",
"officeLocation": null,
"usageLocation": "US",
"userPrincipalName": "user@example.com",
"userType": "Member",
"postalCode": "00000",
"deletedDateTime": null,
"showInAddressList": null,
"isResourceAccount": null,
"refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
"employeeOrgData": null,
"authorizationInfo": {
"certificateUserIds": []
},
"sponsors": [],
"mfa_details": {
"id": "00000000-0000-0000-0000-000000000000",
"userPrincipalName": "user@example.com",
"userDisplayName": "Internal User",
"userType": "member",
"isAdmin": true,
"isSsprRegistered": false,
"isSsprEnabled": true,
"isSsprCapable": false,
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"methodsRegistered": [
"mobilePhone",
"softwareOneTimePasscode"
],
"defaultMfaMethod": "softwareOneTimePasscode",
"isSystemPreferredAuthenticationMethodEnabled": true,
"systemPreferredAuthenticationMethods": [
"SoftwareOTP"
],
"userPreferredMethodForSecondaryAuthentication": "oath",
"lastUpdatedDateTime": "2026-01-01T00:00:00Z"
}
}
}
]
出力メッセージ
Get Manager Contact Details アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Could not fetch user manager's details successfully. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Get Manager Contact Details アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ユーザーがグループに属しているかどうか
[Is User in Group] アクションを使用して、ユーザーが特定の Microsoft Entra ID グループのメンバーであるかどうかを確認します。このアクションでは、User エンティティを username@domain 形式で構成する必要があります。
このアクションは、Google SecOps の User エンティティに対して実行されます。
アクションへの入力
Is User in Group アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Group ID |
必須
ユーザーを追加する Microsoft Entra ID グループの ID( |
アクションの出力
Is User in Group アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Is User in Group アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"EntityResult": "true",
"Entity": "user@example.com"
}
]
出力メッセージ
ユーザーがグループに属しているかアクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
User was not found in the group. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Is User in Group アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
グループの一覧表示
グループを一覧表示アクションを使用して、指定した検索条件で Microsoft Entra ID グループを一覧表示します。
リスティング グループ アクションの場合、フィルタリングは Name フィールドで機能します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
List Groups アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Order By |
省略可
返されたグループを名前で並べ替える順序。 デフォルト値は 値は次のいずれかになります。
|
Results Limit |
省略可
返されるグループの最大数。 |
Filter Logic |
省略可
グループを名前でフィルタするロジック。 デフォルト値は 値は次のいずれかになります。
|
Filter Value |
省略可
選択したフィルタ ロジックを使用してグループをフィルタする値。この値はグループ名に適用されます。
値を設定しない場合、フィルタは適用されません。 |
アクションの出力
[List Groups] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| エンティティ拡充テーブル | 利用可能 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
List Groups アクションは、Google SecOps で次のテーブルを返すことができます。
テーブル名: Groups
列:
- 名前
- ID
- 説明
- メール
- 作成日時
- グループの種類
エンティティ拡充テーブル
List Groups アクションは、次のエンティティの拡充をサポートしています。
| 拡充フィールド | ロジック |
|---|---|
Group Type |
JSON の結果に存在する場合に返します。 |
ID |
JSON の結果に存在する場合に返します。 |
Name |
JSON の結果に存在する場合に返します。 |
Description |
JSON の結果に存在する場合に返します。 |
Created Time |
JSON の結果に存在する場合に返します。 |
JSON の結果
次の例は、List Groups アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"Group_Type": "managed",
"Id": "1212-12312-123",
"Name": "Group Name",
"Description": "This group is ...",
"Created_Time": "2019-10-24T19:10:18Z",
"onPremisesSamAccountName": "alext"
}
]
出力メッセージ
リスティング グループ アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Groups list fetch was not successful. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[List Groups] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
グループのメンバーを一覧表示する
[List Members in the Group] アクションを使用して、指定した Microsoft Entra ID グループのメンバーを一覧表示します。
フィルタリング ロジックは、Filter Key パラメータ値に基づいて機能します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[List Members in the Group] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Max Records To Return |
省略可
返すレコードの最大数。 デフォルト値は 50 です。 |
Group Name |
省略可
メンバーを一覧表示する Microsoft Entra ID グループの名前。 |
Group ID |
省略可
メンバーを一覧表示する Microsoft Entra ID グループの ID。 |
Filter Key |
省略可
グループ メンバーをフィルタするフィールド( 値は次のいずれかになります。
|
Filter Logic |
省略可
フィルタに適用するロジック。 値は次のいずれかになります。
|
Filter Value |
省略可
選択した
値を設定しない場合、フィルタは適用されません。 |
アクションの出力
[List Members in the Group] アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
[List Members in the Group] アクションは、Google SecOps で次のテーブルを返すことができます。
表の名前: グループの利用可能なメンバー
列:
- ID
- ユーザー プリンシパル名
- 表示名
- 姓
- 名
- メール
- 役職
- ビジネス用スマートフォン
- スマートフォン
- オフィスの所在地
- 優先言語
JSON の結果
次の例は、グループ内のメンバーを一覧表示するアクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"@odata.type": "#microsoft.graph.user",
"id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"businessPhones": [],
"displayName": "Alex T",
"givenName": "Alex",
"jobTitle": "Software Engineer",
"mail": "alex.t@example.com",
"mobilePhone": null,
"officeLocation": "Building A",
"preferredLanguage": "en-US",
"surname": "T",
"userPrincipalName": "alex.t@example.com"
}
]
出力メッセージ
List Members in the Group アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "List Members in the Group". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[グループのメンバーを一覧表示する] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ユーザーのグループ メンバーシップを一覧表示する
[List User's Groups Membership] アクションを使用して、ユーザーがメンバーになっている Microsoft Entra ID グループを一覧表示します。
ユーザー名は、エンティティまたはアクション入力パラメータとして指定できます。ユーザー名をエンティティと入力パラメータの両方として構成すると、アクションは入力パラメータを使用します。
ユーザー名を構成するには、username@domain 形式に従います。
このアクションは、Google SecOps の Username エンティティに対して実行されます。
アクションへの入力
List User's Groups Membership アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
User Name |
省略可
グループ メンバーシップを取得するユーザー名のカンマ区切りのリスト( |
Return Only Security Enabled Groups |
省略可
選択すると、ユーザーが属するセキュリティ対応グループのみが返されます。 デフォルトでは選択されていません。 |
Return Detailed Groups Information |
省略可
選択すると、アクションは Microsoft Entra ID グループに関する詳細情報を返します。 デフォルトでは選択されていません。 |
Filter Key |
省略可
グループのフィルタリングに使用するキー。 デフォルト値は 値は次のいずれかになります。
|
Filter Logic |
省略可
グループをフィルタリングするときに適用するロジック。 デフォルト値は 次の値を指定できます。
|
Filter Value |
省略可
グループのフィルタリングに使用する値。
値を設定しない場合、フィルタは適用されません。 |
Max Records To Return |
省略可
返すレコードの最大数。値を設定しない場合、アクションはデフォルトで 50 件のレコードを返します。 |
アクションの出力
[List User's Groups Membership] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
ユーザーのグループ メンバーシップを一覧表示するアクションは、Google SecOps で次のテーブルを返すことができます。
テーブル名: グループ メンバーシップ
列:
- ID
- 表示名
- 説明
- セキュリティが有効
- セキュリティ ID
- Created DateTime
- 分類
- 公開設定
- メール
- メールが有効
- メールのニックネーム
JSON の結果
次の例は、ユーザーのグループ メンバーシップを一覧表示するアクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(Edm.String)",
"value": [
"ID",
"ID",
"ID",
]
}
出力メッセージ
ユーザーのグループ メンバーシップを一覧表示するアクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "List User's Groups Membership". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ユーザーのグループ メンバーシップを一覧表示するアクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ユーザーの一覧表示
List Users アクションを使用して、指定した検索条件で Microsoft Entra ID ユーザーを一覧表示します。
[List Users] アクションの場合、フィルタリングは Username(userPrincipalName)フィールドで機能します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
List Users アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Filter |
省略可
結果に含めるフィールド。 デフォルト値は 値は次のいずれかになります。
|
Order By Field |
省略可
結果の並べ替え基準となるフィールド。 デフォルト値は 値は次のいずれかになります。
|
Order By |
省略可
結果の順序(昇順または降順)。 デフォルト値は 値は次のいずれかになります。
|
Results Limit |
省略可
返されるユーザーの最大数。 |
Advanced Filter Logic |
省略可
デフォルト値は 次の値を指定できます。
|
Advanced Filter Value |
省略可
値を設定しない場合、フィルタは適用されません。 |
アクションの出力
[List Users] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| エンティティ拡充テーブル | 利用可能 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
List Users アクションは、Google SecOps で次のテーブルを返すことができます。
テーブル名: Users
列:
- 名前
- ユーザー名
- ID
- 名
- 優先言語
- メール
- スマートフォン
- 姓
- 役職
エンティティ拡充テーブル
List Users アクションは、次のエンティティの拡充をサポートしています。
| 拡充フィールド | ロジック |
|---|---|
Username |
JSON の結果に存在する場合に返します。 |
Surname |
JSON の結果に存在する場合に返します。 |
Name |
JSON の結果に存在する場合に返します。 |
Job Title |
JSON の結果に存在する場合に返します。 |
Mail |
JSON の結果に存在する場合に返します。 |
JSON の結果
次の例は、List Users アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"Group Type": "managed",
"Id": "ID",
"Name": "Example",
"Description": "Example",
"Created Time":"2019-10-24T19:10:18Z"
}
]
出力メッセージ
ユーザーを一覧表示アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
User list fetch was not successful. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ユーザーを一覧表示するアクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
Ping
[Ping] アクションを使用して、Microsoft Entra ID への接続性をテストします。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
なし
アクションの出力
Ping アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Ping アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Connection could not be established successfully. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
グループからユーザーを削除する
[Remove User from the Group] アクションを使用して、Microsoft Entra ID の指定されたグループからユーザーを削除します。
ユーザー名は、エンティティまたはアクション入力パラメータとして指定できます。ユーザー名をエンティティと入力パラメータの両方として構成すると、アクションは入力パラメータを使用します。
ユーザー名を構成するには、username@domain 形式に従います。
このアクションは、Google SecOps の Username エンティティに対して実行されます。
アクションへの入力
Remove User from the Group アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
User Name |
省略可
指定したグループから削除するユーザー名のカンマ区切りの文字列。このパラメータ値を構成するには、 値を設定しない場合、アクションはアクション インシデントのユーザー エンティティのユーザー名で実行されます。 |
Group Name |
省略可
ユーザーを削除するグループの名前。 |
Group ID |
省略可
ユーザーを削除するグループの ID。
|
アクションの出力
Remove User from the Group アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Remove User from the Group アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Remove User from the Group". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Remove User from the Group] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ユーザー パスワードを再設定
[Reset User Password] アクションを使用して、ユーザー パスワードをアクションで指定したパスワードに再設定します。この操作を行うと、ユーザーは次回ログイン時にパスワードを変更する必要があります。
ユーザー パスワードを再設定するアクションでは、User エンティティを username@domain 形式で構成する必要があります。
このアクションは、Google SecOps の User エンティティに対して実行されます。
アクションへの入力
ユーザー パスワードを再設定するアクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Password |
必須
ユーザーに設定する新しいパスワード。 |
アクションの出力
ユーザー パスワードを再設定アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Reset User Password アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
User password reset was not successful. |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Reset User Password] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ユーザー セッションの取り消し
ユーザー セッションを取り消すには、ユーザー セッションの取り消しアクションを使用します。
このアクションは、次の Google SecOps エンティティに対して実行されます。
UsernameEmail Address
アクションへの入力
なし
アクションの出力
ユーザー セッションの取り消しアクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、ユーザー セッションを取り消すアクションを使用した場合に受信される JSON 結果の出力を示しています。
ユーザーが存在する場合:
{ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Edm.Boolean", "value": true }ユーザーが見つからない場合:
{ "error": "User not found." }
出力メッセージ
ユーザー セッションの取り消しアクションでは、次の出力メッセージが返されることがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Revoke User Session". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ユーザー セッションを取り消すアクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。