Mengintegrasikan Active Directory dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan Active Directory dengan Google Security Operations.

Kasus penggunaan

Integrasi Active Directory menggunakan kemampuan Google SecOps untuk mendukung kasus penggunaan berikut:

  • Mengaktifkan dan menonaktifkan pengguna: Nonaktifkan akun pengguna yang berpotensi disusupi dan cegah akses tidak sah lebih lanjut.

  • Mereset sandi: Mereset sandi pengguna secara otomatis di Active Directory dan memberi tahu pengguna tentang perubahan tersebut.

  • Mengelola grup: Tambahkan pengguna baru ke grup keamanan yang sesuai berdasarkan peran mereka dan pastikan pengguna memiliki izin akses yang benar.

  • Mengambil informasi pengguna: Mengambil detail pengguna seperti keanggotaan grup, waktu login terakhir, dan informasi kontak tentang akun pengguna tertentu.

  • Otomatiskan proses penghentian: Nonaktifkan akun, hapus akun dari grup, dan transfer kepemilikan file saat karyawan berhenti.

Sebelum memulai

Sebelum mengonfigurasi integrasi Active Directory di Google SecOps, pastikan lingkungan jaringan, Active Directory Domain Services (AD DS), dan kredensial akun layanan Anda memenuhi semua prasyarat operasional.

Untuk menyiapkan lingkungan Anda untuk integrasi, penuhi prasyarat berikut:

  1. Verifikasi konektivitas jaringan dan resolusi DNS antara instance Google SecOps (atau Agen Jarak Jauh) dan Pengontrol Domain Active Directory Anda.

  2. Opsional: Jika terhubung melalui LDAPS (port 636, diperlukan untuk reset sandi) menggunakan Certificate Authority internal, konfigurasikan Sertifikat CA dengan mengenkode sertifikat root atau intermediate certificate Anda menjadi string base64.

  3. Buat akun layanan Active Directory khusus yang mematuhi Prinsip Hak Istimewa Terendah.

  4. Tinjau izin tindakan yang diperlukan untuk menentukan atribut dan hak akses yang diperlukan untuk tindakan tertentu yang ingin Anda jalankan.

  5. Delegasikan izin di Unit Organisasi target untuk tindakan yang ingin Anda gunakan (menggunakan Active Directory Users and Computers atau PowerShell dan dsacls), memastikan akun layanan memiliki akses Baca dan Tulis eksplisit ke atribut userAccountControl.

Persyaratan jaringan dan DNS

Google SecOps berkomunikasi langsung dengan Pengontrol Domain Active Directory menggunakan Lightweight Directory Access Protocol (LDAP atau LDAPS) melalui TCP.

Pastikan lingkungan jaringan Anda memenuhi aturan konektivitas berikut:

  • Konektivitas port: Pastikan firewall dan perutean jaringan Anda mengizinkan komunikasi keluar dari Google SecOps (atau Agen Jarak Jauh Anda) ke Pengontrol Domain Active Directory Anda di port berikut:

    • LDAP (standar): Buka port 389/TCP untuk komunikasi LDAP yang tidak dienkripsi.
    • LDAPS (direkomendasikan - wajib untuk sandi): Buka port 636/TCP (atau port SSL/TLS kustom Anda). LDAPS diperlukan untuk traffic direktori terenkripsi dan wajib untuk tindakan modifikasi sandi.

  • Resolusi DNS dan nama host: Active Directory memerlukan resolusi nama host yang akurat untuk mencocokkan sertifikat SSL/TLS dan pengikatan layanan direktori. Jika domain Anda di-resolve oleh nama DNS yang sepenuhnya memenuhi syarat melalui penyiapan DNS internal, konfigurasi host tambahan tidak diperlukan. Jika resolusi DNS tidak tersedia di image container agen jarak jauh, konfigurasikan file /etc/hosts.

Mengonfigurasi file /etc/hosts

Konfigurasi ini bersifat opsional. Jika pengontrol domain Anda sudah di-resolve melalui penyiapan DNS internal, lewati bagian ini. Jika agen jarak jauh Anda tidak dapat menyelesaikan pengontrol domain Active Directory menggunakan DNS, petakan host secara manual dalam file /etc/hosts agar cocok dengan sertifikat SSL/TLS dan binding layanan direktori.

Untuk mengonfigurasi file /etc/hosts, selesaikan langkah-langkah berikut:

  1. Buka /etc/hosts di editor teks dengan hak istimewa administratif:

    sudo vi /etc/hosts

  2. Tambahkan entri yang memetakan alamat IP pengontrol domain ke nama domain yang sepenuhnya memenuhi syarat (FQDN):

    192.0.2.195 dc01.example.local

  3. Simpan dan tutup file tersebut.

Jika Anda tidak memerlukan sertifikat CA untuk integrasi, lanjutkan ke konfigurasi persyaratan autentikasi dan akun layanan. Jika tidak, konfigurasikan sertifikat CA Anda.

Mengonfigurasi sertifikat CA

Langkah ini opsional. Jika Anda terhubung menggunakan LDAP standar (port 389) atau menggunakan sertifikat tepercaya publik, lewati bagian ini dan lanjutkan ke Persyaratan autentikasi dan akun layanan. Jika Anda terhubung melalui LDAPS (port 636, diperlukan untuk reset sandi) menggunakan sertifikat yang dikeluarkan oleh CA pribadi atau internal, berikan string sertifikat berenkode base64 selama penyiapan untuk membuat koneksi TLS tepercaya.

Untuk mengonfigurasi dan mengupload sertifikat CA, selesaikan langkah-langkah berikut:

  1. Enkode file sertifikat berformat PEM Anda:

    • Linux: bash base64 -w 0 mycert.crt

    • macOS: bash base64 -i mycert.crt

  2. Salin string output lengkap (termasuk header yang dienkode) dan tempelkan ke kolom CA Certificate File - parsed into Base64 String di konfigurasi integrasi Google SecOps.

  3. Tetapkan parameter Server ke FQDN pengontrol domain (bukan alamat IP-nya) agar nama host cocok dengan Nama Umum (CN) atau Nama Alternatif Subjek (SAN) pada sertifikat.

  4. Klik Test untuk memvalidasi TLS handshake.

Persyaratan autentikasi dan akun layanan

Integrasi Active Directory melakukan autentikasi menggunakan kredensial AD DS standar.

Pastikan penyiapan autentikasi Anda mematuhi praktik keamanan berikut:

  • Akun layanan khusus: Buat akun layanan khusus (seperti svc_secops_ad) khusus untuk playbook otomatis Google SecOps. Hindari penggunaan akun pengguna interaktif atau akun administrator domain bawaan.

  • Format nama pengguna: Nama pengguna dapat diberikan sebagai Nama Utama Pengguna (UPN) (seperti svc_secops@example.local) atau sebagai Nama Login Down-Level (EXAMPLE\svc_secops).

  • PoLP: Jangan tambahkan akun layanan ke grup bawaan dengan hak istimewa seperti Domain Admins, Enterprise Admins, atau Account Operators. Sebagai gantinya, berikan izin terperinci pada OU tertentu tempat objek pengguna, komputer, atau grup berada.

Mengonfigurasi izin tindakan (hak istimewa terendah)

Berikan akun layanan autentikasi hanya izin Active Directory dan akses atribut LDAP yang diperlukan untuk tindakan tertentu yang ingin Anda jalankan.

Lihat izin minimal untuk tindakan Active Directory dalam tabel berikut:

Nama Tindakan Izin AD DS/Hak yang Diperluas yang Diperlukan Class Objek Target Deskripsi/Cakupan Atribut
Ping Read Property Pengguna, Root Domain Membuat kueri objek akun layanan yang dikonfigurasi (sAMAccountName, userPrincipalName, mail) untuk memvalidasi konektivitas dan kredensial direktori.
Memperkaya Entity
  • List Contents
  • Read Property (atribut target: userAccountControl, sAMAccountName, mail, memberOf, lockoutTime, pwdLastSet)
 Pengguna, Komputer, Grup Membuat kueri atribut pengguna dan komputer serta menyelesaikan keanggotaan grup bertingkat. Memerlukan Read Property di userAccountControl untuk mencegah error subskrip null.
Menonaktifkan Akun
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 Pengguna Membaca dan menetapkan flag ACCOUNTDISABLE (0x0002) pada objek pengguna target.
Aktifkan Akun
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 Pengguna Membaca dan menghapus tanda ACCOUNTDISABLE (0x0002) pada objek pengguna target.
Menonaktifkan Komputer
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 Komputer Membaca dan menetapkan flag ACCOUNTDISABLE pada objek komputer target.
Mengaktifkan Komputer
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 Komputer Membaca dan menghapus flag ACCOUNTDISABLE pada objek komputer target.
Melepaskan Akun yang Terkunci
  • Read Property: lockoutTime
  • Write Property: lockoutTime
 Pengguna Membaca dan menetapkan atribut lockoutTime ke 0 untuk membuka kunci akun pengguna yang terkunci.
Memaksa Pembaruan Sandi
  • Read Property: pwdLastSet
  • Write Property: pwdLastSet
 Pengguna Membaca dan menetapkan atribut pwdLastSet ke 0 untuk mewajibkan pengguna mengubah sandi mereka saat login berikutnya.
Menetapkan Sandi Pengguna
  • Hak yang Diperluas: Reset Password (User-Force-Change-Password)
  • (Opsional) Write Property: unicodePwd
 Pengguna Mereset sandi pengguna target. Memerlukan LDAPS (port 636) atau StartTLS.
Menambahkan Pengguna ke Grup
  • Read Property: member
  • Write Property: member
 Grup Menambahkan Nama Khusus (distinguishedName) pengguna target ke atribut member grup.
Menghapus Pengguna dari Grup
  • Read Property: member
  • Write Property: member
 Grup Menghapus Nama yang Dibedakan (distinguishedName) pengguna target dari atribut member grup.
Mengubah OU Pengguna
  • Delete Child Object (Pengguna) di OU sumber
  • Create Child Object (Pengguna) di OU tujuan
  • Write Property: name, distinguishedName
 Unit Organisasi, Pengguna Memindahkan objek pengguna antar-OU menggunakan modify_dn LDAP.
Mengubah OU Host
  • Delete Child Object (Komputer) di OU sumber
  • Create Child Object (Komputer) di OU tujuan
  • Write Property: name, distinguishedName
 Unit Organisasi, Komputer Memindahkan objek komputer antar-OU menggunakan LDAP modify_dn.
Memperbarui atribut Pengguna AD Write Property pada atribut target (seperti mail, title, department, telephoneNumber, description, atau manager) Pengguna Mengubah nilai atribut yang ditentukan pada objek pengguna target.
Memperbarui atribut Host AD Write Property pada atribut target (seperti description atau location) Komputer Mengubah nilai atribut yang ditentukan pada objek komputer target.
Mendapatkan Anggota Grup
  • List Contents
  • Read Property: member, sAMAccountName, distinguishedName
 Grup, Pengguna, Komputer Membuat kueri keanggotaan grup dan atribut akun anggota.
Mendapatkan Detail Kontak Pengelola
  • Read Property: manager
  • Read Property: cn, telephoneNumber, mail, displayName, title
 Pengguna Membaca atribut manager dari objek pengguna target dan mengambil detail kontak pengelola.
Is User In Group
  • Read Property: memberOf, sAMAccountName
 Pengguna, Grup Mengevaluasi apakah akun pengguna termasuk dalam grup keamanan atau distribusi yang ditentukan.
Mencantumkan Grup Pengguna
  • Read Property: memberOf, sAMAccountName
 Pengguna, Grup Menampilkan daftar semua grup yang ditetapkan ke akun pengguna yang ditentukan.
Menelusuri Active Directory
  • List Contents
  • Read Property pada atribut yang dikueri
 Pengguna, Komputer, Grup, Unit Organisasi Menjalankan kueri filter LDAP kustom terhadap subhierarki direktori.

Mendelegasikan izin di Active Directory

Untuk menerapkan PoLP tanpa memberikan hak administratif yang luas, delegasikan izin pada OU target menggunakan konsol ADUC grafis atau alat command line PowerShell dan dsacls. Anda hanya perlu menggunakan salah satu metode ini, dan Anda hanya perlu mendelegasikan izin yang diperlukan untuk tindakan tertentu yang ingin Anda jalankan.

Mendelegasikan kontrol menggunakan ADUC

Jika Anda lebih suka menggunakan antarmuka grafis, gunakan Delegation of Control Wizard di ADUC untuk mendelegasikan izin khusus objek dan properti.

Jalankan wizard di OU target untuk memberikan izin objek dan properti yang diperlukan untuk tindakan yang ingin Anda gunakan (seperti membaca dan menulis flag kontrol akun, mereset sandi, atau membuka kunci akun).

Untuk panduan langkah demi langkah dalam menjalankan wizard, lihat dokumentasi Microsoft tentang Delegation of Control in AD DS.

Mendelegasikan kontrol menggunakan PowerShell dan dsacls

Jika Anda lebih menyukai pendekatan command line atau ingin mengotomatiskan penetapan izin, gunakan PowerShell dengan utilitas dsacls.exe bawaan, bukan ADUC.

Jalankan hanya contoh perintah yang berlaku untuk tindakan yang ingin Anda gunakan di workstation administratif atau Pengontrol Domain, dengan mengganti OU target dan nama akun layanan Anda:

  • Berikan izin Baca dan Tulis di userAccountControl untuk objek pengguna (untuk mengaktifkan atau menonaktifkan akun pengguna dan mencegah error pengayaan): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;user"
  • Berikan izin Baca dan Tulis di userAccountControl untuk objek komputer (untuk mengaktifkan atau menonaktifkan komputer): powershell dsacls.exe "OU=Computers,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;computer"
  • Berikan izin buka kunci akun (lockoutTime): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;lockoutTime;user"
  • Berikan izin paksa perubahan sandi (pwdLastSet): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;pwdLastSet;user"
  • Berikan hak reset sandi (hak yang diperluas Reset Password): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:CA;Reset Password;user"
  • Memberikan hak modifikasi keanggotaan pada grup keamanan: powershell dsacls.exe "CN=SecOps-Quarantine,OU=Groups,DC=example,DC=local" /G "EXAMPLE\svc_secops_ad:RPWP;member;group"

Untuk mengetahui detail selengkapnya tentang sintaksis dan tombol parameter, lihat dokumentasi Microsoft tentang dsacls.

Parameter integrasi

Integrasi Active Directory memerlukan parameter berikut:

Parameter Deskripsi
Server

Wajib.

Nama host, nama DNS, atau alamat IP server Active Directory. Integrasi ini berkomunikasi menggunakan protokol LDAP.

Untuk menggunakan port kustom, tambahkan ke alamat (seperti mydomain.com:636).

Secara default, integrasi menggunakan port 636 saat SSL/TLS diaktifkan dan port 389 saat dinonaktifkan.
Username

Wajib.

Nama pengguna atau alamat email pengguna untuk terhubung ke Active Directory, seperti DOMAIN\username atau user@example.com.

Parameter ini juga menerima atribut userPrincipalName.
Password

Wajib.

Sandi untuk akun pengguna.
Domain

Wajib.

Jalur DNS lengkap ke domain Anda dalam namespace jaringan.

Berikan nama domain yang sepenuhnya memenuhi syarat (FQDN) domain Anda dalam format berikut: SUBDOMAIN.ROOT_DOMAIN.

Misalnya, jika domain Active Directory internal Anda adalah example.local, FQDN yang harus dimasukkan adalah example.local. Jika domain Active Directory internal Anda adalah corp.example.com, FQDN yang harus dimasukkan adalah corp.example.com.
Custom Query Fields

Opsional.

Daftar kolom Active Directory kustom yang dipisahkan koma untuk disertakan dalam kueri, seperti customField1, customField2.
CA Certificate File - parsed into Base64 String

Opsional.

String file sertifikat CA yang dienkode ke dalam format base64 yang diperoleh saat mengonfigurasi sertifikat CA. Berikan nilai lengkap.
Use SSL

Opsional.

Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server Active Directory dan menggunakan LDAPS yang aman (port 636).

Jika tidak dipilih, LDAP standar (port 389) akan digunakan.
Debug Logging

Opsional.

Jika dipilih, integrasi akan mencatat informasi proses debug mendetail untuk operasi Active Directory.

Untuk mendapatkan petunjuk tentang cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Anda dapat melakukan perubahan pada tahap selanjutnya, jika diperlukan. Setelah mengonfigurasi instance integrasi, Anda dapat menggunakannya dalam playbook. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi dan mendukung beberapa instance, lihat Mendukung beberapa instance.

Tindakan

Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan yang tertunda dari meja kerja Anda dan Menjalankan tindakan manual dalam kasus Anda.

Menambahkan Pengguna ke Grup

Gunakan tindakan Add User To Group untuk menambahkan pengguna dari kasus ke satu atau beberapa grup Active Directory, seperti menambahkan akun ke grup akses terbatas selama investigasi. Tindakan ini otomatis mengidentifikasi pengguna target dari kasus dan menambahkannya ke grup yang ditentukan.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Add User To Group memerlukan parameter berikut:

Parameter Deskripsi
Group Name

Wajib.

Daftar grup yang dipisahkan koma untuk menambahkan pengguna.

Output tindakan

Tindakan Add User To Group memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Add User To Group dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

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

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

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin untuk mengubah atribut member pada grup target.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan ID entitas cocok dengan nama pengguna atau alamat email yang valid.
The following groups were not found in Active Directory: GROUP_NAME

Tindakan gagal untuk grup yang ditentukan.

Periksa ejaan nama grup dalam parameter Group Name dan konfirmasi bahwa grup tersebut ada di domain yang dikonfigurasi.
No users were added to the group "GROUP_NAME" in Active Directory.

Tindakan gagal untuk grup yang ditentukan.

Pastikan pengguna target ada di Active Directory dan akun layanan memiliki akses tulis ke grup yang ditentukan.
No users were added to the provided groups in Active Directory.

Tindakan gagal.

Pastikan kasus berisi entitas User yang valid dan grup yang ditentukan ada di Active Directory.
Error executing action "Add User To Group". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter input, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Add User To Group:

Nama hasil skrip Nilai
is_success true atau false

Mengubah OU Host

Gunakan tindakan Change Host OU untuk memindahkan komputer dalam kasus ke Unit Organisasi yang berbeda di Active Directory, seperti memindahkan mesin yang disusupi ke OU karantina dengan kebijakan terbatas. Tindakan ini secara otomatis mengidentifikasi komputer target dari kasus dan memindahkannya ke OU tujuan yang ditentukan.

Tindakan ini berjalan di entity Hostname Google SecOps.

Input tindakan

Tindakan Ubah OU Host memerlukan parameter berikut:

Parameter Deskripsi
OU Name

Wajib.

Nama OU host baru.

Output tindakan

Tindakan Ubah OU Host memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Ubah OU Host dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Changed OU for the following hosts: ENTITY_ID Tindakan berhasil.
Failed to change OU for the following hosts : ENTITY_ID

Tindakan gagal untuk host yang ditentukan.

Pastikan OU tujuan ada dan akun layanan memiliki izin untuk memindahkan objek komputer antara OU sumber dan tujuan.
The following hosts were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk host yang ditentukan.

Pastikan akun komputer ada di Active Directory dan cocok dengan entitas Hostname dalam kasus ini.
The action didn't change OU on any hosts.

Tindakan gagal.

Pastikan komputer target dan OU tujuan ada di Active Directory dan akun layanan memiliki izin untuk memindahkan akun komputer.
Error executing action "Change Host OU". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter OU Name, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Ubah OU Host:

Nama hasil skrip Nilai
is_success true atau false

Mengubah OU Pengguna

Gunakan tindakan Change User OU untuk memindahkan pengguna dalam kasus ke Unit Organisasi yang berbeda di Active Directory, seperti memindahkan akun ke OU yang dibatasi selama insiden atau alur kerja penghentian akses. Tindakan ini secara otomatis mengidentifikasi pengguna target dari kasus dan memindahkannya ke OU tujuan yang ditentukan.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Ubah OU Pengguna memerlukan parameter berikut:

Parameter Deskripsi
OU Name

Wajib.

Nama OU pengguna baru.

Output tindakan

Tindakan Ubah OU Pengguna memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Ubah OU Pengguna dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Changed OU for the following users: ENTITY_ID Tindakan berhasil.
Failed to change OU for the following users : ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan OU tujuan ada dan akun layanan memiliki izin untuk memindahkan objek pengguna antara OU sumber dan tujuan.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
The action didn't change OU on any users.

Tindakan gagal.

Pastikan pengguna target dan OU tujuan ada di Active Directory dan akun layanan memiliki izin untuk memindahkan akun pengguna.
Error executing action "Change User OU". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter OU Name, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Change User OU:

Nama hasil skrip Nilai
is_success true atau false

Nonaktifkan Akun

Gunakan tindakan Nonaktifkan Akun untuk menonaktifkan akun pengguna di Active Directory. Tindakan ini otomatis menargetkan pengguna yang terkait dengan kasus.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Nonaktifkan Akun memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Nonaktifkan Akun dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Disabled account for the following users: ENTITY_ID Tindakan berhasil.
Failed to disable account for the following users: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin baca dan izin tulis untuk atribut userAccountControl di akun pengguna target dan pengguna tersebut bukan akun administratif yang dilindungi.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
No users were disabled in Active Directory.

Tindakan gagal.

Pastikan kasus berisi entitas User yang valid dan akun layanan memiliki izin untuk menonaktifkan akun target.
Error executing action "Disable Account". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Nonaktifkan Akun:

Nama hasil skrip Nilai
is_success true atau false

Nonaktifkan Komputer

Gunakan tindakan Disable Computer untuk menonaktifkan akun komputer di Active Directory guna mencegah mesin yang disusupi atau tidak sah melakukan autentikasi ke domain. Tindakan ini otomatis menargetkan nama host yang dilampirkan ke kasus.

Tindakan ini berjalan di entity Hostname Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Disable Computer memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Disable Computer dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully disabled the following computers in Active Directory: ENTITY_ID

The following computers were already disabled in Active Directory: ENTITY_ID

 Tindakan berhasil.
Action wasn't able to disable the following computers in Active Directory: ENTITY_ID

Tindakan gagal untuk komputer yang ditentukan.

Pastikan akun layanan memiliki izin baca dan izin tulis untuk atribut userAccountControl pada objek komputer target.
The following computers were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk komputer yang ditentukan.

Pastikan akun komputer ada di Active Directory dan cocok dengan entitas Hostname dalam kasus ini.
No computers were disabled in Active Directory.

Tindakan gagal.

Pastikan kasus berisi entity Hostname yang valid dan akun layanan memiliki izin untuk menonaktifkan akun komputer target.
Error executing action "Disable Computer". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Nonaktifkan Komputer:

Nama hasil skrip Nilai
is_success true atau false

Aktifkan Akun

Gunakan tindakan Enable Account untuk mengaktifkan kembali akun pengguna yang dinonaktifkan di Active Directory. Tindakan ini otomatis menargetkan pengguna yang terkait dengan kasus.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Enable Account memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Enable Account dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully enabled the following users in Active Directory: ENTITY_ID

The following users were already enabled in Active Directory: ENTITY_ID

 Tindakan berhasil.
Action wasn't able to enable the following users in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin baca dan tulis untuk atribut userAccountControl di akun pengguna target.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
No users were enabled in Active Directory.

Tindakan gagal.

Pastikan kasus berisi entitas User yang valid dan akun layanan memiliki izin untuk mengaktifkan akun target.
Error executing action "Enable Account". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Enable Account:

Nama hasil skrip Nilai
is_success true atau false

Aktifkan Komputer

Gunakan tindakan Enable Computer untuk mengaktifkan kembali akun komputer yang dinonaktifkan di Active Directory agar mesin dapat melakukan autentikasi ke domain lagi. Tindakan ini otomatis menargetkan nama host yang terkait dengan kasus.

Tindakan ini berjalan di entity Hostname Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Enable Computer memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Enable Computer dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully enabled the following computers in Active Directory: ENTITY_ID

The following computers were already enabled in Active Directory: ENTITY_ID

 Tindakan berhasil.
Action wasn't able to enable the following computers in Active Directory: ENTITY_ID

Tindakan gagal untuk komputer yang ditentukan.

Pastikan akun layanan memiliki izin baca dan izin tulis untuk atribut userAccountControl pada objek komputer target.
The following computers were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk komputer yang ditentukan.

Pastikan akun komputer ada di Active Directory dan cocok dengan entitas Hostname dalam kasus ini.
No computers were enabled in Active Directory.

Tindakan gagal.

Pastikan kasus berisi entity Hostname yang valid dan akun layanan memiliki izin untuk mengaktifkan akun komputer target.
Error executing action "Enable Computer". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Enable Computer:

Nama hasil skrip Nilai
is_success true atau false

Memperkaya Entity

Gunakan tindakan Enrich Entities untuk mengambil detail profil Active Directory, status akun, dan keanggotaan grup untuk pengguna dan komputer dalam kasus. Anda dapat memperkaya entitas dengan semua informasi direktori yang tersedia atau membatasi hasil dan tabel dinding kasus ke atribut tertentu.

Tindakan ini bersifat asinkron. Sesuaikan nilai waktu tunggu skrip di IDE Google SecOps untuk tindakan tersebut, jika diperlukan.

Tindakan Enrich Entities berjalan di entity Google SecOps berikut:

  • User
  • Hostname

Input tindakan

Tindakan Enrich Entities memerlukan parameter berikut:

Parameter Deskripsi
Mark Entities as Internal

Opsional.

Jika dipilih, tindakan ini akan otomatis menandai entitas yang berhasil diperkaya sebagai entitas internal.

Diaktifkan secara default.
Create Case Wall Table

Opsional.

Jika dipilih, tindakan ini akan menghasilkan tabel dinding kasus yang berisi atribut Active Directory yang diambil untuk setiap entity yang diperkaya.

Diaktifkan secara default.
Specific Attribute Names To Enrich With

Opsional.

Daftar nama atribut yang dipisahkan koma untuk memperkaya entity.

Jika Anda tidak memberikan nilai apa pun, tindakan ini akan memperkaya entity dengan semua atribut yang tersedia. Jika atribut berisi beberapa nilai, tindakan akan memperkaya atribut dengan semua nilai yang tersedia.

Parameter ini peka huruf besar/kecil.
Should Case Wall Table be filtered by the specified Attributes?

Opsional.

Jika dipilih, tindakan ini akan mengisi tabel repositori kasus hanya dengan atribut yang ditentukan di Specific Attribute Names To Enrich With.
Should JSON result be filtered by the specified Attributes?

Opsional.

Jika dipilih, hasil JSON hanya menampilkan atribut yang ditentukan dalam Specific Attribute Names To Enrich With.

Output tindakan

Tindakan Enrich Entities memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tersedia
Tabel pengayaan entitas Tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Tabel repositori kasus

Tindakan Enrich Entities menyediakan tabel berikut di Case Wall saat Create Case Wall Table dipilih:

  • Nama tabel: Report for: <var class="readonly">ENTITY_ID</var>
  • Kolom: Nama dan nilai atribut Active Directory yang diambil untuk entity (atau difilter oleh parameter Specific Attribute Names To Enrich With jika Should Case Wall Table be filtered by the specified Attributes? dipilih).
Pengayaan entity

Tindakan Enrich Entities mendukung pengayaan entity berikut:

Nama kolom pengayaan Logika
AD_primaryGroupID Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_logonCount Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_cn Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_countryCode Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_objectClass Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_userPrincipalName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_adminCount Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_lastLogonTimestamp Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_manager Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_instanceType Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_distinguishedName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_dSCorePropagationData Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_msDS-SupportedEncryptionTypes Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_objectSid Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_whenCreated Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_uSNCreated Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_lockoutTime Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_badPasswordTime Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_pwdLastSet Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_sAMAccountName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_objectCategory Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_lastLogon Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_objectGUID Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_whenChanged Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_badPwdCount Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_accountExpires Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_displayName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_name Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_memberOf Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_codePage Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_userAccountControl Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_sAMAccountType Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_uSNChanged Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_sn Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_givenName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_lastLogoff Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Enrich Entities:

[
    {
        "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"
    }
]
Pesan output

Tindakan Enrich Entities dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Active Directory Permalink: SERVER

Enriched the following Users ENTITY_ID

Enriched the following Hosts ENTITY_ID

All entities were enriched.

 Tindakan berhasil.
The following entities were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk entity yang ditentukan.

Pastikan akun pengguna atau host ada di Active Directory dan cocok dengan ID entitas dalam kasus ini.
Failed to enrich the following Users ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin untuk membaca atribut (termasuk userAccountControl) di akun pengguna target dan periksa apakah ada atribut kustom di Active Directory.
Failed to enrich the following Hosts ENTITY_ID

Tindakan gagal untuk host yang ditentukan.

Pastikan akun layanan memiliki izin untuk membaca atribut (termasuk userAccountControl) di akun komputer target dan periksa apakah ada atribut kustom di Active Directory.
No entities were enriched.

Tindakan gagal.

Pastikan kasus berisi entitas User atau Hostname yang valid yang ada di Active Directory.
Error executing action "Enrich Entities". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, kolom kueri kustom, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Enrich Entities:

Nama hasil skrip Nilai
is_success true atau false

Paksa Update Sandi

Gunakan tindakan Paksa Pembaruan Sandi untuk mewajibkan pengguna mengubah sandi mereka saat login berikutnya. Tindakan ini otomatis menargetkan pengguna yang terkait dengan kasus tersebut.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Force Password Update memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Paksa Update Sandi dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Forced password update on next logon for the following users: ENTITY_ID Tindakan berhasil.
Failed to force password update on next logon for the following users: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin baca dan izin tulis untuk atribut pwdLastSet di akun pengguna target.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
Password update wasn't forced on any users.

Tindakan gagal.

Pastikan kasus berisi entity User yang valid dan akun layanan memiliki izin untuk memperbarui setelan masa berlaku sandi.
Error executing action "Force Password Update". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Force Password Update:

Nama hasil skrip Nilai
is_success true atau false

Mendapatkan Anggota Grup

Gunakan tindakan Get Group Members untuk mencantumkan pengguna, komputer, atau keduanya yang termasuk dalam grup Active Directory tertentu. Anda dapat mempersempit penelusuran ke Unit Organisasi atau grup induk tertentu dan menyertakan anggota dari subgrup bertingkat.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Dapatkan Anggota Grup memerlukan parameter berikut:

Parameter Deskripsi
Group Name

Wajib.

Nama grup yang berisi anggota yang tercantum.
Members Type

Wajib.

Jenis anggota yang akan diambil dari grup.

Kemungkinan nilainya adalah sebagai berikut:

  • Only Users
  • Only Hosts
  • Both

Nilai defaultnya adalah Only Users.
Where To Search

Wajib.

Organizational Unit atau Group tertentu untuk membatasi cakupan penelusuran.

Kemungkinan nilainya adalah sebagai berikut:

  • Select Option
  • Organizational Unit
  • Group

Nilai defaultnya adalah Select Option.
Filter Object Value

Opsional.

Nama Organizational Unit atau Group tempat tindakan menelusuri grup target. Parameter ini wajib diisi jika Where To Search ditetapkan ke Organizational Unit atau Group.
Perform Nested Search

Opsional.

Jika dipilih, tindakan ini akan mengambil anggota dari subgrup bertingkat yang termasuk dalam grup target.
Limit

Opsional.

Jumlah maksimum listingan yang akan diambil dari Active Directory.

Nilai defaultnya adalah 100.

Output tindakan

Tindakan Dapatkan Anggota Grup memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Tabel repositori kasus

Tindakan Get Group Members menyediakan tabel berikut di Case Wall:

  • Nama tabel: Members of Active Directory group: <var class="readonly">GROUP_NAME</var>
  • Kolom:
    • Distinguished Name
    • SAM Account Name
    • User Principal Name
    • Type
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Dapatkan Anggota Grup:

[
  {
    "dn": "CN=Example User1,OU=User Accounts,DC=example,DC=local",
    "sAMAccountName": "ExampleUser1",
    "userPrincipalName": "user1@example.local",
    "type": "CN=Person,CN=Schema,CN=Configuration,DC=example,DC=local"
  },
  {
    "dn": "CN=Example User2,CN=Users,DC=example,DC=local",
    "sAMAccountName": "ExampleUser2",
    "userPrincipalName": "user2@example.local",
    "type": "CN=Person,CN=Schema,CN=Configuration,DC=example,DC=local"
  }
]
Pesan output

Tindakan Get Group Members dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully retrieved members of the group "GROUP_NAME" from Active Directory.

Group "GROUP_NAME" doesn't contain any members matching search criteria in Active Directory.

 Tindakan berhasil.
Error executing action "Get Group Members". Reason: Filter Object Value should be provided

Tindakan gagal.

Berikan nama grup atau OU yang valid dalam parameter Filter Object Value saat Where To Search ditetapkan ke Organizational Unit atau Group.
Error executing action "Get Group Members". Reason: Given value for Limit should be a positive number.

Tindakan gagal.

Masukkan bilangan bulat yang lebih besar dari 0 dalam parameter Limit.
Error executing action "Get Group Members". Reason: Given group doesn't exist in Active Directory.

Tindakan gagal.

Periksa nama grup di parameter Group Name dan pastikan grup tersebut ada dalam cakupan penelusuran yang dikonfigurasi.
Error executing action "Get Group Members". Reason: Specified Organizational Unit doesn't exist in Active Directory.

Tindakan gagal.

Pastikan Unit Organisasi yang ditentukan di Filter Object Value ada di Active Directory.
Error executing action "Get Group Members". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.

Tindakan gagal.

Pastikan grup induk yang ditentukan di Filter Object Value ada di Active Directory.
Error executing action "Get Group Members". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter input, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Dapatkan Anggota Grup:

Nama hasil skrip Nilai
is_success true atau false

Mendapatkan Detail Kontak Pengelola

Gunakan tindakan Get Manager Contact Details untuk mencari pengelola pengguna di Active Directory dan mengambil detail kontak pengelola. Tindakan ini otomatis menargetkan pengguna yang terkait dengan kasus tersebut.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Dapatkan Detail Kontak Pengelola memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tersedia
Tabel pengayaan entitas Tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Tabel repositori kasus

Tindakan Get Manager Contact Details menyediakan tabel berikut di Case Wall:

  • Nama tabel: Manager Contact: <var class="readonly">ENTITY_ID</var>
  • Kolom:
    • Manager Name
    • Manager Phone
Pengayaan entity

Tindakan Get Manager Contact Details mendukung pengayaan entity berikut:

Nama kolom pengayaan Logika
AD_Manager_Name Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_Manager_phone Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_primaryGroupID Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_logonCount Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_cn Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_countryCode Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_objectClass Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_userPrincipalName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_adminCount Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_lastLogonTimestamp Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_manager Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_instanceType Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_distinguishedName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_dSCorePropagationData Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_msDS-SupportedEncryptionTypes Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_objectSid Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_whenCreated Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_uSNCreated Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_lockoutTime Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_badPasswordTime Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_pwdLastSet Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_sAMAccountName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_objectCategory Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_lastLogon Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_objectGUID Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_whenChanged Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_badPwdCount Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_accountExpires Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_displayName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_name Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_memberOf Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_codePage Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_userAccountControl Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_sAMAccountType Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_uSNChanged Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_sn Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_givenName Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
AD_lastLogoff Tindakan ini akan menampilkan nilai jika ada dalam hasil JSON.
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Dapatkan Detail Kontak Pengelola:

[
   {
        "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"],
            "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"
    }
]
Pesan output

Tindakan Get Manager Contact Details dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Retrieved manager details for the following users: ENTITY_ID Tindakan berhasil.
The following users don't have managers specified in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan atribut manager diisi di akun pengguna target di Active Directory.
Failed to retrieve manager details for the following users: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin untuk membaca atribut manager dan profil pengguna pengelola di Active Directory.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
No manager details were retrieved for the provided users.

Tindakan gagal.

Pastikan kasus berisi entitas User yang valid dan memiliki pengelola yang ditetapkan di Active Directory.
Error executing action "Get Manager Contact Details". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Get Manager Contact Details:

Nama hasil skrip Nilai
is_success true atau false

Apakah Pengguna Ada di Grup

Gunakan tindakan Is User In Group untuk memeriksa apakah pengguna tertentu termasuk dalam grup Active Directory tertentu. Secara default, tindakan ini akan memeriksa entity User dalam kasus, atau Anda dapat memasukkan daftar nama pengguna yang dipisahkan koma dalam parameter User Name untuk memeriksa akun tertentu secara langsung.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Is User In Group memerlukan parameter berikut:

Parameter Deskripsi
Group Name

Wajib.

Nama grup yang akan diperiksa, seperti administrators.
User Name

Opsional.

Daftar nama pengguna yang dipisahkan koma untuk diperiksa.

Jika Anda tidak memberikan nilai, tindakan akan memeriksa entity User dalam kasus.
Where To Search

Wajib.

Organizational Unit atau Group tertentu untuk mencakup penelusuran.

Kemungkinan nilainya adalah sebagai berikut:

  • Select Option
  • Organizational Unit
  • Group

Nilai defaultnya adalah Select Option.
Filter Object Value

Opsional.

Nama Organizational Unit atau Group tempat tindakan menelusuri grup target. Parameter ini wajib ada jika Where To Search ditetapkan ke Organizational Unit atau Group.
Search In Subgroups

Opsional.

Jika dipilih, tindakan akan menelusuri secara berulang dalam subgrup bertingkat.

Output tindakan

Tindakan Is User In Group memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Is User In Group:

[
    {
        "EntityResult": true,
        "Entity": "USER1@EXAMPLE.COM"
    }, {
        "EntityResult": false,
        "Entity": "USER2@EXAMPLE.COM"
    }, {
        "EntityResult": true,
        "Entity": "USER3@EXAMPLE.COM"
    }
]
Pesan output

Tindakan Is User In Group dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

USER_NAME IN GROUP_NAME;

USER_NAME NOT in GROUP_NAME;

 Tindakan berhasil.
The following users were not found in Active Directory: USER_NAME

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan nama pengguna atau entity User ada di Active Directory.
None of the provided users were found in Active Directory.

Tindakan gagal.

Pastikan kasus berisi entity User yang valid atau nama pengguna yang ditentukan dalam parameter User Name ada di Active Directory.
Error executing action "Is User In Group". Reason: Filter Object Value should be provided

Tindakan gagal.

Berikan nama grup atau OU yang valid dalam parameter Filter Object Value saat Where To Search ditetapkan ke Organizational Unit atau Group.
Error executing action "Is User In Group". Reason: Given group doesn't exist in Active Directory.

Tindakan gagal.

Periksa nama grup di parameter Group Name dan pastikan grup tersebut ada dalam cakupan penelusuran yang dikonfigurasi.
Error executing action "Is User In Group". Reason: Specified Organizational Unit doesn't exist in Active Directory.

Tindakan gagal.

Pastikan Unit Organisasi yang ditentukan di Filter Object Value ada di Active Directory.
Error executing action "Is User In Group". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.

Tindakan gagal.

Pastikan grup induk yang ditentukan di Filter Object Value ada di Active Directory.
Error executing action "Is User In Group". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter input, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Is User In Group:

Nama hasil skrip Nilai
is_success true atau false

Mencantumkan Grup Pengguna

Gunakan tindakan List User Groups untuk mengambil daftar semua grup Active Directory tempat pengguna berada. Tindakan ini otomatis menargetkan pengguna yang terkait dengan kasus tersebut.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan List User Groups memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan List User Groups:

[
    {
        "EntityResult": ["Domain Users"],
        "Entity": "user@example.com"
    }
]
Pesan output

Tindakan List User Groups dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Groups were listed for the following users: ENTITY_ID Tindakan berhasil.
No groups were found for the following users: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ditetapkan ke setidaknya satu grup eksplisit di atribut memberOf di Active Directory.
Failed to list groups for the following users: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin untuk membaca atribut memberOf di akun pengguna target.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
No groups were listed.

Tindakan gagal.

Pastikan kasus berisi entitas User yang valid yang termasuk dalam grup di Active Directory.
Error executing action "List User Groups". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan List User Groups:

Nama hasil skrip Nilai
is_success true atau false

Ping

Gunakan tindakan Ping untuk memverifikasi bahwa Google SecOps dapat terhubung dan melakukan autentikasi ke server Active Directory Anda menggunakan setelan integrasi yang dikonfigurasi.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Ping memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Ping dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Connected successfully. Tindakan berhasil.
Error executing action "Ping". Reason: ERROR_REASON

Tindakan gagal.

Periksa alamat server, port, setelan SSL, atau kredensial akun layanan dalam konfigurasi integrasi.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Ping:

Nama hasil skrip Nilai
is_success true atau false

Melepaskan Akun Terkunci

Gunakan tindakan Release Locked Account untuk membuka kunci akun pengguna di Active Directory yang terkunci setelah terlalu banyak upaya login yang gagal. Tindakan ini otomatis menargetkan pengguna yang terkait dengan kasus tersebut.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Release Locked Account memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Release Locked Account dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Unlocked account for the following users: ENTITY_ID Tindakan berhasil.
Failed to unlock account for the following users: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin baca dan izin tulis untuk atribut lockoutTime di akun pengguna target.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
No accounts were unlocked.

Tindakan gagal.

Pastikan kasus berisi entitas User yang valid dan akun layanan memiliki izin untuk membuka kunci akun target.
Error executing action "Release Locked Account". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Release Locked Account:

Nama hasil skrip Nilai
is_success true atau false

Menghapus Pengguna dari Grup

Gunakan tindakan Remove User From Group untuk menghapus pengguna dalam kasus dari satu atau beberapa grup Active Directory, seperti mencabut akses grup yang ditingkatkan selama insiden. Tindakan ini otomatis mengidentifikasi pengguna target dari kasus dan menghapusnya dari grup yang ditentukan.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Remove User From Group memerlukan parameter berikut:

Parameter Deskripsi
Group Name

Wajib.

Daftar grup yang dipisahkan koma untuk menghapus pengguna.

Output tindakan

Tindakan Remove User From Group memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Remove User From Group dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

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

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

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin untuk mengubah atribut member pada grup target.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
The following groups were not found in Active Directory: GROUP_NAME

Tindakan gagal untuk grup yang ditentukan.

Periksa ejaan nama grup dalam parameter Group Name dan konfirmasi bahwa grup tersebut ada di domain yang dikonfigurasi.
No users were removed from the group "GROUP_NAME" in Active Directory.

Tindakan gagal untuk grup yang ditentukan.

Pastikan pengguna target ada di Active Directory dan akun layanan memiliki akses tulis ke grup yang ditentukan.
No users were removed from the provided groups in Active Directory.

Tindakan gagal.

Pastikan kasus berisi entitas User yang valid dan grup yang ditentukan ada di Active Directory.
Error executing action "Remove User From Group". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter input, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Remove User From Group:

Nama hasil skrip Nilai
is_success true atau false

Menelusuri Active Directory

Gunakan tindakan Search Active Directory untuk menelusuri pengguna, komputer, grup, atau Unit Organisasi di direktori Anda menggunakan kondisi penelusuran bawaan atau kueri kustom. Anda juga dapat memfilter penelusuran menurut Unit Organisasi tertentu dan memilih kolom direktori yang akan disertakan dalam hasil.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Search Active Directory memerlukan parameter berikut:

Parameter Deskripsi
Search Condition

Wajib.

Kondisi yang akan diterapkan ke penelusuran.

Kemungkinan nilainya adalah sebagai berikut:

  • Contains
  • Exact Match
  • Starts With
  • Custom LDAP Query

Nilai defaultnya adalah Contains.
Include Domain

Opsional.

Jika dipilih, tindakan akan menyertakan komponen domain saat menelusuri dengan kondisi Contains, Exact Match, atau Starts With.
Search Object

Wajib.

Jenis objek yang akan ditelusuri saat tidak menggunakan Custom LDAP Query.

Kemungkinan nilainya adalah sebagai berikut:

  • Select Option
  • User
  • Host
  • Group
  • Organizational Unit

Nilai defaultnya adalah Select Option.
Filter Object Value

Wajib.

Nilai objek yang akan difilter, atau string kueri LDAP lengkap saat Search Condition ditetapkan ke Custom LDAP Query.
Custom Fields

Opsional.

Daftar atribut LDAP yang dipisahkan koma untuk ditampilkan dalam hasil penelusuran.
Specific OUs to Search

Opsional.

Daftar nama Unit Organisasi yang dipisahkan koma untuk membatasi cakupan penelusuran.
Include Default Search Fields

Opsional.

Jika dipilih, tindakan ini akan menyertakan kolom Active Directory default dalam hasil yang ditampilkan, selain Custom Fields yang ditentukan.

Diaktifkan secara default.
Max Records To Return

Opsional.

Jumlah maksimum data yang akan diambil dari Active Directory.

Nilai defaultnya adalah 100.
Sort Field

Opsional.

Nama atribut LDAP yang digunakan untuk mengurutkan entri yang ditampilkan.

Output tindakan

Tindakan Search Active Directory memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Tabel repositori kasus

Tindakan Search Active Directory menyediakan tabel berikut di Case Wall:

  • Nama tabel: Active Directory Search Results
  • Kolom: Atribut Active Directory yang ditampilkan untuk entri direktori yang cocok (berdasarkan Include Default Search Fields dan Custom Fields).
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Search Active Directory:

[
      {
        "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"
        ]
      }
    ]
Pesan output

Tindakan Search Active Directory dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully performed the query "QUERY_STRING" in Active Directory.

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

 Tindakan berhasil.
Error executing action "Search Active Directory". Reason: you need to select "Search Object" or choose "Custom LDAP Query" as a "Search Condition"

Tindakan gagal.

Pilih jenis objek yang valid di parameter Search Object atau ubah Search Condition menjadi Custom LDAP Query.
Error executing action "Search Active Directory". Reason: Value for the parameter "Max Records To Return" should be a positive number.

Tindakan gagal.

Masukkan bilangan bulat yang lebih besar dari 0 dalam parameter Max Records To Return.
Error executing action "Search Active Directory". Reason: The following OUs were not found in Active Directory: OU_NAMES

Tindakan gagal.

Periksa ejaan Unit Organisasi dalam parameter Specific OUs to Search dan pastikan unit tersebut ada di Active Directory.
Error executing action "Search Active Directory". Reason: Knowingly invalid query was executed: "QUERY_STRING". Please verify the inputs and try again.

Tindakan gagal.

Periksa sintaksis kueri kustom atau nilai filter Anda dalam parameter Filter Object Value dan pastikan bahwa nama Custom Fields atau Sort Field yang ditentukan adalah atribut LDAP yang valid.
Error executing action "Search Active Directory". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter input, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Search Active Directory:

Nama hasil skrip Nilai
is_success true atau false

Menetapkan Sandi Pengguna

Gunakan tindakan Setel Sandi Pengguna untuk mereset sandi pengguna dalam kasus ini ke sandi baru. Pastikan integrasi terhubung melalui SSL (LDAPS) dan sandi baru memenuhi aturan kompleksitas sandi domain Anda.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Set User Password memerlukan parameter berikut:

Parameter Deskripsi
New Password

Wajib.

Nilai sandi baru.

Output tindakan

Tindakan Set User Password memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Set User Password dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Reset password for the following users: ENTITY_ID Tindakan berhasil.
Failed to reset password for the following users: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan sandi baru memenuhi persyaratan kerumitan dan histori sandi domain, serta pengguna target bukan akun administratif yang dilindungi.
The following users were not found in Active Directory: ENTITY_ID

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
No passwords were changed.

Tindakan gagal.

Pastikan kasus berisi entity User yang valid dan akun layanan memiliki izin untuk mereset sandi di akun target.
Failed to execute "Set User Password" action! Watch Over Extended Rights permission or SSL connection.

Tindakan gagal.

Pastikan Use SSL dipilih dalam konfigurasi integrasi (LDAPS di port 636) dan akun layanan memiliki hak yang diperluas Reset Password.
Error executing action "Set User Password". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter input, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Set User Password:

Nama hasil skrip Nilai
is_success true atau false

Memperbarui atribut Host AD

Gunakan tindakan Update attributes of an AD Host untuk memperbarui properti direktori tertentu di akun komputer dalam kasus ini, seperti memperbarui kolom Description komputer dengan catatan insiden. Tindakan ini akan otomatis mengidentifikasi komputer target dari kasus dan menerapkan nilai baru.

Tindakan ini berjalan di entity Hostname Google SecOps.

Input tindakan

Tindakan Update attributes of an AD Host memerlukan parameter berikut:

Parameter Deskripsi
Attribute Name

Wajib.

Nama atribut yang akan diperbarui, seperti Description.
Attribute Value

Wajib.

Nilai baru untuk atribut.

Output tindakan

Tindakan Update attributes of an AD Host memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Update attributes of an AD Host dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Successfully updated attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST Tindakan berhasil.
Action wasn't able to update attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST

Tindakan gagal untuk host yang ditentukan.

Pastikan akun layanan memiliki izin tulis untuk atribut yang ditentukan di akun komputer target dan format nilainya valid untuk atribut tersebut.
The following hosts were not found in Active Directory: ENTITY_ID_LIST

Tindakan gagal untuk host yang ditentukan.

Pastikan akun komputer ada di Active Directory dan cocok dengan entitas Hostname dalam kasus ini.
No hosts were updated in Active Directory.

Tindakan gagal.

Pastikan kasus berisi entity Hostname yang valid dan akun layanan memiliki izin untuk memperbarui atribut yang ditentukan.
Error executing action "Update attributes of an AD Host". Reason: Provided attribute doesn't exist in Active Directory.

Tindakan gagal.

Periksa ejaan atribut dalam parameter Attribute Name dan pastikan atribut tersebut adalah atribut komputer Active Directory yang valid.
Error executing action "Update attributes of an AD Host". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter input, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Update attributes of an AD Host:

Nama hasil skrip Nilai
is_success true atau false

Memperbarui atribut Pengguna AD

Gunakan tindakan Update attributes of an AD User untuk memperbarui properti direktori tertentu di akun pengguna dalam kasus ini, seperti memperbarui kolom Description, title, atau department pengguna. Tindakan ini akan otomatis mengidentifikasi pengguna target dari kasus dan menerapkan nilai baru.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Update attributes of an AD User memerlukan parameter berikut:

Parameter Deskripsi
Attribute Name

Wajib.

Nama atribut yang akan diperbarui, seperti Description.
Attribute Value

Wajib.

Nilai baru untuk atribut.

Output tindakan

Tindakan Update attributes of an AD User memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Update attributes of an AD User dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan
Successfully updated attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST Tindakan berhasil.
Action wasn't able to update attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun layanan memiliki izin tulis untuk atribut yang ditentukan di akun pengguna target dan format nilainya valid untuk atribut tersebut.
The following users were not found in Active Directory: ENTITY_ID_LIST

Tindakan gagal untuk pengguna yang ditentukan.

Pastikan akun pengguna ada di Active Directory dan cocok dengan entitas User dalam kasus ini.
No users were updated in Active Directory.

Tindakan gagal.

Pastikan kasus berisi entity User yang valid dan akun layanan memiliki izin untuk memperbarui atribut yang ditentukan.
Error executing action "Update attributes of an AD User". Reason: Provided attribute doesn't exist in Active Directory.

Tindakan gagal.

Periksa ejaan atribut dalam parameter Attribute Name dan pastikan atribut tersebut adalah atribut pengguna Active Directory yang valid.
Error executing action "Update attributes of an AD User". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server Active Directory, parameter input, atau kredensial akun layanan.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Update attributes of an AD User:

Nama hasil skrip Nilai
is_success true atau false

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.