F.2.1 秘密鍵管理環境の作成/設定コマンド

MessageQueueDirector説明書

目次索引

付録F 証明書/鍵管理ツール

> F.2 証明書/鍵管理用コマンド

F.2.1 秘密鍵管理環境の作成/設定コマンド

　秘密鍵管理環境の作成と設定で使用するコマンドについて、以下に説明します。

■mkslt (スロットを生成する)

◆機能説明

　スロットを生成します。スロットに設定するスロットパスワードを対話入力します。

◆入力形式

---------------------------------------------------------------------------------------
      mkslt  -sd Slot-directory
---------------------------------------------------------------------------------------

◆パラメタ

オプション	項目概要
-sd	スロット情報ディレクトリ(Slot-directory)をフルパスで指定します。

◆注意事項

　指定したスロット情報ディレクトリが存在しない場合はエラーとなり、コマンドは異常終了します。
　スロットパスワードは、付表F.7の文字セットから6～128文字で指定します。条件を満たさない文字列を指定した場合、コマンドは異常終了します。
　設定したスロットパスワードは、トークンを生成して組み込みを行う際に必要となる。
　スロットの生成に成功した場合、生成したスロットのスロットIDを出力します。

[付表F.7 指定可能な文字セット]

カテゴリ	文字
英字	ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz
数字	0123456789
記号	!"#%&'()*+,-./:;<=>?[\]^_{\|}~ (注)
空白

注) 記号の“\”は、コード0x5cに該当する文字であり、表示する環境によってはバックスラッシュとなります。

◆使用例

　/home/slotにスロットを生成します。

------------------------------------------------------------------------------
      # mkslt -sd /home/slot
      Setting Slot-password.
      Slot-password:                        (注)
      Retype:                               (注)
      mkslt: Succeeded. New Slot-ID is 1.
      #
------------------------------------------------------------------------------

注) スロットパスワードの対話入力時、入力した文字は表示されません。

■mktkn (トークンを生成する)

◆機能説明

　トークンを生成してスロットに組み込みます。トークンに設定するSO-PIN、ユーザPINの入力を対話的に行います。

◆入力形式

---------------------------------------------------------------------------------------
      mktkn  -sd Slot-directory -sn SlotID -tl TokenLabel
---------------------------------------------------------------------------------------

◆パラメタ

オプション	項目概要
-sd	スロット情報ディレクトリ(Slot-directory)をフルパスで指定します。
-sn	生成するトークンの組込み先スロットをスロットID(SlotID)で指定します。
-tl	生成したトークンに設定するトークンラベル(TokenLabel)を、32文字以内で指定します。32文字に満たない場合は空白が埋められます。指定可能な文字セットについては付表F.7に示します。

◆注意事項

　指定したスロット情報ディレクトリが存在しない場合はエラーとなり、コマンドは異常終了します。
　トークンラベルは利用者がトークンを特定するために使用される情報です。そのため、システム内で一意なものを指定してください。

　SO-PIN、ユーザPINは、それぞれ下表の条件を満たした文字列を指定してください。

項目	内容	有効文字	有効文字数
SO-PIN	トークンの初期化などの際に必要。	付表F.7参照	6～128
ユーザPIN	トークン内のオブジェクトの操作などに必要。	付表F.7参照	6～128

◆使用例

スロットIDが“1”のスロットに、“Token01”というラベルのトークンを生成します。

----------------------------------------------------------------------------------
      # mktkn -sd /home/slot -sn 1 -tl Token01
      Slot-password:                                    (注1,2)
      Setting SO-PIN(also used as Token-password).
      SO-PIN:                                           (注2)
      Retype:                                           (注2)
      Setting User-PIN.
      User-PIN:                                         (注2)
      Retype:                                           (注2)
      #
----------------------------------------------------------------------------------

注1) 組込み先のスロットに設定されているスロットパスワードの入力が促されます。

注2) スロットパスワード、SO-PIN、ユーザPINの対話入力時、入力した文字は表示されません。

■initkn (トークンを初期化する)

◆機能説明

　指定したスロットに存在するトークンの初期化を行います。初期化したトークンに設定するユーザPINの入力を対話的に行います。

◆入力形式

---------------------------------------------------------------------------------------
      initkn  -sd Slot-directory -tl TokenLabel
---------------------------------------------------------------------------------------

◆パラメタ

オプション	項目概要
-sd	スロット情報ディレクトリ(Slot-directory)をフルパスで指定します。
-tl	初期化するトークンのトークンラベル(TokenLabel)を指定します。

◆注意事項

　初期化したトークンに設定する新しいSO-PIN、ユーザPIN、トークンラベルの入力を対話的に行います。トークンラベルは利用者がトークンを特定するために使用する情報です。そのため、システム内で一意なものを指定する必要があります。
　本コマンドの実行時、他から対象トークンへのアクセスがない状態を確保する必要があります。それ以外の状態での動作は保証しません。

◆使用例

トークン名が“Token01”のトークンを初期化します。

----------------------------------------------------------------------------------
      # initkn -sd /home/slot -tl Token01
      Setting SO-PIN.
      SO-PIN:                                 (注1)
      Retype:                                 (注1)
      New Token label: Token02               (注2)
      initkn: Initialize token?(y/n) y       (注3)
      Setting User-PIN.
      User-PIN:                               (注1)
      Retype:                                 (注1)
      #
----------------------------------------------------------------------------------

注1) SO-PIN、ユーザPINの対話入力時、入力した文字は表示されません。

注2) 新しいトークンラベルとして“Token01”を再使用することもできます。

注3) コマンドは初期化実行の確認を行います。

■setpin (PINを変更する)

◆機能説明

　指定したトークンのPINの変更を行います。

◆入力形式

---------------------------------------------------------------------------------------
      setpin  -ed Environment-directory -tl TokenLabel [-s]
---------------------------------------------------------------------------------------

◆パラメタ

オプション	項目概要
-ed	運用管理ディレクトリ(Environment-directory)をフルパスで指定します。
-tl	変更対象トークンを、ラベル(TokenLabel)で指定します。
-s	SO-PINの変更を行う際に指定します。省略した場合、ユーザPIN の変更を行います。

◆注意事項

　PINの変更には、変更前のPINが必要です。
　本コマンドの実行時、他から対象トークンへのアクセスがない状態を確保する必要があります。それ以外の状態での動作は保証しません。
　本コマンドでは、cmsetenvコマンドで設定した環境情報を参照してスロット情報ディレクトリを環境変数に設定します。そのため、環境情報にスロット情報ディレクトリが設定されている必要があります。

◆使用例

例1) ラベルが“Token01”のトークンの、ユーザPINを変更します。

----------------------------------------------------------------------------------
      # setpin -ed /home/sslcert -tl Token01
      User-PIN for Token01:
      New User-PIN:             (注)
      Retype:                   (注)
      #
----------------------------------------------------------------------------------
      注) ユーザPINの対話入力時、入力した文字は表示されません。

例2) ラベルが“Token01”のトークンの、SO-PINを変更します。

----------------------------------------------------------------------------------
      # setpin -ed /home/sslcert -tl Token01 -s
      SO-PIN for Token01:  
      New SO-PIN:               (注)
      Retype:                   (注)
      #
----------------------------------------------------------------------------------
      注) SO-PINの対話入力時、入力した文字は表示されません。

目次索引