**Ti presentiamo una nuova esperienza di console per AWS WAF**

Ora puoi utilizzare l'esperienza aggiornata per accedere alle AWS WAF funzionalità da qualsiasi punto della console. Per ulteriori dettagli, consulta [Lavorare con la console](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-console.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# AWS WAF specifiche SDK per dispositivi mobili
<a name="waf-mobile-sdk-specification"></a>

Questa sezione elenca gli oggetti SDK, le operazioni e le impostazioni di configurazione per l'ultima versione disponibile dell'SDK AWS WAF mobile. Per informazioni dettagliate su come funzionano il provider di token e le operazioni per le varie combinazioni di impostazioni di configurazione, consulta. [Come funziona l'SDK AWS WAF per dispositivi mobili](waf-mobile-sdk-how-it-works.md) 

**`WAFToken`**  
Detiene un AWS WAF token.    
**`getValue()`**  
Recupera la `String` rappresentazione di. `WAFToken` 

**`WAFTokenProvider`**  
Gestisce i token nella tua app mobile. Implementalo usando un `WAFConfiguration` oggetto.    
**`getToken()`**  
Se l'aggiornamento in background è abilitato, restituisce il token memorizzato nella cache. Se l'aggiornamento in background è disabilitato, viene effettuata una chiamata sincrona e bloccante AWS WAF a per recuperare un nuovo token.   
**`loadTokenIntoProvider(WAFToken)`**  
Carica il token specificato in`WAFTokenProvider`, sostituendo qualsiasi token gestito dal provider. Il fornitore di token assume la proprietà del nuovo token e ne gestisce l'aggiornamento in futuro. Questa operazione aggiorna anche il token nel cookie store, se `setTokenCookie` abilitata in. `WAFConfiguration`  
**`onTokenReady(WAFTokenResultCallback)`**  
Indica al fornitore del token di aggiornare il token e di richiamare il callback fornito quando un token attivo è pronto. Il fornitore del token invocherà il callback in un thread in background quando il token è memorizzato nella cache e pronto. Chiamalo quando l'app viene caricata per la prima volta e anche quando torna allo stato attivo. Per ulteriori informazioni sul ritorno a uno stato attivo, consulta[Recupero di un token dopo l'inattività dell'app](waf-mobile-sdk-how-it-works.md#waf-mobile-sdk-how-back-from-inactive).   
Per le app Android o iOS, puoi `WAFTokenResultCallback` impostare l'operazione che desideri venga richiamata dal provider del token quando un token richiesto è pronto. La tua implementazione di `WAFTokenResultCallback` deve accettare i parametri`WAFToken`,`SdkError`. Per le app iOS, puoi creare alternativamente una funzione in linea.   
**`storeTokenInCookieStorage(WAFToken)`**  
Indica `WAFTokenProvider` a memorizzare il AWS WAF token specificato nel gestore dei cookie dell'SDK. Per impostazione predefinita, il token viene aggiunto all'archivio dei cookie solo quando viene acquisito per la prima volta e quando viene aggiornato. Se l'applicazione cancella l'archivio di cookie condiviso per qualsiasi motivo, l'SDK non aggiunge automaticamente il AWS WAF token fino al prossimo aggiornamento. 

**`WAFConfiguration`**  
Contiene la configurazione per l'implementazione di. `WAFTokenProvider` Quando lo implementate, fornite l'URL di integrazione del pacchetto di protezione (Web ACL), il nome di dominio da utilizzare nel token e tutte le impostazioni non predefinite che desiderate che il provider del token utilizzi.   
L'elenco seguente specifica le impostazioni di configurazione che è possibile gestire nell'oggetto. `WAFConfiguration`    
**`applicationIntegrationUrl`**   
L'URL di integrazione dell'applicazione. Scaricalo dalla AWS WAF console o tramite la chiamata `getWebACL` API.  
Obbligatorio: sì  
Tipo: URL specifico dell'app. Per iOS, vedi [URL iOS](https://developer.apple.com/documentation/foundation/url). Per Android, vedi l'URL [java.net.](https://docs.oracle.com/javase/7/docs/api/java/net/URL.html)   
**`backgroundRefreshEnabled`**   
Indica se desideri che il fornitore del token aggiorni il token in background. Se si imposta questa impostazione, il provider di token aggiorna i token in background in base alle impostazioni di configurazione che regolano le attività di aggiornamento automatico dei token.   
Obbligatorio: no  
Tipo: `Boolean`  
Valore predefinito: `TRUE`  
**`domainName`**   
Il dominio da utilizzare nel token, utilizzato per l'acquisizione dei token e l'archiviazione dei cookie. Ad esempio `example.com` o `aws.amazon.com`. Di solito si tratta del dominio host della risorsa associato al pacchetto di protezione (web ACL), a cui invierai le richieste web. Per il gruppo di regole gestito ACFP`AWSManagedRulesACFPRuleSet`, in genere si tratta di un singolo dominio che corrisponde al dominio nel percorso di creazione dell'account fornito nella configurazione del gruppo di regole. Per il gruppo di regole gestito ATP`AWSManagedRulesATPRuleSet`, in genere si tratta di un singolo dominio che corrisponde al dominio nel percorso di accesso fornito nella configurazione del gruppo di regole.   
I suffissi pubblici non sono consentiti. Ad esempio, non puoi usare `gov.au` or `co.uk` come dominio del token.  
Il dominio deve essere accettato, in base al dominio host protetto e all'elenco di domini token del Protection Pack (Web ACL). AWS WAF Per ulteriori informazioni, consulta [AWS WAF configurazione dell'elenco di domini con token protection pack (Web ACL)](waf-tokens-domains.md#waf-tokens-domain-lists).  
Obbligatorio: sì  
Tipo: `String`   
**`maxErrorTokenRefreshDelayMsec`**   
Il tempo massimo di attesa in millisecondi prima di ripetere un aggiornamento del token dopo un tentativo fallito. Per ogni tentativo automatico per un tentativo fallito, aggiungerà un backup esponenziale fino al tempo di ritardo di input specificato. Questo valore viene utilizzato dopo che il recupero del token non è riuscito ed è stato ripetuto più volte. `maxRetryCount`   
Obbligatorio: no  
Tipo: `Integer`  
Valore predefinito: `5000` (5 secondi)  
Valore minimo consentito: `1` (1 millisecondo)  
Valore massimo consentito: `30000` (30 secondi)  
**`maxRetryCount`**   
Il numero massimo di tentativi da eseguire con backoff esponenziale quando viene richiesto un token.   
Obbligatorio: no  
Tipo: `Integer`  
Valore predefinito: `Infinity`  
Valore minimo consentito: `0`  
Valore massimo consentito: `100`  
**`setTokenCookie`**   
Indica se desideri che il gestore dei cookie dell'SDK aggiunga un cookie token nelle richieste e in altre aree.   
Con un `TRUE` valore:   
+ Il gestore dei cookie aggiunge un cookie token a tutte le richieste il cui percorso si trova nel percorso specificato in`tokenCookiePath`. 
+ L'`WAFTokenProvider`operazione `loadTokenIntoProvider()` aggiorna il token nell'archivio dei cookie, oltre a caricarlo nel fornitore del token.
Obbligatorio: no  
Tipo: `Boolean`  
Valore predefinito: `TRUE`  
**`tokenCookiePath`**   
Usato quando `setTokenCookie` è`TRUE`. Indica il percorso di primo livello in cui desideri che il gestore dei cookie dell'SDK aggiunga un cookie token. Il gestore aggiunge un cookie token a tutte le richieste inviate a questo percorso e a tutti i percorsi secondari.   
Ad esempio, se lo imposti su`/web/login`, il gestore include il cookie token per tutto ciò che viene inviato `/web/login` e per tutti i relativi percorsi secondari, ad esempio`/web/login/help`. Non include il token per le richieste inviate ad altri percorsi, come `/``/web`, o`/web/order`.   
Obbligatorio: no  
Tipo: `String`  
Valore predefinito: `/`  
**`tokenRefreshDelaySec`**   
Utilizzato per l'aggiornamento dello sfondo. La quantità massima di tempo in secondi tra gli aggiornamenti dei token in background.  
Obbligatorio: no  
Tipo: `Integer`  
Valore predefinito: `88`  
Valore minimo consentito: `88`  
Valore massimo consentito: `300` (5 minuti)

## AWS WAF errori SDK per dispositivi mobili
<a name="waf-mobile-sdk-errors"></a>

Questa sezione elenca i possibili errori per la AWS WAF versione corrente dell'SDK per dispositivi mobili.

**`SdkError`**  
Il tipo di errore restituito quando non si riesce a recuperare un token. L'SDK per Android e iOS presenta gli stessi tipi di errore.  
L'SDK AWS WAF per dispositivi mobili presenta i seguenti tipi di errore:    
**`invalidChallenge`**  
Questo errore viene restituito quando il token server restituisce dati di sfida non validi o il blob di risposta viene modificato da un utente malintenzionato.  
**`errorInvokingGetChallengeEndpoint`**  
Questo errore viene restituito quando il token server invia al client un codice di risposta non riuscito o quando si verifica un errore di rete.  
**`invalidVerifyChallengeResponse`**  
Questo errore viene restituito quando si verifica un errore durante il `aws-waf-token` recupero della risposta di verifica del AWS WAF server o se la risposta del server è stata manomessa.  
**`errorInvokingVerifyEndpoint`**  
Questo errore viene restituito quando il client riceve una risposta errata dal AWS WAF server o un errore di rete durante la verifica della sfida risolta.  
**`internalError`**  
Questo errore viene restituito per tutti gli altri errori che potrebbero verificarsi all'interno dell'SDK stesso.

**`socketTimeoutException`**  
Questo errore viene spesso restituito quando si verificano errori di rete durante il recupero del token.  
Questo errore potrebbe essere causato da quanto segue:  
+ Larghezza di banda di rete ridotta: conferma le impostazioni di connettività di rete
+ URL di integrazione dell'applicazione mutato: verifica che l'URL di integrazione non sia stato modificato rispetto a quanto visualizzato sulla console AWS WAF