PKA 鍵変換 (CSNDPKT および CSNFPKT)

CALL CSNDPKT(
             return_code,
             reason_code,
             exit_data_length,
             exit_data,
             rule_array_count,
             rule_array,
             source_key_identifier_length,
             source_key_identifier,
             source_transport_key_identifier_length,
             source_transport_key_identifier,
             target_transport_key_identifier_length,
             target_transport_key_identifier,
             target_key_token_length,
             target_key_token)

return_code

方向	タイプ
出力	整数

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

reason_code

方向	タイプ
出力	整数

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

exit_data_length

方向	タイプ
入出力	整数

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

exit_data

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

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

rule_array_count

方向	タイプ
入力	整数

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

rule_array

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

制御情報を呼び出し可能サービスに提供するキーワード。 リストについては、表 1 を参照してください。 キーワードは、8 バイト・フィールドで左寄せされ、右側にブランクが埋め込まれます。

表 1. PKA 鍵変換規則配列のキーワード

キーワード	意味
出力フォーマット (いずれかが必須)
移行用出力フォーマット
EXTDWAKW	ソース鍵が外部 DES ラップ・トークンであり、AESKW ラップ・トークンに移行することを指定します。
INTDWAKW	ソース鍵が内部 DES ラップ・トークンであり、AESKW ラップ・トークンに移行することを指定します。
変換用出力フォーマット
EMVCRT	このキーワードは、外部 RSA CRT 鍵を EMV CRT フォーマットに変換し、TDES-ECB を使用してラップすることを指示します。 XLATE ビット (ビット 22) を target_transport_key_identifier 制御ベクトルで設定する必要があります。
EMVDDA	このキーワードは、外部 RSA CRT 鍵を EMV DDA フォーマットに変換し、TDES-CBC を使用してラップすることを指示します。 XLATE ビット (ビット 22) を target_transport_key_identifier 制御ベクトルで設定する必要があります。
EMVDDAE	このキーワードは、外部 RSA CRT 鍵を EMV DDAE フォーマットに変換し、TDES-ECB を使用してラップすることを指示します。 XLATE ビット (ビット 22) を target_transport_key_identifier 制御ベクトルで設定する必要があります。
SCCOMCRT	このキーワードは、鍵をスマート・カード中国剰余定理フォーマットに変換することを指示します。
SCCOMME	このキーワードは、鍵をスマート・カード・モジュラス指数フォーマットに変換することを指示します。
SCVISA	このキーワードは、鍵をスマート・カード Visa プロプラエタリー・フォーマットに変換することを指示します。

source_key_identifier_length

方向	タイプ
入力	整数

source_key_identifier 変数の長さ (バイト)。 最大長は 3500 バイトです。

source_key_identifier

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

このフィールドには、RSA 秘密鍵トークンを識別する鍵ラベル、または RSA 秘密-公開鍵トークンが含まれています。 スマート・カード処理の場合、鍵は外部鍵トークン内になければなりません。 OPK 移行の場合、トークンは内部または外部にすることができます。 外部トークンは DES 鍵暗号鍵でラップされます。 内部トークンが指定されている場合、トランスポート鍵は使用されません。

source_transport_key_identifier_length

方向	タイプ
入力	整数

source_transport_key_identifier パラメーターの長さ (バイト)。 この値は 64 でなければなりません。 フォーマット規則 INTDWAKW の場合、長さはゼロでなければなりません。

source_transport_key_identifier

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

このフィールドには、DES 鍵暗号鍵の内部トークンまたは内部ラベルが含まれます。 この鍵は、パラメーター source_key_identifier で指定された入力 RSA 鍵トークンのアンラップに使用されます。 使用可能なトランスポート鍵のタイプについて詳しくは、アクセス制御点を参照してください。

target_transport_key_identifier_length

方向	タイプ
入力	整数

target_transport_key_identifier パラメーターの長さ (バイト)。 DES 鍵暗号化が使用されている場合、この値は 64 でなければなりません。 AES 鍵暗号鍵が使用されている場合、この値はトークンの長さです。 最大長は 725 です。INTDWAKW の場合、長さはゼロでなければなりません。

target_transport_key_identifier

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

このフィールドには、DES 鍵暗号鍵の内部トークンまたは内部ラベルが含まれます。 この鍵は、パラメーター target_key_token で返される出力 RSA 鍵のラップに使用されます。 使用可能なトランスポート鍵のタイプについて詳しくは、アクセス制御点を参照してください。

target_key_token_length

方向	タイプ
入出力	整数

target_key_token パラメーターの長さ (バイト)。 出力時に、この変数の値は、呼び出し可能サービスによって生成された target_key_token の実際の長さを含むように更新されます。 最大長は 3500 バイトです。

target_key_token

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

このフィールドは、規則配列で指定されたスマート・カード・フォーマットの RSA 鍵を含み、target_transport_key パラメーターで指定された鍵暗号鍵によって保護されます。 これは CCA トークンではなく、PKDS に保管することはできません。

CCA RSA ME トークンは、SCCOMCRT、EMV DDA、EMV DDAE、または EMV CRT フォーマットには変換されません。 CCA RSA CRT トークンは、SCCOMME フォーマットには変換されません。 SCVISA では、モジュラス指数 (ME) 鍵のみがサポートされています。

EMVDDA、EMVDDAE、または EMVCRT の各フォーマットの場合、CCA RSA CRT トークンの最大モジュラス・サイズは 2040 ビットです。

秘密セクション X'08' を持つ CCA RSA CRT トークンのみが、EMVDDA、EMVDDAE、または EMVCRT 規則配列キーワードでサポートされます。

フォーマット規則配列キーワードおよび使用可能なトランスポート鍵タイプの使用を制御するアクセス制御点は、以下のとおりです。

以下のアクセス制御点は、下表に示す鍵タイプの組み合わせを制御します。 これらのアクセス制御点のいずれかを有効にする必要があります。

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