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 SDKspecifiche per dispositivi mobili
Questa sezione elenca gli SDK oggetti, le operazioni e le impostazioni di configurazione per l'ultima versione disponibile di AWS WAF cellulareSDK. Per informazioni dettagliate sul funzionamento del provider del token e delle operazioni per le varie combinazioni di impostazioni di configurazione, vedereCome AWS WAF il cellulare SDK funziona.
WAFToken
-
Contiene un AWS WAF gettone.
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 a AWS WAF per recuperare un nuovo token.
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, consultaRecupero di un token dopo l'inattività dell'app.
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 diWAFTokenResultCallback
deve accettare i parametriWAFToken
,SdkError
. Per le app iOS, puoi creare alternativamente una funzione in linea. storeTokenInCookieStorage(WAFToken)
-
Indica a
WAFTokenProvider
memorizzare il specificato AWS WAF token nel gestore SDK dei cookie. Per impostazione predefinita, il token viene aggiunto al cookie store solo quando viene acquisito per la prima volta e quando viene aggiornato. Se l'applicazione cancella l'archivio di cookie condiviso per qualsiasi motivo, SDK non aggiunge automaticamente il AWS WAF torna indietro fino al prossimo aggiornamento.
WAFConfiguration
-
Contiene la configurazione per l'implementazione di
WAFTokenProvider
. Quando lo implementi, fornisci l'integrazione ACL del tuo sito webURL, il nome di dominio da utilizzare nel token e tutte le impostazioni non predefinite che desideri che il provider del token utilizzi.L'elenco seguente specifica le impostazioni di configurazione che è possibile gestire nell'
WAFConfiguration
oggetto.applicationIntegrationUrl
-
L'integrazione URL dell'applicazione. Scaricalo da AWS WAF console o tramite
getWebACL
API chiamata.Campo obbligatorio: sì
Tipo: specifico per l'appURL. Per iOS, vedi iOS URL
. Per Android, vedi java.net. URL 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.
Campo 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
oaws.amazon.com
. Di solito si tratta del dominio host della risorsa associata al WebACL, a cui invierai le richieste web. Per il gruppo di regole ACFP gestitoAWSManagedRulesACFPRuleSet
, 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 ATP gestitoAWSManagedRulesATPRuleSet
, 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
orco.uk
come dominio del token.Il dominio deve essere uno che AWS WAF accetterà, in base al dominio host protetto e all'elenco dei domini token ACL del Web. Per ulteriori informazioni, consulta AWS WAF configurazione dell'elenco di domini con ACL token web.
Campo obbligatorio: sì
Tipo:
String
maxErrorTokenRefreshDelayMsec
-
Il tempo massimo di attesa in millisecondi prima di ripetere un aggiornamento del token dopo un tentativo fallito. Questo valore viene utilizzato dopo che il recupero del token non è riuscito ed è stato ripetuto più volte.
maxRetryCount
Campo 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.
Campo obbligatorio: no
Tipo:
Integer
Valore predefinito: se l'aggiornamento in background è abilitato,.
5
In caso contrario,3
.Valore minimo consentito:
0
Valore massimo consentito:
10
setTokenCookie
Indica se desideri che SDK il gestore dei cookie aggiunga un cookie token nelle tue richieste. Per impostazione predefinita, questo aggiunge un cookie token a tutte le richieste. Il gestore dei cookie aggiunge un cookie token a qualsiasi richiesta il cui percorso si trova nel percorso specificato in
tokenCookiePath
.Campo obbligatorio: no
Tipo:
Boolean
Valore predefinito:
TRUE
tokenCookiePath
-
Usato quando
setTokenCookie
èTRUE
. Indica il percorso di primo livello in cui desideri che SDK il gestore dei cookie 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
.Campo 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.
Campo obbligatorio: no
Tipo:
Integer
Valore predefinito:
88
Valore minimo consentito:
88
Valore massimo consentito:
300
(5 minuti)