개요
“개요” 섹션민감한 API 호출을 신뢰하기 전에, 요청이 실제 앱 설치에서 온 것임을 입증하세요. prepare() 및 createAttestation() Apple App Attest 플로우를 지원하며, Play Integrity Standard와 선택적 Widevine 지문 방식이 Android를 커버합니다. 내장 헬퍼를 사용해 키 ID를 안전하게 저장하세요.
적합한 사용 사례: 사기 방지, 고액 거래, 로그인 또는 출금 엔드포인트의 변조 방지 검사.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | App Attest 키, 어설션, DeviceCheck 토큰 헬퍼 |
| Android | 지원 | Play Integrity Standard, 선택적 Widevine fingerprint |
| 웹 | 폴백 | 네이티브 API를 사용할 수 없을 때의 Web attestation 형식 |
핵심 기능
“핵심 기능” 섹션isSupported- 이 기기에서 native attestation 사용 가능 여부를 확인합니다.prepare- attestation 상태를 준비하고 이후 호출에 사용할 key handle을 반환합니다.createAttestation- 백엔드에서 발행한 challenge에 바인딩된 registration attestation token을 생성합니다.createAssertion- 요청 페이로드에 바인딩된 request assertion token을 생성합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
isSupported | 이 기기에서 native attestation을 사용할 수 있는지 확인합니다. |
prepare | attestation 상태를 준비하고 이후 호출에 사용할 key handle을 반환합니다. |
createAttestation | 백엔드가 발급한 challenge에 바인딩된 registration attestation token을 생성합니다. |
createAssertion | 요청 페이로드에 바인딩된 request assertion token을 생성합니다. |
storeKeyId | 키 식별자를 저장/준비하여 재사용합니다. |
getStoredKeyId | 현재 저장/준비된 키 식별자를 반환합니다. |
clearStoredKeyId | 저장/준비된 키 식별자를 삭제합니다. |
generateKey | 레거시 별칭: prepare(). |
attestKey | 레거시 별칭: createAttestation(). |
generateAssertion | 레거시 별칭 createAssertion(). |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-app-attest.
@capgo/capacitor-app-attest에서 계속하기
“@capgo/capacitor-app-attest에서 계속하기” 섹션사용 중이라면 @capgo/capacitor-app-attest 보안 및 컴플라이언스 계획을 세우려면, 다음 항목과 연결하세요: @capgo/capacitor-app-attest 사용하기 @capgo/capacitor-app-attest 사용 시 네이티브 기능을 위해, 암호화 암호화 구현 상세 정보: 컴플라이언스 컴플라이언스 구현 상세 정보: Capgo 보안 스캐너 Capgo Security Scanner에서 제품 워크플로우는, 그리고 Capgo 보안 Capgo Security의 제품 워크플로를 위해.
