暗号化 PIN 変換 (CSNBPTR および CSNEPTR)

CALL CSNBPTR(
             return_code,
             reason_code,
             exit_data_length,
             exit_data,
             input_PIN_encrypting_key_identifier,
             output_PIN_encrypting_key_identifier,
             input_PIN_profile,
             PAN_data_in,
             PIN_block_in,
             rule_array_count,
             rule_array,
             output_PIN_profile,
             PAN_data_out,
             sequence_number,
             PIN_block_out) 

return_code

方向	タイプ
出力	整数

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

reason_code

方向	タイプ
出力	整数

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

exit_data_length

方向	タイプ
入出力	整数

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

exit_data

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

インストール・システム出口に渡されるデータ。

input_PIN_encrypting_key_identifier

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

64 バイト内部鍵トークンまたは鍵ラベルとして指定される PIN_block_in パラメーター用の入力 PIN 暗号鍵 (IPINENC)。 キーワード UKPTIPIN、UKPTBOTH、DUKPT-IP、または DUKPT-BH が rule_array で指定されている場合は、input_PIN_encrypting_key_identifier で、UKPT 使用ビットが有効になっている KEYGENKY の鍵トークンまたは鍵ラベルを指定する必要があります。

output_PIN_encrypting_key_identifier

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

64 バイト内部鍵トークンまたは鍵ラベルとして指定される PIN_block_out パラメーター用の出力 PIN 暗号鍵 (OPINENC)。 キーワード UKPTOPIN、UKPTBOTH、DUKPT-OP、または DUKPT-BH が rule_array で指定されている場合は、output_PIN_encrypting_key_identifier で、UKPT 使用ビットが有効になっている KEYGENKY の鍵トークンまたは鍵ラベルを指定する必要があります。

input_PIN_profile

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

フォーマット設定済み PIN ブロックを作成するため、またはフォーマット設定された PIN ブロックから PIN を抽出するために必要な情報を含む、3 つの 8 バイト文字エレメント。 PIN プロファイルは、PIN ブロックが呼び出し可能サービスによって暗号化されているか復号されているかに応じて、入力 PIN プロファイルまたは出力 PIN プロファイルのいずれかになります。 追加情報については、PIN プロファイルを参照してください。

REFORMAT 処理規則 (rule_array パラメーター) を使用して暗号化 PIN 変換呼び出し可能サービス内の 3624 または 3621 PIN ブロックから PIN を抽出するには、埋め込み数字が必要です。 処理規則が TRANSLAT の場合、埋め込み数字は無視されます。

PAN_data_in

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

処理規則 (rule_array パラメーター) が REFORMAT であり、入力 PIN フォーマットが ISO-0 または VISA-4 のみの場合は、個人アカウント番号 (PAN)。 その他の場合、このパラメーターは無視されます。 12 桁のアカウント・データを文字フォーマットで指定します。

ISO-0 の場合、チェック・ディジットを除き、PAN の右端 12 桁を使用します。

VISA-4 の場合、チェック・ディジットを除き、PAN の左端 12 桁を使用します。

PIN_block_in

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

変換する PIN を含む 8 バイトの暗号化 PIN ブロック。

rule_array_count

方向	タイプ
入力	整数

rule_array パラメーターで指定された処理規則数。 値は 1、2、3 のいずれかです。

rule_array

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

呼び出し可能サービスの処理規則。

表 1. 暗号化 PIN 変換のキーワード

キーワード	意味
処理規則 (必須)
REFORMAT	PIN フォーマット、PIN ブロックの内容、および PIN 暗号鍵を変更します。
TRANSLAT	PIN 暗号鍵のみを変更します。 PIN フォーマットおよび PIN ブロックの内容は変更されません。
PIN ブロック・フォーマットおよび PIN 抽出方式 (オプション)	追加情報と、PIN ブロック・フォーマットおよび PIN 抽出方式キーワードのリストについては、PIN ブロック・フォーマットおよび PIN 抽出方式キーワードを参照してください。 注: PIN 抽出方式が指定されていない場合、表 1にリストされる最初の PIN ブロック・フォーマットがデフォルトになります。
DUKPT キーワード - 単一長鍵導出 (オプション)
UKPTIPIN	input_PIN_encrypting_key_identifier は単一長鍵として導出されます。 input_PIN_encrypting_key_identifier は、UKPT 使用ビットが有効になっている KEYGENKY 鍵でなければなりません。 input_PIN_profile は 48 バイトで、鍵シリアル番号が含まれていなければなりません。
UKPTOPIN	output_PIN_encrypting_key_identifier は単一長鍵として導出されます。 output_PIN_encrypting_key_identifier は、UKPT 使用ビットが有効になっている KEYGENKY 鍵でなければなりません。 output_PIN_profile は 48 バイトで、鍵シリアル番号が含まれていなければなりません。
UKPTBOTH	input_PIN_encrypting_key_identifier および output_PIN_encrypting_key_identifier はいずれも単一長鍵として導出されます。 input_PIN_encrypting_key_identifier および output_PIN_encrypting_key_identifier はいずれも、UKPT 使用ビットが有効になっている KEYGENKY 鍵でなければなりません。 input_PIN_profile および output_PIN_profile はいずれも 48 バイトで、それぞれの鍵シリアル番号が含まれていなければなりません。
DUKPT キーワード - 倍長鍵導出 (オプション) - 2004 年 5 月以降のバージョンのライセンス内部コード (LIC) が必要です
DUKPT-IP	input_PIN_encrypting_key_identifier は倍長鍵として導出されます。 input_PIN_encrypting_key_identifier は、UKPT 使用ビットが有効になっている KEYGENKY 鍵でなければなりません。 input_PIN_profile は 48 バイトで、鍵シリアル番号が含まれていなければなりません。
DUKPT-OP	output_PIN_encrypting_key_identifier は倍長鍵として導出されます。 output_PIN_encrypting_key_identifier は、UKPT 使用ビットが有効になっている KEYGENKY 鍵でなければなりません。 output_PIN_profile は 48 バイトで、鍵シリアル番号が含まれていなければなりません。
DUKPT-BH	input_PIN_encrypting_key_identifier および output_PIN_encrypting_key_identifier はいずれも倍長鍵として導出されます。 input_PIN_encrypting_key_identifier および output_PIN_encrypting_key_identifier はいずれも、UKPT 使用ビットが有効になっている KEYGENKY 鍵でなければなりません。 input_PIN_profile および output_PIN_profile はいずれも 48 バイトで、それぞれの鍵シリアル番号が含まれていなければなりません。

output_PIN_profile

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

フォーマット設定済み PIN ブロックを作成するため、またはフォーマット設定された PIN ブロックから PIN を抽出するために必要な情報を含む、3 つの 8 バイト文字エレメント。 PIN プロファイルは、PIN ブロックが呼び出し可能サービスによって暗号化されているか復号されているかに応じて、入力 PIN プロファイルまたは出力 PIN プロファイルのいずれかになります。

• rule_array パラメーターで REFORMAT 処理規則を選択した場合、入力 PIN プロファイルおよび出力 PIN プロファイルでは異なる PIN ブロック・フォーマットを使用できます。
• rule_array パラメーターで UKPTOPIN または UKPTBOTH を指定する場合、output_PIN_profile は 48 バイト・フィールドに拡張され、現行鍵シリアル番号を含んでいなければなりません。 追加情報については、PIN プロファイルを参照してください。
• rule_array パラメーターで DUKPT-OP または DUKPT-BH を指定する場合、output_PIN_profile は 48 バイト・フィールドに拡張され、現行鍵シリアル番号を含んでいなければなりません。 追加情報については、PIN プロファイルを参照してください。

PAN_data_out

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

処理規則 (rule_array パラメーター) が REFORMAT であり、出力 PIN フォーマットが ISO-0 または VISA-4 のみの場合は、個人アカウント番号 (PAN)。 その他の場合、このパラメーターは無視されます。 12 桁のアカウント・データを文字フォーマットで指定します。

ISO-0 の場合、チェック・ディジットを除き、PAN の右端 12 桁を使用します。

VISA-4 の場合、チェック・ディジットを除き、PAN の左端 12 桁を使用します。

sequence_number

方向	タイプ
入力	整数

処理規則 (rule_array パラメーター) が REFORMAT であり、出力 PIN ブロック・フォーマットが 3621 または 4704-EPP のみの場合は、シーケンス番号。 整数値 99999 を指定します。 その他の場合、このパラメーターは無視されます。

PIN_block_out

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

再暗号化された 8 バイトの出力 PIN ブロック。

「Enhanced PIN Security」アクセス制御点が有効であり、出力 PIN プロファイルで 3624 または 3621 が PIN ブロック・フォーマットとして指定されている場合、埋め込み数字は 10 進数以外の数字に制限されます。

PIN プロファイルで指定されているフォーマット制御は、NONE でなければなりません。

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

一部の PIN ブロック・フォーマットは複数の名前で認識されています。 下表に、追加の名前を示します。

下表に、このサービスの機能を制御するドメイン役割内のアクセス制御点を示します。

「トランザクション単位の固有鍵」規則配列キーワードのいずれかが指定されている場合は、「UKPT - PIN Verify, PIN Translate」アクセス制御点が有効になっていなければなりません。

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