Mulai Menggunakan

Copas prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

        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.

Installation

Anda dapat menggunakan Setup Bantuan AI untuk memasang plugin ini. Tambahkan Capgo kemampuan ke alat AI Anda menggunakan perintah berikut:

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

Lalu gunakan prompt berikut:

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

Jika Anda lebih suka Setup Manual, instal plugin dengan menjalankan perintah-perintah berikut dan ikuti instruksi spesifik platform di bawah ini:

Install the package
Jendela terminal
```
bun add @capgo/capacitor-app-attest
```
Sinkronkan proyek asli
Jendela terminal
```
bunx cap sync
```
Tentukan persyaratan platform
- Selesai Pengaturan iOS Pengaturan untuk kemampuan dan alur verifikasi backend App Attest.
- Selesai Pengaturan Android Pengaturan untuk Standar Integritas Play dan alur verifikasi backend.

Mengapa menggunakan plugin ini

Plugin ini menyediakan satu API lintas platform sementara menjaga keamanan platform asli:

iOS: Apple App Attest (Attestasi Aplikasi Apple)DeviceCheck)
Android: Standar Integritas Google Play API
Tidak ada skema kriptografi klien khusus
Hasil normalisasi untuk periksa backend

Penggunaan

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);

Bentuk respons yang diintegrasikan

createAttestation() dan createAssertion() Kembalikan kunci field yang sama pada iOS dan Android:

Field	Jenis	Description
`platform`	`'ios' \| 'android' \| 'web'`	Jenis Platform yang menghasilkan token
`format`	`AttestationFormat`	`apple-app-attest` atau `google-play-integrity-standard`
`keyId`	`string`	Tanggung jawab kunci/pemilik yang digunakan untuk pengesahan
`token`	`string`	Token untuk memverifikasi di backend Anda

Persyaratan Backend

Attestasi hanya berguna ketika diverifikasi di sisi server.

Tidak pernah percaya pada kesuksesan klien saja.
Memerlukan nilai-nilai tantangan/payload sekali pakai dari backend Anda.
Verifikasi tokenMenggunakan identitas aplikasi, dan perlindungan ulang dalam logika backend.

Pakai panduan backend spesifik platform:

Teruskan dari Getting Started

Jika Anda menggunakan Mulai Menggunakan untuk merencanakan keamanan dan kinerja, hubungkannya dengan Menggunakan @capgo/capacitor-app-attest untuk kemampuan asli dalam Menggunakan @capgo/capacitor-app-attest, Enkripsi untuk detail implementasi dalam Enkripsi, Kinerja untuk detail implementasi dalam Kinerja, Scanner Keamanan Capgo untuk alur kerja produk di Scanner Keamanan Capgo Scanner Keamanan Capgo untuk alur kerja produk di Scanner Keamanan Capgo