Quick start: Deploy a DigiCert agent — Windows
Introduction
This guide covers the basic steps needed to install and activate the DigiCert® agent software on a Windows system.
The agent is DigiCert’s native client for discovering and managing certificates on servers. You need to install an agent on each server system to use the following features in DigiCert® Trust Lifecycle Manager:
System-based discovery scans: Scan both OS certificate stores and the local file system for end-entity certificates.
Certificate management: Manage certificates for common web servers and custom applications.
Certificate delivery: Deliver certificates using the
Admin web requestfeature, including custom post-script support.
Agents use a pull communication model to synchronize with Trust Lifecycle Manager over outbound port 443 (HTTPS). They do not require inbound access. Each agent can keep itself updated as new software versions get released to reduce the need for ongoing maintenance.
Before you begin
Before installing the Windows version of the agent, verify the following:
System requirements
Your environment must have at least a minimal installation of a supported operating system.
Server type | Supported OS version | Minimum specifications |
|---|---|---|
Windows |
|
|
Network requirements
To connect to Trust Lifecycle Manager, the agent requires outbound access to HTTPS (TCP port 443) on the two DigiCert® ONE platform URLs in one of the following regions.
In addition to platform access, the agent requires outbound access to HTTPS (TCP port 443) on the following automation and discovery service URLs.
Loopback ports
The agent binds to the following loopback ports on the local host. To adjust the loopback port numbers for an installed agent, edit the applicable configuration file/parameter in the agent conf sub-directory and restart the agent service.
Loopback ports | Description | Agent conf file | Configuration parameter |
|---|---|---|---|
58080 | Local communications port for the plugin manager process used to manage certificate delivery events for Trust Lifecycle Manager. | config.toml | |
61613 | Local communications port for Simple (or Streaming) Text Oriented Messaging Protocol (STOMP). Used for message queuing between the main agent process and the plugin manager process. | config.toml | |
注記
Loopback ports do not require any access rules on the local firewall.
Deployment workflow
To deploy the DigiCert agent software on a Windows system, complete these tasks:
Windows 版エージェントソフトウェアをダウンロードして Trust Lifecycle Manager でアクティベーションキーを生成するには、以下の手順に従います。
Trust Lifecycle Manager メインメニューから、［Discovery & automation tools > Client tools］を選択します。
［エージェント - Windows インストーラ］を選択します。
右側にあるダウンロードボタンを使用して、Windows 版 DigiCert エージェントインストーラの最新バージョンをダウンロードします。エージェントは tlm_agent_N.N.N_win64.zip といった名前になっているはずです。ここで、「N.N.N」はエージェントのバージョン番号です。
アクティベーションコードを取得するには、［Requirements］の下にある［アクティベーションコードの生成］ボタンを選択します。開かれたポップアップダイアログで、次の操作を実行します。
（任意）エージェントを割り当てる事業部門を選択します。ここで選択した場合、その事業部門に管理者として割り当てられたユーザーだけがエージェントを管理できるようになります。
（任意）［コードの共有］で、アクティベーションコードを電子メールで受け取るユーザーを選択します。たとえば、エージェントソフトウェアをインストールする管理者を選択します。
［コードの生成］ボタンを選択します。コードをコピーします。このコードを使用してエージェントをインストールすることも、インストールを実行するユーザーにコードを提供することもできます。
注記
アクティベーションコードは 30 分間有効で、1 回だけ使用できます。有効期限が切れた場合は、プロセスを繰り返して新しいコードを生成します。
Windows サーバーにエージェントソフトウェアをインストールしてアクティブ化するには、以下の手順に従います。
ダウンロードしたインストーラを解凍し、管理者として DigiCert TLM Agent 実行可能ファイルを実行します。
エージェントをインストールするためのボタンを選択します。指示に従ってエージェントをインストールします。
アクティベーションコードの確認を求められたら、［I have the activation code］を選択します。
選択を求められたら、エージェントが Trust Lifecycle Manager に接続する方法を選択します。
［Direct, no proxy］: エージェントが直接接続する場合に選択します。
［My own proxy server］: サードパーティのプロキシサーバー経由で接続する場合に選択します。プロキシサーバーの詳細の入力を求められます。
［DigiCert sensor as proxy］: DigiCert センサーをプロキシサーバーとして使用する場合に選択します。センサーの詳細の入力を求められます。
アクティベーション画面で、生成した アクティベーションコードを入力します。任意で、Trust Lifecycle Manager で識別しやすくなるように、エージェントにカスタム名を割り当てます。
最後の画面で、エージェントサービスを今すぐ起動するかどうかを選択します。ホスト上の証明書を検出および自動化するためには、エージェントサービスが実行中になっている必要があります。
Return to the Trust Lifecycle Manager web console to verify that the installed agent is ready for use:
From the Trust Lifecycle Manager menu, select Discovery & automation tools > Agents.
You should see the agent you installed listed in the table.
The Status column lists the current status of the agent. An agent that's installed and ready to use should show Active.
注記
If your agent does not appear in the table or does not show the Active status, refer to Troubleshoot agents for troubleshooting help.
What's next
With an active DigiCert agent installed on a server in your network, you can use Trust Lifecycle Manager to:
Set up system scans to scan both OS certificate stores and the local file system for certificate files. Certificates found during these scans added to the certificate inventory for continuous monitoring and tracking.
Enable certificate lifecycle automation on the host systems.
Enroll certificates from different issuing CAs with automated delivery to external systems.
Customize certificate processing on your servers using agent scripts.