VM サーバと VM エージェントの HTTPS 対応手順

正規の SSL 証明書のインストール

SSL 証明書のベンダや組織内 CA (Certificate Authority, 認証局) 等で発行された証明書をインストールする手順です。
SSL 証明書の取得の仕方は、SSL 証明書のベンダの手順で実施してください。VM サーバでは、取得した SSL 証明書のインストール方法のみ提供しています。 この手順では VM サーバのアーカイブ（sidfmvm-x.x.x.tar.gz) に含まれるtls_install.sh を使用します。
また、使用する各ファイルは以下のような意味です。

• ssl.crt - 証明書ファイル
• ssl.key - 秘密鍵ファイル
• chain.crt - 中間証明書ファイル

1. VM サーバプログラムのインスールディレクトリに移動します。

   $ cd /var/lib/sidfm/sidfmvm

2. SSL 証明書のインストール(中間証明書無しの場合)

   $ sudo ./tls_install.sh -cert ssl.crt
   $ sudo ./tls_install.sh -key ssl.key
   $ sudo ./tls_install.sh -apply
    Server Disabled
    Server Enabled 

3. SSL 証明書のインストール(中間証明書有りの場合)

   $ sudo ./tls_install.sh -cert ssl.crt
   $ sudo ./tls_install.sh -key ssl.key
   $ sudo ./tls_install.sh -chain chain.crt
   $ sudo ./tls_install.sh -apply
    Server Disabled
    Server Enabled 

正規の SSL 証明書のアンインストール

正規の SSL 証明書をアンインストールする手順です。

1. VM サーバプログラムのインスールディレクトリに移動します。

   $ cd /var/lib/sidfm/sidfmvm

2. SSL 証明書のアンインストールします。

   $ sudo ./tls_install.sh -clean
    Server Disabled
    Server Enabled 

自己署名証明書のイントール

自己署名証明書をインストールする手順です。

1. VM サーバをインストールしたホストで以下のコマンドを実行します。

   $ sudo docker exec sidfmd /ca -init

   $ sudo docker exec sidfmd /ca -add host.example.com

   $ sudo docker exec sidfmd /vm_manage server disable

   $ sleep 5

   $ sudo docker exec sidfmd /vm_manage server enable

2. Web ブラウザや OS に証明書をインストールします。
   上記の操作で https://host.example.com/redmine/ でアクセスできるようになりますが、自己認証局で発行した証明書を使用しているため Web ブラウザや OS に証明書をインストールする必要があります。

   $ sudo docker exec sidfmd /ca -show_ca > vm-server.crt

   [Widnows の例]

   1.  証明書 (vm-server.crt) を右クリック

   2.  証明書のインストール

   3. 「信頼されたルート証明機関」の証明書ストアへインストール

自己署名証明書の更新

自己署名証明書の更新、ホスト名変更の手順です。

1. VM サーバをインストールしたホストで以下のコマンドを実行します。

   $ sudo docker exec sidfmd /ca -revoke host.example.com

   $ sudo docker exec sidfmd /ca -add host.example.com

VM サーバの http(80/tcp) の無効化手順

VM サーバの http(80/tcp) の無効化手順です。

1. root ユーザに昇格します。

   $ su -

2. VM サーバのアーカイブファイルを展開したディレクトリに移動します。もし他のディレクトリにインストールした場合は、以降の説明はインストールしたディレクトリで読み替えて下さい。

   # cd /var/lib/sidfm/sidfmvm

   VM サーバのインストール時に VM サーバのアーカイブファイル (sidfmvm-1.0.?.tar.gz) を展開したディレクトリに移動します。もし削除してしまった場合は、以下の手順で改めてダウンロードし、ファイルを展開してください。なお、手順最後の「7. イメージを生成します。」は実行する必要はありません。
   Red Hat Enterprise Linux 7 / CentOS 7 に VM サーバをインストールする
   Ubuntu 18.04 LTS に VM サーバをインストールする
3. sidfmd-start.sh ファイルを編集します。sidfmd-start.sh を編集し、80/tcp(http) の設定を削除します。

   # vi sidfmd-start.sh

   [修正前]

   sudo docker container run -td -p 80:80 -p 443:443 --name=sidfmd sidfmd

   [修正後]

   sudo docker container run -td -p 443:443 --name=sidfmd sidfmd

4. VM サーバを一度停止します。

   # ./sidfmd-stop.sh

5. 2.で編集されたスクリプトを利用して、VM サーバを起動します。

   # ./sidfmd-start.sh

   # docker exec sidfmd /vm_manage server enable

   # docker exec sidfmd /vm_manage issue_update enable

   「already enabled」というメッセージが出力される場合がありますが、動作に影響はありませんので無視してください。