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: Aktifkan, nonaktifkan, atau reset sandi pengguna secara otomatis berdasarkan pemberitahuan keamanan untuk mengurangi risiko.

  • Mengakhiri sesi aktif: Hapus semua sesi Okta aktif secara instan untuk akun yang disusupi guna mencegah akses tidak sah di seluruh aplikasi terintegrasi.

  • Mengotomatiskan penetapan peran: Tetapkan atau batalkan penetapan peran administratif secara dinamis kepada pengguna untuk mempertahankan prinsip hak istimewa terendah selama penyelidikan.

  • 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 Anda:

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

    • Token API: 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 Okta OAuth.

  • 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 menggunakan OAuth 2.0 untuk autentikasi, bukan token API.

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

Jika dinonaktifkan, Api Token bersifat wajib.
Client ID

Opsional.

ID unik untuk aplikasi Okta OAuth.

Jika Use Oauth Authentication diaktifkan, parameter ini wajib diisi.

Jika mengautentikasi 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 mengautentikasi 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 mengautentikasi 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 mengetahui petunjuk tentang cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Anda dapat melakukan perubahan di 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 tertunda dari Ruang Kerja Anda dan Melakukan tindakan manual.

Tambahkan Grup

Tambahkan grup.

Parameter

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan 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

Tetapkan 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 Jalankan Di Cakupan Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Run On

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 apakah ada dalam hasil JSON
Insight

T/A

Menghapus Sesi Pengguna Okta

Gunakan tindakan Hapus Sesi Pengguna Okta untuk mengakhiri semua sesi Okta aktif bagi pengguna tertentu di semua perangkat dan aplikasi terintegrasi.

Tindakan ini dijalankan pada 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 membatalkan sesi Penyedia Identitas (IdP) aktif untuk semua pengguna yang diidentifikasi dalam cakupan entitas, selain pengguna yang dicantumkan secara eksplisit dalam 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.
Dinonaktifkan Kotak centang Dicentang Apakah pengguna akan dinonaktifkan atau hanya ditangguhkan.
Kirim Email Jika Dinonaktifkan Kotak centang Dicentang Apakah akan mengirim email setelah menonaktifkan atau tidak.
Juga Jalankan Di Cakupan Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Run On

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 dinonaktifkan. Jika tidak: Salah
is_send_email_deactivate Jika True, pengguna 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.
Aktifkan Kotak centang Dicentang Apakah akan mengaktifkan pengguna atau hanya menghentikan penangguhan.
Kirim Email Jika Aktif Kotak centang Dicentang Apakah akan mengirim email setelah mengaktifkan atau tidak.
Juga Jalankan Di Cakupan Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Run On

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 Benar (True), pengguna diaktifkan. Jika tidak: Salah
is_send_email_reactivate Jika True, pengguna 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.
ID Kotak centang Dicentang Apakah nilai berupa ID atau nama.

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan 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 Jalankan Di Cakupan Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Run On

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 maksimum hasil yang akan ditampilkan.

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan 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 Jalankan Di Cakupan Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Run On

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

Mendapatkan 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 Jalankan Di Cakupan Kotak centang Dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Run On

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 apakah ada dalam hasil JSON
nama Menampilkan apakah 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 sebagian properti.
Telusuri String T/A Kueri penelusuran kustom untuk sebagian besar properti.
Batas String 200 Jumlah maksimum hasil yang akan ditampilkan.

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan 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 apakah ada dalam hasil JSON
nama Menampilkan apakah ada dalam hasil JSON
Insight

T/A

Ping

Uji Koneksi dengan Okta.

Parameter

T/A

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan 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 mengembalikan token untuk setiap pengguna.
Juga Jalankan Di Cakupan Kotak centang Tidak dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Run On

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 apakah 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.
Menambahkan 10 Karakter Acak Kotak centang Tidak dicentang Apakah akan menambahkan karakter tambahan ke setiap sandi pengguna atau tidak.
Juga Jalankan Di Cakupan Kotak centang Tidak dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Run On

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 apakah ada dalam hasil JSON
Insight

T/A

Mengirim 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 diberikan dalam format string dan mencakup 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 Jalankan Di Cakupan Kotak centang Tidak dicentang Apakah akan dijalankan pada entity serta input.

Kasus penggunaan

T/A

Run On

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 apakah ada dalam hasil JSON
Insight

T/A

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