Pengaturan Android & Verifikasi Backend

Sistem native Android digunakan

Pada Android, plugin ini menggunakan Standar Keamanan Integrasi Google Play API:

• prepareIntegrityToken Dalam proses prepare()
• requestStandardIntegrityToken Untuk createAttestation() dan createAssertion()

Persyaratan

• Aplikasi Android yang didistribusikan melalui ekosistem Google Play
• Jasa Google Play tersedia di perangkat
• Integritas Play API diaktifkan untuk aplikasi Anda
• Nomor proyek Google Cloud yang dikonfigurasi

Pengaturan Google

1. Dengan mengaktifkan Integritas Permainan API di proyek Cloud Google Anda.
2. Buka Console Play dan atur akses Integritas Play untuk aplikasi Anda.
3. Sediakan cloudProjectNumber ke plugin.

Capacitor config

capacitor.config.ts

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

Anda juga dapat melewati cloudProjectNumber per panggilan dalam opsi metode.

Alur Klien

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

const { keyId } = await AppAttest.prepare({
  cloudProjectNumber: '123456789012',
});

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

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

token adalah token Integrasi Play dan harus diurai di sisi server.

Alur Backend (Android)

Pendaftaran (createAttestation)createAttestation)

1. App memanggil challenge.
2. Backend memanggil Google createAttestation({ keyId, challenge }).
3. __CAPGO_KEEP_0__. decodeIntegrityToken API.
4. __CAPGO_KEEP_0__.
   • requestDetails.requestHash === base64url(SHA256(challenge))
   • appIntegrity.packageName Sama dengan ID aplikasi Android Anda
   • appIntegrity.certificateSha256Digest Mengandung digest sertifikat tanda tangan rilis Anda
   • Verifikasi integritas sesuai dengan kebijakan keamanan Anda

Permintaan perlindungan (createAssertion)createAssertion)

1. Backend membuat token satu kali payload.
2. Aplikasi memanggil createAssertion({ keyId, payload }).
3. Backend memecahkan token dan memeriksa requestHash === base64url(SHA256(payload)).
4. Menggunakan kebijakan verifikasi integritas dan mencegah ulang penggunaan (single-use + TTL).

Schemas Android

sequenceDiagram
  participant App as Android App
  participant Plugin as AppAttest plugin
  participant PlaySDK as Play Integrity SDK
  participant BE as Backend
  participant Google as decodeIntegrityToken API

  App->>Plugin: prepare(cloudProjectNumber)
  Plugin->>PlaySDK: prepareIntegrityToken()
  PlaySDK-->>Plugin: provider handle (keyId)

  BE->>App: one-time challenge
  App->>Plugin: createAttestation(keyId, challenge)
  Plugin->>PlaySDK: requestStandardIntegrityToken(requestHash)
  PlaySDK-->>Plugin: integrity token
  Plugin-->>App: token + platform + format + keyId
  App->>BE: token + challenge + keyId
  BE->>Google: decodeIntegrityToken(token)
  Google-->>BE: decoded payload
  BE->>BE: verify requestHash + app identity + verdicts

  BE->>App: one-time payload
  App->>Plugin: createAssertion(keyId, payload)
  Plugin->>PlaySDK: requestStandardIntegrityToken(requestHash)
  PlaySDK-->>Plugin: integrity token
  App->>BE: token + payload + keyId
  BE->>Google: decodeIntegrityToken(token)
  Google-->>BE: decoded payload
  BE->>BE: verify requestHash + replay policy

Kontrak minimal payload backend

Pendaftaran:

{
  "platform": "android",
  "format": "google-play-integrity-standard",
  "keyId": "string",
  "challenge": "string",
  "token": "string"
}

Klaim:

{
  "platform": "android",
  "format": "google-play-integrity-standard",
  "keyId": "string",
  "payload": "string",
  "token": "string"
}

Teruskan dari Pengaturan Android & Verifikasi Backend

Jika Anda menggunakan Pengaturan Android & Verifikasi Backend untuk merencanakan keamanan dan keterbatasan, hubungkannya dengan Menggunakan @capgo/capacitor-app-attest untuk kemampuan asli dalam Menggunakan @capgo/capacitor-app-attest, Enkripsi untuk detail implementasi dalam Enkripsi, Kepatuhan untuk detail implementasi dalam Kepatuhan, Capgo Scanner Keamanan untuk alur kerja produk dalam Capgo Scanner Keamanan, dan Capgo Keamanan untuk alur kerja produk dalam Capgo Keamanan.