メインコンテンツまでスキップ

ナビゲーション

clmBot は、お客様の社内ネットワークのサーバーに導入される軽量クライアントで、SSL証明書の導入と更新を自動的に完了します。クラウドから最新の証明書を取得し、サーバー上の証明書インストールポイントに書き込み、設定に従ってスクリプトを実行してミドルウェアサービスをリロードします。

動作方式​

clmBotの証明書更新フローは以下のとおりです。

  1. 証明書の有効期限が切れる前に、クラウド側で証明書の再署名が自動的に完了し、新しい証明書が生成されます。
  2. clmBotは、クラウドプッシュまたは定期プルにより最新の証明書を取得します。
  3. clmBotは、サーバー上のローカル証明書ファイルのバックアップと置き換えを試みます。バックアップに失敗した場合はエラーが記録されますが、その後の更新は妨げられません。
  4. clmBotは、設定に従ってリロードスクリプト(after_script)を実行します。実際に有効になるかどうかは、スクリプトの実行結果とミドルウェアの状態によって決まります。

このプロセス全体を通じて、サーバーに手動でログインして証明書を置き換える必要はなく、サーバーの管理エントリを外部に公開することもありません。

対応している更新方式​

clmBotは、2つの証明書更新方式をサポートしており、サーバーごとに選択できます。

更新方式動作モードポート要件適用シナリオ
クラウドプッシュ管理バックエンドでプッシュを開始し、サーバー上のclmBotサービスが受信して証明書を更新8862/tcp のインバウンドポートを開放する必要ありネットワークポリシーでインバウンドポートの開放が許可されており、更新を即時に反映させたい場合
定期プルcrontab または Windows タスクスケジューラで clmBot を定期実行し、最新の証明書を確認して取得インバウンドポートの開放は不要で、アウトバウンドのクラウドへのアクセスのみ必要インバウンドポートを開放できないサーバー(デフォルト方式として推奨)

詳細な設定方法は、証明書更新方式 を参照してください。

対応プラットフォームとミドルウェア​

対応OS:

  • Linux(amd64、arm64)
  • macOS(amd64、arm64)
  • Windows(amd64;旧版Windows は legacy 互換パックを使用)

対応ミドルウェアと証明書形式:

ミドルウェア証明書形式説明
nginxPEM証明書、CAチェーン、秘密鍵を分離して導入
Apache HTTP ServerPEM証明書、CAチェーン、秘密鍵を分離して導入
TomcatPEM / JKSPEM証明書またはJKSキーストアに対応
IISIIS内蔵スクリプトでPFXをインポートし、サイトバインディングを更新。管理者権限が必要
ExchangeExchange更新のみ対応。検出、照会、sync-server は非対応。管理者権限が必要
その他(カスタムスクリプト)PFX などカスタムの after_script により、任意のシナリオをサポート

ドキュメントの選択方法​

使用シーン推奨ページ
初回利用で、迅速に導入して証明書更新を1回完了させたい場合クイックスタート
2つの更新方式の詳細な設定を理解したい場合証明書更新方式
インストールポイントを手動で追加、バックエンドからインストールポイントを同期、ローカルWeb設定ページを使用する場合インストールポイント管理
config.yaml のフィールドの意味、スクリプトテンプレート変数の確認設定リファレンス
nginx、Apache、Tomcat などミドルウェアの証明書インストールとリロードの完全な例設定例
本番環境で clmBot の実行権限を強化し、sudoers を設定実行権限の要件
clmBot をシステムサービスとして登録、バージョンアップ、ログの確認サービス化デプロイとアップグレード

クイックスタート​

clmBot を初めてご利用になる場合は、以下の手順をお勧めします:

  1. 管理コンソールで AccessKey / AccessSecret を生成します。
  2. clmBot をダウンロードしてサーバーにアップロードします。
  3. login を実行して接続し、コンソールでノードをアクティベートします。
  4. discover-certificate を実行して、サーバー上の証明書を自動検出します。
  5. 更新方法(プッシュまたは定期取得)を設定します。

詳細な手順は、クイックスタート を参照してください。