Android セットアップ & バックエンド検証

使用されているAndroidネイティブシステム

Android上で、このプラグインは Google Play Integrity Standard API:

• prepareIntegrityToken 期間中 prepare()
• requestStandardIntegrityToken 対象 createAttestation() そして createAssertion()

要件

• AndroidアプリはGoogle Playエコシステムを通じて配布されます。
• デバイス上で利用可能なGoogle Playサービス
• Play Integrity APIがアプリに有効化されている
• Google Cloudプロジェクト番号が設定されている

Googleの設定

1. Google Playエコシステムを通じて配布されるAndroidアプリ Play Integrity API Google Cloud プロジェクト内で使用してください。
2. Play Consoleを開き、Play Integrity アクセスをアプリに設定してください。
3. 提供 cloudProjectNumber プラグインに

Capacitor config

capacitor.config.ts

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

オプションのメソッドで、各呼び出しごとに cloudProjectNumber クライアントフロー

Client flow

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 はPlay Integrityトークンであり、サーバーサイドでデコードする必要があります。

バックエンドワークフロー（Android）

登録（createAttestation）createAttestation)

1. アプリは challenge.
2. バックエンドはGoogle createAttestation({ keyId, challenge }).
3. __CAPGO_KEEP_0__ decodeIntegrityToken API.
4. コピー
   • requestDetails.requestHash === base64url(SHA256(challenge))
   • appIntegrity.packageName Android アプリ ID と等しくなります
   • appIntegrity.certificateSha256Digest リリース署名証明書のダイジェストを含んでいます
   • セキュリティポリシーと一致する整合性判定結果が得られます

保護要求 (createAssertion)createAssertion)

1. バックエンドが一時的な payload.
2. アプリが createAssertion({ keyId, payload }).
3. バックエンドがトークンをデコードし、 requestHash === base64url(SHA256(payload)).
4. 再生防止 (シングル ユース + TTL) と整合性判定ポリシーを強制します。

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

最小のバックエンドペイロード契約

登録:

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

アサーション:

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

Androidセットアップとバックエンド検証から続けてください

Androidセットアップとバックエンド検証を使用してセキュリティとコンプライアンスを計画する場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-app-attestと接続します あなたが使用している場合 Androidセットアップとバックエンド検証 Using @capgo/capacitor-app-attest for the native capability in Using @capgo/capacitor-app-attest, 暗号化 暗号化の実装詳細について 法的合致 法的合致の実装詳細について Capgo セキュリティ スキャナー Capgo セキュリティ スキャナーの製品ワークフローについて Capgo セキュリティ Capgo セキュリティの製品ワークフローについて