メインコンテンツへスキップ
@capgo/capacitor-persona 認証とセキュリティ オープンソース

ペルソナ Capacitor プラグイン

ネイティブ iOS/Android SDK で Persona の本人確認リクエストを開始

インストール

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

ガイド

Capacitor で Persona を使用する方法

@capgo/capacitor-intuneの使用方法

Microsoft IntuneのMAM登録、アプリ保護ポリシー、アプリ構成、およびMSAL認証に対応したCapacitorプラグイン。

インストール

bun add @capgo/capacitor-intune
bunx cap sync

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

インポート

import { IntuneMAM } from '@capgo/capacitor-intune';

API の概要

メソッド 説明
acquireToken Microsoftのサインインフローを表示し、アクセストークンとアカウントのメタデータを返します。
acquireTokenSilent 以前にサインインしたユーザーのMSALキャッシュからトークンを取得します。
registerAndEnrollAccount 以前に認証されたアカウントをIntuneに登録し、登録を開始します。
loginAndEnrollAccount アプリのトークンを先に要求せずに、Intuneにユーザーの認証と登録を依頼します。
enrolledAccount 現在登録されているIntuneアカウントがあれば返します。
deRegisterAndUnenrollAccount Intuneからアカウントの登録を解除し、必要に応じてセレクティブワイプを実行します。
logoutOfAccount Intuneアカウントの登録を解除せずに、MSALからユーザーをサインアウトします。
appConfig 管理対象アカウントのリモートIntuneアプリ構成を取得します。
getPolicy 管理対象アカウントに適用されている現在のIntuneアプリ保護ポリシーを取得します。
groupName 存在する場合、以下の GroupName アプリ設定値を解決する便利なヘルパーです。
sdkVersion このプラグインに同梱されているネイティブのIntuneおよびMSAL SDK バージョンを返します。
displayDiagnosticConsole ネイティブのIntune診断UIを表示します。

例

acquireToken()

Microsoftのサインインフローを表示し、アクセストークンとアカウントのメタデータを返します。

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.

acquireTokenSilent()

以前にサインインしたユーザーのMSALキャッシュからトークンを取得します。

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.acquireTokenSilent({
  scopes: ['openid'],
  accountId: 'acquireToken',
});
// The result holds sensitive values: use it without logging it.

registerAndEnrollAccount()

以前に認証されたアカウントをIntuneに登録し、登録を開始します。

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });

loginAndEnrollAccount()

アプリのトークンを先に要求せずに、Intuneにユーザーの認証と登録を依頼します。

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount()

現在登録されているIntuneアカウントがあれば返します。

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.enrolledAccount();
console.log(result);

deRegisterAndUnenrollAccount()

Intuneからアカウントの登録を解除し、必要に応じてセレクティブワイプを実行します。

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'account-id-123' });

上記の表は12個のコアメソッドを一覧にしています。リスナーとバージョンのヘルパー、および各メソッドの完全な仕様は、以下に記載されています。 GitHub リポジトリ.

イベントをリッスンする

addListener ハンドルを返します。画面がアンマウントされるときに handle.remove() 画面がアンマウントされるとき、または IntuneMAM.removeAllListeners() すべてのリスナーを解除します。

完全なリファレンス

@capgo/capacitor-intune の使用から続ける

使用している場合 @capgo/capacitor-intuneの使用方法 認証とアカウントフローを計画するには、これを次と連携させてください @capgo/capacitor-intune @capgo/capacitor-intune の実装の詳細については、 スタートガイド スタートガイドの実装詳細については、 @capgo/capacitor-social-login @capgo/capacitor-social-login の実装の詳細については、 @capgo/capacitor-passkey @capgo/capacitor-passkey の実装詳細については、 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric. の実装詳細についてはこちら

よくある質問

Persona pluginのFAQ

Capacitor アプリに Persona プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-persona"(または "npm install @capgo/capacitor-persona")を実行した後、"bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させてください。その後、アプリの code から "@capgo/capacitor-persona" をインポートします。

@capgo/capacitor-persona は React、Vue、Angular で動作しますか?

はい。Persona は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、およびプレーンな JavaScript を含む、Capacitor 内で動作するあらゆる Web フレームワークで使用できます。

@capgo/capacitor-persona はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-persona は無料のオープンソースですか?

はい。code のソースコードは GitHub の https://github.com/Cap-go/capacitor-persona/ で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストをお待ちしています。

App Store の審査なしで、Persona を使用している code をアップデートできますか?

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

アプリの審査を待たずに Persona の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める