Getting Started

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-app-attest`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/app-attest/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

설치

AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. 다음 명령어를 사용하여 AI 도구에 Capgo 기능을 추가하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

그런 다음 다음 명령어를 사용하세요:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-app-attest` plugin in my project.

만약 Manual Setup을 선호한다면, 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:

패키지 설치
터미널 창
```
bun add @capgo/capacitor-app-attest
```
자연 프로젝트 동기화
터미널 창
```
bunx cap sync
```
설정 요구 사항 구성
- 완료 iOS 설정 App Attest 기능과 백엔드 검증 흐름을 위해
- 완료 Android 설정 Play Integrity Standard과 백엔드 검증 흐름을 위해

이 플러그인을 사용하는 이유

이 플러그인은 한 번의 크로스 플랫폼 API를 제공하면서 native 플랫폼 보안을 유지합니다:

iOS: Apple App Attest (DeviceCheck)
Android: Google Play Integrity Standard API
사용자 정의 클라이언트 측 암호화 스키마가 없습니다
백엔드 검사에 대한 정규화된 출력

사용 방법

import { AppAttest } from '@capgo/capacitor-app-attest';

const support = await AppAttest.isSupported();
if (!support.isSupported) {
  throw new Error(`Attestation not supported on ${support.platform}`);
}

const prepared = await AppAttest.prepare();

const registration = await AppAttest.createAttestation({
  keyId: prepared.keyId,
  challenge: 'backend-one-time-registration-challenge',
});

const assertion = await AppAttest.createAssertion({
  keyId: prepared.keyId,
  payload: 'backend-one-time-request-payload',
});

console.log(registration.platform, registration.format, registration.token);
console.log(assertion.platform, assertion.format, assertion.token);

통합된 응답 형태

createAttestation() iOS와 Android에서 동일한 키 필드를 반환합니다: createAssertion() 필드

타입	설명	Description
`platform`	`'ios' \| 'android' \| 'web'`	Native platform이 토큰을 생성했습니다.
`format`	`AttestationFormat`	`apple-app-attest` 또는 `google-play-integrity-standard`
`keyId`	`string`	Capacitor live-update alternatives 비교 페이지에서 사용되는 HTML 텍스트 조각입니다. Page/area: Capacitor live-update alternatives 비교 페이지. Role: 장기 마케팅 또는 법적 문단. Seen in: page alternatives.astro. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지합니다. Message key `alternatives_cta_questions` (Alternatives CTA Questions). \| Appflow 비교/이동 마케팅 복사본. Page/area: Appflow 비교/이동 마케팅 복사본. Role: 장기 마케팅 또는 법적 문단. Seen in: page ionic-appflow.astro. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지합니다. Message key `appflow_cta_questions` (Appflow CTA Questions). \| Capawesome 비교 페이지에서 사용되는 HTML 텍스트 조각입니다. Page/area: Capawesome 비교 페이지. Role: 장기 마케팅 또는 법적 문단. Seen in: page capwesome.astro. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지합니다. Message key `capwesome_cta_questions` (Capwesome CTA Questions). \| HTML 텍스트 조각이 포함된 Consulting 서비스 페이지입니다. Page/area: Consulting 서비스 페이지. Role: 섹션 서브 타이틀 또는 태그 라인. Seen in: page consulting.astro. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지합니다. Message key `consulting_faq_subtitle` (Consulting FAQ Subtitle). \| Appflow 비교/이동 마케팅 복사본. Page/area: Appflow 비교/이동 마케팅 복사본. Role: 짧은 UI 레이블 또는 네비게이션 아이템. Seen in: page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Message key `appflow_plugins_or` (Appflow Plugins Or).
`token`	`string`	인증을 위한 Key/Provider 핸들

서버에서 확인할 토큰

백엔드 요구 사항

서버에서만 인증이 유용합니다.
클라이언트만 성공을 믿지 마세요.
백엔드에서 한번만 사용할 challenge/payload 값을 요구하세요. token인증

앱 식별성 및 재생 방지 기능을 백엔드 논리에서 확인하세요.

시작하기에서 계속

이러한 기능을 사용하는 경우 시작하기 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-앱-인증을 사용하여 @capgo/capacitor-앱-인증을 사용하여 for the native capability in Using @capgo/capacitor-app-attest, 암호화 규정 준수 규정 준수 구현 세부 정보에 대한 Compliance에 대해 Capgo 보안 스캐너 Capgo 보안 스캐너의 제품 워크플로에 대해 Capgo 보안 Capgo 보안의 제품 워크플로에 대해