> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/nfc-wallet-sdk-android/ja/help/knowledge-base/android-12-keystore-creation-issue.md).

# Android 12 の Keystore 作成の問題

## 概要

NFC Wallet SDK はエンドユーザー認証を必要とする Android Keystore キーを作成します。このキーは非接触決済時に使用される決済資産を保護します。一部のデバイスでは、認証が必要な場合にキーの作成に失敗します。

{% hint style="warning" %}
この問題は次の場合にウォレットのアクセスと支払いをブロックします。 **CDCVM** デバイス認証を要求します。
{% endhint %}

### 症状

The **デジタルウォレットアプリケーション** 初期化時にキーを作成します **デバイスCVM**。これは次を呼び出したときに発生します `DeviceCVMManager.INSTANCE.initialize(CHVerificationMethod)`.

この問題は通常次の環境で発生します:

* `CHVerificationMethod.DEVICE_KEYGUARD`
* `CHVerificationMethod.BIOMETRICS`

キーの作成に失敗すると、NFC Wallet SDK は例外をスローします `DeviceCVMException`。メッセージは通常次のとおりです:

`AKS キーの作成に問題があります。秘密鍵の格納に失敗しました`

```java
// ウォレットのために Device CVM を初期化します
DeviceCVMManager.INSTANCE.initialize(CHVerificationMethod.BIOMETRICS);
```

デバッグビルドの NFC Wallet SDK で再現すると、次のようなメッセージが表示されることがあります:

```
java.security.KeyStoreException: Failed to store private key
 at android.security.keystore2.AndroidKeyStoreSpi.setPrivateKeyEntry(AndroidKeyStoreSpi.java:581)
 at android.security.keystore2.AndroidKeyStoreSpi.engineSetEntry(AndroidKeyStoreSpi.java:1211)
 at java.security.KeyStore.setEntry(KeyStore.java:1617)
 at java.lang.reflect.Method.invoke(Native Method)
 …
 原因: android.security.KeyStoreException: Keystore not initialized
   at android.security.KeyStore2.getKeyStoreException(KeyStore2.java:384)
   at android.security.KeyStoreSecurityLevel.handleExceptions(KeyStoreSecurityLevel.java:59)
   at android.security.KeyStoreSecurityLevel.importKey(KeyStoreSecurityLevel.java:204
   …
```

### 根本原因

類似の Android プラットフォームの問題が Google Issue Tracker で追跡されています。参照してください [issue 195330769](https://issuetracker.google.com/issues/195330769).

Google は修正が次から利用可能であると示しています **Android 12L**。修正は次にはバックポートされていません **Android 12**.

### 影響を受ける Android バージョンとデバイス

報告の大部分は **Android 12**で、しばしば Xiaomi デバイスで発生します。2026 年 2 月時点で、以下の網羅的でないリストが報告されています:

| ベンダー    | モデル            | Android バージョン | API レベル |
| ------- | -------------- | ------------- | ------- |
| Honor   | NTH-NX9        | Android 12    | 31      |
| LGE     | LG-US996       | Android 8.0   | 26      |
| OnePlus | KB2003         | Android 12    | 31      |
| Samsung | SM-G998B       | Android 12    | 31      |
| Samsung | SM-G998U       | Android 12    | 31      |
| Samsung | SM-A426BZKHXSP | Android 12    | 31      |
| Samsung | SM-A516U       | Android 12    | 31      |
| Xiaomi  | M2101K7BNY     | Android 12    | 31      |
| Xiaomi  | 2109119DG      | Android 12    | 31      |
| Xiaomi  | 22031116BG     | Android 12    | 31      |
| Xiaomi  | M2007J3SG      | Android 12    | 31      |
| Xiaomi  | M2012K11G      | Android 12    | 31      |
| Xiaomi  | M2007J17G      | Android 12    | 31      |
| Xiaomi  | M2101K9G       | Android 12    | 31      |
| Xiaomi  | M2007J20CG     | Android 12    | 31      |
| Xiaomi  | 21081111RG     | Android 12    | 31      |
| Xiaomi  | M2004J19C      | Android 11    | 30      |
| Xiaomi  | POCO F2 Pro    | Android 12    | 31      |
| Xiaomi  | M2011K2G       | Android 12    | 31      |
| Xiaomi  | M2102J20SG     | Android 12    | 31      |

### 回避策と次のステップ

1. **デバイスが Android 12 を実行している場合は、Android 12L 以降にアップグレードしてください。**
2. **デバイスが他のバージョンを実行している場合は、デバイスのロックと生体認証をリセットしてください。**
   * 画面ロックを解除してください。
   * デバイスを再起動してください。
   * 生体認証を再登録してください。
   * 画面ロックを再設定してください。
3. **Device CVM の初期化を再試行してください。**

問題が Android 12 以外のデバイスで再現する場合は、サポートチケットを開いてください。デバイスモデル、Android バージョン、および完全なログを共有してください。次に従ってください [Thales NFC Wallet SDK の問題を報告する方法は?](/nfc-wallet-sdk-android/ja/help/knowledge-base/report-nfc-wallet-sdk-issues.md)。ログを取得するには次を使用してください [Android デバイスからログを取得する](/nfc-wallet-sdk-android/ja/help/knowledge-base/retrieve-logs-from-an-android-device.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/nfc-wallet-sdk-android/ja/help/knowledge-base/android-12-keystore-creation-issue.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.