AWS WAF SDKspesifikasi ponsel - AWS WAF, AWS Firewall Manager, dan AWS Shield Advanced

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS WAF SDKspesifikasi ponsel

Bagian ini mencantumkan SDK objek, operasi, dan pengaturan konfigurasi untuk versi terbaru yang tersedia AWS WAF ponselSDK. Untuk informasi terperinci tentang cara kerja penyedia token dan operasi untuk berbagai kombinasi pengaturan konfigurasi, lihatBagaimana AWS WAF SDKkarya seluler.

WAFToken

Memegang sebuah AWS WAF token.

getValue()

Mengambil String representasi dari. WAFToken

WAFTokenProvider

Mengelola token di aplikasi seluler Anda. Terapkan ini menggunakan WAFConfiguration objek.

getToken()

Jika penyegaran latar belakang diaktifkan, ini mengembalikan token yang di-cache. Jika penyegaran latar belakang dinonaktifkan, ini membuat panggilan yang sinkron dan memblokir ke AWS WAF untuk mengambil token baru.

onTokenReady(WAFTokenResultCallback)

Menginstruksikan penyedia token untuk menyegarkan token dan memanggil panggilan balik yang disediakan saat token aktif siap. Penyedia token akan memanggil panggilan balik Anda di utas latar belakang saat token di-cache dan siap. Panggil ini saat aplikasi Anda pertama kali dimuat dan juga saat kembali ke status aktif. Untuk informasi selengkapnya tentang kembali ke status aktif, lihatMengambil token setelah aplikasi tidak aktif.

Untuk aplikasi Android atau iOS, Anda dapat mengatur WAFTokenResultCallback ke operasi yang ingin dijalankan oleh penyedia token saat token yang diminta sudah siap. Implementasi Anda WAFTokenResultCallback harus mengambil parameterWAFToken,SdkError. Untuk aplikasi iOS, Anda dapat membuat fungsi inline secara bergantian.

storeTokenInCookieStorage(WAFToken)

Menginstruksikan WAFTokenProvider untuk menyimpan yang ditentukan AWS WAF token ke SDK manajer cookie. Secara default, token hanya ditambahkan ke toko cookie saat pertama kali diperoleh dan saat di-refresh. Jika aplikasi membersihkan toko cookie bersama karena alasan apa pun, aplikasi SDK tidak secara otomatis menambahkan AWS WAF token kembali hingga penyegaran berikutnya.

WAFConfiguration

Memegang konfigurasi untuk implementasiWAFTokenProvider. Saat Anda menerapkan ini, Anda menyediakan integrasi web ACL AndaURL, nama domain yang akan digunakan dalam token, dan pengaturan non-default apa pun yang Anda inginkan untuk digunakan oleh penyedia token.

Daftar berikut menentukan pengaturan konfigurasi yang dapat Anda kelola dalam WAFConfiguration objek.

applicationIntegrationUrl

Integrasi aplikasiURL. Dapatkan ini dari AWS WAF konsol atau melalui getWebACL API panggilan.

Wajib: Ya

Jenis: Khusus aplikasiURL. Untuk iOS, lihat iOS URL. Untuk Android, lihat java.net. URL

backgroundRefreshEnabled

Menunjukkan apakah Anda ingin penyedia token menyegarkan token di latar belakang. Jika Anda menyetel ini, penyedia token akan menyegarkan token Anda di latar belakang sesuai dengan pengaturan konfigurasi yang mengatur aktivitas penyegaran token otomatis.

Wajib: Tidak

Tipe: Boolean

Nilai default: TRUE

domainName

Domain yang akan digunakan dalam token, yang digunakan dalam akuisisi token dan penyimpanan cookie. Misalnya, example.com atau aws.amazon.com. Ini biasanya domain host dari sumber daya Anda yang terkait dengan webACL, tempat Anda akan mengirim permintaan web. Untuk grup aturan ACFP terkelolaAWSManagedRulesACFPRuleSet, ini biasanya akan menjadi domain tunggal yang cocok dengan domain di jalur pembuatan akun yang Anda berikan dalam konfigurasi grup aturan. Untuk grup aturan ATP terkelolaAWSManagedRulesATPRuleSet, ini biasanya akan menjadi domain tunggal yang cocok dengan domain di jalur login yang Anda berikan dalam konfigurasi grup aturan.

Sufiks publik tidak diizinkan. Misalnya, Anda tidak dapat menggunakan gov.au atau co.uk sebagai domain token.

Domain harus menjadi salah satu yang AWS WAF akan menerima, berdasarkan domain host yang dilindungi dan daftar domain token webACL. Untuk informasi selengkapnya, lihat AWS WAF konfigurasi daftar domain ACL token web.

Wajib: Ya

Tipe: String

maxErrorTokenRefreshDelayMsec

Waktu maksimum dalam milidetik untuk menunggu sebelum mengulangi penyegaran token setelah upaya gagal. Nilai ini digunakan setelah pengambilan token gagal dan berulang kali dicobamaxRetryCount.

Wajib: Tidak

Tipe: Integer

Nilai default: 5000 (5 detik)

Nilai minimum yang diizinkan: 1 (1 milidetik)

Nilai maksimum yang diizinkan: 30000 (30 detik)

maxRetryCount

Jumlah maksimum percobaan ulang untuk dilakukan dengan backoff eksponensial ketika token diminta.

Wajib: Tidak

Tipe: Integer

Nilai default: Jika penyegaran latar belakang diaktifkan,5. Atau, 3.

Nilai minimum yang diizinkan: 0

Nilai maksimum yang diizinkan: 10

setTokenCookie

Menunjukkan apakah Anda ingin pengelola cookie menambahkan cookie token dalam permintaan Anda. SDK Secara default, ini menambahkan cookie token ke semua permintaan. Manajer cookie menambahkan cookie token ke permintaan apa pun yang jalurnya berada di bawah jalur yang ditentukan dalamtokenCookiePath.

Wajib: Tidak

Tipe: Boolean

Nilai default: TRUE

tokenCookiePath

Digunakan kapan setTokenCookieTRUE. Menunjukkan jalur tingkat atas tempat Anda ingin pengelola cookie menambahkan cookie token. SDK Manajer menambahkan cookie token ke semua permintaan yang Anda kirim ke jalur ini dan ke semua jalur anak.

Misalnya, jika Anda menyetel ini/web/login, maka manajer menyertakan cookie token untuk semua yang dikirim ke /web/login dan jalur turunannya, seperti/web/login/help. Itu tidak termasuk token untuk permintaan yang dikirim ke jalur lain, seperti/,/web, atau/web/order.

Wajib: Tidak

Tipe: String

Nilai default: /

tokenRefreshDelaySec

Digunakan untuk penyegaran latar belakang. Jumlah waktu maksimum dalam hitungan detik antara token latar belakang menyegarkan.

Wajib: Tidak

Tipe: Integer

Nilai default: 88

Nilai minimum yang diizinkan: 88

Nilai maksimum yang diizinkan: 300 (5 menit)