Mengintegrasikan Okta dengan Google SecOps

Dokumen ini memberikan panduan tentang cara mengintegrasikan Okta dengan Google Security Operations.

Kasus penggunaan

Integrasi Okta menggunakan kemampuan Google SecOps untuk mendukung kasus penggunaan berikut:

  • Mengelola siklus proses pengguna: Mengaktifkan, menonaktifkan, atau mereset sandi secara otomatis untuk pengguna berdasarkan notifikasi keamanan guna mengurangi risiko.

  • Menghentikan sesi aktif: Segera hapus semua sesi Okta aktif untuk akun yang disusupi guna mencegah akses yang tidak sah di seluruh aplikasi terintegrasi.

  • Mengotomatiskan penetapan peran: Menetapkan atau membatalkan penetapan peran administratif kepada pengguna secara dinamis untuk mempertahankan prinsip hak istimewa terendah selama investigasi.

  • Menyinkronkan sinyal ancaman: Kirim sinyal Identity Threat Protection (ITP) ke Okta untuk membagikan konteks risiko dan memicu respons keamanan otomatis.

  • Memperkaya konteks identitas: Ambil profil pengguna dan keanggotaan grup yang mendetail untuk memberikan visibilitas mendalam kepada analis terkait aktivitas akun.

Sebelum memulai

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

  • Metode autentikasi: Tentukan apakah organisasi Anda menggunakan Token API (SSWS) atau OAuth 2.0 untuk autentikasi.

    • API token: Buat token SSWS. Untuk mengetahui detailnya, lihat dokumentasi token Okta API.
    • OAuth 2.0: Daftarkan aplikasi layanan untuk mendapatkan Client ID, Key ID, dan Private Key. Untuk mengetahui detailnya, lihat dokumentasi OAuth Okta.

  • Izin akun: Pastikan akun memiliki izin yang memadai untuk melakukan tindakan pengelolaan pengguna dan penghentian sesi.

Parameter integrasi

Integrasi Okta memerlukan parameter berikut:

Parameter Deskripsi
Api Root

Wajib.

URL dasar instance Okta Anda, yang digunakan untuk mengakses API.

Nilai defaultnya adalah https://{okta_domain}.com/.
Api Token

Opsional.

Token API (SSWS) yang digunakan untuk autentikasi dengan instance Okta.

Jika Use Oauth Authentication dinonaktifkan, parameter ini wajib diisi.
Use Oauth Authentication

Wajib.

Jika diaktifkan, integrasi akan menggunakan OAuth 2.0 untuk autentikasi, bukan token API.

Saat menggunakan OAuth, Client ID, Key ID, dan Private Key bersifat wajib, dan Api Token harus dikosongkan.

Jika dinonaktifkan, Api Token wajib diisi.
Client ID

Opsional.

ID unik untuk aplikasi Okta OAuth.

Jika Use Oauth Authentication diaktifkan, parameter ini wajib diisi.

Jika melakukan autentikasi menggunakan token API, kosongkan kolom ini.
Key ID

Opsional.

ID kunci publik yang terkait dengan kunci pribadi yang digunakan untuk autentikasi OAuth.

Jika Use Oauth Authentication diaktifkan, parameter ini wajib diisi.

Jika melakukan autentikasi menggunakan token API, kosongkan kolom ini.
Private Key

Opsional.

Kunci pribadi dalam format PEM yang digunakan untuk autentikasi OAuth.

Jika Use Oauth Authentication diaktifkan, parameter ini wajib diisi.

Jika melakukan autentikasi menggunakan token API, kosongkan kolom ini.
Verify SSL

Opsional.

Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server Okta.

Diaktifkan 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.

Tambahkan Grup

Tambahkan grup.

Parameter

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity

T/A

Insight

T/A

Tetapkan Peran

Menetapkan peran kepada pengguna.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID Pengguna String T/A ID pengguna di Okta.
Jenis Peran String T/A Jenis peran yang akan ditetapkan kepada pengguna.
Juga Berjalan di Scope Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Pengguna
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity
Nama Kolom Pengayaan Logika - Kapan harus diterapkan
Peran Menampilkan jika ada dalam hasil JSON
Insight

T/A

Menghapus Sesi Pengguna Okta

Gunakan tindakan Clear Okta User Session untuk menghentikan semua sesi Okta yang aktif bagi pengguna tertentu di semua perangkat dan aplikasi terintegrasi.

Tindakan ini berjalan di entity Username Google SecOps.

Input tindakan

Tindakan Clear Okta User Session memerlukan parameter berikut:

Parameter Deskripsi
User IDs Or Logins

Opsional.

Daftar ID pengguna atau ID login Okta yang dipisahkan koma.
Also Run On Scope

Opsional.

Jika dipilih, tindakan ini akan mencabut sesi Penyedia Identitas (IdP) aktif untuk semua pengguna yang diidentifikasi dalam cakupan entitas, selain yang tercantum secara eksplisit di User IDs Or Logins.

Output tindakan

Tindakan Clear Okta User Session 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 Clear Okta User Session dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully cleared sessions for the following users: ENTITY_IDS.

The sessions failed to clear for the following user in Okta: ENTITY_ID.

No users were found to clear sessions.

 Tindakan berhasil.
Error executing action "Clear Okta 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 Clear Okta User Session:

Nama hasil skrip Nilai
is_success true atau false

Nonaktifkan Pengguna

Menonaktifkan pengguna yang ditentukan.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID Pengguna Atau Login String T/A ID pengguna di Okta.
Is Deactivate Kotak centang Dicentang Apakah akan menonaktifkan atau hanya menangguhkan pengguna.
Kirim Email Jika Dinonaktifkan Kotak centang Dicentang Apakah akan mengirim email setelah penonaktifan atau tidak.
Juga Berjalan di Scope Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Pengguna
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity
Nama Kolom Pengayaan Logika - Kapan harus diterapkan
is_deactivate Jika True, pengguna akan dinonaktifkan. Jika tidak: Salah
is_send_email_deactivate Jika True, pengguna akan dinonaktifkan. Jika tidak: Salah
Insight

T/A

Aktifkan Pengguna

Mengaktifkan pengguna yang ditentukan.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID Pengguna Atau Login String T/A ID atau login pengguna di Okta.
Is Activate Kotak centang Dicentang Apakah akan mengaktifkan pengguna atau hanya membatalkan penangguhan.
Kirim Email Jika Diaktifkan Kotak centang Dicentang Apakah akan mengirim email setelah aktivasi atau tidak.
Juga Berjalan di Scope Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Pengguna
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity
Nama Kolom Pengayaan Logika - Kapan harus diterapkan
is_reactivate Jika True, pengguna diaktifkan. Jika tidak: Salah
is_send_email_reactivate Jika True, pengguna akan dinonaktifkan. Jika tidak: Salah
Insight

T/A

Mendapatkan Grup

Mendapatkan informasi tentang grup.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID atau Nama Grup String T/A ID atau nama grup di Okta.
Is Id Kotak centang Dicentang Apakah nilai berupa ID atau nama.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity

T/A

Insight

T/A

Mendapatkan pengguna

Mendapatkan informasi tentang pengguna

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID Pengguna Atau Login String T/A ID atau login (email atau nama email singkat) pengguna di Okta, misalnya: test@gmail.com atau cukup 'test'.
Juga Berjalan di Scope Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Pengguna
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
[
  {
    "status": "ACTIVE",
    "profile": {
      "mobilePhone": null,
      "firstName": "Test",
      "lastName": "User",
      "secondEmail": null,
      "login": "test.user@asd.com",
      "email": "test.user@asd.com"
    },
    "passwordChanged": "2022-07-11T06:11:25.000Z",
    "created": "2022-07-11T06:07:55.000Z",
    "activated": null,
    "lastUpdated": "2022-07-11T06:11:25.000Z",
    "_links": {
      "schema": {
        "href": "https://trial-0000.okta.com/api/v1/meta/schemas/user/osc1xxxxxxxx"
      },
      "suspend": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx/lifecycle/suspend",
        "method": "POST"
      },
      "forgotPassword": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx/credentials/forgot_password",
        "method": "POST"
      },
      "self": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx"
      },
      "expirePassword": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx/lifecycle/expire_password",
        "method": "POST"
      },
      "resetFactors": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx/lifecycle/reset_factors",
        "method": "POST"
      },
      "deactivate": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx/lifecycle/deactivate",
        "method": "POST"
      },
      "changePassword": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx/credentials/change_password",
        "method": "POST"
      },
      "changeRecoveryQuestion": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx/credentials/change_recovery_question",
        "method": "POST"
      },
      "type": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx"
      },
      "resetPassword": {
        "href": "https://trial-0000.okta.com/api/v1/users/00u1xxxxxxxx/lifecycle/reset_password",
        "method": "POST"
      }
    },
    "lastLogin": "2022-07-11T06:15:14.000Z",
    "credentials": {
      "password": {},
      "provider": {
        "type": "OKTA",
        "name": "OKTA"
      }
    },
    "type": {
      "id": "oty1xxxxxxxxxxxxx"
    },
    "id": "oty1xxxxxxxxxxxxx",
    "statusChanged": "2022-07-11T06:11:25.000Z"
  }
]
Pengayaan Entity

T/A

Insight

T/A

Mencantumkan Penyedia

Mencantumkan penyedia identitas (IdP) di organisasi Anda.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
Kueri String T/A Telusuri properti nama untuk menemukan kecocokan.
Jenis Kotak centang Dicentang Filter menurut jenis.
Batas String 20 Jumlah hasil maksimum yang akan ditampilkan.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity

T/A

Insight

T/A

Mencantumkan Peran

Mencantumkan semua peran yang ditetapkan kepada pengguna.

Parameter

ID Pengguna String T/A ID pengguna di Okta.
Juga Berjalan di Scope Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Pengguna
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity

T/A

Insight

T/A

Mencantumkan Grup Pengguna

Dapatkan grup tempat pengguna menjadi anggota.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID Pengguna Atau Login String T/A ID atau login pengguna di Okta.
Juga Berjalan di Scope Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Pengguna
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity
Nama Kolom Pengayaan Logika - Kapan harus diterapkan
profil Menampilkan jika ada dalam hasil JSON
nama Menampilkan jika ada dalam hasil JSON
Insight

T/A

Mencantumkan Pengguna

Dapatkan daftar pengguna.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
Kueri String T/A Telusuri kecocokan di nama depan, nama belakang, atau di email.
Filter String T/A Kueri penelusuran kustom untuk subset properti.
Telusuri String T/A Kueri penelusuran kustom untuk sebagian besar properti.
Batas String 200 Jumlah hasil maksimum yang akan ditampilkan.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity
Nama Kolom Pengayaan Logika - Kapan harus diterapkan
profil Menampilkan jika ada dalam hasil JSON
nama Menampilkan jika ada dalam hasil JSON
Insight

T/A

Ping

Uji Koneksi dengan Okta.

Parameter

T/A

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity

T/A

Insight

T/A

Reset Sandi

Buat token sekali pakai yang dapat digunakan untuk mereset sandi pengguna.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID Pengguna Atau Login String T/A ID atau login pengguna di Okta.
Kirim Email Kotak centang Tidak dicentang Apakah akan mengirim email untuk reset sandi atau menampilkan token untuk setiap pengguna.
Juga Berjalan di Scope Kotak centang Tidak dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Pengguna
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity
Nama Kolom Pengayaan Logika - Kapan harus diterapkan
send_email Menampilkan jika ada dalam hasil JSON
Insight

T/A

Tetapkan Sandi

Menetapkan sandi pengguna tanpa memvalidasi kredensial yang ada.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID Pengguna Atau Login String T/A ID atau login pengguna di Okta.
Sandi Baru String T/A Sandi baru.
Tambahkan 10 Karakter Acak Kotak centang Tidak dicentang Apakah akan menambahkan karakter tambahan ke setiap sandi pengguna atau tidak.
Juga Berjalan di Scope Kotak centang Tidak dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Pengguna
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity
Nama Kolom Pengayaan Logika - Kapan harus diterapkan
set_password Menampilkan jika ada dalam hasil JSON
Insight

T/A

Kirim Sinyal ITP

Mendistribusikan sinyal Identity Threat Protection (ITP) kepada konsumen yang relevan menggunakan Shared Signals Framework (SSF).

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID Kunci String T/A ID kunci publik yang digunakan untuk memverifikasi tanda tangan kunci pribadi.
String Kunci Pribadi Sandi T/A Kunci pribadi yang digunakan untuk menandatangani sinyal.

Kunci disediakan dalam format string dan menyertakan pernyataan "BEGIN" dan "END".
Email Pengguna Alamat Surat T/A Alamat email pengguna yang terpengaruh.
Stempel waktu timestamp T/A Stempel waktu terjadinya sinyal.

Format stempel waktu adalah ISO 8601.
Alasan String T/A Deskripsi singkat yang menjelaskan alasan sinyal dibuat.
Keparahan String atau DDL T/A Tingkat keparahan sinyal.
URL Penerbit URL T/A Sistem sumber yang membuat sinyal.

Hasil Tindakan

Hasil JSON
{
   "status":200,
   "payload":{
      "iss":"https://www.google.com/",
      "jti":"3c5fbf0c-3977-11f0-a195-7e498c84a3dd",
      "iat":1748184472,
      "aud":"https://<your-okta-domain>.oktapreview.com",
      "events":{
         "https://schemas.okta.com/secevent/okta/event-type/user-risk-change":{
            "subject":{
               "user":{
                  "format":"email",
                  "email":"user@domain.net"
               }
            },
            "current_level":"medium",
            "previous_level":"low",
            "reason_admin":{
               "en":"BadNavigationEvent"
            },
            "event_timestamp":1742199770057
         }
      }
   }
}
Pesan output
Pesan output Deskripsi pesan

Successfully sent the ITP signal to Okta.

Context value was not found for the provided context key CONTEXT_KEY and connector identifier CONNECTOR_IDENTIFIER.

Action can't return the Case Wall table as the context values are too big.

 Tindakan berhasil.
Failed to send the ITP signal to Okta. Error is {0}".format(exception.stacktrace)

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success True atau False

Cabut Penetapan Peran

Membatalkan penetapan peran dari pengguna.

Parameter

Nama Parameter Jenis Nilai Default Deskripsi
ID Pengguna String T/A ID pengguna di Okta.
ID atau Nama Peran String T/A ID atau nama peran di Okta.
Juga Berjalan di Scope Kotak centang Tidak dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Pengguna
  • Hostname

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ScriptResult T/A T/A
Hasil JSON
N/A
Pengayaan Entity
Nama Kolom Pengayaan Logika - Kapan harus diterapkan
unassign_role Menampilkan jika ada dalam hasil JSON
Insight

T/A

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