credentials

このライブラリはユーザーの認証情報への統一アクセスを提供します。パスワード、パスキー、フェデレーションの認証情報などが含まれます。このライブラリは、シームレスで安全なログイン エクスペリエンスを提供するために使用します。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2024 年 9 月 4 日 1.2.2 1.3.0-rc01 - 1.5.0-alpha05

依存関係の宣言

認証情報への依存関係を追加するには、Google の Maven リポジトリを 作成します。Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Kotlin

dependencies {
    implementation("androidx.credentials:credentials:1.5.0-beta01")

    // optional - needed for credentials support from play services, for devices running
    // Android 13 and below.
    implementation("androidx.credentials:credentials-play-services-auth:1.5.0-beta01")
}

Groovy

dependencies {
    implementation "androidx.credentials:credentials:1.5.0-beta01"

    // optional - needed for credentials support from play services, for devices running
    // Android 13 and below.
    implementation "androidx.credentials:credentials-play-services-auth:1.5.0-beta01"
}

依存関係について詳しくは、このモジュールの ビルド依存関係を追加する。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

このアーティファクトのリリースノートはありません。

認証情報 e2ee バージョン 1.0。

バージョン 1.0.0-alpha02

2024 年 4 月 17 日

androidx.credentials:credentials-e2ee:1.0.0-alpha02 がリリースされました。このバージョンには、以前のリリースで欠落していたソース JAR が含まれています。

バージョン 1.0.0-alpha01

2024 年 4 月 3 日

androidx.credentials:credentials-e2ee:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • パスキーからの IdentityKey の作成のサポート（Iba31e）

バージョン 1.5

バージョン 1.5.0-alpha05

2024 年 9 月 4 日

androidx.credentials:credentials:1.5.0-alpha05 と androidx.credentials:credentials-play-services-auth:1.5.0-alpha05 がリリースされました。バージョン 1.5.0-alpha05 に含まれる commit については、こちらをご覧ください。

API の変更

  • 新しい認証情報タイプ DigitalCredential をサポートします。（I12952）
  • バンドル変換 API の公開: asBundle ヘルパーと fromBundle ヘルパーを追加して、これらのクラスを IPC 間でより簡単に渡せるようにしました（I1a017）。
  • PendingIntentHandler の下位互換性。（I34c13）。
  • CallingAppInfo の下位互換性を確保（I65085）
  • ClearCredentialRequestTypes 定数を公開します。

バージョン 1.5.0-alpha04

2024 年 8 月 7 日

androidx.credentials:credentials:1.5.0-alpha04 と androidx.credentials:credentials-play-services-auth:1.5.0-alpha04 がリリースされました。バージョン 1.5.0-alpha04 に含まれる commit については、こちらをご覧ください。

API の変更

  • CreateRestoreCredentialRequest の isCloudBackupEnabled パラメータにデフォルト値を追加しました。

バグの修正

  • credentials-play-services-auth の minSdkVersion を削除しました。

バージョン 1.5.0-alpha03

2024 年 7 月 24 日

androidx.credentials:credentials:1.5.0-alpha03 と androidx.credentials:credentials-play-services-auth:1.5.0-alpha03 がリリースされました。このバージョンは内部ブランチで開発されています。

新機能

  • 新しい機能である Restore Credentials が導入されました。復元用の認証情報は、ユーザーの認証情報を以前のデバイスから新しい Android デバイスに復元するために使用されます。ユーザーの RestoreCredential を作成すると、ユーザーがセットアップ ステージで古いデバイスから移行するアプリを選択した場合、認証情報がユーザーの新しいデバイスに自動的に転送されます。

API の変更

  • 復元認証情報をリクエストするための新しいクラスが追加されました。
  • 新しい認証情報タイプ RestoreCredential。新しいデバイスに認証情報を復元できます。
  • CreateRestoreCredentialRequest: 新しい RestoreCredential を作成する場合。
  • RestoreCredential を取得するための GetRestoreCredentialOption。
  • ClearCredentialStateRequest を変更して、RestoreCredential を消去できます。

バグの修正

  • アプリの復元用の新しい RestoreCredential API を追加しました（If2d40）

バージョン 1.5.0-alpha02

2024 年 6 月 12 日

androidx.credentials:credentials:1.5.0-alpha02 と androidx.credentials:credentials-play-services-auth:1.5.0-alpha02 がリリースされました。このバージョンは内部ブランチで開発されています。

新機能

  • プロバイダ向けに、Jetpack を介して認証情報の作成と取得フローに BiometricPrompt を直接埋め込む機能を CredentialManager で利用できるようになりました。

API の変更

  • BiometricPromptData を API サーフェスに追加し、CredentialManager を通じて新しい取り込まれた BiometricPrompt フローを使用できるようにしました（I3b159）。
  • CreateEntry と CredentialEntry のすべてのエントリクラスとサブクラスを変更して、プロバイダで BiometricPromptData のユーティリティを利用できるようになりました。（I16936、I8e5bc）。
  • エラーと、CredentialManager を組み込んだ BiometricPrompt フローからの結果をエンコードするために必要な型を追加しました。（I8e5bc）。

バージョン 1.5.0-alpha01

2024 年 5 月 29 日

androidx.credentials:credentials:1.5.0-alpha01 と androidx.credentials:credentials-play-services-auth:1.5.0-alpha01 がリリースされました。このバージョンは内部ブランチで開発されています。

新機能

認証情報選択のセカンダリ UI エクスペリエンス: ログイン時に認証情報マネージャー API を呼び出してユーザーにセレクタを提示するアプリ デベロッパーは、新しい API を使用して、同じ GetCredentialRequest をユーザー名やパスワード フィールドなどの特定のビューに関連付けることができるようになりました。

その後、ユーザーがこれらのビューのいずれかにフォーカスすると、対応するリクエストが認証情報マネージャーに送信されます。取得された認証情報は複数のプロバイダから集約され、キーボードやプルダウンの候補といった二次 UI のように自動入力で表示されます。そのため、すべての API を一緒に使用すると、ユーザーにはまずセレクタが表示されます。このセレクタを閉じて上記のフィールドのいずれかをタップすると、キーボードやプルダウンの候補が表示されます。

API の変更

  • （既存の）GetCredentialRequest と、非同期的に使用可能な場合に（既存の）GetCredentialResponse で呼び出されるコールバックを受け取る PendingGetCredentialRequest クラス。
  • Android View クラス用の新しい拡張機能セッター API により、PendingGetCredentialRequest のインスタンスを設定できるようになりました。この API を使用すると、指定されたビューが準備され、ユーザーがそのビューをタップすると、キーボードやプルダウンの候補などのセカンダリ UI エクスペリエンスに認証情報の候補が表示されます。

バージョン 1.3

バージョン 1.3.0-rc01

2024 年 7 月 10 日

androidx.credentials:credentials:1.3.0-rc01 と androidx.credentials:credentials-play-services-auth:1.3.0-rc01 がリリースされました。バージョン 1.3.0-rc01 には、こちらの commit が含まれています。

新機能

  • バージョン バンプリリースと小規模な実装アップデート。

バージョン 1.3.0-beta02

2024 年 6 月 12 日

androidx.credentials:credentials:1.3.0-beta02 と androidx.credentials:credentials-play-services-auth:1.3.0-beta02 がリリースされました。バージョン 1.3.0-beta02 に含まれる commit については、こちらをご覧ください。

バグの修正

  • U 以前のデバイスでエラーを含む公開鍵認証情報フローで CONSTRAINT_ERR ではなく NOT_ALLOWED_ERR を正しくチェックするようにロジックを修正しました（I31b37）

バージョン 1.3.0-beta01

2024 年 5 月 29 日

androidx.credentials:credentials:1.3.0-beta01 と androidx.credentials:credentials-play-services-auth:1.3.0-beta01 がリリースされました。バージョン 1.3.0-beta01 に含まれる commit については、こちらをご覧ください。

API の変更

  • reateCredentialRequest Bundle コンバージョン API の名前を変更。（I46b95）。
  • Preferredhints API を更新しました（Ida554）

バージョン 1.3.0-alpha04

2024 年 5 月 14 日

androidx.credentials:credentials:1.3.0-alpha04 と androidx.credentials:credentials-play-services-auth:1.3.0-alpha04 がリリースされました。バージョン 1.3.0-alpha04 に含まれる commit については、こちらをご覧ください。

バグの修正

  • AndroidX ライブラリのデフォルトの minSdkVersion を 21 に移動しました。（I6ec7f）。
  • Android バージョン 13 以前の PRF 作成をサポートします。
  • Android バージョン 13 以前の preferImmediatelyAvailableCredentials をサポートします。

バージョン 1.3.0-alpha03

2024 年 4 月 17 日

androidx.credentials:credentials:1.3.0-alpha03 と androidx.credentials:credentials-play-services-auth:1.3.0-alpha03 がリリースされました。このバージョンには、以前のリリースで欠落していたソース JAR が含まれています。

バージョン 1.3.0-alpha02

2024 年 4 月 3 日

androidx.credentials:credentials:1.3.0-alpha02 と androidx.credentials:credentials-play-services-auth:1.3.0-alpha02 がリリースされました。バージョン 1.3.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

  • getCredential または createCredential の呼び出し中に認証情報セレクタに認証情報エントリが明確に表示されるようにする新しい API を追加しました。

API の変更

  • 表示の優先度に関する情報を含めるために Credential Options API サーフェスを拡張しました（Ied6fe）。
  • 未加工のバンドルを構造化データ変換ヘルパーに公開しました（If03a0）
  • isDefaultIcon API と isAutoSelectAllowedFromOption API を公開しました（I05c59）
  • アイコンのデフォルトに関する情報を含めるように認証情報入力 API サーフェスを拡張しました（I9fe00）。
  • 認証情報エントリに entryGroupId ビットを追加しました（Id995c）。
  • CredentialEntry API サーフェスに新しい affiliationName プロパティを追加しました。（I6261e）。
  • フレームワークで使用される fromXYZEntry API を公開しました。（I645a1）

バグの修正 - プラットフォーム認証情報マネージャーが使用できない場合の代替ソリューションを提供（b/310701473）。 - clearCredentialState API に起因する NPE を修正（b/327686881）

バージョン 1.3.0-alpha01

2023 年 12 月 13 日

androidx.credentials:credentials:1.3.0-alpha01 と androidx.credentials:credentials-play-services-auth:1.3.0-alpha01 がリリースされました。バージョン 1.3.0-alpha01 に含まれる commit については、こちらをご覧ください。

バグの修正

  • Google Play 開発者サービスに必要な最小 APK バージョンは 2023 v08.23（APK バージョン APK バージョン 230815045）となり、このチェックはライブラリに組み込まれています。（aosp/2856137）。
  • 複数の処理中のリクエストの競合状態に起因するすでに再開中のエラーを修正（Ic3567）

バージョン 1.2

バージョン 1.2.2

2024 年 4 月 3 日

androidx.credentials:credentials:1.2.2 と androidx.credentials:credentials-play-services-auth:1.2.2 がリリースされました。バージョン 1.2.2 に含まれる commit については、こちらをご覧ください。

バグの修正

  • 複数の処理中のリクエストの競合状態に起因するすでに再開中のエラーを修正（Ic3567）
  • clearCredentialState API に起因する NPE を修正（b/327686881）

バージョン 1.2.1

2024 年 3 月 6 日

androidx.credentials:credentials:1.2.1 と androidx.credentials:credentials-play-services-auth:1.2.1 がリリースされました。バージョン 1.2.1 に含まれる commit については、こちらをご覧ください。

バグの修正

  • プラットフォームの認証情報マネージャーが利用できない場合の代替ソリューションを提供しました。（b/310701473）。

バージョン 1.2.0

2023 年 11 月 1 日

androidx.credentials:credentials:1.2.0 と androidx.credentials:credentials-play-services-auth:1.2.0 がリリースされました。バージョン 1.2.0 に含まれる commit については、こちらをご覧ください。

1.0.0 以降の重要な変更

  • このリリースでは、認証情報プロバイダをサポートするための新しい API セットが ユーザーごとのパスワード、パスキーの保存と取得できます。

バージョン 1.2.0-rc01

2023 年 10 月 4 日

androidx.credentials:credentials:1.2.0-rc01 と androidx.credentials:credentials-play-services-auth:1.2.0-rc01 がリリースされました。バージョン 1.2.0-rc01 に含まれる commit については、こちらをご覧ください。

  • バージョン バンプリリースと小規模な実装アップデート

バージョン 1.2.0-beta04

2023 年 9 月 20 日

androidx.credentials:credentials:1.2.0-beta04 と androidx.credentials:credentials-play-services-auth:1.2.0-beta04 がリリースされました。バージョン 1.2.0-beta04 に含まれる commit については、こちらをご覧ください。

新機能

  • 「Google でログイン」のログイン インテント取得フローを追加しました。（Ib6559、I7a042）。
  • 許可リストに登録されたパッケージの単一署名チェックを追加しました。（Ie6ff5）。
  • 更新された toJson() メソッドを使用するように PublicKeyCredential JSON 解析を更新しました。（I708e3、I00402）。

バグの修正

  • 欠落していた ProGuard ルールを修正しました（b/288120539）

バージョン 1.2.0-beta03

2023 年 8 月 23 日

androidx.credentials:credentials:1.2.0-beta03 と androidx.credentials:credentials-play-services-auth:1.2.0-beta03 がリリースされました。バージョン 1.2.0-beta03 に含まれる commit については、こちらをご覧ください。

バグの修正

  • webauthn 仕様で計画的な非推奨化により、uvm 拡張機能を削除します。（I2d46d）。
  • clientExtensions、credProps、rk プロパティに関する webauthn 仕様への準拠を確保（I3ab01）

バージョン 1.2.0-beta02

2023 年 8 月 1 日

androidx.credentials:credentials:1.2.0-beta02 と androidx.credentials:credentials-play-services-auth:1.2.0-beta02 がリリースされました。バージョン 1.2.0-beta02 に含まれる commit については、こちらをご覧ください。

バグの修正

  • b/293743991 - PublicKeyCredential の authenticationResponseJson プロパティを正しく解析できるように、authenticatorData フィールドの定数値を修正します。

バージョン 1.2.0-beta01

2023 年 7 月 26 日

androidx.credentials:credentials:1.2.0-beta01 と androidx.credentials:credentials-play-services-auth:1.2.0-beta01 がリリースされました。バージョン 1.2.0-beta01 に含まれる commit については、こちらをご覧ください。

API の変更

  • オリジンにデータが入力されているかどうかを判断する API を公開しました（Ia91f4）。
  • カスタム例外を意味的に正しいものにしました。（Ibf6f4）
  • テスト API を追加（I61c1d）
  • テスト API を追加（Iaeb6f）
  • 試験運用版の isAtLeastU() API の使用を削除しました（Ie9117、b/289269026）。
  • 許可リストを受け取るカスタムの送信元ゲッターを公開しました。（I0c1b4）
  • VisibleForTest アノテーションを追加しました（I5467a）。
  • VisibleForTest アノテーションを追加しました（Idf57a）。
  • テスト専用 API を削除しました（Idcc05）
  • プロバイダ エントリクラスを下位 API レベルに公開しました（I2e00a）。
  • テスト API を追加しました（Id6b9e）

バグの修正

  • テスト API を追加しました（I0d243）。
  • 新しいテスト API を追加しました（I6fa12）。
  • 作成リクエストの自動選択を公開しました（I84eee）
  • JSON エンコード エラーをより詳細にしました。（I7a865）
  • アクティビティ以外のコンテキスト パラメータに対するデベロッパー エラーを適切に報告する（/I20dd7、b/288288940）
  • プロバイダから返される例外の例外解析を修正しました（Iaa2af、I0d243、I55151）。
  • toSlice のドキュメントを改善しました

バージョン 1.2.0-alpha05

2023 年 6 月 7 日

androidx.credentials:credentials:1.2.0-alpha05 と androidx.credentials:credentials-play-services-auth:1.2.0-alpha05 がリリースされました。このバージョンは内部ブランチで開発されています。

新機能

  • パブリック ブランチとともに導入された GMS モジュールで、get API の下位互換解析。

バージョン 1.2.0-alpha04

2023 年 5 月 10 日

androidx.credentials:credentials:1.2.0-alpha04 と androidx.credentials:credentials-play-services-auth:1.2.0-alpha04 がリリースされました。このバージョンは内部ブランチで開発されています。

バージョン 1.2.0-alpha03

2023 年 4 月 12 日

androidx.credentials:credentials:1.2.0-alpha03 と androidx.credentials:credentials-play-services-auth:1.2.0-alpha03 がリリースされました。これは内部ブランチからリリースされました。

バージョン 1.2.0-alpha02

2023 年 3 月 8 日

androidx.credentials:credentials:1.2.0-alpha02 と androidx.credentials:credentials-play-services-auth:1.2.0-alpha02 がリリースされました。内部ブランチで開発。

API の変更

  • コンストラクタを公開することで、プロバイダ リクエスト クラスのテストを有効にします。
  • すべてのエントリクラスでアイコンを必須にします。ただし、認証情報プロバイダからアイコンが提供されていない場合、このライブラリには代替アイコンがあります。
  • 認証情報プロバイダで複数の認証アクション エントリを設定できるようにし、それぞれにタイトルを設定します。
  • すべての特権リクエスト クラスを削除します。プロバイダが android.service.credentials.CallingAppInfo クラスからオリジンを取得するだけで、特権呼び出し（別のアプリの代理呼び出し）用の特別なリクエスト クラスを処理する必要はなくなりました。

バージョン 1.2.0-alpha01

2023 年 2 月 8 日

androidx.credentials:credentials:1.2.0-alpha01 と androidx.credentials:credentials-play-services-auth:1.2.0-alpha01 がリリースされました。バージョン 1.2.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • このリリースでは、認証情報プロバイダをサポートするための新しい API セットが ユーザーごとのパスワード、パスキーの保存と取得できます。

API の変更

  • Credential Provider をサポートする新しい API を追加しました。

バージョン 1.0

<ph type="x-smartling-placeholder">

バージョン 1.0.0-alpha09

2023 年 6 月 7 日

androidx.credentials:credentials:1.0.0-alpha09 と androidx.credentials:credentials-play-services-auth:1.0.0-alpha09 がリリースされました。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

バグの修正

  • 例外タイプが正確かつ一貫していることを検証します。（Id13d7）。
  • パスキー取得リクエストで JSON 形式をサポートします。（I25100）。
  • パスキー取得フローに以前の GMS モジュールとの下位互換性があります（I23878）。

バージョン 1.0.0-alpha08

2023 年 5 月 3 日

androidx.credentials:credentials:1.0.0-alpha08 と androidx.credentials:credentials-play-services-auth:1.0.0-alpha08 がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。

バグの修正

  • デバッグ出力の読みやすさとエラー メッセージを改善しました。

バージョン 1.0.0-alpha07

2023 年 4 月 19 日

androidx.credentials:credentials:1.0.0-alpha07 と androidx.credentials:credentials-play-services-auth:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit については、こちらをご覧ください。

バグの修正

バージョン 1.0.0-alpha06

2023 年 4 月 5 日

androidx.credentials:credentials:1.0.0-alpha06 と androidx.credentials:credentials-play-services-auth:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

新機能

  • Google ID との統合の更新（com.google.android.libraries.identity.googleid:googleid:1.0.0 と連携します）

バージョン 1.0.0-alpha05

2023 年 3 月 22 日

androidx.credentials:credentials:1.0.0-alpha05 と androidx.credentials:credentials-play-services-auth:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

バグの修正

  • ユーザーがモーダル シートをキャンセルしたときに、ユーザーのキャンセル エラーを適切に報告します。（/I9ff3、b/271863184）。

バージョン 1.0.0-alpha04

2023 年 3 月 8 日

androidx.credentials:credentials:1.0.0-alpha04 と androidx.credentials:credentials-play-services-auth:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

API の変更

  • Jetpack ライブラリでオリジンを設定するための android.permission.CREDENTIAL_MANAGER_SET_ORIGIN 要件を追加しました。（Ibaad4）。
  • パスキー取得フロー例外を追加しました（I4f654）。
  • CredentialManager API の自動選択の動作の更新（I576dd）
  • CreateCredentialRequest.DisplayInfo は、String フィールドではなく CharSequence フィールドを使用するようになりました。（I85e70）。

バグの修正

  • Play 認証モジュールが R8 によって削除されないように ProGuard ルールを追加。（9543977）。

バージョン 1.0.0-alpha03

2023 年 2 月 22 日

androidx.credentials:credentials:1.0.0-alpha03 と androidx.credentials:credentials-play-services-auth:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれるコミットについては、こちらをご覧ください。

新機能

  • 「Google でログイン」のサポートを追加しました。

API の変更

  • UnsupportedException が正しく機能することを許可します（I68208）。
  • デバイスに必要なフラグが含まれていない場合などに対応するために、新しい例外タイプを追加しました（If08dd）
  • CredentialManager 例外 API（I72947）

バージョン 1.0.0-alpha02

2023 年 2 月 8 日

androidx.credentials:credentials:1.0.0-alpha02 と androidx.credentials:credentials-play-services-auth:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

API の変更

  • CredentialManager API 署名を変更しました。（Iabdec）
  • CredentialManager API 署名を変更しました。（I977ed）
  • CredentialManager API 署名を変更しました。（Ia6e9b）

バグの修正

  • webauthn 仕様で古い「cable」がサポートされなくなり、その代わりとして、トランスポート リストで「hybrid」が返されるようになりました。
  • トランスポートが 2 次元リストで返されていた問題を、正しい 1 次元リストになるよう修正しました。

バージョン 1.0.0-alpha01

2023 年 1 月 11 日

androidx.credentials:credentials:1.0.0-alpha01 と androidx.credentials:credentials-play-services-auth:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • このリリースには、ユーザーの認証情報への統一アクセスを提供する新しい Jetpack ライブラリが含まれています。パスワード、パスキー、フェデレーション認証情報などが含まれます。このライブラリは、シームレスで安全なログイン エクスペリエンスを提供する場合に使用する必要があります。
  • 「androidx.credentials:credentials-play-services-auth:1.0.0-alpha01」は、認証情報を Google パスワード マネージャーに保存し、そこから取得できるライブラリ（オプション）です。Android API レベル 33 以前を搭載しているデバイスでは、この依存関係が必要です。

API の変更

  • 新しい API を含む新しいライブラリを追加