Mengintegrasikan Google Terjemahan dengan Google SecOps

Dokumen ini menjelaskan cara mengonfigurasi dan mengintegrasikan Google Terjemahan dengan Google Security Operations (Google SecOps).

Versi integrasi: 4.0

Sebelum memulai

Untuk menggunakan integrasi, Anda perlu membuat dan mengonfigurasi kunci API.

Buat kunci API

Untuk membuat kunci API, selesaikan langkah-langkah berikut:

  1. Di konsol Google Cloud , buka APIs & Services > Credentials.

    Buka Kredensial

  2. Klik add Create credentials.

  3. Pilih Kunci API untuk membuat kunci API baru. Dialog akan muncul dengan kunci API yang dibuat.

  4. Untuk menyalin kunci API, klik Salin.

Mengonfigurasi pembatasan kunci API

Untuk mengonfigurasi pembatasan API pada kunci API, selesaikan langkah-langkah berikut:

  1. Klik Restrict key.

  2. Di bagian Pembatasan API, pilih Batasi kunci.

  3. Pilih Cloud Translation API dari daftar API.

  4. Konfigurasi batasan yang berlaku.

  5. Klik Simpan untuk menyimpan konfigurasi kunci API.

Parameter integrasi

Integrasi Google Terjemahan memerlukan parameter berikut:

Parameter Deskripsi
API Root

Wajib.

Root API instance Google Terjemahan.

Nilai defaultnya adalah https://translation.googleapis.com.

Untuk mengetahui informasi selengkapnya tentang Cloud Translation API, lihat Cloud Translation API.
API Key

Wajib.

Kunci API akun Google Translate.
Verify SSL

Wajib.

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

Dipilih secara default.

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

Anda dapat melakukan perubahan di tahap berikutnya, 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.

Daftar Bahasa

Gunakan tindakan List Languages untuk mencantumkan bahasa yang tersedia di Google Terjemahan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan List Languages memerlukan parameter berikut:

Parameter Deskripsi
Filter Key

Opsional.

Kunci untuk memfilter bahasa.

Kemungkinan nilainya adalah sebagai berikut:

  • Select One
  • Name

Nilai defaultnya adalah Select One.
Filter Logic

Opsional.

Logika filter yang akan diterapkan.

Logika pemfilteran menggunakan nilai yang Anda tetapkan dalam parameter Filter Key.

Kemungkinan nilainya adalah sebagai berikut:

  • Not Specified
  • Equal
  • Contains

Nilai defaultnya adalah Not Specified.
Filter Value

Opsional.

Nilai yang akan digunakan dalam filter.

Logika pemfilteran menggunakan nilai yang Anda tetapkan dalam parameter Filter Key.

Jika Equal dipilih, tindakan akan menelusuri kecocokan persis di antara hasil. Jika Contains dipilih, tindakan akan menelusuri hasil yang berisi substring yang ditentukan.

Jika Anda tidak memilih nilai, tindakan akan mengabaikan filter.

Logika pemfilteran berfungsi berdasarkan nilai yang diberikan dalam parameter Filter Key.
Max Records To Return

Opsional.

Jumlah maksimum data yang akan ditampilkan.

Nilai maksimumnya adalah 50.

Jika Anda tidak menetapkan nilai, tindakan akan menampilkan 50 data secara default.

Output tindakan

Tindakan List Languages 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 Languages dapat menghasilkan tabel berikut:

Nama tabel: Available Languages

Kolom tabel: Kunci Bahasa

Hasil JSON

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

{
    "data": {
        "languages": [
            {
                "language": "af"
            },
            {
                "language": "am"
            },
            {
                "language": "ar"
            }

        ]
    }
}
Pesan output

Tindakan List Languages dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully found language for the provided criteria in Google Translate.

No languages were found for the provided criteria in Google Translate.

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

 Tindakan berhasil.
Error executing action "List Languages". 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 List Languages:

Nama hasil skrip Nilai
is_success True atau False

Ping

Gunakan tindakan Ping untuk menguji konektivitas ke Google Terjemahan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Ping memberikan output berikut:

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

Tindakan Ping dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully connected to the Google Translate server with the provided connection parameters!

 Tindakan berhasil.
Failed to connect to the Google Translate server! Error is 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 Ping:

Nama hasil skrip Nilai
is_success True atau False

Menerjemahkan Teks

Gunakan tindakan Terjemahkan Teks untuk menerjemahkan teks dengan Google Terjemahan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Terjemahkan Teks memerlukan parameter berikut:

Parameter Deskripsi
Source Language

Opsional.

Bahasa sumber teks.

Jika Anda tidak mengonfigurasi parameter ini, tindakan akan mendeteksi bahasa secara otomatis.
Target Language

Wajib.

Bahasa target.

Nilai defaultnya adalah en.
Text

Wajib.

Teks yang akan diterjemahkan.

Output tindakan

Tindakan Terjemahkan Teks 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 Terjemahkan Teks:

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}
Pesan output

Tindakan Translate Text dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully translated the provided text in Google Translate.

 Tindakan berhasil.
Error executing action "Translate Text". 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 Terjemahkan Teks:

Nama hasil skrip Nilai
is_success True atau False

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