Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mengintegrasikan Microsoft Entra ID dengan Google SecOps

Dokumen ini memberikan panduan tentang cara mengintegrasikan Microsoft Entra ID dengan Google Security Operations (Google SecOps).

Integrasi ini menggunakan satu atau beberapa komponen open source. Anda dapat mendownload salinan zip kode sumber lengkap integrasi ini dari bucket Cloud Storage.

Kasus penggunaan

Mengintegrasikan Microsoft Entra ID dengan Google SecOps dapat membantu Anda menyelesaikan kasus penggunaan berikut:

Pengelolaan akun pengguna: gunakan kemampuan Google SecOps untuk mengotomatiskan penonaktifan dan pengaktifan akun pengguna di Microsoft Entra ID berdasarkan peristiwa keamanan, seperti dugaan penyusupan atau offboarding karyawan.
Reset sandi: gunakan kemampuan Google SecOps untuk mengorkestrasi reset sandi untuk akun yang disusupi atau pengguna yang terkunci dari akun mereka. Mereset sandi dapat membantu Anda menyederhanakan proses pemulihan sandi dan mengurangi tiket dukungan teknis.
Pengelolaan grup: gunakan kemampuan Google SecOps untuk mengotomatiskan pembuatan, modifikasi, dan penghapusan grup Microsoft Entra ID.
Penerapan kebijakan akses bersyarat: gunakan kebijakan akses bersyarat Microsoft Entra ID dalam playbook Google SecOps untuk mengontrol akses secara dinamis berdasarkan konteks dan memungkinkan kontrol terperinci atas akses ke resource berdasarkan faktor seperti lokasi, perangkat, dan risiko pengguna.
Pemberitahuan keamanan dan respons insiden: mengintegrasikan pemberitahuan keamanan Microsoft Entra ID ke dalam Google SecOps untuk mengotomatiskan alur kerja respons insiden.

Sebelum memulai

Sebelum mengonfigurasi integrasi di Google SecOps, pastikan Anda telah memenuhi persyaratan berikut di lingkungan Microsoft:

Pendaftaran Aplikasi Azure: Anda harus mendaftarkan aplikasi di pusat admin Microsoft Entra untuk mendapatkan Client ID dan Tenant ID.

Untuk mengetahui petunjuk mendetail, lihat Register an application in Microsoft Entra ID.
API permissions: Berikan Microsoft Graph > Application permissions berikut ke aplikasi Anda dan berikan izin admin:
- Directory.Read.All
- Directory.ReadWrite.All
- Group.ReadWrite.All
- User.ReadWrite.All
- AuditLog.Read.All (Diperlukan untuk menggunakan parameter Sertakan Detail MFA)
Penetapan peran: Untuk menjalankan tindakan terkait sandi, seperti Force Password Update atau Reset User Password, Anda harus menetapkan peran Password Administrator ke aplikasi Anda dalam Microsoft Entra ID.
Rahasia klien: Buat rahasia klien di bagian Certificates & secrets di aplikasi Azure Anda. Segera simpan Nilai rahasia (bukan ID Rahasia), karena nilai ini hanya ditampilkan sekali dan diperlukan untuk konfigurasi.

Parameter integrasi

Integrasi Microsoft Entra ID memerlukan parameter berikut:

Parameter	Deskripsi
`Login API Root`	Opsional Root API yang digunakan untuk melakukan autentikasi dengan platform identitas Microsoft. Nilai defaultnya adalah `https://login.microsoftonline.com`.
`API Root`	Opsional Root API instance Azure Active Directory. Nilai defaultnya adalah `https://graph.microsoft.com`.
`Client ID`	Wajib Nilai ID aplikasi (klien) akun Microsoft Entra ID Anda.
`Client Secret`	Wajib Nilai rahasia klien akun Microsoft Entra ID Anda.
`Directory ID`	Wajib Nilai ID direktori (tenant) akun Microsoft Entra ID Anda.
`Verify SSL`	Opsional Jika dipilih, integrasi akan memverifikasi bahwa sertifikat SSL yang digunakan untuk terhubung ke server Microsoft Entra ID valid. Dipilih secara default.

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 a Group untuk menambahkan pengguna ke grup Microsoft Entra ID tertentu. Tindakan ini mengharuskan Anda mengonfigurasi entity User dalam format username@domain.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Add User to a Group memerlukan parameter berikut:

Parameter	Deskripsi
`Group ID`	Wajib ID grup Microsoft Entra ID untuk menambahkan pengguna, seperti `00e40000-1971-439d-80fc-d0e000001dbd`.

Output tindakan

Tindakan Add User to a 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 Tambahkan Pengguna ke Grup dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`Member USER_ID was added to the group GROUP_ID successfully.` `Some errors occurred. Please check the logs.`	Tindakan berhasil.
`Member could not be added successfully.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Member USER_ID was added to the group GROUP_ID successfully.

Some errors occurred. Please check the logs.

Tindakan berhasil.

Member could not be added successfully.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Tambahkan Pengguna ke Grup:

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Nonaktifkan Akun

Gunakan tindakan Disable Account untuk menonaktifkan akun di Microsoft Entra ID. Tindakan ini mengharuskan Anda mengonfigurasi entity User dalam format username@domain.

Untuk menjalankan tindakan Disable Account, berikan hak istimewa administratif ke akun Microsoft Entra ID yang Anda gunakan dalam integrasi.

Tindakan ini berjalan di entity User Google SecOps.

Mengonfigurasi izin tambahan

Tindakan Disable Account mengharuskan Anda mengonfigurasi izin API berikut untuk aplikasi:

User.EnableDisableAccount.All

Untuk panduan tentang cara mengonfigurasi izin API di Microsoft Entra ID, lihat bagian Mengonfigurasi izin API dalam dokumen ini.

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

Pesan output	Deskripsi pesan
`User account disabled successfully.` `Some errors occurred. Please check the logs.`	Tindakan berhasil.
`Disable user account was not successful.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

User account disabled successfully.

Some errors occurred. Please check the logs.

Tindakan berhasil.

Disable user account was not successful.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Aktifkan Akun

Gunakan tindakan Enable Account untuk mengaktifkan akun di Microsoft Entra ID. Tindakan ini mengharuskan Anda mengonfigurasi entity User dalam format username@domain.

Tindakan ini berjalan di entity User Google SecOps.

Mengonfigurasi izin tambahan

Tindakan Enable Account mengharuskan Anda mengonfigurasi izin API berikut untuk aplikasi:

User.EnableDisableAccount.All

Untuk panduan tentang cara mengonfigurasi izin API di Microsoft Entra ID, lihat bagian Mengonfigurasi izin API dalam dokumen ini.

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

Pesan output	Deskripsi pesan
`User account was enabled successfully.` `Some errors occurred. Please check the logs.`	Tindakan berhasil.
`Enable user account was not successful.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

User account was enabled successfully.

Some errors occurred. Please check the logs.

Tindakan berhasil.

Enable user account was not successful.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Host Pengayaan

Gunakan tindakan Enrich Host untuk memperkaya entity Host Google SecOps dengan informasi dari Microsoft Entra ID. Tindakan ini menemukan kecocokan untuk entity Host yang disediakan menggunakan kolom displayName di perangkat di Microsoft Entra ID.

Tindakan ini berjalan di entity Host Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Enrich 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 entitas	Tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Tabel pengayaan entitas

Tindakan Enrich Host mendukung pengayaan entity berikut:

Kolom pengayaan	Logika
`AAD_Name`	Menampilkan jika ada dalam hasil JSON.
`AAD_Enabled`	Menampilkan jika ada dalam hasil JSON.
`AAD_Property Device ID`	Menampilkan jika ada dalam hasil JSON.
`AAD_OS`	Menampilkan jika ada dalam hasil JSON.
`AAD_Version`	Menampilkan jika ada dalam hasil JSON.
`AAD_Profile Type`	Menampilkan jika ada dalam hasil JSON.
`AAD_Compliant`	Menampilkan jika ada dalam hasil JSON.
`AAD_Last Sign In`	Menampilkan jika ada dalam hasil JSON.

Hasil JSON

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

[
    {
        "EntityResult": {
            "deletedDateTime": "1234569",
            "complianceExpirationDateTime": "1234567",
            "profileType": "RegisteredDevice",
            "key": "007",
            "if":"889922-aaaa-123123"
        },
        "Entity": "us-lt-v13001"
    }
]

Pesan output

Tindakan Enrich Host dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`Host details were fetched successfully: HOSTNAME.` `Some errors occurred. Please check log.`	Tindakan berhasil.
`Host details were not found.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Host details were fetched successfully: HOSTNAME.

Some errors occurred. Please check log.

Tindakan berhasil.

Host details were not found.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Memperkaya Pengguna

Gunakan tindakan Enrich User untuk memperkaya entitas User Google SecOps dengan informasi dari Microsoft Entra ID. Tindakan ini mengharuskan Anda mengonfigurasi entity User dalam format username@domain.

Tindakan ini berjalan di entity Host Google SecOps.

Input tindakan

Tindakan Enrich User memerlukan parameter berikut:

Parameter Deskripsi

Parameter	Deskripsi
`Include MFA Details`	Opsional. Jika dipilih, tindakan akan menampilkan detail MFA tentang pengguna. Catatan: Parameter ini memerlukan izin aplikasi Microsoft Graph `AuditLog.Read.All` di Pendaftaran Aplikasi Azure Anda.
`Include Last Sign In Details`	Opsional. Jika dipilih, tindakan akan mengambil aktivitas login pengguna (termasuk stempel waktu login interaktif dan non-interaktif).

Include MFA Details

Opsional.

Jika dipilih, tindakan akan menampilkan detail MFA tentang pengguna.

Catatan: Parameter ini memerlukan izin aplikasi Microsoft Graph AuditLog.Read.All di Pendaftaran Aplikasi Azure Anda.

Include Last Sign In Details

Opsional.

Jika dipilih, tindakan akan mengambil aktivitas login pengguna (termasuk stempel waktu login interaktif dan non-interaktif).

Output tindakan

Tindakan Enrich 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 entitas	Tersedia
Hasil JSON	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Tabel pengayaan entitas

Tindakan Enrich User mendukung pengayaan entity berikut:

Kolom pengayaan	Logika
`AAD_Name`	Menampilkan jika ada dalam hasil JSON.
`AAD_Mobile Phone`	Menampilkan jika ada dalam hasil JSON.
`AAD_Preferred Language`	Menampilkan jika ada dalam hasil JSON.
`AAD_Job Title`	Menampilkan jika ada dalam hasil JSON.
`AAD_Username`	Menampilkan jika ada dalam hasil JSON.

Hasil JSON

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

[
  {
    "Entity": "user@domain.com",
    "EntityResult": {
      "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
      "accountEnabled": true,
      "ageGroup": null,
      "businessPhones": [],
      "city": "New York",
      "companyName": "ExampleCorp",
      "consentProvidedForMinor": null,
      "country": "US",
      "createdDateTime": "2025-01-01T00:00:00Z",
      "creationType": null,
      "department": "Security",
      "displayName": "User Name",
      "mail": "user@domain.com",
      "employeeId": "12345",
      "employeeHireDate": null,
      "employeeType": null,
      "externalUserStateChangeDateTime": null,
      "faxNumber": null,
      "givenName": "User",
      "imAddresses": [],
      "externalUserState": null,
      "jobTitle": "Security Analyst",
      "surname": "Surname",
      "lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
      "legalAgeGroupClassification": null,
      "mailNickname": "usernickname",
      "mobilePhone": "+11234567890",
      "id": "user-id-12345",
      "officeLocation": null,
      "onPremisesSamAccountName": null,
      "onPremisesDistinguishedName": null,
      "onPremisesDomainName": null,
      "onPremisesImmutableId": null,
      "onPremisesLastSyncDateTime": null,
      "onPremisesProvisioningErrors": [],
      "onPremisesSecurityIdentifier": null,
      "onPremisesSyncEnabled": null,
      "onPremisesUserPrincipalName": null,
      "otherMails": [],
      "passwordPolicies": "None",
      "preferredDataLocation": null,
      "preferredLanguage": "en-US",
      "proxyAddresses": [],
      "signInSessionsValidFromDateTime": "2025-01-01T00:00:00Z",
      "state": "NY",
      "streetAddress": "123 Main St",
      "usageLocation": "US",
      "userPrincipalName": "user@domain.com",
      "userType": "Member",
      "postalCode": "10001",
      "deletedDateTime": null,
      "showInAddressList": null,
      "isResourceAccount": null,
      "refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
      "employeeOrgData": null,
      "passwordProfile": null,
      "authorizationInfo": {
        "certificateUserIds": []
      },
      "mfa_details": {
        "id": "user-id-12345",
        "userPrincipalName": "user@domain.com",
        "userDisplayName": "User Name",
        "userType": "member",
        "isAdmin": false,
        "isSsprRegistered": true,
        "isSsprEnabled": true,
        "isSsprCapable": true
        "isMfaRegistered": true,
        "isMfaCapable": true,
        "isPasswordlessCapable": false,
        "methodsRegistered": [
          "email",
          "mobilePhone"
        ],
        "defaultMfaMethod": "mobilePhone",
        "isSystemPreferredAuthenticationMethodEnabled": false,
        "systemPreferredAuthenticationMethods": [],
        "userPreferredMethodForSecondaryAuthentication": "oath",
        "lastUpdatedDateTime": "2026-01-01T00:00:00Z"
      }
    }
  }
]

Pesan output

Tindakan Enrich User dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`User details were fetched successfully: USERNAME.` `Some errors occurred. Please check the logs.`	Tindakan berhasil.
`Users list fetch was not successful.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

User details were fetched successfully: USERNAME.

Some errors occurred. Please check the logs.

Tindakan berhasil.

Users list fetch was not successful.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Paksa Update Sandi

Gunakan tindakan Wajibkan Pembaruan Sandi untuk mewajibkan pembaruan sandi bagi pengguna. Tindakan ini mengharuskan pengguna mengubah sandinya pada upaya login berikutnya.

Tindakan Paksa Update Sandi mengharuskan Anda mengonfigurasi entitas User dalam format username@domain.

Tindakan ini berjalan di entity User Google SecOps.

Mengonfigurasi izin tambahan

Tindakan Paksa Update Sandi mengharuskan Anda mengonfigurasi izin API berikut untuk aplikasi:

User-PasswordProfile.ReadWrite.All

Untuk panduan tentang cara mengonfigurasi izin API di Microsoft Entra ID, lihat bagian Mengonfigurasi izin API dalam dokumen ini.

Menetapkan peran ke aplikasi Anda

Tindakan Paksa Update Sandi mengharuskan Anda menetapkan peran Password Administrator ke aplikasi Anda.

Untuk menetapkan peran Password Administrator ke aplikasi Anda, selesaikan langkah-langkah berikut:

Login ke portal Azure menggunakan akun Microsoft Anda.
Di Microsoft Entra ID, telusuri Roles and administrators.
Pilih atau telusuri peran Password Administrator dari daftar.
Klik Add Assignment.
Pilih akun (anggota) yang Anda gunakan dalam integrasi, lalu klik Berikutnya.
Masukkan justifikasi untuk menetapkan peran.
Klik Tetapkan.

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

Pesan output	Deskripsi pesan
`Force password update on the user was successful.` `Some errors occurred. Please check the logs.`	Tindakan berhasil.
`Attempt to Force user password update was not successful.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Force password update on the user was successful.

Some errors occurred. Please check the logs.

Tindakan berhasil.

Attempt to Force user password update was not successful.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

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 Detail Kontak Pengelola

Gunakan tindakan Get Manager Contact Details untuk mendapatkan detail kontak pengelola bagi pengguna.

Tindakan Get Manager Contact Details mengharuskan Anda mengonfigurasi entity User dalam format username@domain.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Dapatkan Detail Kontak Pengelola memerlukan parameter berikut:

Parameter Deskripsi

Parameter	Deskripsi
`Fields To Return`	Opsional. Daftar atribut profil pengelola tertentu yang dipisahkan koma untuk diambil. Jika tidak ada nilai yang diberikan, tindakan akan menampilkan kumpulan atribut default yang ditentukan oleh API. Nilai defaultnya adalah accountEnabled,ageGroup,assignedLicenses, businessPhones,city,companyName,consentProvidedForMinor,country, createdDateTime,creationType,department,displayName,mail,employeeId, employeeHireDate,employeeOrgData,employeeType,onPremisesExtensionAttributes, externalUserStateChangeDateTime,faxNumber,givenName,imAddresses,identities, externalUserState,jobTitle,surname,lastPasswordChangeDateTime, legalAgeGroupClassification,mailNickname,mobilePhone,id,officeLocation, onPremisesSamAccountName,onPremisesDistinguishedName,onPremisesDomainName, onPremisesImmutableId,onPremisesLastSyncDateTime, onPremisesProvisioningErrors,onPremisesSecurityIdentifier, onPremisesSyncEnabled,onPremisesUserPrincipalName,otherMails, passwordPolicies,passwordProfile,preferredDataLocation,preferredLanguage, proxyAddresses,signInSessionsValidFromDateTime,sponsors,state,streetAddress, usageLocation,userPrincipalName,userType,postalCode,authorizationInfo, deletedDateTime,showInAddressList,isResourceAccount, refreshTokensValidFromDateTime.
`Include MFA Details`	Opsional. Jika dipilih, tindakan akan menampilkan detail MFA tentang pengguna. Catatan: Parameter ini memerlukan izin aplikasi Microsoft Graph `AuditLog.Read.All` di Pendaftaran Aplikasi Azure Anda.
`Include Last Sign In Details`	Opsional. Jika dipilih, tindakan akan mengambil aktivitas login pengguna (termasuk stempel waktu login interaktif dan non-interaktif).

Fields To Return

Opsional.

Daftar atribut profil pengelola tertentu yang dipisahkan koma untuk diambil.

Jika tidak ada nilai yang diberikan, tindakan akan menampilkan kumpulan atribut default yang ditentukan oleh API.

Nilai defaultnya adalah accountEnabled,ageGroup,assignedLicenses, businessPhones,city,companyName,consentProvidedForMinor,country, createdDateTime,creationType,department,displayName,mail,employeeId, employeeHireDate,employeeOrgData,employeeType,onPremisesExtensionAttributes, externalUserStateChangeDateTime,faxNumber,givenName,imAddresses,identities, externalUserState,jobTitle,surname,lastPasswordChangeDateTime, legalAgeGroupClassification,mailNickname,mobilePhone,id,officeLocation, onPremisesSamAccountName,onPremisesDistinguishedName,onPremisesDomainName, onPremisesImmutableId,onPremisesLastSyncDateTime, onPremisesProvisioningErrors,onPremisesSecurityIdentifier, onPremisesSyncEnabled,onPremisesUserPrincipalName,otherMails, passwordPolicies,passwordProfile,preferredDataLocation,preferredLanguage, proxyAddresses,signInSessionsValidFromDateTime,sponsors,state,streetAddress, usageLocation,userPrincipalName,userType,postalCode,authorizationInfo, deletedDateTime,showInAddressList,isResourceAccount, refreshTokensValidFromDateTime.

Include MFA Details

Opsional.

Jika dipilih, tindakan akan menampilkan detail MFA tentang pengguna.

Catatan: Parameter ini memerlukan izin aplikasi Microsoft Graph AuditLog.Read.All di Pendaftaran Aplikasi Azure Anda.

Include Last Sign In Details

Opsional.

Jika dipilih, tindakan akan mengambil aktivitas login pengguna (termasuk stempel waktu login interaktif dan non-interaktif).

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 dapat menampilkan tabel berikut di Google SecOps:

Nama tabel: Manager contact

Kolom:

Nama
Nomor telepon

Tabel pengayaan entitas

Tindakan Get Manager Contact Details mendukung pengayaan entity berikut:

Kolom pengayaan	Logika
`Display Name`	Menampilkan jika ada dalam hasil JSON.
`Mobile Phone`	Menampilkan jika ada dalam hasil JSON.
`@odata.context`	Menampilkan jika ada dalam hasil JSON.
`AAD_Job Title`	Menampilkan jika ada dalam hasil JSON.
`AAD_Username`	Menampilkan jika ada dalam hasil JSON.

Hasil JSON

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

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
      "accountEnabled": true,
      "ageGroup": null,
      "businessPhones": [],
      "city": "Anytown",
      "companyName": "Example Corporation",
      "consentProvidedForMinor": null,
      "country": "US",
      "createdDateTime": "2025-01-01T00:00:00Z",
      "creationType": null,
      "department": "Security Operations",
      "displayName": "Internal User",
      "mail": "user@example.com",
      "employeeId": "ID-00001",
      "employeeHireDate": null,
      "employeeType": "Full-time",
      "externalUserStateChangeDateTime": null,
      "faxNumber": null,
      "givenName": "Alex",
      "imAddresses": [],
      "externalUserState": null,
      "jobTitle": "Security Lead",
      "surname": "Doe",
      "lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
      "legalAgeGroupClassification": null,
      "mailNickname": "alexdoe",
      "mobilePhone": "+1 555-0100",
      "id": "00000000-0000-0000-0000-000000000000",
      "officeLocation": null,
      "usageLocation": "US",
      "userPrincipalName": "user@example.com",
      "userType": "Member",
      "postalCode": "00000",
      "deletedDateTime": null,
      "showInAddressList": null,
      "isResourceAccount": null,
      "refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
      "employeeOrgData": null,
      "authorizationInfo": {
        "certificateUserIds": []
      },
      "sponsors": [],
      "mfa_details": {
        "id": "00000000-0000-0000-0000-000000000000",
        "userPrincipalName": "user@example.com",
        "userDisplayName": "Internal User",
        "userType": "member",
        "isAdmin": true,
        "isSsprRegistered": false,
        "isSsprEnabled": true,
        "isSsprCapable": false,
        "isMfaRegistered": true,
        "isMfaCapable": true,
        "isPasswordlessCapable": false,
        "methodsRegistered": [
          "mobilePhone",
          "softwareOneTimePasscode"
        ],
        "defaultMfaMethod": "softwareOneTimePasscode",
        "isSystemPreferredAuthenticationMethodEnabled": true,
        "systemPreferredAuthenticationMethods": [
          "SoftwareOTP"
        ],
        "userPreferredMethodForSecondaryAuthentication": "oath",
        "lastUpdatedDateTime": "2026-01-01T00:00:00Z"
      }
    }
  }
]

Pesan output

Tindakan Get Manager Contact Details dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`User manager details were fetched successfully.` `Some errors occurred. Please check the logs.`	Tindakan berhasil.
`Could not fetch user manager's details successfully.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

User manager details were fetched successfully.

Some errors occurred. Please check the logs.

Tindakan berhasil.

Could not fetch user manager's details successfully.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

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`

Is User in Group

Gunakan tindakan Is User in Group untuk memeriksa apakah pengguna memiliki keanggotaan di grup Microsoft Entra ID tertentu. Tindakan ini mengharuskan Anda mengonfigurasi entity User dalam format username@domain.

Tindakan ini berjalan di entity User Google SecOps.

Input tindakan

Tindakan Is User in Group memerlukan parameter berikut:

Parameter	Deskripsi
`Group ID`	Wajib ID grup Microsoft Entra ID untuk menambahkan pengguna, seperti `00e40000-1971-439d-80fc-d0e000001dbd`.

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": "user@example.com"
    }
]

Pesan output

Tindakan Is User in Group dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`The following user was found in the group: USER_ID.` `Some errors occurred. Please check the logs.`	Tindakan berhasil.
`User was not found in the group.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

The following user was found in the group: USER_ID.

Some errors occurred. Please check the logs.

Tindakan berhasil.

User was not found in the group.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

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`

Membuat Daftar Grup

Gunakan tindakan List Groups untuk mencantumkan grup Microsoft Entra ID menggunakan kriteria penelusuran yang ditentukan.

Untuk tindakan List Groups, pemfilteran berfungsi dengan kolom Name.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan List Groups memerlukan parameter berikut:

Parameter	Deskripsi
`Order By`	Opsional Urutan untuk mengurutkan grup yang ditampilkan berdasarkan namanya. Nilai defaultnya adalah `ASC`. Kemungkinan nilainya adalah sebagai berikut: `DESC` `ASC`
`Results Limit`	Opsional Jumlah maksimum grup yang akan ditampilkan.
`Filter Logic`	Opsional Logika untuk memfilter grup berdasarkan namanya. Nilai defaultnya adalah `Equal`. Kemungkinan nilainya adalah sebagai berikut: `Equal` `Contains`
`Filter Value`	Opsional Nilai untuk memfilter grup menggunakan logika filter yang dipilih. Nilai ini berlaku untuk nama grup. Jika Anda memilih `Equal`, tindakan akan mencoba menemukan kecocokan persis di antara hasil. Jika Anda memilih `Contain`, tindakan akan mencoba menemukan hasil yang berisi substring yang diberikan. Jika Anda tidak menetapkan nilai, filter tidak akan diterapkan.

Output tindakan

Tindakan List Groups 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 List Groups dapat menampilkan tabel berikut di Google SecOps:

Nama tabel: Groups

Kolom:

Nama
ID
Deskripsi
Email
Waktu Dibuat
Jenis Grup

Tabel pengayaan entitas

Tindakan List Groups mendukung pengayaan entity berikut:

Kolom pengayaan	Logika
`Group Type`	Menampilkan jika ada dalam hasil JSON.
`ID`	Menampilkan jika ada dalam hasil JSON.
`Name`	Menampilkan jika ada dalam hasil JSON.
`Description`	Menampilkan jika ada dalam hasil JSON.
`Created Time`	Menampilkan jika ada dalam hasil JSON.

Hasil JSON

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

[
  {
    "Group_Type": "managed",
    "Id": "1212-12312-123",
    "Name": "Group Name",
    "Description": "This group is ...",
    "Created_Time": "2019-10-24T19:10:18Z",
    "onPremisesSamAccountName": "alext"
  }
]

Pesan output

Tindakan List Groups dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`Groups list was fetched successfully.` `Some errors occurred. Please check the logs.`	Tindakan berhasil.
`Groups list fetch was not successful.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Groups list was fetched successfully.

Some errors occurred. Please check the logs.

Tindakan berhasil.

Groups list fetch was not successful.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Mencantumkan Anggota dalam Grup

Gunakan tindakan List Members in the Group untuk mencantumkan anggota dalam grup Microsoft Entra ID yang ditentukan.

Logika pemfilteran berfungsi berdasarkan nilai parameter Filter Key.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan List Members in the Group memerlukan parameter berikut:

Parameter	Deskripsi
`Max Records To Return`	Opsional Jumlah maksimum data yang akan ditampilkan. Nilai defaultnya adalah 50.
`Group Name`	Opsional Nama grup Microsoft Entra ID untuk mencantumkan anggota.
`Group ID`	Opsional ID grup Microsoft Entra ID untuk mencantumkan anggota. Jika Anda mengonfigurasi parameter `Group Name` dan `Group ID`, tindakan akan menggunakan parameter value `Group ID`.
`Filter Key`	Opsional Kolom untuk memfilter anggota grup, seperti `User Display Name`. Kemungkinan nilainya adalah sebagai berikut: `Select One` `User Display Name` `User Principal Name` `User Mail Name`
`Filter Logic`	Opsional Logika yang akan diterapkan ke filter. Kemungkinan nilainya adalah sebagai berikut: `Not Specified` `Equal` `Contains`
`Filter Value`	Opsional Nilai yang akan digunakan untuk memfilter anggota grup berdasarkan nilai parameter `Filter Key` dan `Filter Logic` yang dipilih. Jika Anda memilih `Equal`, tindakan akan mencoba menemukan kecocokan persis di antara hasil. Jika Anda memilih `Contain`, tindakan akan mencoba menemukan hasil yang berisi substring yang diberikan. Jika Anda tidak menetapkan nilai, filter tidak akan diterapkan.

Output tindakan

Tindakan List Members in the Group 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 List Members in the Group dapat menampilkan tabel berikut di Google SecOps:

Nama tabel: Anggota grup yang tersedia

Kolom:

ID
Nama Utama Pengguna
Display Name
Nama belakang
Nama Depan
Email
Jabatan
Telepon Bisnis
Nomor Ponsel
Lokasi Kantor
Bahasa Pilihan

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan List Members in the Group:

[
  {
    "@odata.type": "#microsoft.graph.user",
    "id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
    "businessPhones": [],
    "displayName": "Alex T",
    "givenName": "Alex",
    "jobTitle": "Software Engineer",
    "mail": "alex.t@example.com",
    "mobilePhone": null,
    "officeLocation": "Building A",
    "preferredLanguage": "en-US",
    "surname": "T",
    "userPrincipalName": "alex.t@example.com"
  }
]

Pesan output

Tindakan List Members in the Group dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`Successfully found members for the provided criteria in Azure AD group.` `No members were found for the provided criteria in Azure AD group.` `The filter was not applied, because parameter "Filter Value" has an empty value.`	Tindakan berhasil.
`Error executing action "List Members in the Group". Reason: ERROR_REASON`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Successfully found members for the provided criteria in Azure AD group.

No members were found for the provided criteria in Azure AD group.

The filter was not applied, because parameter "Filter Value" has an empty value.

Tindakan berhasil.

Error executing action "List Members in the Group". Reason:
      ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Mencantumkan Keanggotaan Grup Pengguna

Gunakan tindakan List User's Groups Membership untuk mencantumkan grup Microsoft Entra ID tempat pengguna menjadi anggota.

Anda dapat memberikan nama pengguna sebagai entity atau parameter input tindakan. Jika Anda mengonfigurasi nama pengguna sebagai entity dan parameter input, tindakan akan menggunakan parameter input.

Untuk mengonfigurasi nama pengguna, ikuti format username@domain.

Tindakan ini berjalan di entity Username Google SecOps.

Input tindakan

Tindakan Mencantumkan Keanggotaan Grup Pengguna memerlukan parameter berikut:

Parameter	Deskripsi
`User Name`	Opsional Daftar nama pengguna yang dipisahkan koma untuk mengambil keanggotaan grup, seperti `username@domain`. Jika Anda tidak menetapkan nilai, tindakan akan menggunakan ID pengguna dari entity `Username`.
`Return Only Security Enabled Groups`	Opsional Jika dipilih, tindakan ini hanya akan menampilkan grup yang mendukung keamanan tempat pengguna berada. Tidak dipilih secara default.
`Return Detailed Groups Information`	Opsional Jika dipilih, tindakan akan menampilkan informasi mendetail tentang grup Microsoft Entra ID. Tidak dipilih secara default.
`Filter Key`	Opsional Kunci yang akan digunakan untuk memfilter grup. Nilai defaultnya adalah `Select One`. Kemungkinan nilainya adalah sebagai berikut: `Select One` `Group Display Name` `Group Description`
`Filter Logic`	Opsional Logika yang akan diterapkan saat memfilter grup. Nilai defaultnya adalah `Not Specified`. Kemungkinan nilainya adalah sebagai berikut: `Not Specified` `Equal` `Contains`
`Filter Value`	Opsional Nilai yang akan digunakan untuk memfilter grup. Jika Anda memilih `Equal`, tindakan akan mencoba menemukan kecocokan persis di antara hasil. Jika Anda memilih `Contain`, tindakan akan mencoba menemukan hasil yang berisi substring yang diberikan. Jika Anda tidak menetapkan nilai, filter tidak akan diterapkan.
`Max Records To Return`	Opsional Jumlah maksimum data yang akan ditampilkan. Jika Anda tidak menetapkan nilai, tindakan akan menampilkan 50 data secara default.

Output tindakan

Tindakan Mencantumkan Keanggotaan Grup Pengguna 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 List User's Groups Membership dapat menampilkan tabel berikut di Google SecOps:

Nama tabel: Group Memberships

Kolom:

ID
Display Name
Deskripsi
Keamanan Diaktifkan
ID Keamanan
Created DateTime
Klasifikasi
Visibilitas
Email
Mail Enabled
Nama Email

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Mencantumkan Keanggotaan Grup Pengguna:

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(Edm.String)",
    "value": [
        "ID",
        "ID",
        "ID",
    ]
}

Pesan output

Tindakan Mencantumkan Keanggotaan Grup Pengguna dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`Successfully found groups for the provided criteria for the following entities: ENTITY_ID` `The following entities were not found in the Azure AD: ENTITY_ID` `No groups were found in Azure Active Directory for the following entities: ENTITY_ID` `The filter was not applied, because parameter "Filter Value" has an empty value.`	Tindakan berhasil.
`Error executing action "List User's Groups Membership". Reason: ERROR_REASON`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Successfully found groups for the provided criteria for the following entities: ENTITY_ID

The following entities were not found in the Azure AD: ENTITY_ID

No groups were found in Azure Active Directory for the following entities: ENTITY_ID

The filter was not applied, because parameter "Filter Value" has an empty value.

Tindakan berhasil.

Error executing action "List User's Groups Membership". Reason:
      ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Mencantumkan Keanggotaan Grup Pengguna:

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Mencantumkan Pengguna

Gunakan tindakan List Users untuk mencantumkan pengguna Microsoft Entra ID menggunakan kriteria penelusuran yang ditentukan.

Untuk tindakan List Users, pemfilteran berfungsi dengan kolom Username (userPrincipalName).

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan List Users memerlukan parameter berikut:

Parameter	Deskripsi
`Filter`	Opsional Kolom yang akan disertakan dalam hasil. Nilai defaultnya adalah `All Fields`. Kemungkinan nilainya adalah sebagai berikut: `All Fields` `displayName` `userPrincipalName` `id` `jobTitle` `mail` `mobilePhone` `preferredLanguage` `surname` `givenName`
`Order By Field`	Opsional Kolom untuk mengurutkan hasil. Nilai defaultnya adalah `displayName`. Kemungkinan nilainya adalah sebagai berikut: `displayName` `userPrincipalName`
`Order By`	Opsional Urutan hasil (menaik atau menurun). Nilai defaultnya adalah `ASC`. Kemungkinan nilainya adalah sebagai berikut: `DESC` `ASC`
`Results Limit`	Opsional Jumlah maksimum pengguna yang akan ditampilkan.
`Advanced Filter Logic`	Opsional Logika yang akan digunakan untuk pemfilteran lanjutan yang berlaku untuk kolom `Username` (`userPrincipalName`). Nilai defaultnya adalah `Equal`. Kemungkinan nilainya adalah sebagai berikut: `Equal` `Contains`
`Advanced Filter Value`	Opsional Nilai yang akan digunakan dalam filter lanjutan untuk kolom `Username` (`userPrincipalName`). Jika Anda memilih `Equal`, tindakan akan mencoba menemukan kecocokan persis di antara hasil. Jika Anda memilih `Contain`, tindakan akan mencoba menemukan hasil yang berisi substring yang diberikan. Jika Anda tidak menetapkan nilai, filter tidak akan diterapkan.

Output tindakan

Tindakan List Users 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 List Users dapat menampilkan tabel berikut di Google SecOps:

Nama tabel: Users

Kolom:

Nama
Username
ID
Nama depan
Bahasa pilihan
Email
Nomor Ponsel
Nama belakang
Jabatan

Tabel pengayaan entitas

Tindakan List Users mendukung pengayaan entity berikut:

Kolom pengayaan	Logika
`Username`	Menampilkan jika ada dalam hasil JSON.
`Surname`	Menampilkan jika ada dalam hasil JSON.
`Name`	Menampilkan jika ada dalam hasil JSON.
`Job Title`	Menampilkan jika ada dalam hasil JSON.
`Mail`	Menampilkan jika ada dalam hasil JSON.

Hasil JSON

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

[
    {
        "Group Type": "managed",
        "Id": "ID",
        "Name": "Example",
        "Description": "Example",
        "Created Time":"2019-10-24T19:10:18Z"
    }
]

Pesan output

Tindakan List Users dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`List of users was fetched successfully.` `Some errors occurred. Please check the logs.`	Tindakan berhasil.
`User list fetch was not successful.`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

List of users was fetched successfully.

Some errors occurred. Please check the logs.

Tindakan berhasil.

User list fetch was not successful.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Ping

Gunakan tindakan Ping untuk menguji konektivitas ke Microsoft Entra ID.

Tindakan ini berjalan di semua 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

Connection established successfully.

Tindakan berhasil.

Connection could not be established successfully.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Menghapus Pengguna dari Grup

Gunakan tindakan Remove User from the Group untuk menghapus pengguna dari grup yang ditentukan di Microsoft Entra ID.

Anda dapat memberikan nama pengguna sebagai entity atau parameter input tindakan. Jika Anda mengonfigurasi nama pengguna sebagai entity dan parameter input, tindakan akan menggunakan parameter input.

Untuk mengonfigurasi nama pengguna, ikuti format username@domain.

Tindakan ini berjalan di entity Username Google SecOps.

Input tindakan

Tindakan Remove User from the Group memerlukan parameter berikut:

Parameter Deskripsi

User Name

Opsional

String nama pengguna yang dipisahkan koma untuk dihapus dari grup yang ditentukan. Untuk mengonfigurasi nilai parameter ini, gunakan format username@domain.

Jika Anda tidak menetapkan nilai, tindakan akan dijalankan pada nama pengguna entity pengguna dari insiden tindakan.

Group Name

Opsional

Nama grup tempat pengguna akan dihapus.

Group ID

Opsional

ID grup tempat pengguna akan dihapus.

Jika Anda menetapkan parameter Group Name dan Group ID, tindakan akan memprioritaskan nilai Group ID.

Output tindakan

Tindakan Remove User from the 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 the Group dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully removed the following entities from the Azure AD group: ENTITY_ID

The following entities were not found in the Azure AD: ENTITY_ID

No usernames were removed from the Azure AD group.

Tindakan berhasil.

Error executing action "Remove User from the Group". Reason:
      ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Mereset Sandi Pengguna

Gunakan tindakan Reset User Password untuk mereset sandi pengguna ke sandi yang Anda tentukan dalam tindakan. Tindakan ini mengharuskan pengguna mengubah sandinya pada upaya login berikutnya.

Tindakan Reset User Password mengharuskan Anda mengonfigurasi entitas User dalam format username@domain.

Tindakan ini berjalan di entity User Google SecOps.

Menetapkan peran ke aplikasi Anda

Tindakan Reset User Password mengharuskan Anda menetapkan peran Password Administrator ke aplikasi Anda.

Untuk menetapkan peran Password Administrator ke aplikasi Anda, selesaikan langkah-langkah berikut:

Login ke portal Azure menggunakan akun Microsoft Anda.
Di Microsoft Entra ID, telusuri Roles and administrators.
Pilih atau telusuri peran Password Administrator dari daftar.
Klik Add Assignment.
Pilih akun (anggota) yang Anda gunakan dalam integrasi, lalu klik Berikutnya.
Masukkan justifikasi untuk menetapkan peran.
Klik Tetapkan.

Input tindakan

Tindakan Reset User Password memerlukan parameter berikut:

Parameter	Deskripsi
`Password`	Wajib Sandi baru yang akan ditetapkan untuk pengguna.

Output tindakan

Tindakan Reset 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 Reset User Password dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

User password was reset successfully.

Some errors occurred. Please check the logs.

Tindakan berhasil.

User password reset was not successful.

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

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

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

Mencabut Sesi Pengguna

Gunakan tindakan Cabut Sesi Pengguna untuk mencabut sesi pengguna.

Tindakan ini berjalan di entity Google SecOps berikut:

Username
Email Address

Input tindakan

Tidak ada.

Output tindakan

Tindakan Cabut Sesi 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	Tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Cabut Sesi Pengguna:

Jika pengguna ada:

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Edm.Boolean",
    "value": true
}

Jika pengguna tidak ditemukan:
```
{
    "error": "User not found."
}
```

Pesan output

Tindakan Cabut Sesi Pengguna dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully revoked sessions for the following users in Azure AD: ENTITY_ID

Action wasn't able to find the following users in Azure AD: ENTITY_ID

None of the provided users were found in Azure AD.

Tindakan berhasil.

Error executing action "Revoke User Session". Reason:
      ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Cabut Sesi Pengguna:

Nama hasil skrip	Nilai
`is_success`	`True` atau `False`

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