기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS WAF 모바일 SDK 사양
이 섹션에서는 사용 가능한 최신 버전의 AWS WAF 모바일에 대한 SDK 객체, 작업 및 구성 설정을 나열합니다SDK. 다양한 구성 설정 조합에 적합한 토큰 공급자 및 작업의 작동 방식에 대한 자세한 내용은 AWS WAF 모바일 SDK 작동 방식 섹션을 참조하세요.
WAFToken
-
AWS WAF 토큰을 보관합니다.
getValue()
-
WAFToken
의String
표현을 가져옵니다.
WAFTokenProvider
-
모바일 앱에서 토큰을 관리합니다.
WAFConfiguration
객체를 사용하여 이를 구현합니다.getToken()
-
백그라운드 새로 고침이 활성화된 경우 캐시된 토큰이 반환됩니다. 백그라운드 새로 고침이 비활성화되면에 대한 호출을 차단 AWS WAF 하여 새 토큰을 검색합니다.
loadTokenIntoProvider(WAFToken)
-
지정된 토큰을에 로드하여 공급자가 관리하고 있는 토큰을
WAFTokenProvider
교체합니다. 토큰 공급자는 새 토큰에 대한 소유권을 갖고 앞으로 새로 고침을 처리합니다. 이 작업은에서가setTokenCookie
활성화된 경우 쿠키 스토어의 토큰도 업데이트합니다WAFConfiguration
. onTokenReady(WAFTokenResultCallback)
-
활성 토큰이 준비되면 토큰 공급자에게 토큰을 새로 고치고 제공된 콜백을 호출하도록 지시합니다. 토큰이 캐시되고 준비되면 토큰 공급자는 백그라운드 스레드에서 콜백을 호출합니다. 이 콜백은 앱을 처음 로드할 때와 활성 상태로 복원될 때호출합니다. 활성 상태로 복원하는 방법에 대한 자세한 내용은 앱 비활성 이후 토큰 검색 섹션을 참조하세요.
Android 또는 iOS 앱의 경우 요청된 토큰이 준비되었을 때 토큰 공급자가 호출할 작업을
WAFTokenResultCallback
으로 설정할 수 있습니다.WAFTokenResultCallback
의 구현에는WAFToken
,SdkError
파라미터를 사용해야 합니다. iOS 앱의 경우 인라인 함수를 번갈아 생성할 수 있습니다. storeTokenInCookieStorage(WAFToken)
-
지정된 AWS WAF 토큰을 SDK의 쿠키 관리자에 저장
WAFTokenProvider
하도록에 지시합니다. 기본적으로 토큰은 처음 획득했을 때와 새로 고칠 때만 쿠키 저장소에 추가됩니다. 애플리케이션이 어떤 이유로든 공유 쿠키 스토어를 지우면 SDK는 다음 새로 고침까지 AWS WAF 토큰을 자동으로 다시 추가하지 않습니다.
WAFConfiguration
-
WAFTokenProvider
의 구현을 위해 구성을 보관합니다. 이를 구현할 때 웹ACL의 통합 URL, 토큰에 사용할 도메인 이름 및 토큰 공급자가 사용할 기본값이 아닌 설정을 제공합니다.다음 목록은
WAFConfiguration
객체에서 관리할 수 있는 구성 설정을 지정합니다.applicationIntegrationUrl
-
애플리케이션 통합 URL. AWS WAF 콘솔에서 또는
getWebACL
API 직접 호출을 통해 가져옵니다.필수 여부: 예
유형: 앱별 URL. iOS의 경우 iOS를 URL
참조하세요. Android의 경우 java.net 참조하세요URL . backgroundRefreshEnabled
토큰 공급자가 백그라운드에서 토큰을 새로 고치도록 할지 여부를 나타냅니다. 이를 설정하면 토큰 공급자가 자동 토큰 새로 고침 활동을 제어하는 구성 설정에 따라 백그라운드에서 토큰을 새로 고칩니다.
필수 여부: 아니요
유형:
Boolean
기본 값:
TRUE
domainName
-
토큰에 사용할 도메인으로, 토큰 획득 및 쿠키 저장에 사용됩니다. 예:
example.com
또는aws.amazon.com
. 이는 일반적으로 웹과 연결된 리소스의 호스트 도메인으로ACL, 웹 요청을 보낼 것입니다. ACFP 관리형 규칙 그룹인의 경우AWSManagedRulesACFPRuleSet
일반적으로 규칙 그룹 구성에서 제공한 계정 생성 경로의 도메인과 일치하는 단일 도메인입니다. ATP 관리형 규칙 그룹인의 경우AWSManagedRulesATPRuleSet
일반적으로 규칙 그룹 구성에서 제공한 로그인 경로의 도메인과 일치하는 단일 도메인입니다.공개 접미사는 허용되지 않습니다. 예를 들어
gov.au
또는co.uk
를 토큰 도메인으로 사용할 수 없습니다.도메인은 보호된 호스트 도메인과 웹ACL의 토큰 도메인 목록을 기반으로 수락 AWS WAF 할 도메인이어야 합니다. 자세한 내용은 AWS WAF 웹 ACL 토큰 도메인 목록 구성 단원을 참조하십시오.
필수 여부: 예
유형:
String
maxErrorTokenRefreshDelayMsec
-
시도 실패 후 토큰 새로 고침을 반복할 때까지 대기하는 최대 시간 (밀리초) 입니다. 이 값은 토큰 검색이 실패하고
maxRetryCount
회 재시도된 후에 사용됩니다.필수 여부: 아니요
유형:
Integer
기본값:
5000
(5초)허용된 최소값:
1
(1밀리초)허용된 최대값:
30000
(30초) maxRetryCount
-
토큰 요청 시 지수 백오프를 사용하여 수행할 최대 재시도 횟수입니다.
필수 여부: 아니요
유형:
Integer
기본값: 백그라운드 새로 고침이 활성화된 경우,
5
입니다. 그렇지 않을 경우3
입니다.허용된 최소값:
0
허용되는 최대값:
10
setTokenCookie
의 SDK쿠키 관리자가 요청 및 다른 영역에 토큰 쿠키를 추가할지 여부를 나타냅니다.
TRUE
값이 있는 경우:쿠키 관리자는 경로가에 지정된 경로 아래에 있는 모든 요청에 토큰 쿠키를 추가합니다
tokenCookiePath
.WAFTokenProvider
작업은 토큰 공급자에 로드하는 것 외에도 쿠키 스토어의 토큰을loadTokenIntoProvider()
업데이트합니다.
필수 여부: 아니요
유형:
Boolean
기본 값:
TRUE
tokenCookiePath
-
setTokenCookie
가TRUE
일 때 사용됩니다. SDK의 쿠키 관리자가 토큰 쿠키를 추가할 최상위 경로를 나타냅니다. 관리자는 이 경로와 모든 하위 경로로 보내는 모든 요청에 토큰 쿠키를 추가합니다.예를 들어, 이 값을
/web/login
로 설정하면 관리자는 받는 모든 항목/web/login
및 하위 경로(예:/web/login/help
)로 전송된 모든 것에 대한 토큰 쿠키를 포함합니다./
,/web
또는/web/order
와 같은 다른 경로로 전송된 요청에 대한 토큰은 포함하지 않습니다.필수 여부: 아니요
유형:
String
기본 값:
/
tokenRefreshDelaySec
-
백그라운드 새로 고침에 사용됩니다. 백그라운드 토큰 새로 고침 최대 시간 간격(초).
필수 여부: 아니요
유형:
Integer
기본 값:
88
허용된 최소값:
88
허용된 최대값:
300
(5분)