Mengintegrasikan Akamai dengan Google SecOps
Dokumen ini menjelaskan cara mengintegrasikan Akamai dengan Google Security Operations (Google SecOps).
Versi integrasi: 1.0
Parameter integrasi
Integrasi Akamai memerlukan parameter berikut:
Parameter | Deskripsi |
---|---|
Host |
Wajib. Nama host instance Akamai. |
Client Token |
Wajib. Token Klien Akamai Anda. |
Client Secret |
Wajib. Rahasia Klien Akamai Anda. |
Access Token |
Wajib. Token akses Akamai Anda. |
Verify SSL |
Wajib. Memvalidasi sertifikat SSL saat terhubung ke Akamai. Dipilih secara default. |
Tindakan
Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan tertunda dari Workdesk Anda dan Melakukan tindakan manual.
Ping
Gunakan tindakan Ping untuk menguji konektivitas ke Akamai.
Tindakan ini tidak berjalan di entity Google SecOps dan tidak memiliki parameter input.
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 |
Hasil skrip | Tersedia |
Pesan output
Tindakan Ping memberikan pesan output berikut:
Pesan output | Deskripsi pesan |
---|---|
Successfully connected to the Akamai server with the provided
connection parameters! |
Tindakan berhasil. |
Failed to connect to the Akamai server! Error is
{0}".format(exception.stacktrace) |
Tindakan gagal. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Ping:
Nama hasil skrip | Nilai |
---|---|
is_success |
True atau False |
Mendapatkan Daftar Jaringan
Gunakan tindakan Get Network Lists untuk mendapatkan informasi tentang daftar jaringan di Akamai.
Input tindakan
Tindakan Get Network Lists memerlukan parameter berikut:
Parameter | Deskripsi |
---|---|
Network List Name |
Opsional. Daftar nama daftar jaringan yang dipisahkan koma untuk ditelusuri. |
Network List ID |
Opsional. Daftar ID daftar jaringan yang dipisahkan koma untuk ditelusuri. |
Include Items |
Opsional. Menampilkan informasi tentang item di dalam daftar jaringan. Nilai defaultnya adalah |
Include Activation Status |
Opsional. Menampilkan status aktivasi untuk setiap daftar jaringan. Nilai defaultnya adalah Catatan: Informasi ini hanya ditampilkan jika |
Activation Environment |
Opsional. Lingkungan yang status aktivasinya ditampilkan. Nilai yang mungkin adalah sebagai berikut:
Catatan: Informasi ini hanya ditampilkan jika |
Max Network Lists To Return |
Wajib. Jumlah maksimum daftar jaringan yang akan ditampilkan. Nilai default dan maksimumnya adalah |
Max Network List Items To Return |
Wajib. Jumlah maksimum item yang akan ditampilkan per daftar jaringan. Nilai default dan maksimumnya adalah |
Output tindakan
Tindakan Get Network Lists 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 |
Hasil skrip | Tersedia |
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Get Network Lists:
[
{
"networkListType": "networkListResponse",
"accessControlGroup": "KSD\nwith ION 3-13H1234",
"name": "General List",
"elementCount": 3011,
"readOnly": false,
"shared": false,
"syncPoint": 22,
"type": "IP",
"uniqueId": "25614_GENERALLIST",
"links": {
"activateInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
"method": "POST"
},
"activateInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
"method": "POST"
},
"appendItems": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "POST"
},
"retrieve": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"update": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
}
},
"Activation_STAGING": {
"activationId": 12345,
"activationComments": "Allow IPs of new employees who joined this week",
"activationStatus": "PENDING_ACTIVATION",
"syncPoint": 5,
"uniqueId": "25614_GENERALLIST",
"fast": false,
"dispatchCount": 1,
"links": {
"appendItems": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
"method": "POST"
},
"retrieve": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"syncPointHistory": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
},
"update": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
},
"activationDetails": {
"href": "/network-list/v2/network-lists/activations/12345/"
}
}
},
"Activation_PRODUCTION": {
"activationId": 12345,
"activationComments": "Allow IPs of new employees who joined this week",
"activationStatus": "PENDING_ACTIVATION",
"syncPoint": 5,
"uniqueId": "25614_GENERALLIST",
"fast": false,
"dispatchCount": 1,
"links": {
"appendItems": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
"method": "POST"
},
"retrieve": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"syncPointHistory": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
},
"update": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
},
"activationDetails": {
"href": "/network-list/v2/network-lists/activations/12345/"
}
}
}
}
]
Pesan output
Tindakan Get Network Lists memberikan pesan output berikut:
Pesan output | Deskripsi pesan |
---|---|
|
Tindakan berhasil. |
Error executing action "Get Network Lists". Reason: {0}''.format
(error.Stacktrace)
|
Tindakan gagal. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Get Network Lists:
Nama hasil skrip | Nilai |
---|---|
is_success |
True atau False |
Menambahkan Item Ke Daftar Jaringan
Gunakan tindakan Tambahkan Item ke Daftar Jaringan untuk menambahkan item ke daftar jaringan di Akamai.
Input tindakan
Tindakan Tambahkan Item ke Daftar Jaringan memerlukan parameter berikut:
Parameter | Deskripsi |
---|---|
Network List Name |
Opsional. Nama daftar jaringan yang akan diupdate. Jika |
Network List ID |
Opsional. ID daftar jaringan yang akan diperbarui. Jika |
Items |
Wajib. Daftar item yang dipisahkan koma untuk ditambahkan ke daftar jaringan. |
Output tindakan
Tindakan Tambahkan Item Ke Daftar Jaringan 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 |
Hasil skrip | Tersedia |
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Tambahkan Item Ke Daftar Jaringan:
{
"networkListType": "networkListResponse",
"accessControlGroup": "KSD\nwith ION 3-13H1234",
"name": "General List",
"elementCount": 3011,
"readOnly": false,
"shared": false,
"syncPoint": 22,
"type": "IP",
"uniqueId": "25614_GENERALLIST",
"links": {
"activateInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
"method": "POST"
},
"activateInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
"method": "POST"
},
"appendItems": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "POST"
},
"retrieve": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"update": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
}
}
}
Pesan output
Tindakan Tambahkan Item Ke Daftar Jaringan memberikan pesan output berikut:
Pesan output | Deskripsi pesan |
---|---|
Successfully updated network list in Akamai. |
Tindakan berhasil. |
|
Tindakan gagal. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Tambahkan Item Ke Daftar Jaringan:
Nama hasil skrip | Nilai |
---|---|
is_success |
True atau False |
Menghapus Item dari Daftar Jaringan
Gunakan tindakan Remove Items From Network List untuk menghapus item dari daftar jaringan di Akamai.
Input tindakan
Tindakan Remove Items From Network List memerlukan parameter berikut:
Parameter | Deskripsi |
---|---|
Network List Name |
Opsional. Nama daftar jaringan yang akan diupdate. Jika |
Network List ID |
Opsional. ID daftar jaringan yang akan diperbarui. Jika |
Items |
Wajib. Daftar item yang dipisahkan koma untuk dihapus dari daftar jaringan. |
Output tindakan
Tindakan Hapus Item dari Daftar Jaringan 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 |
Hasil skrip | Tersedia |
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Hapus Item dari Daftar Jaringan:
{
"networkListType": "networkListResponse",
"accessControlGroup": "KSD\nwith ION 3-13H1234",
"name": "General List",
"elementCount": 3011,
"readOnly": false,
"shared": false,
"syncPoint": 22,
"type": "IP",
"uniqueId": "25614_GENERALLIST",
"links": {
"activateInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
"method": "POST"
},
"activateInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
"method": "POST"
},
"appendItems": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "POST"
},
"retrieve": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"update": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
}
}
}
Pesan output
Tindakan Remove Items From Network List memberikan pesan output berikut:
Pesan output | Deskripsi pesan |
---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Hapus Item dari Daftar Jaringan:
Nama hasil skrip | Nilai |
---|---|
is_success |
True atau False |
Daftar Jaringan Aktif
Gunakan tindakan Activate Network List untuk menghapus item dari daftar jaringan di Akamai.
Input tindakan
Tindakan Activate Network List memerlukan parameter berikut:
Parameter | Deskripsi |
---|---|
Network List Name |
Opsional. Nama daftar jaringan yang akan diupdate. Jika |
Network List ID |
Opsional. ID daftar jaringan yang akan diperbarui. Jika |
Environment |
Opsional. Lingkungan target untuk aktivasi. Nilai yang mungkin adalah sebagai berikut:
|
Comment |
Opsional. Komentar yang menjelaskan tujuan aktivasi. |
Notification Recipients |
Opsional. Daftar alamat email yang dipisahkan koma untuk diberi tahu tentang aktivasi daftar jaringan. |
Output tindakan
Tindakan Activate Network List 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 |
Hasil skrip | Tersedia |
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Activate Network Lists:
{
"activationId": 12345,
"activationComments": "Allow IPs of new employees who joined this week",
"activationStatus": "PENDING_ACTIVATION",
"syncPoint": 5,
"uniqueId": "25614_GENERALLIST",
"fast": false,
"dispatchCount": 1,
"links": {
"appendItems": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
"method": "POST"
},
"retrieve": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"syncPointHistory": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
},
"update": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
},
"activationDetails": {
"href": "/network-list/v2/network-lists/activations/12345/"
}
}
}
Pesan output
Tindakan Activate Network List memberikan pesan output berikut:
Pesan output | Deskripsi pesan |
---|---|
Successfully activated the network list in Akamai. |
Tindakan berhasil. |
|
Tindakan gagal. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Activate Network List:
Nama hasil skrip | Nilai |
---|---|
is_success |
True atau False |
Mendapatkan Daftar Klien
Gunakan tindakan Get Client Lists untuk mendapatkan informasi tentang daftar klien di Akamai.
Input tindakan
Tindakan Get Client Lists memerlukan parameter berikut:
Parameter | Deskripsi |
---|---|
Client List Name |
Opsional. Daftar nama daftar klien yang dipisahkan koma untuk ditelusuri. |
Client List ID |
Opsional. Daftar ID daftar klien yang dipisahkan koma untuk ditelusuri. |
Include Items |
Opsional. Menampilkan informasi tentang item di dalam daftar klien. Nilai defaultnya adalah Catatan: Informasi ini hanya ditampilkan jika |
Type |
Opsional. Jenis daftar klien yang akan ditelusuri. Nilai yang mungkin adalah sebagai berikut:
ASN TLS Fingerprint File Hash Catatan: Jika |
Max Client Lists To Return |
Wajib. Jumlah maksimum daftar klien yang akan ditampilkan. Nilai default dan maksimumnya adalah |
Max Client List Items To Return |
Wajib. Jumlah maksimum item yang akan ditampilkan per daftar klien. Nilai default dan maksimumnya adalah |
Output tindakan
Tindakan Dapatkan Daftar Klien 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 |
Hasil skrip | Tersedia |
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Get Client Lists:
[
{
"contractId": "K-0N7RAK71",
"createDate": "2023-04-05T18:20:42.090+00:00",
"createdBy": "jsmith",
"deprecated": false,
"groupId": 32145,
"groupName": "Acme IT Group",
"items": [
{
"createDate": "2023-04-05T18:20:42.892+00:00",
"createdBy": "jkowalski",
"description": "Canada - North America",
"expirationDate": "2023-12-31T23:59:19.700+00:00",
"productionStatus": "INACTIVE",
"stagingStatus": "INACTIVE",
"tags": [
"allowlist1"
],
"type": "GEO",
"updateDate": "2023-04-05T18:20:42.892+00:00",
"updatedBy": "mrossi",
"value": "CA"
}
],
"itemsCount": 3,
"listId": "1234_NORTHAMERICAGEOALLOWLIST",
"listType": "CL",
"name": "NorthAmericaGeoAllowlist",
"notes": "GEO code allowlist",
"productionActivationStatus": "INACTIVE",
"readOnly": false,
"shared": false,
"stagingActivationStatus": "INACTIVE",
"tags": [
"allowlist2"
],
"type": "GEO",
"updateDate": "2023-04-05T18:20:42.090+00:00",
"updatedBy": "jdupont",
"version": 1
}
]
Pesan output
Tindakan Get Client Lists memberikan pesan output berikut:
Pesan output | Deskripsi pesan |
---|---|
|
Tindakan berhasil. |
Error executing action "Get Client Lists". Reason: {0}''.format
(error.Stacktrace) |
Tindakan gagal. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Get Client Lists:
Nama hasil skrip | Nilai |
---|---|
is_success |
True atau False |
Menambahkan Item ke Daftar Klien
Gunakan tindakan Tambahkan Item Ke Daftar Klien untuk menambahkan item ke daftar klien di Akamai.
Input tindakan
Tindakan Add Items To Client List memerlukan parameter berikut:
Parameter | Deskripsi |
---|---|
Client List Name |
Opsional. Nama daftar klien yang akan diupdate. Catatan: Jika |
Client List ID |
Opsional. ID daftar klien yang akan diperbarui. Catatan: Jika |
Item Value |
Wajib. Daftar item yang dipisahkan koma untuk ditambahkan ke daftar klien. |
Item Description |
Opsional. Deskripsi untuk item yang ditambahkan ke daftar klien. |
Item Expiration Date |
Opsional. Tanggal habis masa berlaku untuk item yang ditambahkan, dalam format ISO 8601. |
Item Tags |
Opsional. Daftar tag yang dipisahkan koma untuk dikaitkan dengan item yang ditambahkan. |
Output tindakan
Tindakan Tambahkan Item Ke Daftar Klien 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 |
Hasil skrip | Tersedia |
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Tambahkan Item Ke Daftar Klien:
[
{
"createDate": "2023-04-05T19:29:02.320+00:00",
"createdBy": "jkowalski",
"description": "Jamaica - North America",
"expirationDate": "2023-12-31T23:59:19.700+00:00",
"productionStatus": "INACTIVE",
"stagingStatus": "INACTIVE",
"tags": [
"allowlist2"
],
"type": "GEO",
"updateDate": "2023-04-05T19:29:02.320+00:00",
"updatedBy": "jdupont",
"value": "JM"
}
}
]
Pesan output
Tindakan Add Items To Client List memberikan pesan output berikut:
Pesan output | Deskripsi pesan |
---|---|
Successfully returned client lists from Akamai. |
Tindakan berhasil. |
|
Tindakan gagal. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Add Items To Client List:
Nama hasil skrip | Nilai |
---|---|
is_success |
True atau False |
Menghapus Item dari Daftar Klien
Gunakan tindakan Remove Items From Client List untuk menghapus item dari daftar klien di Akamai.
Input tindakan
Tindakan Hapus Item dari Daftar Klien memerlukan parameter berikut:
Parameter | Deskripsi |
---|---|
Client List Name |
Opsional. Nama daftar klien yang akan diupdate. Catatan: Jika |
Client List ID |
Opsional. ID daftar klien yang akan diperbarui. Catatan: Jika |
Item Value |
Wajib. Daftar item yang dipisahkan koma untuk dihapus dari daftar klien. |
Output tindakan
Tindakan Remove Items From Client List 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 |
Hasil skrip | Tersedia |
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Hapus Item Dari Daftar Klien:
[
{
"createDate": "2023-04-05T19:29:02.320+00:00",
"createdBy": "jkowalski",
"description": "Jamaica - North America",
"expirationDate": "2023-12-31T23:59:19.700+00:00",
"productionStatus": "INACTIVE",
"stagingStatus": "INACTIVE",
"tags": [
"allowlist2"
],
"type": "GEO",
"updateDate": "2023-04-05T19:29:02.320+00:00",
"updatedBy": "jdupont",
"value": "JM"
}
]
Pesan output
Tindakan Remove Items From Client List memberikan pesan output berikut:
Pesan output | Deskripsi pesan |
---|---|
|
Tindakan berhasil. |
|
Tindakan gagal. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Hapus Item dari Daftar Klien:
Nama hasil skrip | Nilai |
---|---|
is_success |
True atau False |
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.