鍵パーツ・インポート (CSNBKPI および CSNEKPI)

CALL CSNBKPI(
             return_code,
             reason_code,
             exit_data_length,
             exit_data,
             rule_array_count,
             rule_array,
             key_part,
             key_identifier)

return_code

方向	タイプ
出力	整数

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

reason_code

方向	タイプ
出力	整数

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

exit_data_length

方向	タイプ
入出力	整数

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

exit_data

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

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

rule_array_count

方向	タイプ
入力	整数

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

rule_array

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

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

表 1. 鍵パーツ・インポート制御情報のキーワード

キーワード	意味
鍵パーツ (必須)
FIRST	このキーワードは、最初の鍵パーツが入力されることを指定します。 この呼び出し可能サービスでは、この鍵パーツがマスター鍵で暗号化されて指定の鍵トークンに入れられて返されます。
ADD-PART	このキーワードは、追加の鍵パーツ情報が指定されることを示します。
COMPLETE	このキーワードは、鍵の制御ベクトルにおいて鍵パーツ・ビットをオフにして 鍵を完全に操作可能にすることを指定します。 このキーワードでは鍵に鍵パーツ情報は追加されないことに注意してください。
MIDDLE	このキーワードは、中間の鍵パーツ (最初の鍵パーツでも最後の鍵パーツでもないもの) が入力されることを指定します。 このキーワードのコマンド制御点は LAST キーワードのコマンド制御点と同じであり、ADD-PART キーワードのコマンド制御点とは異なることに注意してください。
LAST	このキーワードは、最後の鍵パーツが入力されることを指定します。 制御ベクトルにおいて鍵パーツ・ビットがオフになります。
鍵ラップ方式 (オプション)
USECONFG	これは、システム・デフォルト構成を使用してラップ方式を決定することを指定します。 これがデフォルト・キーワードです。 システム・デフォルト鍵ラップ方式は、インストール・オプション・データ・セットで DEFAULTWRAP パラメーターを使用して指定できます。 「z/OS Cryptographic Services ICSF System Programmer's Guide」「z/OS Cryptographic Services ICSF System Programmer's Guide」「z/OS Cryptographic Services ICSF System Programmer's Guide」を 参照してください。
WRAP-ENH	これは、ANSI X9.24 標準に準拠した拡張鍵ラップ方式を使用します。
WRAP-ECB	これは、元の鍵ラップ方式 (DES 鍵トークンには ECB ラップが使用され、AES 鍵トークンには CBC ラップが使用される) を使用します。

key_part

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

入力対象の非暗号化鍵パーツを含む 16 バイト・フィールドです。 対象の鍵が単一長の鍵の場合は、鍵パーツを左寄せにして、右側にゼロを埋め込む必要があります。 COMPLETE が指定されている場合、このフィールドは無視されます。

key_identifier

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

内部トークンを含む 64 バイト・フィールド、 または既存の CKDS レコードのラベルを含む 64 バイト・フィールド。 rule_array が FIRST の場合、このフィールドは、KEY-PART でマークされている単一長/倍長の鍵の内部トークンのスケルトンです。 rule_array が MIDDLE または LAST の場合、これは内部トークンであるか、 または部分的に結合された鍵の CKDS レコードのラベルです。 入力フォーマットに応じて、累積された部分的な鍵や完全な鍵が、内部トークンまたは更新された CKDS レコードとして返されます。 返された key_identifier は現行マスター鍵で暗号化されます。

ICSF は、DES 鍵トークンにおいて鍵値をラップする方式として、 元の ECB ラップ方式と、ANSI X9.24 準拠の拡張 CBC ラップ方式の 2 つの方式をサポートします。 FIRST 鍵パーツのデフォルトを指定変更する規則配列キーワードが指定されていない場合、 出力 key_identifier ではデフォルト方式が使用されます。 key_identifier が既存のトークンの場合は、既存のトークンと同じラップ方式が使用されます。

key_identifier でラベルを指定する場合、そのラベルは固有でなければなりません。 複数のレコードが検出されると、サービスは失敗します。

この呼び出し可能サービスは、バージョン X'00' または X'01' の DES 鍵トークンのみをサポートします。

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

「複製された鍵半分」の鍵 (倍長の鍵の非暗号化テキストの左右の半分が等しい) は、左右の鍵半分が等しくない倍長の鍵ほどセキュアではありません。 ドメイン役割で「Key Part Import - Unrestricted」アクセス制御点が無効になっている場合、鍵パーツ・インポート・サービス verb は、 前述の鍵半分の制限を適用します。

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

このサービスは、Transaction Security System 鍵パーツ・インポート verb と整合性があります。