非暗号化鍵インポート (CSNBCKI および CSNECKI)

非暗号化鍵インポート呼び出し可能サービスは、データの暗号化/復号に使用される非暗号化 DATA 鍵をインポートする場合に使用します。 この呼び出し可能サービスでできることは、DATA 鍵をインポートすることのみです。 非暗号化鍵インポートでは、8 バイトの非暗号化 DATA 鍵が受け入れられ、マスター鍵で暗号化され、 その暗号化された DATA 鍵が操作可能形式で内部鍵トークンに入れられて返されます。

非暗号化鍵値の各バイトの下位ビットに奇数パリティーがない場合、 このサービスでは、reason_code パラメーターで警告値が返されます。 この呼び出し可能サービスでは、鍵のパリティーは調整されません。

注: 16 バイトまたは 24 バイトの DATA 鍵をインポートするには、 複数非暗号化鍵インポート呼び出し可能サービス (複数非暗号化鍵インポート (CSNBCKM および CSNECKM)を参照) を使用してください。 複数非暗号化鍵インポート・サービスは AES DATA 鍵をサポートします。

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

形式

CALL CSNBCKI(
             return_code,
             reason_code,
             exit_data_length,
             exit_data,
             clear_key,
             key_identifier) 

パラメーター

return_code
方向 タイプ
出力 整数

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

reason_code
方向 タイプ
出力 整数

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

exit_data_length
方向 タイプ
入出力 整数

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

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

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

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

clear_key は、インポート対象の 8 バイト非暗号化鍵値を指定します。

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

内部鍵トークンを受け取る 64 バイトのストリング。 内部鍵トークンについては、鍵トークンの鍵 IDに説明があります。

アクセス制御点

「Clear Key Import/Multiple Clear Key Import - DES」アクセス制御点は、このサービスの機能を制御するものです。

「Disallow 24-byte DATA wrapped with 16-byte Key」アクセス制御点が有効になっているときに、 ソース鍵が 3 倍長の DATA 鍵であり DES マスター鍵が 16 バイトの鍵であると、このサービスは失敗します。

必須ハードウェア

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

表 1. 非暗号化鍵インポート必須ハードウェア
サーバー 必須暗号化ハードウェア 制約事項

IBM eServer zSeries 990
IBM eServer zSeries 890

PCI X 暗号化コプロセッサー/Crypto Express2 コプロセッサー  

IBM System z9 EC
IBM System z9 BC

Crypto Express2 コプロセッサー  

IBM System z10 EC
IBM System z10 BC

Crypto Express2 コプロセッサー

Crypto Express3 コプロセッサー

 

IBM zEnterprise 196
IBM zEnterprise 114

Crypto Express3 コプロセッサー  

IBM zEnterprise EC12
IBM zEnterprise BC12

Crypto Express3 コプロセッサー

Crypto Express4 コプロセッサー

 

IBM z13

Crypto Express5 CCA コプロセッサー