PINを変更する

物理カード内でPINの露出を制限するため、イシュアアプリケーションはPIN変更の作業をD1 SDKに委譲します。

現在サポートされている（イシュアバックエンドからの）PINフォーマットは次のとおりです：

• PIN ISO0
• PIN 3DES Seccos

ユーザーエクスペリエンス

イシュアアプリケーションのサンプルPIN変更画面

フロー

PINを変更するためのハイレベルフロー

1. ユーザーはバンキングアプリで認証し、PIN変更を要求します
2. SDKへの内部呼び出しが行われます
3. PINを安全に入力する
4. D1 バックエンド API
5. D1はデバイス鍵からイシュア鍵へPINを変換暗号化します
6. PINをイシュアのバックエンドに設定する

シーケンス図

前提条件

• コンシューマー、口座、およびカードがすでにD1に登録されていること
• SDKが適切に初期化されていること
• イシュアアプリがD1 SDKのログインAPIを呼び出していること。

PIN変更のためのシーケンス図

必要なAPI

API	インバウンド／アウトバウンド	説明
承認トークンを取得	イシュア <- Thales D1	イシュアバックエンドを呼び出すためのOAuth 2.0アクセストークンを取得します。
PIN設定	イシュア <- Thales D1	モバイルアプリからイシュアのバックエンドにPINを設定します。

条件付きAPI

API	インバウンド／アウトバウンド	説明
PIN変更カウンター取得API	イシュア <- Thales D1	PIN Seccosの場合。PIN計算に必要なPIN変更カウンターを取得するために使用されます

SDK

注意

セキュリティ強化のため、Change PIN APIは他のAPIよりも既定でより厳格な最終ログインタイムアウト期間を持っています。PIN変更を成功させるには、PIN変更を送信する前に割り当てられた時間内にログイン／再ログインフローを完了するように管理する必要があります。

Android

@Nullable
@Override
public View onCreateView(
        @NonNull LayoutInflater inflater,
        @Nullable ViewGroup container,
        @Nullable Bundle savedInstanceState
) {
    View view = inflater.inflate(R.layout.fragment_main, container, false);

    SecureEditText entryEditPin = (SecureEditText)view.findViewById(R.id.pin_entry);
    SecureEditText confirmEditPin = (SecureEditText)view.findViewById(R.id.pin_confirm);
    PINEntryUI.PINEventListener listener = new PINEntryUI.PINEventListener() {
        @Override
        public void onPinEvent(PINEntryUI.PINEvent pinEvent, String additionalInfo) {
            switch (pinEvent){
                case FIRST_ENTRY_FINISH:
                    // フォーカスをconfirmEditPinに切り替える
                    break;
                case PIN_MATCH:
                    // 続行／送信ボタンを有効にする
                    break;
                case PIN_MISMATCH:
                    // 続行／送信ボタンを無効にし、PIN_MISMATCHのエラーを表示する
                    break;
            }
        }
    };

    String cardID = ""; // 例：サーバーから取得
    ChangePINOptions options = new ChangePINOptions(4);
    pinEntryUI = d1Task.changePIN(cardID, entryEditPin, confirmEditPin, options, listener);

    Button button = (Button)view.findViewById(R.id.pin_submit);
    button.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            pinEntryUI.submit(new D1Task.Callback<Void>() {
                @Override
                public void onSuccess(final Void data) {
                }

                @Override
                public void onError(@NonNull final D1Exception exception) {
                }
            });
        }
    });
    
    return view;
}

iOS