Web Application Firewall:CreateDefenseTemplate - Web Application Firewall - Alibaba Cloud - Web Application Firewall

Membuat templat perlindungan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

yundun-waf:CreateDefenseTemplate

create

*Semua Sumber daya.

*

acs:ResourceGroupId

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans WAF. Catatan Anda dapat memanggil DescribeInstance untuk mendapatkan ID instans WAF saat ini.	waf_cdnsdf3****
TemplateName	string	Yes	Nama templat perlindungan yang akan dibuat. Panjang nama harus 1 hingga 255 karakter dan dapat berisi karakter Tionghoa, huruf, angka, garis bawah (_), titik (.), dan tanda hubung (-). Catatan Nama templat harus unik dalam skenario perlindungan (DefenseScene) yang sama.	test221
TemplateType	string	Yes	Tipe templat perlindungan yang akan dibuat. Nilai valid: user_default: perlindungan default. user_custom: perlindungan kustom.	user_default
TemplateStatus	integer	Yes	Status templat perlindungan yang akan dibuat. Nilai valid: 0: Dinonaktifkan. 1: Diaktifkan.	1
DefenseScene	string	Yes	Skenario perlindungan. Untuk informasi lebih lanjut, lihat parameter DefenseScene di CreateDefenseRule.	waf_kelompok
TemplateOrigin	string	Yes	Sumber templat perlindungan yang akan dibuat. Atur nilai menjadi custom, yang menunjukkan didefinisikan oleh pengguna.	custom
DefenseSubScene	string	No	Sub-skenario templat perlindungan. Parameter ini hanya didukung untuk skenario Manajemen bot lanjutan. Valid values: app : templat skenario app. web : templat skenario web. bot_custom_acl : templat aturan kustom lanjutan.	web
Description	string	No	Deskripsi templat perlindungan yang akan dibuat.	test
RegionId	string	No	Informasi templat terperinci, yang berupa string berformat JSON. Pasangan kunci-nilai yang berbeda merepresentasikan atribut yang berbeda dari objek yang dilindungi. Untuk informasi lebih lanjut, lihat deskripsi Detail. Catatan Parameter ini hanya berlaku untuk skenario perlindungan versi baru perlindungan dasar (waf_base) dan versi baru Manajemen bot (bot_manager). Parameter ini wajib diisi untuk skenario perlindungan versi baru Manajemen bot (bot_manager).	{"trafficFeature":"{\"global\":0,\"excludeStatus\":1,\"conditions\":[{\"key\":\"URL\",\"opValue\":\"not-contain\",\"values\":\"test\"}]}"}
ResourceManagerResourceGroupId	string	No	Apakah akan mengaktifkan mode dry run. Jika Anda tidak menentukan parameter ini, permintaan normal akan dikirim. Nilai valid: true: Permintaan dry run dikirim. Sistem memeriksa apakah permintaan memenuhi kondisi eksekusi tanpa melakukan operasi yang ditentukan. Jika dry run gagal, kode kesalahan yang sesuai akan dikembalikan. Jika dry run berhasil, kode kesalahan Defense.Control.DryRunOperation akan dikembalikan. false: Permintaan normal dikirim. Operasi yang ditentukan akan dilakukan setelah permintaan lulus pemeriksaan.	false
UnbindResources	array	No	Wilayah tempat instans WAF berada. Nilai valid: cn-hangzhou: Tiongkok daratan. ap-southeast-1: di luar Tiongkok daratan.	cn-hangzhou
	string	No	Objek yang dilindungi yang akan dilepaskan.	abc
UnbindResourceGroups	array	No	ID kelompok sumber daya Alibaba Cloud.	rg-acfm***q
	string	No	Kelompok objek yang dilindungi yang akan dilepaskan.	kelompok1
		No	Objek yang dilindungi yang akan dilepaskan saat membuat templat perlindungan default. Gunakan format ["XX1","XX2",……]. Catatan Parameter ini hanya berlaku saat membuat templat default (saat TemplateType diatur ke user_default).
		No	Kelompok objek yang dilindungi yang akan dilepaskan saat membuat templat perlindungan default. Gunakan format ["group1","group2",……]. Catatan Parameter ini hanya berlaku saat membuat templat default (saat TemplateType diatur ke user_default).

Deskripsi parameter Detail

Konten parameter Detail bervariasi tergantung pada skenario perlindungan (DefenseScene) dari templat perlindungan.

Versi baru perlindungan inti Web (waf_base)

Deskripsi parameter

Nama	Tipe	Wajib	Contoh	Deskripsi
aiWhitelistStatus	integer	Tidak	1	Status mesin daftar putih cerdas untuk versi baru perlindungan dasar. Nilai valid: - 0 (default): Dinonaktifkan. - 1: Diaktifkan.

Contoh

{
  "aiWhitelistStatus": 1
}

Versi baru Manajemen bot (bot_manager)

Deskripsi parameter

Nama	Tipe	Wajib	Contoh	Deskripsi
trafficFeature	String	Tidak	{"global":1,"excludeStatus":1,"staticFile":".css,.js,.jpg,……"}	Pengaturan parameter Template perlindungan dari templat perlindungan Manajemen bot, yang dijelaskan dalam format string JSON. Parameter ini wajib diisi saat skenario perlindungan (DefenseScene) adalah bot_manager. Untuk informasi lebih lanjut, lihat pengaturan parameter terperinci trafficFeature.

Pengaturan parameter terperinci trafficFeature

Nama	Tipe	Wajib	Contoh	Deskripsi
global	Integer	Ya	1	Apakah Template perlindungan mencakup seluruh situs. Nilai valid: - 0: Template perlindungan kustom. Gunakan conditions untuk menentukan karakteristik lalu lintas yang berlaku. - 1: Perlindungan global. Templat berlaku untuk semua permintaan ke objek yang dilindungi.
excludeStatus	Integer	Tidak	1	Apakah akan mengecualikan sumber daya statis. Permintaan yang cocok dengan akhiran file statis yang ditentukan di staticFile tidak masuk ke perlindungan bot. Nilai valid: - 0: Sumber daya statis tidak dikecualikan. - 1: Sumber daya statis dikecualikan. Gunakan staticFile untuk menentukan akhiran file statis yang akan dikecualikan.
staticFile	String	Tidak	.7z,.aac,.css,.js,.jpg,.png,.pdf,.zip,……	Daftar akhiran file statis yang akan dikecualikan, direpresentasikan sebagai string yang dipisahkan koma (,). Setiap akhiran dimulai dengan titik (.). Konfigurasikan parameter ini hanya saat excludeStatus diatur ke 1.
conditions	Array	Tidak	[{"key":"URL","opValue":"not-contain","values":"test"}]	Karakteristik lalu lintas untuk Template perlindungan kustom, yang dijelaskan dalam format string JSON. Parameter ini hanya dapat dikonfigurasi saat global diatur ke 0. Untuk informasi lebih lanjut, lihat pengaturan parameter conditions di Pengaturan parameter aturan perlindungan.

Contoh

{
  "trafficFeature": "{\"global\":0,\"excludeStatus\":1,\"conditions\":[{\"key\":\"URL\",\"opValue\":\"not-contain\",\"values\":\"test\"}]}"
}

Elemen respons

Element	Type	Description	Example
	object	Struktur tanggapan.
RequestId	string	ID permintaan.	F48ABDF7-D777-5F26-892A-57349765D7A9
TemplateId	integer	ID templat perlindungan.	2212

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F48ABDF7-D777-5F26-892A-57349765D7A9",
  "TemplateId": 2212
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.