Mengumpulkan log data Konteks Organisasi Microsoft Entra ID (sebelumnya Azure Active Directory)
Versi Parser: 12.0
Dokumen ini menjelaskan cara mengumpulkan data konteks organisasi Microsoft Entra ID (sebelumnya Azure Active Directory) dengan menyiapkan feed Google Security Operations menggunakan API Pihak Ketiga.
Konteks Organisasi Microsoft Entra ID menyediakan informasi direktori seperti pengguna, grup, dan perangkat dari tenant Microsoft Entra ID Anda. Data ini bukan data peristiwa atau log, melainkan snapshot berkala status direktori yang memperkaya jenis log lain di Google SecOps dengan konteks identitas.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- Akses istimewa ke portal Microsoft Azure
- Salah satu peran berikut untuk memberikan izin administrator:
- Global Administrator - dapat memberikan izin untuk izin apa pun, untuk API apa pun
- Privileged Role Administrator - dapat memberikan izin untuk izin apa pun, untuk API apa pun
Mengonfigurasi daftar IP yang diizinkan
Anda harus menambahkan rentang IP Google SecOps di setelan jaringan Microsoft Azure atau kebijakan Akses Bersyarat sebelum membuat feed. Hal ini penting jika sumber data menerapkan batasan berbasis IP. Jika feed menampilkan error 403, pastikan bahwa izin diaktifkan di sana. Untuk membatasi akses dengan rentang yang lebih sempit, buka tiket dukungan.
Untuk mengetahui informasi selengkapnya, lihat Daftar IP yang Diizinkan.
Mendapatkan rentang IP Google SecOps
- Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
- Klik Tambahkan Feed Berita Baru.
- Catat rentang IP yang ditampilkan di antarmuka pembuatan feed.
- Atau, ambil rentang IP secara terprogram menggunakan Feed Management API.
Mengonfigurasi akses bersyarat untuk workload identity (jika diperlukan)
Jika organisasi Anda menggunakan kebijakan akses bersyarat yang membatasi akses berdasarkan lokasi, lakukan hal berikut:
- Di Microsoft Entra admin center, buka Protection > Conditional Access > Named locations.
- Klik + Lokasi baru.
- Berikan detail konfigurasi berikut:
- Nama: Masukkan
Google SecOps IP Ranges. - Mark as trusted location: Opsional, berdasarkan kebijakan keamanan Anda.
- IP ranges: Tambahkan setiap rentang IP Google SecOps dalam notasi CIDR.
- Nama: Masukkan
- Klik Create.
- Buka Conditional Access > Policies.
- Untuk kebijakan apa pun yang berlaku pada workload identity, konfigurasikan pengecualian untuk lokasi bernama
Google SecOps IP Rangesatau akun utama layanan tertentu.
Mengonfigurasi pendaftaran aplikasi Microsoft Entra
Membuat pendaftaran aplikasi
- Login ke Microsoft Entra admin center atau Azure portal.
- Buka Identity > Applications > App registrations.
- Klik New registration.
- Berikan detail konfigurasi berikut:
- Name: Masukkan nama deskriptif (misalnya,
Google SecOps Entra ID Context Integration). - Jenis akun yang didukung: Pilih Akun di direktori organisasi ini saja (Single tenant).
- Redirect URI: Biarkan kosong (tidak diperlukan untuk autentikasi akun utama layanan).
- Name: Masukkan nama deskriptif (misalnya,
- Klik Daftar.
- Setelah pendaftaran, salin dan simpan nilai berikut:
- Application (client) ID
- Directory (tenant) ID
Mengonfigurasi izin API
Feed membaca direktori pengguna melalui endpoint List users Microsoft Graph, dengan pengelola setiap pengguna diperluas. Berikan izin aplikasi yang sesuai dengan opsi feed yang Anda aktifkan.
- Di pendaftaran aplikasi, buka API permissions.
- Klik Add a permission.
- Pilih Microsoft Graph > Application permissions.
- Telusuri dan pilih izin berikut:
- User.Read.All - Wajib. Membaca profil pengguna dan hubungan pengelola yang diserap feed.
- Group.Read.All - Hanya jika Anda menetapkan Retrieve groups ke True di feed. Membaca grup yang ditampilkan untuk keanggotaan setiap pengguna.
- Device.Read.All - Hanya jika Anda menetapkan Retrieve devices ke True di feed. Membaca perangkat yang terkait dengan setiap pengguna.
- Klik Add permissions.
- Klik Grant admin consent for Your Organization.
Pastikan kolom Status menampilkan Granted for Your Organization untuk semua izin.
Izin Jenis Jika diperlukan User.Read.All Aplikasi Selalu Group.Read.All Aplikasi Ambil grup adalah Benar Device.Read.All Aplikasi Retrieve devices adalah True
Membuat rahasia klien
- Di pendaftaran aplikasi, buka Certificates & secrets.
- Klik Rahasia klien baru.
Berikan detail konfigurasi berikut:
- Description: Masukkan nama deskriptif (misalnya,
Google SecOps Feed). - Berakhir: Pilih periode habis masa berlaku.
- Description: Masukkan nama deskriptif (misalnya,
Klik Tambahkan.
Segera salin Nilai rahasia klien.
Memverifikasi akses API sebelum Anda membuat feed
Pastikan pendaftaran aplikasi dapat memperoleh token akses dan membaca pengguna dari Microsoft Graph. Pengujian ini menggunakan kredensial dan endpoint yang sama dengan feed. Jalankan di shell yang memiliki curl dan jq, misalnya Cloud Shell.
Tetapkan tenant ID dan client ID, lalu masukkan rahasia klien saat diminta:
TENANT_ID="TENANT_ID" CLIENT_ID="CLIENT_ID" printf "Client secret: "; read -rs CLIENT_SECRET; echoGanti kode berikut:
TENANT_ID: ID Direktori (tenant) pendaftaran aplikasi.CLIENT_ID: ID Aplikasi (klien) pendaftaran aplikasi.
Pada prompt, tempel Nilai rahasia klien. Rahasia tidak ditampilkan dan tidak disimpan dalam histori shell.
Minta token akses:
TOKEN_RESPONSE=$(curl -sS "https://login.microsoftonline.com/${TENANT_ID}/oauth2/v2.0/token" \ --data-urlencode "grant_type=client_credentials" \ --data-urlencode "client_id=${CLIENT_ID}" \ --data-urlencode "client_secret=${CLIENT_SECRET}" \ --data-urlencode "scope=https://graph.microsoft.com/.default") echo "${TOKEN_RESPONSE}" | jq 'del(.access_token)' ACCESS_TOKEN=$(echo "${TOKEN_RESPONSE}" | jq -r '.access_token // empty')Permintaan token harus berupa HTTP POST dengan isi yang dienkode formulir.
--data-urlencodemengirimkannya dengan cara tersebut dan mengenkode karakter seperti+atau&dalam secret. Jika permintaan berhasil, output akan menampilkan"token_type": "Bearer". Jika gagal, output akan menampilkanerror_descriptiondengan kode errorAADSTS.Membaca satu pengguna dengan pengelolanya dari Microsoft Graph:
curl -sS -w "\nHTTP %{http_code}\n" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ "https://graph.microsoft.com/beta/users?\$top=1&\$expand=manager"Jika permintaan berhasil, output akan diakhiri dengan
HTTP 200dan arrayvalueakan berisi pengguna.
Memecahkan masalah error autentikasi
Jika permintaan token gagal, temukan kode AADSTS di error_description:
- AADSTS7000215 (rahasia klien tidak valid): Gunakan Nilai rahasia klien, bukan ID Rahasia. Jika Anda tidak lagi memiliki nilai tersebut, buat rahasia klien baru.
- AADSTS7000222 (rahasia klien sudah tidak berlaku): Buat rahasia klien baru dan perbarui Rahasia Klien OAuth di feed.
- AADSTS700016 (aplikasi tidak ditemukan di direktori): Client ID salah, atau tenant ID milik tenant lain. Bandingkan kedua nilai dengan halaman Overview pendaftaran aplikasi.
- AADSTS90002 (tenant tidak ditemukan): Tenant ID salah, atau endpoint autentikasi milik cloud lain.
- AADSTS900144 (isi permintaan harus berisi parameter): Permintaan bukan POST yang dienkode formulir atau tidak memiliki parameter. Jalankan perintah seperti yang ditunjukkan.
- AADSTS53003 (diblokir oleh Akses Bersyarat): Kebijakan Akses Bersyarat untuk Workload Identity memblokir aplikasi. Lihat Mengonfigurasi Akses Bersyarat untuk Workload Identity.
Jika permintaan Microsoft Graph gagal:
- HTTP 401: Permintaan tidak memiliki token akses yang valid. Periksa output permintaan token terlebih dahulu.
- HTTP 403: Izin admin untuk User.Read.All tidak diberikan. Berikan izin seperti yang dijelaskan dalam Mengonfigurasi izin API. Izin adalah bagian dari token, jadi minta token baru setelah Anda memberikan izin.
Jika pengujian berhasil, tetapi feed masih gagal diautentikasi, masukkan kembali Nilai rahasia klien di Rahasia Klien OAuth. Pastikan Tenant ID dan OAuth Client ID cocok dengan nilai yang Anda uji. Pastikan API Authentication Endpoint tidak memiliki awalan https:// dan tidak memiliki jalur.
Mengonfigurasi feed di Google SecOps untuk menyerap data konteks organisasi Microsoft Entra ID
Untuk mengonfigurasi feed, lakukan hal berikut:
- Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
- Klik Tambahkan Feed Berita Baru.
- Di halaman berikutnya, klik Konfigurasi satu feed.
- Di kolom Nama feed, masukkan nama untuk feed (misalnya,
Azure AD Organizational Context). - Pilih API pihak ketiga sebagai Jenis sumber.
- Pilih Azure AD Organizational Context sebagai Log type.
- Klik Berikutnya.
Tentukan nilai untuk parameter input berikut:
- OAuth Client ID: Masukkan Application (client) ID dari pendaftaran aplikasi.
- OAuth Client Secret: Masukkan nilai rahasia klien yang Anda salin sebelumnya.
- Tenant ID: Masukkan Directory (tenant) ID dari pendaftaran aplikasi dalam format UUID (misalnya,
0fc279f9-fe30-41be-97d3-abe1d7681418). - Ambil perangkat: Pilih apakah akan mengambil informasi perangkat dalam konteks pengguna. Tetapkan ke True untuk menyertakan data perangkat.
- Ambil grup: Pilih apakah akan mengambil informasi keanggotaan grup dalam konteks pengguna. Tetapkan ke True untuk menyertakan data grup.
API Full Path: URL endpoint API Microsoft Graph REST:
graph.microsoft.com/beta
API Authentication Endpoint: Microsoft Entra ID Authentication Endpoint:
login.microsoftonline.com
Advanced Options:
- Namespace aset: Namespace aset.
- Label penyerapan: Label yang akan diterapkan ke peristiwa dari feed ini.
Klik Berikutnya.
Tinjau konfigurasi feed berita baru Anda di layar Finalize, lalu klik Submit.
Endpoint regional
Untuk deployment Microsoft Entra ID di sovereign cloud, gunakan endpoint regional yang sesuai:
| Lingkungan Cloud | Jalur Lengkap API | Endpoint Autentikasi API |
|---|---|---|
| Global | graph.microsoft.com/beta |
login.microsoftonline.com |
| L4 Pemerintah AS | graph.microsoft.us/beta |
login.microsoftonline.us |
| US Government L5 (DOD) | dod-graph.microsoft.us/beta |
login.microsoftonline.us |
| China (21Vianet) | microsoftgraph.chinacloudapi.cn/beta |
login.chinacloudapi.cn |
Tabel pemetaan UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
extension_wfc_AccountType |
entity.labels.value |
Dipetakan secara langsung |
extension_wfc_AccountingUnitName |
entity.labels.value |
Dipetakan secara langsung |
extension_wfc_execDescription |
entity.labels.value |
Dipetakan secara langsung |
extension_wfc_groupDescription |
entity.labels.value |
Dipetakan secara langsung |
extension_wfc_orgDescription |
entity.labels.value |
Dipetakan secara langsung |
createdDateTime |
entity.user.attribute.creation_time |
Diurai sebagai RFC3339 |
sign_in_type |
entity.user.attribute.labels.key |
Dipetakan secara langsung |
assignedLicense.skuId |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
employeeType |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.usageLocation |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
externalUserState |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
gopher-manager.onPremisesImmutableId |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
mailNickname |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
onPremisesDistinguishedName |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
onPremisesDomainName |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
onPremisesExtensionAttributes.extensionAttribute4 |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
onPremisesImmutableId |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
onPremisesSamAccountName |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
refreshTokensValidFromDateTime |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
token_date_time |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
userPrincipalName |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
user_ou_data |
entity.user.attribute.labels.value |
Dipetakan secara langsung |
userType |
entity.user.attribute.roles.name |
Dipetakan secara langsung |
user_ou_data |
entity.user.attribute.roles.type |
Dipetakan: Admin → ADMINISTRATOR, Service Accounts → SERVICE_ACCOUNT |
department |
entity.user.department |
Digabung |
mail |
entity.user.email_addresses |
Digabung |
proxyAddress |
entity.user.email_addresses |
Dipetakan: smtp/SMTP → proxyAddress |
userPrincipalName |
entity.user.email_addresses |
Digabung |
employeeId |
entity.user.employee_id |
Diganti namanya/dipetakan |
extension_employeeNumber |
entity.user.employee_id |
Diganti namanya/dipetakan |
onPremisesDomainName |
entity.user.group_identifiers |
Digabung |
proxyAddress |
entity.user.group_identifiers |
Digabung |
sign_in_type_manager |
entity.user.managers.attribute.labels.key |
Dipetakan secara langsung |
temp |
entity.user.managers.attribute.labels.key |
Dipetakan: true → manager accountEnabled |
empmanager-src.sbuxCompanyCode |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxCostCenter |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxDirectorySync |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxEmployeeStatus |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxEmployeeType |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxFullName |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxFullNameAKA |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxFullNameAKAAlt |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxFullNameAlt |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxGivenNameAlt |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxGlobalID |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxJobNumber |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxKnownAs |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxKnownAsAlt |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxLocalMarket |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxLocalMarketEmployeeID |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxManagerImmutableID |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxManagerNumber |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxOnTLA |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxOrgAreaID |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxOrgDistrictID |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxOrgDivisionID |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxOrgRegionID |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxOrgShortName |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxOrgStoreID |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxOrgType |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxOrgUnit |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxSnAlt |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.sbuxSourceSystem |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
empmanager-src.userPrincipalName |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
manager_ou_data |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
temp |
entity.user.managers.attribute.labels.value |
Dipetakan secara langsung |
manager_user_type |
entity.user.managers.attribute.roles.name |
Dipetakan secara langsung |
manager_ou_data |
entity.user.managers.attribute.roles.type |
Dipetakan: Users → ADMINISTRATOR, Service Accounts → SERVICE_ACCOUNT |
empmanager-src.companyName |
entity.user.managers.company_name |
Diganti namanya/dipetakan |
empmanager-src.department |
entity.user.managers.department |
Digabung |
empProxyAddress |
entity.user.managers.email_addresses |
Dipetakan: smtp/SMTP → empProxyAddress |
empmanager-src.mail |
entity.user.managers.email_addresses |
Digabung |
principal_name |
entity.user.managers.email_addresses |
Digabung |
empmanager-src.employeeId |
entity.user.managers.employee_id |
Diganti namanya/dipetakan |
empmanager-src.extension_employeeNumber |
entity.user.managers.employee_id |
Diganti namanya/dipetakan |
empmanager-src.givenName |
entity.user.managers.first_name |
Diganti namanya/dipetakan |
empProxyAddress |
entity.user.managers.group_identifiers |
Digabung |
empmanager-src.surname |
entity.user.managers.last_name |
Diganti namanya/dipetakan |
empmanager-src.city |
entity.user.managers.personal_address.city |
Diganti namanya/dipetakan |
country_n_code |
entity.user.managers.personal_address.country_or_region |
Dipetakan secara langsung |
empmanager-src.streetAddress |
entity.user.managers.personal_address.name |
Diganti namanya/dipetakan |
empmanager-src.state |
entity.user.managers.personal_address.state |
Diganti namanya/dipetakan |
empmanager-src.businessPhones.0 |
entity.user.managers.phone_numbers |
Digabung |
empmanager-src.id |
entity.user.managers.product_object_id |
Diganti namanya/dipetakan |
empmanager-src.jobTitle |
entity.user.managers.title |
Diganti namanya/dipetakan |
empmanager-src.displayName |
entity.user.managers.user_display_name |
Diganti namanya/dipetakan |
empmanager-src.sAMAccountName |
entity.user.managers.userid |
Diganti namanya/dipetakan |
empmanager-src.onPremisesSecurityIdentifier |
entity.user.managers.windows_sid |
Diganti namanya/dipetakan |
country |
entity.user.personal_address.country_or_region |
Dipetakan secara langsung |
usageLocation |
entity.user.personal_address.country_or_region |
Dipetakan secara langsung |
phoneNumber |
entity.user.phone_numbers |
Digabung |
onPremisesSamAccountName |
entity.user.userid |
Diganti namanya/dipetakan |
sAMAccountName |
entity.user.userid |
Diganti namanya/dipetakan |
gopher-device-item.createdDateTime |
metadata.event_timestamp |
Diurai sebagai RFC3339 |
| T/A | entity.labels.key |
Konstanta: wfc_AccountType |
| T/A | entity.user.attribute.labels.key |
Konstanta: gopher-manager onPremisesImmutableId |
| T/A | entity.user.attribute.roles.type |
Konstanta: SERVICE_ACCOUNT |
| T/A | entity.user.managers.attribute.labels.key |
Konstanta: manager accountEnabled |
| T/A | entity.user.managers.attribute.roles.type |
Konstanta: SERVICE_ACCOUNT |
| T/A | entity.user.user_authentication_status |
Konstanta: ACTIVE |
| T/A | metadata.entity_type |
Konstanta: USER |
| T/A | metadata.event_metadata.log_type |
Konstanta: AZURE_AD_CONTEXT |
| T/A | metadata.product_name |
Konstanta: Azure Active Directory |
| T/A | metadata.vendor_name |
Konstanta: Microsoft |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.