Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Esta sección se brinda ejemplos de códigos para usar el SDK para móviles.
Inicialización del proveedor de tokens y obtención de tokens
La instancia del proveedor de tokens se inicia mediante un objeto de configuración. A continuación, puede recuperar los tokens mediante las operaciones disponibles. Se indican a continuación los componentes básicos del código exigido.
let url: URL = URL(string: "
Web ACL integration URL
")! let configuration = WAFConfiguration(applicationIntegrationUrl: url, domainName: "Domain name
") let tokenProvider = WAFTokenProvider(configuration) //onTokenReady can be add as an observer for UIApplication.willEnterForegroundNotification self.tokenProvider.onTokenReady() { token, error in if let token = token { //token available } if let error = error { //error occurred after exhausting all retries } } //getToken() let token = tokenProvider.getToken()
Permisión de que el SDK proporcione la cookie de token en sus solicitudes HTTP
Si setTokenCookie
es TRUE
, el proveedor de tokens incluye la cookie de token para usted en sus solicitudes web en todas las ubicaciones de la ruta especificada en tokenCookiePath
. De forma predeterminada, setTokenCookie
es TRUE
y tokenCookiePath
es /
.
Puede limitar el alcance de las solicitudes que incluyen una cookie de token especificando la ruta de la cookie de token, por ejemplo, /web/login
. Si lo haces, comprueba que tus AWS WAF reglas no inspeccionen los tokens en las solicitudes que envíes a otras rutas. Cuando usa el grupo de reglas de AWSManagedRulesACFPRuleSet
, configura las rutas de registro y creación de cuentas, y el grupo de reglas comprueba si hay tokens en las solicitudes que se envían a esas rutas. Para obtener más información, consulte Adición del grupo de reglas administradas por ACFP a la nueva ACL web. Igualmente, al usar el grupo de reglas de AWSManagedRulesATPRuleSet
, configure la ruta de inicio de sesión, y el grupo de reglas comprueba si hay tokens en las solicitudes que se envían a esa ruta. Para obtener más información, consulte Adición del grupo de reglas administradas por ATP a la nueva ACL web.
Cuando setTokenCookie
es TRUE
así, el proveedor del token almacena el AWS WAF token en un HTTPCookieStorage.shared
e incluye automáticamente la cookie en las solicitudes al dominio que especificasteWAFConfiguration
.
let request = URLRequest(url: URL(string: domainEndpointUrl)!)
//The token cookie is set automatically as cookie header
let task = URLSession.shared.dataTask(with: request) { data, urlResponse, error in
}.resume()
Suministro manual de la cookie de token en sus solicitudes HTTP
Si configura setTokenCookie
en FALSE
, tendrá que proporcionar la cookie de token manualmente, como encabezado de solicitud HTTP de cookie, en las solicitudes que envíe a su punto de conexión protegido. El siguiente código muestra cómo hacerlo.
var request = URLRequest(url: wafProtectedEndpoint) request.setValue("aws-waf-token=
token from token provider
", forHTTPHeaderField: "Cookie") request.httpShouldHandleCookies = true URLSession.shared.dataTask(with: request) { data, response, error in }