DK PRW CMAC 生成 (CSNBDPCG および CSNEDPCG)

DK PRW CMAC 生成呼び出し可能サービスを使用して、アカウント番号変更トランザクションに含まれている特定の値によってメッセージ認証コード (MAC) を生成します。この入力には、現在と新規の PAN およびカード・データと、PIN 参照値が含まれます。

このサービスの出力は、DK PAN トランザクションでの変更呼び出し可能サービスに対する入力として使用されます。DK PAN トランザクションでの変更呼び出し可能サービスは、PIN を検証するために使用される新規 PIN 参照値 (PRW) を作成します。

AMODE(64) 呼び出しの呼び出し可能サービス名は CSNEDPCG です。

形式

CALL CSNBDPCG(
             return_code,
             reason_code,
             exit_data_length,
             exit_data,
             rule_array_count,
             rule_array,
             current_PAN_data_length,
             current_PAN_data,
             new_PAN_data_length,
             new_PAN_data,
             current_card_data_length,
             current_card_data,
             new_card_data_length,
             new_card_data,
             PIN_reference_value_length,
             PIN_reference_value,
             CMAC_FUS_key_identifier_length,
             CMAC_FUS_key_identifier,
             CMAC_FUS_length,
             CMAC_FUS)

パラメーター

return_code
方向 タイプ
出力 整数

戻りコードは、呼び出し可能サービスの一般的な結果を示しています。 ICSF および暗号化コプロセッサーの戻りコードおよび理由コードに、戻りコードがリストされています。

reason_code
方向 タイプ
出力 整数

理由コードは、アプリケーション・プログラムに返される、呼び出し可能サービスの結果を示しています。 戻りコードにはそれぞれ、特定の処理問題を示すさまざまな理由コードが割り当てられています。 ICSF および暗号化コプロセッサーの戻りコードおよび理由コード に、理由コードがリストされています。

exit_data_length
方向 タイプ
入出力 整数

インストール・システム出口に渡されるデータの長さ。 データは exit_data パラメーターで識別されます。

exit_data
方向 タイプ
入出力 ストリング

このデータはインストール出口に渡されます。

rule_array_count
方向 タイプ
入力 整数

rule_array パラメーターで指定するキーワードの数。 値は 0 でなければなりません。

rule_array
方向 タイプ
入力 ストリング

制御情報を呼び出し可能サービスに提供するキーワード。 キーワードは、連続するストレージ内になければならず、各キーワードはその 8 バイト位置で左寄せされ、右側にブランクが埋め込まれている必要があります。 このサービスにはキーワードはありません。

current_PAN_data_length
方向 タイプ
入力 整数

current_PAN_data パラメーターの長さ (バイト) を指定します。値は 10 から 19 の範囲でなければなりません。

current_PAN_data
方向 タイプ
入力 ストリング

現在の PAN データ。チェック・ディジットを含むアカウント番号全体が含まれている必要があります。

new_PAN_data_length
方向 タイプ
入力 整数

new_PAN_data パラメーターの長さ (バイト) を指定します。値は 10 から 19 の範囲でなければなりません。

new_PAN_data
方向 タイプ
入力 ストリング

新規の PAN データ。チェック・ディジットを含むアカウント番号全体が含まれている必要があります。

current_card_data_length
方向 タイプ
入力 整数

current_card_data パラメーターの長さ (バイト) を指定します。値は 4 から 512 の範囲でなければなりません。

current_card_data
方向 タイプ
入力 ストリング

カード発行者によって決定される現在のカード・データ。

new_card_data_length
方向 タイプ
入力 整数

new_card_data パラメーターの長さ (バイト) を指定します。値は 4 から 512 の範囲でなければなりません。

new_card_data
方向 タイプ
入力 ストリング

カード発行者によって決定される新しいカード・データ。

PIN_reference_value_length
方向 タイプ
入力 整数

PIN_reference_value パラメーターの長さ (バイト) を指定します。値は 16 でなければなりません。

PIN_reference_value
方向 タイプ
入力 ストリング

現在の PIN の 16 バイトの PIN 参照値。

CMAC_FUS_key_identifier_length
方向 タイプ
入力 整数

CMAC_FUS_key_identifier パラメーターの長さ (バイト) を指定します。CMAC_FUS_key_identifier にラベルが含まれている場合、長さは 64 でなければなりません。それ以外の場合、この値は、トークンの実際の長さと 725 の間でなければなりません。

CMAC_FUS_key_identifier
方向 タイプ
入力 ストリング

MAC を生成する鍵の ID。 この鍵 ID は、操作可能トークンであるか、または鍵ストレージ内の操作可能トークンの鍵ラベルです。この鍵の鍵アルゴリズムは AES でなければならず、鍵タイプは MAC でなければなりません。また、鍵用途フィールドには GENONLY、CMAC、および DKPINAD2 が指定されている必要があります。

指定されたトークンが旧マスター鍵で暗号化されていた場合、このトークンは現行マスター鍵で暗号化されて返されます。

CMAC_FUS_length
方向 タイプ
入出力 整数

CMAC_FUS パラメーターの長さ (バイト) を指定します。値は 8 から 16 の範囲でなければなりません。

CMAC_FUS
方向 タイプ
出力 ストリング

現在と新規の PAN およびカード・データ・ストリングによる MAC。

使用上の注意

呼び出し側がこの呼び出し可能サービス、鍵ラベル、または CKDS に保管された内部セキュア鍵トークンの使用を許可されているかを検査するために、SAF が呼び出される場合があります。

アクセス制御点

ドメイン役割内の「DK PRW CMAC Generate」アクセス制御点がこのサービスの機能を制御します。

必須ハードウェア

下表に、各サーバー・タイプに必要な暗号化ハードウェアを示し、この呼び出し可能サービスの制約事項について説明します。

表 1. DK PRW CMAC 生成の必須ハードウェア
サーバー 必須暗号化ハードウェア 制約事項

IBM eServer zSeries 990
IBM eServer zSeries 890

  このサービスはサポートされていません。

IBM System z9 EC
IBM System z9 BC

  このサービスはサポートされていません。

IBM System z10 EC
IBM System z10 BC

  このサービスはサポートされていません。

IBM zEnterprise 196
IBM zEnterprise 114

Crypto Express3 コプロセッサー DK AES PIN 鍵のサポートには、2013 年 11 月以降のライセンス内部コード (LIC) が必要です。

IBM zEnterprise EC12
IBM zEnterprise BC12

Crypto Express3 コプロセッサー

Crypto Express4 CCA コプロセッサー

DK AES PIN 鍵のサポートには、2013 年 9 月以降のライセンス内部コード (LIC) が必要です。
IBM z13 Crypto Express5 CCA コプロセッサー