Especificação do SDK móvel do AWS WAF

Recupera a representação String de WAFToken.

Se a atualização em segundo plano estiver ativada, isso retornará o token em cache. Se a atualização em segundo plano estiver desativada, isso fará uma chamada síncrona e bloqueadora para o AWS WAF para recuperar um novo token.

Instrui o provedor de token a atualizar o token e invocar o retorno de chamada fornecido quando um token ativo estiver pronto. O provedor do token invocará seu retorno de chamada em um thread em segundo plano quando o token estiver armazenado em cache e pronto. Chame isso quando seu aplicativo for carregado pela primeira vez e também quando ele voltar ao estado ativo. Para obter mais informações sobre como retornar a um estado ativo, consulte Recuperação de um token após a inatividade do aplicativo.

Para aplicativos Android ou iOS, você pode definir WAFTokenResultCallback para a operação que deseja que o provedor de token invoque quando um token solicitado estiver pronto. Sua implementação do WAFTokenResultCallback deve seguir os parâmetros WAFToken, SdkError. Para aplicativos iOS, você pode criar alternadamente uma função embutida.

Instrui o WAFTokenProvider a armazenar o token do AWS WAF especificado no gerenciador de cookies do SDK. Por padrão, o token só é adicionado ao armazenamento de cookies quando é adquirido pela primeira vez e quando é atualizado. Se o aplicativo limpar o armazenamento de cookies compartilhado por qualquer motivo, o SDK não adicionará automaticamente o token do AWS WAF de volta até a próxima atualização.

O URL de integração do aplicativo. Obtenha isso no console do AWS WAF ou por meio da chamada de API getWebACL.

Obrigatório: Sim

Tipo: URL específico do aplicativo. Para iOS, consulte o URL do iOS. Para Android, consulte o URL do java.net.

Indica se você deseja que o provedor de token atualize o token em segundo plano. Se você definir isso, o provedor de token atualizará seus tokens em segundo plano de acordo com as configurações que regem as atividades de atualização automática de tokens.

Obrigatório: Não

Tipo: Boolean

Valor padrão: TRUE

O domínio a ser usado no token, que é usado na aquisição e armazenamento de cookies. Por exemplo, o example.com ou o aws.amazon.com. Geralmente, esse é o domínio do host do seu recurso associado à web ACL, para onde você enviará solicitações da web. Para o grupo de regras gerenciadas do ACFP, AWSManagedRulesACFPRuleSet, geralmente será um único domínio que corresponde ao domínio no caminho de criação da conta que você forneceu na configuração do grupo de regras. Para o grupo de regras gerenciadas do ATP, AWSManagedRulesATPRuleSet, geralmente será um único domínio que corresponde ao domínio no caminho de login fornecido na configuração do grupo de regras.

Não são permitidos sufixos públicos. Por exemplo, você não pode usar gov.au ou co.uk como domínio do token.

O domínio deve um que será aceito pelo AWS WAF, com base no domínio do host protegido e na lista de domínios de tokens da web ACL. Para ter mais informações, consulte Configuração da lista de domínios de tokens da ACL da Web no AWS WAF.

Obrigatório: Sim

Tipo: String

O tempo máximo em milissegundos a se esperar antes de repetir uma atualização de token após uma tentativa malsucedida. Esse valor é usado depois que a recuperação do token falhou e foi repetida maxRetryCount vezes.

Obrigatório: Não

Tipo: Integer

Valor padrão: 5000 (5 segundos)

Valor mínimo permitido: 1 (1 milissegundo)

Valor máximo permitido: 30000 (30 segundos)

O número máximo de novas tentativas a serem executadas com recuo exponencial quando um token é solicitado.

Obrigatório: Não

Tipo: Integer

Valor padrão: se a atualização em segundo plano estiver ativada, 5. Caso contrário, 3.

Valor mínimo permitido: 0

Valor máximo permitido: 10

Indica se você deseja que o gerenciador de cookies do SDK adicione um cookie de token às suas solicitações. Por padrão, isso adiciona um cookie de token a todas as solicitações. O gerenciador de cookies adiciona um cookie de token a qualquer solicitação cujo caminho esteja abaixo do caminho especificado em tokenCookiePath.

Obrigatório: Não

Tipo: Boolean

Valor padrão: TRUE

Usado quando setTokenCookie é TRUE. Indica o caminho de nível superior em que você deseja que o gerenciador de cookies do SDK adicione um cookie de token. O gerente adiciona um cookie de token a todas as solicitações que você envia para esse caminho e para todos os caminhos secundários.

Por exemplo, se você definir isso como /web/login, o gerenciador incluirá o cookie de token para tudo o que é enviado para /web/login e para qualquer um de seus caminhos secundários, como /web/login/help. Ele não inclui o token para solicitações enviadas para outros caminhos, como /, /web ou /web/order.

Obrigatório: Não

Tipo: String

Valor padrão: /

Usado para atualização em segundo plano. O tempo máximo em segundos entre as atualizações do token em segundo plano.

Obrigatório: Não

Tipo: Integer

Valor padrão: 88

Valor mínimo permitido: 88

Valor máximo permitido: 300 (5 minutos)