PKA 暗号化 (CSNDPKE および CSNFPKE)

CALL CSNDPKE(
             return_code,
             reason_code,
             exit_data_length,
             exit_data,
             rule_array_count,
             rule_array,
             keyvalue_length,
             keyvalue,
             data_structure_length,
             data_structure,
             PKA_key_identifier_length,
             PKA_key_identifier,
             PKA_enciphered_keyvalue_length,
             PKA_enciphered_keyvalue)

return_code

方向	タイプ
出力	整数

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

reason_code

方向	タイプ
出力	整数

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

exit_data_length

方向	タイプ
入出力	整数

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

exit_data

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

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

rule_array_count

方向	タイプ
入力	整数

rule_array パラメーターで指定するキーワードの数。 値は 1 または 2 にすることができます。

rule_array

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

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

表 1. PKA 暗号化のキーワード

キーワード	意味
フォーマット方式 (必須) : 暗号化の前に鍵値をフォーマットするために使用される方式が指定されます。
PKCS-1.2	指定の鍵値をフォーマットするために RSA PKCS #1 V1.5 ブロック・タイプ 02 フォーマットが使用されます。
ZERO-PAD	鍵値の左側には、PKA 鍵モジュラスの長さまで 2 進ゼロが埋め込まれます。 公開鍵の指数は奇数でなければなりません。
MRP	鍵値の左側には、PKA 鍵モジュラスの長さまで 2 進ゼロが埋め込まれます。 RSA 公開鍵の指数は偶数でも奇数でもかまいません。
鍵規則 (オプション)
KEYIDENT	これは、keyvalue フィールド内の値が CKDS における非暗号化トークンのラベルであることを指示します。 keyvalue_length は 64 でなければなりません。

keyvalue_length

方向	タイプ
入力	整数

keyvalue パラメーターの長さ。 最大フィールド・サイズは 512 バイトです。 実際の最大サイズは、PKA_key_identifier のモジュラス長と、rule_array パラメーターで 指定されるフォーマット方式によって決まります。 鍵規則 KEYIDENT が指定される場合、keyvalue_length パラメーターは 64 バイトにする必要があります。

keyvalue

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

この フィールドには、PKA_key_identifier で暗号化される指定の非暗号化鍵値が含まれます。 鍵規則 KEYIDENT が指定される場合、keyvalue パラメーターには、 有効な CKDS 非暗号化鍵トークンのラベルが含まれているとみなされます。

data_structure_length

方向	タイプ
入力	整数

この値は 0 でなければなりません。

data_structure

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

このフィールドは現在では無視されます。

PKA_key_identifier_length

方向	タイプ
入力	整数

PKA_key_identifier パラメーターの長さ。 PKA_key_identifier が鍵ラベルの場合、このフィールドはラベルの長さを指定します。 指定できる最大サイズは 3500 バイトです。

PKA_key_identifier

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

指定された鍵値の暗号化に使用される RSA 公開鍵/秘密鍵の トークンまたはラベル。

PKA_enciphered_keyvalue_length

方向	タイプ
入出力	整数

PKA_enciphered_keyvalue パラメーターの長さ (バイト)。 指定できる最大サイズは 512 バイトです。 戻り時に、このフィールドは、PKA_enciphered_keyvalue の実際の長さで更新されます。

この長さは PKA_key_identifier のモジュラス長と同じでなければなりません。

PKA_enciphered_keyvalue

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

このフィールドには、RSA 公開鍵で保護されている鍵値が含まれます。 このバイト長ストリングは PKA_enciphered_keyvalue パラメーター内で左寄せにされます。

RSA 公開鍵の指数は奇数でなければなりません。 モジュラスが 2048 を超える場合、公開鍵指数は 3 または 65537 でなければなりません。

「PKA Encrypt」アクセス制御点は、このサービスの機能を制御するものです。

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