> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Android のパスキー

> Android の Authentication Methods Management コンポーネント内にレンダリングされるパスキー認証要素の、SDK 固有の動作、アプリケーション側のエンタイトルメント、カスタマイズについて説明します。

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "早期アクセス"
  };
  const stageText = stageTextMap[stage] || "製品リリース段階";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>この機能は{linkify(`${plans}プラン`, "https://auth0.com/pricing")}でご利用いただけます。 </>}
            {contact && "参加をご希望の場合は、" + contact + "までお問い合わせください。 "}
            {terms && <>この機能を使用することにより、Oktaの該当する無料トライアル規約および{linkify("Master Subscription Agreement", "https://www.okta.com/legal")}に同意したものとみなされます。</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>{feature}機能は現在、{linkify(stageText, prsLink)}です。</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 Universal Components" stage="beta" terms="true" contact="Auth0 Support" />

[`AuthenticatorSettingsComponent`](/docs/ja-jp/get-started/universal-components/android/components/auth-methods-management) は、Auth0 [パスキー](/docs/ja-jp/authenticate/database-connections/passkeys)の登録フローをレンダリングできます。

パスキー登録フローでは、説明画面、プラットフォーム認証器との WebAuthn 登録ハンドシェイク、認証器リスト内の登録済み認証要素のエントリがレンダリングされます。

パスキーは他の認証要素と異なり、Universal Components for Android SDK では設定できないアプリケーション側のプラットフォームエンタイトルメントが必要です。

<Frame>
  <img src="https://mintcdn.com/translations/lC_NOnQ2Wbrs3KdZ/docs/images/universal-components/my-account/android/passkey-enrollment.png?fit=max&auto=format&n=lC_NOnQ2Wbrs3KdZ&q=85&s=4b3d02df841ff6d607cf5b2103055a34" alt="Android で説明コンテンツと「パスキーを追加」ボタンを表示するパスキー登録画面" style={{maxWidth: "300px", display: "block", margin: "0 auto"}} width="568" height="1202" data-path="docs/images/universal-components/my-account/android/passkey-enrollment.png" />
</Frame>

<div id="prerequisites">
  ## 前提条件
</div>

Universal Components for Android SDK でパスキーのサポートを有効にするには、以下の準備が必要です。

* **Auth0 テナントでカスタムドメインを設定します**。詳細については、[カスタムドメイン](/docs/ja-jp/customize/custom-domains)を参照してください。

* **Auth0 のデータベース接続でパスキーを有効にします**。Auth0 テナントでパスキーを有効にする方法については、[パスキー](/docs/ja-jp/authenticate/database-connections/passkeys/configure-passkey-policy)を参照してください。

* **Auth0 アプリケーションに Android アプリケーションのパッケージ名と SHA-256 署名フィンガープリントを登録します**。詳細については、[モバイルアプリケーション向け Native Passkeys](/docs/ja-jp/authenticate/database-connections/passkeys/native-passkeys-for-mobile-applications#configure-auth0-dashboard)を参照してください。

* **Android 用 Universal Components をインストールして設定します**。Universal Components のインストール、Auth0 テナントの設定、SDK の初期化については、[セルフサービスのアカウントセキュリティインターフェイスを構築する](/docs/ja-jp/get-started/universal-components/android/components/my-account-overview)を参照してください。

* **Android のバージョンを確認します**。Credential Manager のすべての機能を利用するには、Android **14 以降** (API 34 以降) が必要です。Android **11～13** (API 30～33) では、Play Services が最新のデバイスであれば、パスキーは Google Password Manager を通じて同期されます。

<div id="platform-setup">
  ## プラットフォームの設定
</div>

パスキーは、資格情報を Auth0 テナントの[カスタムドメイン](/docs/ja-jp/customize/custom-domains)に紐付けます。プラットフォームは Android Digital Asset Links を使用して、この紐付けを検証します。

**AndroidX Credentials が解決されていることを確認する**

Universal Components for Android SDK は、`androidx.credentials:credentials:1.5.0+` に推移的に依存しています。Credential Manager のエラーが発生する場合は、`./gradlew app:dependencies` で確認してください。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Google の [Credential Manager](https://developer.android.com/identity/sign-in/credential-manager) ガイドと [Digital Asset Links tester](https://developers.google.com/digital-asset-links/tools/generator) が、信頼できる情報源です。デバイスでテストする前に、`assetlinks.json` を検証してください。
</Callout>

<div id="sdk-limitations">
  ## SDK の制限事項
</div>

* **パスキーの登録は `AuthenticatorSettingsComponent` 内からのみ可能です**。アプリケーション内の他の場所から、単独でパスキー登録を開始するための公開 Composable API はありません。ログイン後に表示する「パスキーを保存」アップセルプロンプトはサポートされていません。最新情報は [universal-components-android](https://github.com/auth0/universal-components-android/issues) で確認できます。

* **コンポーネントでパスキーを削除しても、OS の認証情報ストアからは削除されません**。登録済みのパスキーは Auth0 アカウントから切り離されますが、ユーザーが OS レベルの認証情報マネージャーから削除するまで、秘密認証情報は Google Password Manager に残ります。

* **`PasskeyEnableScreen` composable は情報提供のみを目的としています**。公開呼び出し可能ですが、静的な説明カードをレンダリングするだけで、`onEnableClick` コールバックの処理は利用者側で実装する必要があります。実際の登録ロジックはコンポーネント内部の `PasskeyViewModel` にあり、公開されていません。

* **証明書利用は公開されていません**。SDK では、証明書利用ポリシー (`none` / `indirect` / `direct`) を選択したり、認証器のトランスポートを列挙したりすることはできません。Auth0 テナントで設定された [WebAuthn](/docs/ja-jp/secure/multi-factor-authentication/webauthn-as-mfa#webauthn-as-multi-factor-authentication) ポリシーが使用されます。

<div id="learn-more">
  ## 詳しく見る
</div>

<CardGroup cols={2}>
  <Card title="認証方法の管理" icon="shield" href="/docs/ja-jp/get-started/universal-components/android/components/auth-methods-management">
    `AuthenticatorSettingsComponent` のリファレンスと、サポート対象の認証要素の一覧をご確認ください。
  </Card>

  <Card title="セルフサービスのアカウントセキュリティインターフェースを構築する" icon="key" href="/docs/ja-jp/get-started/universal-components/android/components/my-account-overview">
    SDK を初期化し、トークンプロバイダーを Auth0 テナントに接続します。
  </Card>
</CardGroup>