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

GitHub

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

iOS native system used

On iOS, this plugin uses Apple App Attest from the DeviceCheck framework.

Requirements

iOS 14+
実機が推奨されるため、実際の検証フローで使用するには物理デバイスが必要
App Attest機能を有効にしたXcodeターゲット

Xcodeの設定

XcodeでiOSアプリのターゲットを開いてください。
「 Signing & Capabilities.
「+ Capability」 と追加 App Attest App Attest機能.

iOS用のカスタムパーミッションは必要ありません。 Info.plist App Attest自体の場合です。

クライアントフロー

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 あなたのバックエンドに送信してください。検証はアプリ内で行わないでください。

iOSバックエンドワークフロー

登録（`createAttestation`)

バックエンドは一度限りの challenge.
アプリが呼び出す createAttestation({ keyId, challenge }).
バックエンドはアプリの証明書の検証:
- 証明書チェーンは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 セットアップ & バックエンド検証から続ける

Capgo を使用している場合 iOS セットアップ & バックエンド検証 Capgo を使用して @capgo/capacitor-app-attest @capgo/capacitor-app-attest のネイティブ機能暗号化暗号化の実装詳細規制規制の実装詳細 Capgo セキュリティスキャナー Capgo セキュリティスキャナーの製品ワークフローで Capgo セキュリティ Capgo セキュリティの製品ワークフローで

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