**Memperkenalkan pengalaman konsol baru untuk AWS WAF**
Anda sekarang dapat menggunakan pengalaman yang diperbarui untuk mengakses AWS WAF fungsionalitas di mana saja di konsol. Untuk detail selengkapnya, lihat [Bekerja dengan konsol](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-console.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AWS WAF spesifikasi SDK seluler
Bagian ini mencantumkan objek SDK, operasi, dan pengaturan konfigurasi untuk versi SDK AWS WAF seluler terbaru yang tersedia. Untuk informasi terperinci tentang cara kerja penyedia token dan operasi untuk berbagai kombinasi pengaturan konfigurasi, lihat[Cara kerja SDK AWS WAF seluler](waf-mobile-sdk-how-it-works.md).
**`WAFToken`**
Memegang AWS WAF token.
**`getValue()`**
Mengambil `String` representasi dari. `WAFToken`
**`WAFTokenProvider`**
Mengelola token di aplikasi seluler Anda. Menerapkan ini menggunakan `WAFConfiguration` objek.
**`getToken()`**
Jika penyegaran latar belakang diaktifkan, ini mengembalikan token yang di-cache. Jika penyegaran latar belakang dinonaktifkan, ini membuat panggilan pemblokiran sinkron AWS WAF untuk mengambil token baru.
**`loadTokenIntoProvider(WAFToken)`**
Memuat token yang ditentukan ke dalam`WAFTokenProvider`, menggantikan token apa pun yang dikelola penyedia. Penyedia token mengambil kepemilikan token baru dan menangani penyegarannya ke depan. Operasi ini juga memperbarui token di toko cookie, jika `setTokenCookie` diaktifkan di`WAFConfiguration`.
**`onTokenReady(WAFTokenResultCallback)`**
Menginstruksikan penyedia token untuk me-refresh 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, lihat[Mengambil token setelah aplikasi tidak aktif](waf-mobile-sdk-how-it-works.md#waf-mobile-sdk-how-back-from-inactive).
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 parameter`WAFToken`,`SdkError`. Untuk aplikasi iOS, Anda dapat membuat fungsi inline secara bergantian.
**`storeTokenInCookieStorage(WAFToken)`**
Menginstruksikan `WAFTokenProvider` untuk menyimpan AWS WAF token yang ditentukan ke dalam manajer cookie SDK. Secara default, token hanya ditambahkan ke toko cookie saat pertama kali diperoleh dan saat di-refresh. Jika aplikasi menghapus penyimpanan cookie bersama karena alasan apa pun, SDK tidak secara otomatis menambahkan AWS WAF token kembali hingga penyegaran berikutnya.
**`WAFConfiguration`**
Memegang konfigurasi untuk implementasi`WAFTokenProvider`. Saat menerapkan ini, Anda memberikan URL integrasi paket perlindungan (web ACL), nama domain yang akan digunakan dalam token, dan pengaturan non-default apa pun yang ingin digunakan oleh penyedia token.
Daftar berikut menentukan pengaturan konfigurasi yang dapat Anda kelola dalam `WAFConfiguration` objek.
**`applicationIntegrationUrl`**
URL integrasi aplikasi. Dapatkan ini dari AWS WAF konsol atau melalui panggilan `getWebACL` API.
Wajib: Ya
Jenis: URL khusus aplikasi. Untuk iOS, lihat [URL iOS](https://developer.apple.com/documentation/foundation/url). Untuk Android, lihat URL [java.net](https://docs.oracle.com/javase/7/docs/api/java/net/URL.html).
**`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 paket perlindungan (web ACL), tempat Anda akan mengirim permintaan web. Untuk grup aturan terkelola ACFP`AWSManagedRulesACFPRuleSet`, ini biasanya akan menjadi domain tunggal yang cocok dengan domain di jalur pembuatan akun yang Anda berikan dalam konfigurasi grup aturan. Untuk grup aturan terkelola ATP`AWSManagedRulesATPRuleSet`, 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 paket perlindungan (web ACL). Untuk informasi selengkapnya, lihat [AWS WAF paket perlindungan (web ACL) konfigurasi daftar domain token](waf-tokens-domains.md#waf-tokens-domain-lists).
Wajib: Ya
Tipe: `String`
**`maxErrorTokenRefreshDelayMsec`**
Waktu maksimum dalam milidetik untuk menunggu sebelum mengulangi penyegaran token setelah upaya gagal. Untuk setiap percobaan ulang otomatis untuk upaya yang gagal, itu akan menambahkan cadangan eksponensial hingga waktu tunda input yang diberikan. Nilai ini digunakan setelah pengambilan token gagal dan berulang kali dicoba`maxRetryCount`.
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: `Infinity`
Nilai minimum yang diizinkan: `0`
Nilai maksimum yang diizinkan: `100`
**`setTokenCookie`**
Menunjukkan apakah Anda ingin pengelola cookie SDK menambahkan cookie token ke dalam permintaan dan di area lain.
Dengan `TRUE` nilai:
+ Manajer cookie menambahkan cookie token ke semua permintaan yang jalurnya berada di bawah jalur yang ditentukan dalam`tokenCookiePath`.
+ `WAFTokenProvider`Operasi `loadTokenIntoProvider()` memperbarui token di toko cookie, selain memuatnya ke penyedia token.
Wajib: Tidak
Tipe: `Boolean`
Nilai default: `TRUE`
**`tokenCookiePath`**
Digunakan kapan `setTokenCookie``TRUE`. Menunjukkan jalur tingkat atas tempat Anda ingin pengelola cookie SDK menambahkan cookie token. 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)
## AWS WAF kesalahan SDK seluler
Bagian ini mencantumkan kemungkinan kesalahan untuk versi SDK AWS WAF seluler saat ini.
**`SdkError`**
Jenis kesalahan dikembalikan saat gagal mengambil token. SDK Android dan iOS memiliki jenis kesalahan yang sama.
SDK AWS WAF seluler memiliki jenis kesalahan berikut:
**`invalidChallenge`**
Kesalahan ini dikembalikan ketika server token mengembalikan data tantangan yang tidak valid, atau gumpalan respons dimutasi oleh penyerang.
**`errorInvokingGetChallengeEndpoint`**
Kesalahan ini dikembalikan ketika server token mengirimkan kode respons yang tidak berhasil kembali ke klien atau ketika terjadi kesalahan jaringan.
**`invalidVerifyChallengeResponse`**
Kesalahan ini dikembalikan ketika ada kesalahan mengambil `aws-waf-token` dari respons verifikasi AWS WAF server, atau respons server dirusak.
**`errorInvokingVerifyEndpoint`**
Kesalahan ini dikembalikan ketika klien menerima respons buruk dari AWS WAF server atau kesalahan jaringan saat memverifikasi tantangan yang diselesaikan.
**`internalError`**
Kesalahan ini dikembalikan pada semua kesalahan lain yang mungkin terjadi dalam SDK itu sendiri.
**`socketTimeoutException`**
Kesalahan ini sering dikembalikan saat mengalami kesalahan jaringan selama pengambilan token.
Kesalahan ini mungkin disebabkan oleh hal-hal berikut:
+ Bandwidth jaringan rendah: Konfirmasikan pengaturan konektivitas jaringan Anda
+ URL Integrasi Aplikasi Bermutasi: Konfirmasikan bahwa URL integrasi tidak dimodifikasi dari apa yang muncul di konsol AWS WAF