ナビゲーション
clmBot は、お客様の社内ネットワークのサーバーに導入される軽量クライアントで、SSL証明書の導入と更新を自動的に完了します。クラウドから最新の証明書を取得し、サーバー上の証明書インストールポイントに書き込み、設定に従ってスクリプトを実行してミドルウェアサービスをリロードします。
動作方式
clmBotの証明書更新フローは以下のとおりです。
- 証明書の有効期限が切れる前に、クラウド側で証明書の再署名が自動的に完了し、新しい証明書が生成されます。
- clmBotは、クラウドプッシュまたは定期プルにより最新の証明書を取得します。
- clmBotは、サーバー上のローカル証明書ファイルのバックアップと置き換えを試みます。バックアップに失敗した場合はエラーが記録されますが、その後の更新は妨げられません。
- clmBotは、設定に従ってリロードスクリプト(
after_script)を実行します。実際に有効になるかどうかは、スクリプトの実行結果とミドルウェアの状態によって決まります。
このプロセス全体を通じて、サーバーに手動でログインして証明書を置き換える必要はなく、サーバーの管理エントリを外部に公開することもありません。
対応している更新方式
clmBotは、2つの証明書更新方式をサポートしており、サーバーごとに選択できます。
| 更新方式 | 動作モード | ポート要件 | 適用シナリオ |
|---|---|---|---|
| クラウドプッシュ | 管理バックエンドでプッシュを開始し、サーバー上のclmBotサービスが受信して証明書を更新 | 8862/tcp のインバウンドポートを開放する必要あり | ネットワークポリシーでインバウンドポートの開放が許可されており、更新を即時に反映させたい場合 |
| 定期プル | crontab または Windows タスクスケジューラで clmBot を定期実行し、最新の証明書を確認して取得 | インバウンドポートの開放は不要で、アウトバウンドのクラウドへのアクセスのみ必要 | インバウンドポートを開放できないサーバー(デフォルト方式として推奨) |
詳細な設定方法は、証明書更新方式 を参照してください。
対応プラットフォームとミドルウェア
対応OS:
- Linux(amd64、arm64)
- macOS(amd64、arm64)
- Windows(amd64;旧版Windows は legacy 互換パックを使用)
対応ミドルウェアと証明書形式:
| ミドルウェア | 証明書形式 | 説明 |
|---|---|---|
| nginx | PEM | 証明書、CAチェーン、秘密鍵を分離して導入 |
| Apache HTTP Server | PEM | 証明書、CAチェーン、秘密鍵を分離して導入 |
| Tomcat | PEM / JKS | PEM証明書またはJKSキーストアに対応 |
| IIS | IIS | 内蔵スクリプトでPFXをインポートし、サイトバインディングを更新。管理者権限が必要 |
| Exchange | Exchange | 更新のみ対応。検出、照会、sync-server は非対応。管理者権限が必要 |
| その他(カスタムスクリプト) | PFX など | カスタムの after_script により、任意のシナリオをサポート |
ドキュメントの選択方法
| 使用シーン | 推奨ページ |
|---|---|
| 初回利用で、迅速に導入して証明書更新を1回完了させたい場合 | クイックスタート |
| 2つの更新方式の詳細な設定を理解したい場合 | 証明書更新方式 |
| インストールポイントを手動で追加、バックエンドからインストールポイントを同期、ローカルWeb設定ページを使用する場合 | インストールポイント管理 |
| config.yaml のフィールドの意味、スクリプトテンプレート変数の確認 | 設定リファレンス |
| nginx、Apache、Tomcat などミドルウェアの証明書インストールとリロードの完全な例 | 設定例 |
| 本番環境で clmBot の実行権限を強化し、sudoers を設定 | 実行権限の要件 |
| clmBot をシステムサービスとして登録、バージョンアップ、ログの確認 | サービス化デプロイとアップグレード |
クイックスタート
clmBot を初めてご利用になる場合は、以下の手順をお勧めします:
- 管理コンソールで AccessKey / AccessSecret を生成します。
- clmBot をダウンロードしてサーバーにアップロードします。
loginを実行して接続し、コンソールでノードをアクティベートします。discover-certificateを実行して、サーバー上の証明書を自動検出します。- 更新方法(プッシュまたは定期取得)を設定します。
詳細な手順は、クイックスタート を参照してください。