@capgo/capacitor-device-integrity

개요

Widevine, Play Integrity, App Attest, DeviceCheck 기반 기기 무결성 및 부정 행위 신호

다음으로 시작하세요 getCapabilities() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.

플랫폼 지원

플랫폼	지원	참고 사항
iOS	지원	네이티브
Android	지원	네이티브
웹	부분	시작하기 보기

핵심 기능

• getCapabilities - 현재 플랫폼에서 사용 가능한 무결성(integrity) 기능을 반환합니다.
• getWidevineFingerprint - Android Widevine 기반의 디바이스 핑거프린트를 반환합니다.
• prepareAttestation - App Attest 또는 Play Integrity 상태를 준비하고 키 또는 프로바이더 핸들을 반환합니다.
• createAttestation - 백엔드 챌린지에 바인딩된 등록 증명(attestation) 토큰을 생성합니다.
• createAssertion - 백엔드 페이로드에 바인딩된 요청 어설션(assertion) 토큰을 생성합니다.
• getDeviceCheckToken - 서버 측 부정 행위 조회를 위한 iOS DeviceCheck 토큰을 생성합니다.

공개 API

메서드	설명
getCapabilities	이 기기에서 Widevine, App Attest, DeviceCheck 및 Play Integrity 지원 여부를 반환합니다.
getWidevineFingerprint	Android 전용. 솔트 처리된 SHA-256 지문과 선택적 Widevine 메타데이터를 반환합니다.
prepareAttestation	네이티브 증명을 준비하고 다음을 반환합니다: keyId 및 format.
createAttestation	백엔드에서 발행한 항목에 대한 등록 토큰을 생성합니다. challenge.
createAssertion	백엔드에서 발급한 항목에 대한 어설션 토큰을 생성합니다. payload.
getDeviceCheckToken	iOS 전용입니다. base64 형식의 DeviceCheck 토큰을 반환합니다.

설정

Android Play Integrity에서는 전역 Cloud 프로젝트 번호를 사용할 수 있습니다. capacitor.config.ts:

plugins: {
  DeviceIntegrity: {
    cloudProjectNumber: '123456789012',
  },
},

다음 항목을 전달할 수도 있습니다. cloudProjectNumber 대상 prepareAttestation, createAttestation, 그리고 createAssertion.

Source of Truth

이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-device-integrity.

@capgo/capacitor-device-integrity에서 계속하기

사용 중이라면 @capgo/capacitor-device-integrity 보안 및 컴플라이언스 계획을 세우려면, 다음 항목과 연결하세요: @capgo/capacitor-device-integrity 사용하기 @capgo/capacitor-device-integrity를 사용하여 네이티브 기능을 구현하는 경우, @capgo/capacitor-app-attest 사용하기 관련 attestation 플로우를 위해, @capgo/capacitor-app-attest 구현 세부 사항은, Capgo 보안 스캐너 Capgo Security Scanner에서 제품 워크플로우는, 그리고 Capgo 보안 Capgo Security의 제품 워크플로를 위해.