メインコンテンツにジャンプ
@capgo/capacitor-ネイティブバイオメトリック セキュリティ & アクセス制御 オープンソース

ネイティブバイオメトリック Capacitor プラグイン

Face ID、Touch ID、Android バイオメトリック API を使用したセキュアな認証

インストール

bun add @capgo/capacitor-native-biometric bunx cap sync
npm、pnpm、またはyarn
  • npm install @capgo/capacitor-native-biometric
  • pnpm add @capgo/capacitor-native-biometric
  • yarn add @capgo/capacitor-native-biometric

ガイド

How to use Native Biometric in Capacitor

デバイスでテスト

Download the Capgo app, then scan the QR code.

Native Biometric プラグインのプレビュー QR code

@capgo/capacitor-native-biometricを使用

このプラグインは、AndroidとiOSのネイティブバイオメトリックAPIにアクセスできます。

インストール

bun add @capgo/capacitor-native-biometric
bunx cap sync

bunx cap sync プラグインのネイティブ code をあなたのネイティブ プロジェクトにコピーします。プラグインのアップグレード後は再度実行してください。

インポート

import { NativeBiometric } from '@capgo/capacitor-native-biometric';

APIの概要

方法 説明
isAvailable BIOMETRICハードウェアが利用可能かどうかを確認します。
verifyIdentity ユーザーにBIOMETRIC認証を求めます。
getCredentials 指定されたサーバーに保存されているクレデンシャルを取得します。
setCredentials 指定されたサーバーにクレデンシャルを保存します。
deleteCredentials 指定されたサーバーに保存されているクレデンシャルを削除します。
getSecureCredentials BIOMETRIC認証を必要とする指定されたサーバーに保存されているクレデンシャルを取得します。クレデンシャルは、BIOMETRY_CURRENT_SETまたはBIOMETRY_ANYで保存されている必要があります。
isCredentialsSaved 指定されたサーバーにクレデンシャルがすでに保存されているかどうかを確認します。
setData 指定されたキー下で任意の文字列値を格納します。値は、Android Keystore + SharedPreferences、iOS Keychainを使用したプラットフォームのセキュア ストレージ バックエンドで暗号化されます。
getData 指定されたキーに対して以前保存された値を取得します。ただし、biometric保護されていない値のみを返します。 accessControl.
getSecureData 指定されたキーに対してbiometric保護された値を取得します。値はBIOMETRY_CURRENT_SETまたはBIOMETRY_ANYのいずれかで保存されていなければなりません。 accessControl 指定されたキーに対して保存された値を削除します (保護された値と保護されていない値)。
deleteData 指定されたキーに対して値がすでに保存されているかどうかを確認します。
isDataSaved 例

Examples

isAvailable()

指定されたキーに対して値がすでに保存されているかどうかを確認します。

import { NativeBiometric } from '@capgo/capacitor-native-biometric';

const result = await NativeBiometric.isAvailable();
console.log(result);

verifyIdentity()

biometric認証ハードウェアが利用可能かどうかを確認します。

import { NativeBiometric } from '@capgo/capacitor-native-biometric';

await NativeBiometric.verifyIdentity();

getCredentials()

ユーザーにbiometric認証を求めます。

import { NativeBiometric } from '@capgo/capacitor-native-biometric';

const result = await NativeBiometric.getCredentials({ server: 'example.com' });
// The result holds sensitive values: use it without logging it.

setCredentials()

指定されたサーバーに対して保存されたクレデンシャルを取得します。

import { NativeBiometric } from '@capgo/capacitor-native-biometric';

await NativeBiometric.setCredentials({
  username: 'username',
  password: 'password',
  server: 'example.com',
});

deleteCredentials()

指定されたサーバーに対してクレデンシャルを保存します。

import { NativeBiometric } from '@capgo/capacitor-native-biometric';

await NativeBiometric.deleteCredentials({ server: 'example.com' });

getSecureCredentials()

サーバーに保存された資格情報を取得します。BIOMETRY_CURRENT_SETまたはBIOMETRY_ANYで保存された資格情報が必要です。

import { NativeBiometric } from '@capgo/capacitor-native-biometric';

const result = await NativeBiometric.getSecureCredentials({ server: 'example.com' });
// The result holds sensitive values: use it without logging it.

上の表に記載されている12の基本メソッドがリストされています。リスナーとバージョンヘルパー、各メソッドの完全な契約書は、 GitHub リポジトリ.

イベントをリスンする

addListener ハンドルを返します。画面がアンマウントされたときに呼び出してください。 handle.remove() フルリファレンス

ドキュメント

あなたは@capgo/capacitor-native-biometricを使用している場合

__CAPGO_KEEP_0__ @capgo/capacitor-native-biometric 認証とアカウントフローの計画、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-biometricと接続 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometricの実装詳細 はじめに Getting Startedの実装詳細 @capgo/capacitor-ソーシャルログイン @capgo/capacitor-ソーシャルログインの実装詳細について @capgo/capacitor-パスコード @capgo/capacitor-パスキーの実装詳細について 2要素認証 Two-factor authenticationの実装詳細

FAQ

Native Biometric プラグインのFAQ

Native Biometric プラグインを Capacitor アプリにインストールする方法は何ですか?

「bun add @capgo/capacitor-native-biometric」 (または「npm install @capgo/capacitor-native-biometric」) を実行し、次に「bunx cap sync」を実行して iOS と Android プロジェクトがネイティブ code を取得するようにします。次に、@capgo/capacitor-native-biometric をアプリ code からインポートします。

React、Vue、Angular と @capgo/capacitor-native-biometric はどのように関係していますか?

はい。Native Biometric は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、または単純な JavaScript などの Capacitor 内で実行される任意の Web フレームワークと互換性があります。

Which Capacitor version does @capgo/capacitor-native-biometric support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Is @capgo/capacitor-native-biometric free and open source?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-native-biometric/ and the package is free to install from npm. Bug reports and pull requests are welcome.

code を使用する Native Biometric プラグインを App Store のレビューなしで更新できますか?

プラグインをインストールまたはアップグレードすると、ネイティブ code が変更されるため、新しいストア ビルドが必要になります。その後、JavaScript、HTML、CSS の変更がプラグインを呼び出すと、Capgo のライブ更新で即時配信できます。

アプリレビューの待たずにネイティブバイオメトリックの変更を配信

プラグインがストアにビルドされたら、Capgo ライブアップデートは、ユーザーにJavaScript、HTML、CSSの変更を数分でプッシュします。

Capgo で始めます