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

GitHub

このプラグインのインストール手順とフルマークダウンガイドを含むセットアッププロンプトをコピーしてください。

iOSネイティブシステムを使用

iOSでは、このプラグインは Apple App Attest から DeviceCheck フレームワーク

要件

iOS 14+
物理デバイスが実際の検証フローで推奨されます
App Attest機能が有効になっているXcodeターゲット

Xcodeの設定

XcodeでiOSアプリのターゲットを開きます。
Go to Signing & Capabilities.
Click + Capability と追加 App Attest.

アプリの証明 Info.plist 必要ありません

Client flow

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

const { keyId } = await AppAttest.prepare();

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

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

送信 attestation.token そして assertion.token サーバーに送信してください。アプリ内で検証しないでください。

Backend workflow (iOS)

登録（createAttestation）`createAttestation`)

バックエンドが一時的な challenge.
アプリが createAttestation({ keyId, challenge }).
バックエンドがアプリのAttestの証明書を検証します：
- 証明書チェーンが有効であり、Apple App Attestにアンカーされます
- アプリのIDがアプリ（bundleIdチーム）
- clientDataHash 一致 SHA256(challenge)
ストアデバイスキーの状態（keyId公開鍵、および検証者メタデータ）

保護の要求（`createAssertion`)

バックエンドは一時的な payload （またはcanonical request hash入力）。
アプリは createAssertion({ keyId, payload }).
バックエンドは以前のキー材料とともにアサーション署名を検証します。
再送信保護とnonce TTL チェックを強制します。

iOS スキーマ

sequenceDiagram
  participant App as iOS App
  participant Plugin as AppAttest plugin
  participant Apple as Apple App Attest
  participant BE as Backend

  BE->>App: one-time challenge
  App->>Plugin: prepare()
  Plugin->>Apple: generateKey()
  Apple-->>Plugin: keyId

  App->>Plugin: createAttestation(keyId, challenge)
  Plugin->>Apple: attestKey(keyId, SHA256(challenge))
  Apple-->>Plugin: attestation token
  Plugin-->>App: token + platform + format + keyId
  App->>BE: token + challenge + keyId
  BE->>BE: verify Apple attestation rules

  BE->>App: one-time payload
  App->>Plugin: createAssertion(keyId, payload)
  Plugin->>Apple: generateAssertion(keyId, SHA256(payload))
  Apple-->>Plugin: assertion token
  Plugin-->>App: token + platform + format + keyId
  App->>BE: token + payload + keyId
  BE->>BE: verify signature + replay policy

登録:

コピーする

{
  "platform": "ios",
  "format": "apple-app-attest",
  "keyId": "string",
  "challenge": "string",
  "token": "string"
}

アサーション:

{
  "platform": "ios",
  "format": "apple-app-attest",
  "keyId": "string",
  "payload": "string",
  "token": "string"
}

iOS セットアップ & バックエンド検証から続ける

Capacitor を使用している場合 iOS セットアップ & バックエンド検証 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-app-attest を使用して Capacitor のネイティブ機能のために @capgo/capacitor-app-attest を使用 for the native capability in Using @capgo/capacitor-app-attest, 暗号化の実装詳細 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-app-attest コンプライアンスコンプライアンスの実装詳細のために Capgo セキュリティスキャナー Capgo セキュリティスキャナーの製品ワークフローに Capgo セキュリティ Capgo セキュリティの製品ワークフローに

iOSセットアップ &amp; バックエンド検証