Hitachi

Cosminexus V11 BPM/ESB基盤 サービスプラットフォーム リファレンス


csakeyadd(公開鍵認証の秘密鍵情報の登録・更新)

〈このページの構成〉

形式

csakeyadd [-h]
           -keyfile <秘密鍵のファイルパス>
          [-pass <秘密鍵のパスフレーズ>]
           -keyid <鍵ID>
          [-r]
           -f <公開鍵認証情報定義ファイルのパス>

機能

ユーザ認証のうち,公開鍵認証に必要な秘密鍵の情報を登録または更新します。登録できる公開鍵認証情報の数に上限はありません。

登録または更新した公開鍵認証情報は,それを使用するサービスアダプタの初回リクエスト時に有効となります。また,初回リクエスト後にこのコマンドを実行すると,登録または更新した公開鍵認証情報は,次のサービスアダプタの開始後から有効となります。

コマンドを実行する前の注意事項を次に示します。

引数

-h

コマンドの使用方法が表示されます。このオプションを指定している場合は,ほかのオプションを指定しても無視されます。

-keyfile <秘密鍵のファイルパス>

秘密鍵ファイルのパスを相対パスまたは絶対パスで指定します。パスに空白を含む場合は,オプション引数全体をダブルクォーテーション(")で囲みます。

指定したファイルが存在しない場合はエラーになります。

-pass <秘密鍵のパスフレーズ>

対象となる秘密鍵にパスフレーズが設定されている場合,秘密鍵のパスフレーズを指定します。

-keyid <鍵ID> 〜<半角英数字およびアンダーバー(_)> ((1〜8文字))

秘密鍵を一意に区別するためのIDを指定します。

  • 公開鍵認証情報の登録時

    公開鍵認証情報定義ファイル内で一意となるIDを指定してください。

  • 公開鍵認証情報の更新時(引数-rを指定した場合)

    公開鍵認証情報定義ファイルに登録されているIDを指定してください。

-r

登録済みの公開鍵認証情報を更新する場合に指定します。

-f <公開鍵認証情報定義ファイルのパス>

このコマンドで定義した公開鍵認証情報を保存するための,公開鍵認証情報定義ファイルのパスを相対パスまたは絶対パスで指定します。パスに空白を含む場合は,オプション引数全体をダブルクォーテーション(")で囲みます。

指定したファイルが存在しない場合は次のように動作します。

  • 公開鍵認証情報の登録時

    指定したファイル名で,公開鍵認証情報定義ファイルが新規作成されます。ただし,指定したディレクトリが存在しない場合はエラーになります。

  • 公開鍵認証情報の更新時(引数-rを指定した場合)

    エラーになります。

戻り値

戻り値

意味

0

正常終了しました。

1

コマンドが異常終了しました。

9

実行権限のチェックエラーが発生しました。

注意事項