Active Directory と Google SecOps を統合する

このドキュメントでは、Active Directory を Google Security Operations と統合する方法について説明します。

ユースケース

Active Directory との統合では、Google SecOps の機能を使用して次のユースケースをサポートします。

  • ユーザーの有効化と無効化: 不正使用の疑いがあるユーザー アカウントを無効にして、不正アクセスを防止します。

  • パスワードの再設定: Active Directory でユーザー パスワードを自動的に再設定し、変更をお客様に通知します。

  • グループの管理: ユーザーのロールに基づいて適切なセキュリティ グループに新しいユーザーを追加し、ユーザーに適切なアクセス権が付与されていることを確認します。

  • ユーザー情報を取得する: 特定のユーザー アカウントのグループ メンバーシップ、最終ログイン日時、連絡先情報などのユーザーの詳細情報を取得します。

  • オフボーディングを自動化する: 従業員がオフボーディングされる場合に、アカウントを無効にし、グループから削除して、ファイルの所有権を譲渡します。

始める前に

Google SecOps で Active Directory の統合を構成する前に、ネットワーク環境、Active Directory ドメイン サービス（AD DS）、サービス アカウントの認証情報がすべての運用上の前提条件を満たしていることを確認します。

インテグレーションの環境を準備するには、次の前提条件を満たします。

  1. Google SecOps インスタンス（またはリモート エージェント）と Active Directory ドメイン コントローラ間のネットワーク接続と DNS の解決を確認します。

  2. LDAPS（ポート 636）経由で接続する場合（パスワードのリセットに必要）、ディレクトリ証明書が構成されていることを確認します。内部認証局（CA）を使用する場合は、ルートまたは中間 CA 証明書を Base64 エンコード用に準備します。

  3. 最小権限の原則（PoLP）に準拠した専用の Active Directory サービス アカウントを作成します。

  4. 必要なアクション権限を確認して、実行する予定の特定のハンドブックに必要な属性とアクセス権を特定します。

  5. Active Directory ユーザーとコンピュータ（ADUC）または PowerShell（dsacls）を使用して、ターゲット組織部門（OU）の権限を委任します。サービス アカウントに userAccountControl 属性に対する明示的な読み取り / 書き込みアクセス権があることを確認します。

ネットワークと DNS の要件

Google SecOps は、TCP 経由で Lightweight Directory Access Protocol（LDAP または LDAPS）を使用して Active Directory ドメイン コントローラと直接通信します。

ネットワーク環境が次の接続ルールを満たしていることを確認します。

  • ポート接続: ネットワーク ファイアウォールとルーティングで、次のポートで Google SecOps（またはリモート エージェント）から Active Directory ドメイン コントローラへのアウトバウンド通信が許可されていることを確認します。

    • LDAP（標準）: 暗号化されていない LDAP 通信用にポート 389/TCP を開きます。
    • LDAPS（推奨 - パスワードの場合は必須）: ポート 636/TCP（またはカスタム SSL/TLS ポート）を開きます。LDAPS は、暗号化されたディレクトリ トラフィックに必要であり、ユーザー パスワードの設定などのパスワード変更アクションに必須です。

  • DNS とホスト名の解決: Active Directory では、SSL/TLS 証明書とディレクトリ サービス バインディングを照合するために、正確なホスト名解決が必要です。ドメインが内部 DNS 設定を介して完全修飾 DNS 名で解決される場合は、追加のホスト構成は必要ありません。リモート エージェント コンテナ イメージで DNS の解決が利用できない場合は、/etc/hosts ファイルを構成します。

/etc/hosts ファイルを構成する

Active Directory では、SSL/TLS 証明書とディレクトリ サービス バインディングを一致させるために、正確なホスト名解決が必要です。リモート エージェントが DNS を使用して Active Directory ドメイン コントローラを解決できない場合は、ホストを手動でマッピングします。

/etc/hosts ファイルを構成する手順は次のとおりです。

  1. 管理者権限でテキスト エディタで /etc/hosts を開きます。

    sudo vi /etc/hosts

  2. ドメイン コントローラの IP アドレスを完全修飾ドメイン名（FQDN）にマッピングするエントリを追加します。

    192.0.2.195 dc01.example.local

  3. ファイルを保存して閉じます。

インテグレーションに CA 証明書が必要ない場合は、認証とサービス アカウントの要件の構成に進みます。それ以外の場合は、CA 証明書を構成します。

（省略可）CA 証明書を構成する

プライベート CA または内部 CA によって発行された証明書を使用して LDAPS（ポート 636）経由で接続する場合は、設定時に base64 でエンコードされた証明書文字列を指定して、信頼できる TLS 接続を確立します。

CA 証明書を構成してアップロードする手順は次のとおりです。

  1. PEM 形式の証明書ファイルをエンコードします。

    • Linux: bash base64 -w 0 mycert.crt

    • macOS: bash base64 -i mycert.crt

  2. 出力文字列全体（エンコードされたヘッダーを含む）をコピーし、Google SecOps の統合構成の [CA Certificate File - parsed into Base64 String] フィールドに貼り付けます。

  3. ホスト名が証明書の共通名（CN）またはサブジェクト代替名（SAN）と一致するように、Server パラメータをドメイン コントローラの FQDN（IP アドレスではない）に設定します。

  4. [テスト] をクリックして、TLS ハンドシェイクを検証します。

認証とサービス アカウントの要件

Active Directory 統合では、標準の AD DS 認証情報を使用して認証が行われます。

認証設定が次のセキュリティ プラクティスに準拠していることを確認します。

  • 専用のサービス アカウント: Google SecOps の自動化されたプレイブック専用のサービス アカウント（svc_secops_ad など）を作成します。インタラクティブ ユーザー アカウントまたは組み込みのドメイン管理者アカウントの使用は避けてください。

  • ユーザー名の形式: ユーザー名は、ユーザー プリンシパル名（UPN）（svc_secops@example.local など）またはダウンレベル ログオン名（EXAMPLE\svc_secops）として指定できます。

  • PoLP: サービス アカウントを、ドメイン管理者、エンタープライズ管理者、アカウント オペレーターなどの特権組み込みグループに追加しないでください。代わりに、ユーザー、コンピュータ、グループ オブジェクトが存在する特定の OU にきめ細かい権限を付与します。

アクションの権限を構成する（最小権限）

認証を行うサービス アカウントに、プレイブックが実行するアクションに必要な特定の Active Directory 権限と LDAP 属性アクセス権を付与します。

次の表で、Active Directory アクションの最小権限を確認してください。

アクション名 必要な AD DS 権限 / 拡張権限 ターゲット オブジェクト クラス 説明 / 属性の範囲
ping Read Property ユーザー、ドメインのルート 構成されたサービス アカウント オブジェクト（sAMAccountName、userPrincipalName、mail）をクエリして、ディレクトリの接続と認証情報を検証します。
エンティティを拡充する
  • List Contents
  • Read Property （ターゲット属性: userAccountControl、sAMAccountName、mail、memberOf、lockoutTime、pwdLastSet）
 ユーザー、コンピュータ、グループ ユーザーとコンピュータの属性をクエリし、ネストされたグループ メンバーシップを解決します。null サブスクリプト エラーを防ぐため、userAccountControl で Read Property が必要です。
アカウントを無効にする
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 ユーザー ターゲット ユーザー オブジェクトの ACCOUNTDISABLE フラグ（0x0002）を読み取り、設定します。
アカウントを有効にする
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 ユーザー ターゲット ユーザー オブジェクトの ACCOUNTDISABLE フラグ（0x0002）を読み取ってクリアします。
パソコンを無効にする
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 パソコン ターゲット コンピュータ オブジェクトの ACCOUNTDISABLE フラグを読み取って設定します。
パソコンを有効にする
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 パソコン ターゲット コンピュータ オブジェクトの ACCOUNTDISABLE フラグを読み取ってクリアします。
Release Locked Account（ロックされたアカウントのリリース） Write Property: lockoutTime ユーザー lockoutTime 属性を 0 に設定して、ロックされたユーザー アカウントのロックを解除します。
パスワードの更新を強制する Write Property: pwdLastSet ユーザー pwdLastSet 属性を 0 に設定して、ユーザーが次回ログイン時にパスワードを変更することを要求します。
ユーザー パスワードを設定する
  • Extended Right: Reset Password (User-Force-Change-Password)
  • （省略可）Write Property: unicodePwd
 ユーザー 対象ユーザーのパスワードを再設定します。LDAPS（ポート 636）または StartTLS が必要です。
ユーザーをグループに追加
  • Read Property: member
  • Write Property: member
 グループ ターゲット ユーザーの識別名（distinguishedName）をグループの member 属性に追加します。
Remove User From Group
  • Read Property: member
  • Write Property: member
 グループ グループの member 属性から、ターゲット ユーザーの識別名（distinguishedName）を削除します。
ユーザーの組織部門を変更する
  • ソース組織部門の Delete Child Object（ユーザー）
  • 宛先 OU の Create Child Object（ユーザー）
  • Write Property: name、 distinguishedName
 組織部門（OU）、ユーザー LDAP modify_dn を使用して、ユーザー オブジェクトを OU 間で移動します。
ホスト OU を変更する
  • ソース組織部門の Delete Child Object（コンピュータ）
  • 宛先 OU の Create Child Object（コンピュータ）
  • Write Property: name、 distinguishedName
 組織部門（OU）、コンピュータ LDAP modify_dn を使用して、コンピュータ オブジェクトを OU 間で移動します。
AD ユーザーの属性を更新する ターゲット属性（mail、title、department、telephoneNumber、description、manager など）の Write Property ユーザー ターゲット ユーザー オブジェクトの指定された属性値を変更します。
AD ホストの属性を更新する ターゲット属性の Write Property（description や location など） パソコン ターゲット コンピュータ オブジェクトの指定された属性値を変更します。
グループ メンバーを取得する
  • List Contents
  • Read Property: member、sAMAccountName、distinguishedName
 グループ、ユーザー、コンピュータ グループ メンバーシップとメンバー アカウントの属性をクエリします。
Get Manager Contact Details
  • Read Property: manager
  • Read Property: mail、displayName、telephoneNumber、title
 ユーザー ターゲット ユーザー オブジェクトから manager 属性を読み取り、管理者の連絡先情報を取得します。
Is User In Group
  • Read Property: memberOf、 sAMAccountName
 ユーザー、グループ ユーザー アカウントが指定されたセキュリティ グループまたは配布グループに属しているかどうかを評価します。
ユーザー グループを一覧表示する
  • Read Property: memberOf、 sAMAccountName
 ユーザー、グループ 指定されたユーザー アカウントに割り当てられているすべてのグループのリストを返します。
Active Directory を検索する
  • List Contents
  • クエリされた属性の Read Property
 ユーザー、コンピュータ、グループ、OU ディレクトリ サブツリーに対してカスタム LDAP フィルタ クエリを実行します。

Active Directory での権限の委任

広範な管理者権限を付与せずに PoLP を適用するには、ADUC または PowerShell と dsacls を使用して、標準の Active Directory 管理ツールを使用してターゲット OU の権限を委任します。

ADUC を使用して制御を委任する

グラフィカル インターフェースを使用する場合は、ADUC の制御の委任ウィザードを使用して、オブジェクトとプロパティ固有の権限を委任します。

ターゲット OU でウィザードを実行して、アカウント管理に必要な特定のオブジェクトとプロパティの権限（アカウント制御フラグの読み取りと書き込み、パスワードのリセット、アカウントのロック解除など）を付与します。

ウィザードの実行に関する手順については、Microsoft のドキュメントの Windows Server の AD DS での制御の委任をご覧ください。

PowerShell と dsacls を使用して制御を委任する

コマンドライン アプローチを好む場合や、権限の割り当てを自動化してスクリプト化する必要がある場合は、組み込みの dsacls.exe コマンドライン ユーティリティとともに PowerShell を使用します。

管理ワークステーションまたはドメイン コントローラで次のコマンド例を実行し、移行先 OU とサービス アカウント名を置き換えます。

  • userAccountControl に対する読み取り / 書き込み権限を付与する（ユーザー アカウントを無効化 / 有効化し、エンリッチメント エラーを防ぐ）: powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;user"
  • コンピュータ オブジェクトに対する userAccountControl の読み取り / 書き込み権限を付与する（コンピュータの無効化 / 有効化）: powershell dsacls.exe "OU=Computers,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;computer"
  • アカウントのロック解除権限を付与する（lockoutTime）: powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:WP;lockoutTime;user"
  • パスワードの強制変更権限を付与する（pwdLastSet）: powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:WP;pwdLastSet;user"
  • パスワードの再設定権限を付与する（Reset Password 拡張権限）: powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:CA;Reset Password;user"
  • セキュリティ グループのメンバーシップ変更権限を付与する: powershell dsacls.exe "CN=SecOps-Quarantine,OU=Groups,DC=example,DC=local" /G "EXAMPLE\svc_secops_ad:RPWP;member;group"

構文とパラメータ スイッチの詳細については、Microsoft の dsacls に関するドキュメントをご覧ください。

統合のパラメータ

Active Directory との統合には、次のパラメータが必要です。

パラメータ 説明
Server

必須。

Active Directory サーバーのホスト名、DNS 名、または IP アドレス。統合は LDAP プロトコルを使用して通信します。

カスタムポートを使用するには、アドレスにポートを追加します（mydomain.com:636 など）。

デフォルトでは、SSL/TLS が有効になっている場合はポート 636 が使用され、無効になっている場合はポート 389 が使用されます。
Username

必須。

Active Directory に接続するユーザーのメールアドレス（例: user@example.com）。

このパラメータは userPrincipalName 属性も受け入れます。
Domain

必須。

ネットワーク名前空間内のドメインの完全な DNS パス。

このパラメータを構成するには、ドメインの完全修飾ドメイン名（FQDN）を SUBDOMAIN.ROOT_DOMAIN 形式で入力します。

たとえば、内部 Active Directory ドメインが example.local の場合、入力する FQDN は example.local です。内部 Active Directory ドメインが corp.example.com の場合、入力する FQDN は corp.example.com です。
Password

必須。

ユーザー アカウントのパスワード。
Custom Query Fields

省略可。

Active Directory 統合のカスタム フィールド（customField1, customField2 など）。
CA Certificate File - parsed into Base64 String

省略可。

CA 証明書を構成するときに取得した、base64 形式でエンコードされた CA 証明書ファイル文字列。このパラメータを構成するには、完全な BASE64_ENCODED_CERTIFICATE_STRING 値を入力します。
Use SSL

省略可。

選択すると、統合によって Active Directory サーバーに接続するときに SSL 証明書が検証されます。

この統合では、選択すると安全な LDAPS（ポート 636）が使用されます。選択されていない場合は、標準 LDAP（ポート 389）が使用されます。

デフォルトでは選択されていません。

Google SecOps で統合を構成する手順については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できるようになります。複数のインスタンスの構成とサポートの詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応すると手動による対策を実行するをご覧ください。

ユーザーをグループに追加する

グループにユーザーを追加アクションを使用して、ユーザーをグループに追加します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

[Add User to Group] アクションには、次のパラメータが必要です。

パラメータ 説明
Group Name

必須。

ユーザーを追加するグループのカンマ区切りのリスト。

アクションの出力

[ユーザーをグループに追加] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
出力メッセージ

[ユーザーをグループに追加] アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully added the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID

The following users were already a part of the group "GROUP_NAME" in Active Directory: ENTITY_ID

Action wasn't able to add the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID

No users were added to the group "GROUP_NAME" in Active Directory.

No users were added to the provided groups in Active Directory.

 アクションが成功しました。
Error executing action "Add User to Group". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、[Add User to Group] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

ホストの組織部門を変更する

ホストの OU を変更アクションを使用して、ホストの OU を変更します。

このアクションは Google SecOps Hostname エンティティに対して実行されます。

アクションへの入力

[Change Host OU] アクションには、次のパラメータが必要です。

パラメータ 説明
OU Name

必須。

新規ユーザー OU の名前。

アクションの出力

[Change Host OU] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[Change Host OU] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

ユーザーの組織部門を変更する

ユーザーの組織部門を変更アクションを使用して、ユーザーの組織部門を変更します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

[Change User OU] アクションには、次のパラメータが必要です。

パラメータ 説明
OU Name

必須。

新規ユーザー OU の名前。

アクションの出力

[Change User OU] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、Change User OU アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

アカウントを無効にする

ユーザー アカウントを無効にするには、[Disable Account] アクションを使用します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

なし

アクションの出力

[Disable Account] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[アカウントを無効にする] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

コンピュータを無効にする

コンピュータ アカウントを無効にするには、[Disable Computer] アクションを使用します。

このアクションは Google SecOps Hostname エンティティに対して実行されます。

アクションへの入力

なし

アクションの出力

[Disable Computer] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[Disable Computer] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

アカウントを有効にする

ユーザー アカウントを有効にするには、[Enable Account] アクションを使用します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

なし

アクションの出力

[Enable Account] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[Enable Account] アクションを使用する場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

パソコンを有効にする

[Enable Computer] アクションを使用して、コンピュータ アカウントを有効にします。

このアクションは Google SecOps Hostname エンティティに対して実行されます。

アクションへの入力

なし

アクションの出力

[Enable Computer] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[コンピュータを有効にする] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

エンティティの拡充

エンティティの拡充アクションを使用して、Hostname エンティティまたは Username エンティティを Active Directory プロパティで拡充します。

このアクションは非同期です。必要に応じて、Google SecOps IDE でアクションのスクリプト タイムアウト値を調整します。

[エンティティを拡充] アクションは、次の Google SecOps エンティティに対して実行されます。

  • User
  • Hostname

アクションへの入力

[エンティティを拡充] アクションには、次のパラメータが必要です。

パラメータ 説明
Mark entities as internal

必須。

選択すると、アクションは、エンリッチメントに成功したエンティティを内部エンティティとして自動的にマークします。
Specific Attribute Names To Enrich With

省略可。

エンティティを拡充する属性名のカンマ区切りのリスト。

値を設定しない場合、アクションは利用可能なすべての属性でエンティティを拡充します。属性に複数の値が含まれている場合、アクションは使用可能なすべての値で属性を拡充します。

このパラメータでは大文字と小文字が区別されます。
Should Case Wall table be filtered by the specified attributes?

省略可。

選択すると、Specific Attribute Names To Enrich With パラメータ値で指定した属性のみがケースウォール テーブルに入力されます。

デフォルトでは選択されていません。
Should JSON result be filtered by the specified attributes?

省略可。

選択すると、JSON 結果には Specific Attribute Names To Enrich With パラメータ値で指定した属性のみが返されます。

デフォルトでは選択されていません。
Connection Timeout

省略可。

ネットワーク接続のタイムアウトの制限（秒単位）。

デフォルト値は 10 です。
Receive Timeout

省略可。

ネットワーク受信のタイムアウト上限（秒単位）。

デフォルト値は 60 です。

アクションの出力

[エンティティを拡充] アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
エンティティ拡充テーブル 利用可能
JSON の結果 利用可能
スクリプトの結果 利用可能
エンティティ拡充

[エンティティを拡充] アクションは、次のエンティティ拡充をサポートしています。

拡充フィールド名 ロジック
AD_primaryGroupID JSON の結果に値が存在する場合、アクションはその値を返します。
AD_logonCount JSON の結果に値が存在する場合、アクションはその値を返します。
AD_cn JSON の結果に値が存在する場合、アクションはその値を返します。
AD_countryCode JSON の結果に値が存在する場合、アクションはその値を返します。
AD_objectClass JSON の結果に値が存在する場合、アクションはその値を返します。
AD_userPrincipalName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_adminCount JSON の結果に値が存在する場合、アクションはその値を返します。
AD_lastLogonTimestamp JSON の結果に値が存在する場合、アクションはその値を返します。
AD_manager JSON の結果に値が存在する場合、アクションはその値を返します。
AD_instanceType JSON の結果に値が存在する場合、アクションはその値を返します。
AD_distinguishedName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_dSCorePropagationData JSON の結果に値が存在する場合、アクションはその値を返します。
AD_msDS-SupportedEncryptionTypes JSON の結果に値が存在する場合、アクションはその値を返します。
AD_objectSid JSON の結果に値が存在する場合、アクションはその値を返します。
AD_whenCreated JSON の結果に値が存在する場合、アクションはその値を返します。
AD_uSNCreated JSON の結果に値が存在する場合、アクションはその値を返します。
AD_lockoutTime JSON の結果に値が存在する場合、アクションはその値を返します。
AD_badPasswordTime JSON の結果に値が存在する場合、アクションはその値を返します。
AD_pwdLastSet JSON の結果に値が存在する場合、アクションはその値を返します。
AD_sAMAccountName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_objectCategory JSON の結果に値が存在する場合、アクションはその値を返します。
AD_lastLogon JSON の結果に値が存在する場合、アクションはその値を返します。
AD_objectGUID JSON の結果に値が存在する場合、アクションはその値を返します。
AD_whenChanged JSON の結果に値が存在する場合、アクションはその値を返します。
AD_badPwdCount JSON の結果に値が存在する場合、アクションはその値を返します。
AD_accountExpires JSON の結果に値が存在する場合、アクションはその値を返します。
AD_displayName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_name JSON の結果に値が存在する場合、アクションはその値を返します。
AD_memberOf JSON の結果に値が存在する場合、アクションはその値を返します。
AD_codePage JSON の結果に値が存在する場合、アクションはその値を返します。
AD_userAccountControl JSON の結果に値が存在する場合、アクションはその値を返します。
AD_sAMAccountType JSON の結果に値が存在する場合、アクションはその値を返します。
AD_uSNChanged JSON の結果に値が存在する場合、アクションはその値を返します。
AD_sn JSON の結果に値が存在する場合、アクションはその値を返します。
AD_givenName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_lastLogoff JSON の結果に値が存在する場合、アクションはその値を返します。
JSON の結果

次の例は、エンティティの拡充アクションを使用した場合に受信される JSON 結果の出力です。

[
    {
        "EntityResult": {
            "primaryGroupID": [513],
            "logonCount": [6505],
            "cn": ["user name"],
            "countryCode": [0],
            "objectClass": ["top", "person", "organizationalPerson"],
            "userPrincipalName": ["user@example.com"],
            "adminCount": [1],
            "lastLogonTimestamp": ["2019-01-09 08:42:03.540783+00:00"],
            "manager": ["CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"],
            "instanceType": [4],
            "distinguishedName": ["CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "dSCorePropagationData": ["2019-01-14 14:39:16+00:00"],
            "msDS-SupportedEncryptionTypes": [0],
            "objectSid": ["ID"],
            "whenCreated": ["2011-11-07 08:00:44+00:00"],
            "uSNCreated": [7288202],
            "lockoutTime": ["1601-01-01 00:00:00+00:00"],
            "badPasswordTime": ["date"],
            "pwdLastSet": ["date"],
            "sAMAccountName": ["example"],
            "objectCategory": ["CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"],
            "lastLogon": ["2019-01-14 17:13:54.463070+00:00"],
            "objectGUID": ["GUID"],
            "whenChanged": ["2019-01-14 16:49:01+00:00"],
            "badPwdCount": [1],
            "accountExpires": ["9999-12-31 23:59:59.999999"],
            "displayName": ["example user"],
            "name": ["user"],
            "memberOf": ["CN=\\\\u05e7\\\\u05d1\\\\u05d5\\\\u05e6\\\\u05d4 \\\\u05d1\\\\u05e2\\\\u05d1\\\\u05e8\\\\u05d9\\\\u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL", "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL", "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "codePage": [0],
            "userAccountControl": [111],
            "sAMAccountType": [805306368],
            "uSNChanged": [15301168],
            "sn": ["example"],
            "givenName": ["user"],
            "lastLogoff": ["1601-01-01 00:00:00+00:00"
                          ]},
        "Entity": "user@example.com"
    }
]
スクリプトの結果

次の表に、[エンティティを拡充] アクションを使用する場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

パスワードの更新を強制する

[パスワードの更新を強制する] アクションを使用して、ユーザーに次回ログイン時にパスワードの変更を要求します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

なし

アクションの出力

[Force Password Update] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[パスワードの更新を強制する] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

グループ メンバーを取得する

グループ メンバーの取得アクションを使用して、指定した Active Directory グループのメンバーを取得します。

このアクションは、ユーザー メンバーとホスト名メンバーの両方の取得をサポートし、ネストされたグループ内の検索をサポートします。

アクションへの入力

[グループ メンバーを取得] アクションには、次のパラメータが必要です。

パラメータ 説明
Group Name

必須。

リストされたメンバーを含むグループの名前。
Members Type

必須。

グループのメンバー タイプ。

デフォルト値は User です。
Perform Nested Search

省略可。

選択すると、アクションはメイングループに属するグループに関する追加の詳細情報を取得します。

デフォルトでは選択されていません。
Limit

必須。

Active Directory から取得するリストの最大数。

デフォルト値は 100 です。

アクションの出力

[グループ メンバーを取得] アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、[グループ メンバーを取得] アクションを使用したときに受信した JSON 結果の出力を示しています。

[
  {
    "cn":"Example User1",
    "displayName":"Example User1",
    "distinguishedName":"CN=Example User1,OU=User Accounts,DC=example,DC=local"
  },
  {
    "cn":"Example User2",
    "displayName":"Example User2",
    "distinguishedName":"CN=Example User2,CN=Users,DC=example,DC=local"
  },
  {
    "cn":"Example User3",
    "displayName":"Example User3",
    "distinguishedName":"CN=Example User3,CN=Users,DC=example,DC=local"
  }
]
スクリプトの結果

次の表に、[グループ メンバーを取得] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

マネージャーの連絡先情報を取得する

Get Manager Contact Details アクションを使用して、Active Directory から管理者の連絡先情報を取得します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

なし

アクションの出力

[Get Manager Contact Details] アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
エンティティ拡充テーブル 利用可能
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
エンティティ拡充

[Get Manager Contact Details] アクションは、次のエンティティの拡充をサポートしています。

拡充フィールド名 ロジック
AD_Manager_Name JSON の結果に値が存在する場合、アクションはその値を返します。
AD_Manager_phone JSON の結果に値が存在する場合、アクションはその値を返します。
AD_primaryGroupID JSON の結果に値が存在する場合、アクションはその値を返します。
AD_logonCount JSON の結果に値が存在する場合、アクションはその値を返します。
AD_cn JSON の結果に値が存在する場合、アクションはその値を返します。
AD_countryCode JSON の結果に値が存在する場合、アクションはその値を返します。
AD_objectClass JSON の結果に値が存在する場合、アクションはその値を返します。
AD_userPrincipalName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_adminCount JSON の結果に値が存在する場合、アクションはその値を返します。
AD_lastLogonTimestamp JSON の結果に値が存在する場合、アクションはその値を返します。
AD_manager JSON の結果に値が存在する場合、アクションはその値を返します。
AD_instanceType JSON の結果に値が存在する場合、アクションはその値を返します。
AD_distinguishedName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_dSCorePropagationData JSON の結果に値が存在する場合、アクションはその値を返します。
AD_msDS-SupportedEncryptionTypes JSON の結果に値が存在する場合、アクションはその値を返します。
AD_objectSid JSON の結果に値が存在する場合、アクションはその値を返します。
AD_whenCreated JSON の結果に値が存在する場合、アクションはその値を返します。
AD_uSNCreated JSON の結果に値が存在する場合、アクションはその値を返します。
AD_lockoutTime JSON の結果に値が存在する場合、アクションはその値を返します。
AD_badPasswordTime JSON の結果に値が存在する場合、アクションはその値を返します。
AD_pwdLastSet JSON の結果に値が存在する場合、アクションはその値を返します。
AD_sAMAccountName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_objectCategory JSON の結果に値が存在する場合、アクションはその値を返します。
AD_lastLogon JSON の結果に値が存在する場合、アクションはその値を返します。
AD_objectGUID JSON の結果に値が存在する場合、アクションはその値を返します。
AD_whenChanged JSON の結果に値が存在する場合、アクションはその値を返します。
AD_badPwdCount JSON の結果に値が存在する場合、アクションはその値を返します。
AD_accountExpires JSON の結果に値が存在する場合、アクションはその値を返します。
AD_displayName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_name JSON の結果に値が存在する場合、アクションはその値を返します。
AD_memberOf JSON の結果に値が存在する場合、アクションはその値を返します。
AD_codePage JSON の結果に値が存在する場合、アクションはその値を返します。
AD_userAccountControl JSON の結果に値が存在する場合、アクションはその値を返します。
AD_sAMAccountType JSON の結果に値が存在する場合、アクションはその値を返します。
AD_uSNChanged JSON の結果に値が存在する場合、アクションはその値を返します。
AD_sn JSON の結果に値が存在する場合、アクションはその値を返します。
AD_givenName JSON の結果に値が存在する場合、アクションはその値を返します。
AD_lastLogoff JSON の結果に値が存在する場合、アクションはその値を返します。
JSON の結果

次の例は、[Get Manager Contact Details] アクションを使用したときに受信した JSON 結果の出力です。

[
   {
        "EntityResult":
        {
            "primaryGroupID": [513],
            "logonCount": [6505],
            "cn": ["user name"],
            "countryCode": [0],
            "objectClass": ["top", "person", "organizationalPerson"],
            "userPrincipalName": ["user@example.com"],
            "adminCount": [1],
            "lastLogonTimestamp": ["2019-01-09 08:42:03.540783+00:00"],
            "manager": ["CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"],
            "instanceType": [4],
            "distinguishedName": ["CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "dSCorePropagationData": ["2019-01-14 14:39:16+00:00"],
            "msDS-SupportedEncryptionTypes": [0],
            "objectSid": ["ID"],
            "whenCreated": ["2011-11-07 08:00:44+00:00"],
            "uSNCreated": [7288202],
            "lockoutTime": ["1601-01-01 00:00:00+00:00"],
            "badPasswordTime": ["date"],
            "pwdLastSet": ["date"],
            "sAMAccountName": ["example"],
            "objectCategory": ["CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"],
            "lastLogon": ["2019-01-14 17:13:54.463070+00:00"],
            "objectGUID": ["{id}"],
            "whenChanged": ["2019-01-14 16:49:01+00:00"],
            "badPwdCount": [1],
            "accountExpires": ["9999-12-31 23:59:59.999999"],
            "displayName": ["example"],
            "name": ["user"],
            "memberOf": ["CN= u05e7 u05d1 u05d5 u05e6 u05d4  u05d1 u05e2 u05d1 u05e8 u05d9 u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL", "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL", "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "codePage": [0],
            "userAccountControl": [111],
            "sAMAccountType": [805306368],
            "uSNChanged": [15301168],
            "sn": ["example"],
            "givenName": ["user"],
            "lastLogoff": ["1601-01-01 00:00:00+00:00"]
        },
        "Entity": "user@example.com"
    }
]
出力メッセージ

Ping アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

All entities were processed successfully.

Some entities were processed successfully and some weren't. Please check the action log for further information.

No entities were processed.

 アクションが成功しました。
Error executing action "Get Manager Contact Details". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、Get Manager Contact Details アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

ユーザーがグループに属しているか

ユーザーがグループに所属しているかアクションを使用して、ユーザーが特定のグループのメンバーであるかどうかを確認します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

[Is User in Group] アクションには、次のパラメータが必要です。

パラメータ 説明
Group Name

必須。

確認するグループ名（例: administrators）。

アクションの出力

[ユーザーがグループに属しているか] アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Is User in Group アクションを使用した場合に受信される JSON 結果の出力です。

[
    {
        "EntityResult": true,
        "Entity": "USER1@EXAMPLE.COM"
    }, {
        "EntityResult": false,
        "Entity": "USER2@EXAMPLE.COM"
    }, {
        "EntityResult": true,
        "Entity": "USER3@EXAMPLE.COM"
    }
]
スクリプトの結果

次の表に、[Is User in Group] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

ユーザー グループの一覧を取得する

ユーザー グループのリスト アクションを使用して、Active Directory で使用可能なすべてのユーザー グループのリストを取得します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

なし

アクションの出力

ユーザー グループを一覧表示アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、ユーザー グループのリスト アクションを使用した場合に受信する JSON 結果の出力を示しています。

[
    {
        "EntityResult": ["Domain Users"],
        "Entity": "user@example.com"
    }
]
スクリプトの結果

次の表に、List User Groups アクションを使用する場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

Ping

Ping アクションを使用して、Active Directory への接続をテストします。

このアクションは、すべての Google SecOps エンティティに対して実行されます。

アクションへの入力

なし

アクションの出力

[Ping] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、Ping アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

Release Locked Account（ロックされたアカウントのリリース）

Release Locked Account アクションを使用して、ロックされたアカウントのブロックを解除します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

なし

アクションの出力

[Release Locked Account] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[Release Locked Account] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

グループからユーザーを削除する

Remove User From Group アクションを使用して、ユーザーをグループから削除します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

[Remove User From Group] アクションには、次のパラメータが必要です。

パラメータ 説明
Group Name

必須。

ユーザーを削除するグループのカンマ区切りのリスト。

アクションの出力

[Remove User From Group] アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
出力メッセージ

[Remove User From Group] アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully removed the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID

The following users were not a part of the group "GROUP_NAME" in Active Directory: ENTITY_ID

Action wasn't able to remove the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID

No users were removed from the group "GROUP_NAME" in Active Directory.

No users were removed from the provided groups in Active Directory.

 アクションが成功しました。
Error executing action "Remove User From Group". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、[Remove User From Group] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

Active Directory を検索する

Active Directory の検索アクションを使用して、指定したクエリで Active Directory を検索します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

[Active Directory を検索] アクションには、次のパラメータが必要です。

パラメータ 説明
Query String

必須。

Active Directory で実行するクエリ文字列。
Limit

省略可。

Active Directory から取得するリストの最大数。

アクションの出力

[Active Directory を検索] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、[Search Active Directory] アクションを使用した場合に受信される JSON 結果の出力です。

[
      {
        "primaryGroupID": [
          513
        ],
        "logonCount": [
          6505
        ],
        "cn": [
          "user name"
        ],
        "countryCode": [
          0
        ],
        "objectClass": [
          "top",
          "person",
          "organizationalPerson"
        ],
        "userPrincipalName": [
          "user@example.com"
        ],
        "adminCount": [
          1
        ],
        "lastLogonTimestamp": [
          "2019-01-09 08:42:03.540783+00:00"
        ],
        "manager": [
          "CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"
        ],
        "instanceType": [
          4
        ],
        "distinguishedName": [
          "CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"
        ],
        "dSCorePropagationData": [
          "2019-01-14 14:39:16+00:00"
        ],
        "msDS-SupportedEncryptionTypes": [
          0
        ],
        "objectSid": [
          "ID"
        ],
        "whenCreated": [
          "2011-11-07 08:00:44+00:00"
        ],
        "uSNCreated": [
          7288202
        ],
        "lockoutTime": [
          "1601-01-01 00:00:00+00:00"
        ],
        "badPasswordTime": [
          "date"
        ],
        "pwdLastSet": [
          "date"
        ],
        "sAMAccountName": [
          "example"
        ],
        "objectCategory": [
          "CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"
        ],
        "lastLogon": [
          "2019-01-14 17:13:54.463070+00:00"
        ],
        "objectGUID": [
          "GUID"
        ],
        "whenChanged": [
          "2019-01-14 16:49:01+00:00"
        ],
        "badPwdCount": [
          1
        ],
        "accountExpires": [
          "9999-12-31 23:59:59.999999"
        ],
        "displayName": [
          "example"
        ],
        "name": [
          "user"
        ],
        "memberOf": [
          "CN=\\\\u05e7\\\\u05d1\\\\u05d5\\\\u05e6\\\\u05d4 \\\\u05d1\\\\u05e2\\\\u05d1\\\\u05e8\\\\u05d9\\\\u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL",
          "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL",
          "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"
        ],
        "codePage": [
          0
        ],
        "userAccountControl": [
          111
        ],
        "sAMAccountType": [
          805306368
        ],
        "uSNChanged": [
          15301168
        ],
        "sn": [
          "example"
        ],
        "givenName": [
          "user"
        ],
        "lastLogoff": [
          "1601-01-01 00:00:00+00:00"
        ]
      }
    ]
出力メッセージ

[Search Active Directory] アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully performed the query "QUERY_STRING" in Active Directory.

No results to show following the query: "QUERY_STRING".

 アクションが成功しました。
Error executing action "Search Active Directory". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、[Search Active Directory] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

ユーザー パスワードを設定する

ユーザー パスワードを構成するには、[ユーザー パスワードを設定] アクションを使用します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

[Set User Password] アクションには、次のパラメータが必要です。

パラメータ 説明
New Password

必須。

新しいパスワード値。

アクションの出力

[ユーザー パスワードを設定] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
スクリプトの結果 利用可能
スクリプトの結果

次の表に、[ユーザー パスワードを設定] アクションを使用する場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

AD ホストの属性を更新する

AD ホストの属性を更新するアクションを使用して、Active Directory の現在のホストの属性を更新します。

このアクションは Google SecOps Hostname エンティティに対して実行されます。

アクションへの入力

[AD ホストの属性を更新] アクションには、次のパラメータが必要です。

パラメータ 説明
Attribute Name

必須。

更新する属性の名前（Description など）。
Attribute Value

必須。

属性の新しい値。

アクションの出力

[AD ホストの属性を更新する] アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
出力メッセージ

[AD ホストの属性を更新] アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Active Directory - Following entities were updated successfully: ENTITY_ID_LIST.

No suitable entities were found.

 アクションが成功しました。
Failed to update the ATTRIBUTE_NAME for the following entities: ENTITY_ID_LIST.

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、AD ホストの属性を更新するアクションを使用する場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

AD ユーザーの属性を更新する

[Update attributes of an AD User] アクションを使用して、Active Directory の現在のユーザーの属性を更新します。

このアクションは Google SecOps User エンティティに対して実行されます。

アクションへの入力

[Update attributes of an AD User] アクションには、次のパラメータが必要です。

パラメータ 説明
Attribute Name

必須。

更新する属性の名前（Description など）。
Attribute Value

必須。

属性の新しい値。

アクションの出力

[Update attributes of an AD User] アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
出力メッセージ

[Update attributes of an AD User] アクションは、次の出力メッセージを返すことがあります。

出力メッセージ メッセージの説明

Active Directory - Following entities were updated successfully: ENTITY_ID_LIST.

No suitable entities were found.

 アクションが成功しました。
Failed to update the ATTRIBUTE_NAME for the following entities: ENTITY_ID_LIST.

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。
スクリプトの結果

次の表に、[Update attributes of an AD User] アクションを使用する場合のスクリプト結果出力の値を示します。

スクリプトの結果名 値
is_success True または False

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。