EKS/AKS の Automation Suite のインストールガイド

最終更新日時 2025年5月16日

証明書の概要

このページでは、Automation Suite のインストールに必要なすべての証明書と、証明書ローテーションプロセスの原則について説明します。

重要: 自己署名証明書を置き換える際に指定する必要がある証明書の詳細については、「証明書の要件」をご覧ください。

信頼証明書の仕組みを理解する

Automation Suite 内での製品間のサービス間通信は、クラスターの FQDN を介して行われます。製品が内部 URL を使用して相互に通信することはできません。たとえば、Orchestrator は https://automationsuite.mycompany.com/identity を介して Identity Server に接続し、ユーザー認証を行うことができます。

2 つの異なる Automation Suite 製品はクラスターの FQDN を使用する必要がありますが、複数のマイクロサービスを含めることもできます。これらのマイクロサービスは内部 URL を使用して相互に通信できます。

通信の仕組みを理解する

次の図とフローでは、クライアントがどのようにサービスに接続し、認証が ID サービスを介してどのように行われるかを説明します。

クライアントは、URL を使用するサービス (Orchestrator、Apps、Insights など) に次の URL を使用して接続します: https://automationsuite.mycompany.com/myorg/mytenant/service_。
Istio は、その呼び出しをインターセプトし、service_ のパスに基づいて呼び出しを特定のサービスに転送します。
そのサービスは、ID サービスを呼び出して、ロボットからの受信リクエストを https://automationsuite.mycompany.com/myorg/mytenant/identity_ を介して認証します。
Istio は、その呼び出しをインターセプトし、identity_ のパスに基づいてリクエストを ID サービスに転送します。
ID サービスは、応答を結果とともに Istio に返します。
Istio は、サービスに応答を返します。呼び出しは HTTPS プロトコルを使用して行われるので、Istio は応答を TLS 証明書とともに返し、接続をセキュリティで保護します。サービスは、Istio によって返されたサーバー証明書を信頼する場合、応答を承認します。信頼しない場合は、応答を拒否します。
サービスは応答を準備し、Istio に返します。
Istio は、リクエストをクライアントに転送して戻します。クライアントマシンが証明書を信頼する場合、リクエスト全体が成功します。信頼しない場合、リクエストは失敗します。

ロボットと Orchestrator 間の通信の仕組みを理解する

このセクションでは、ロボットが Automation Suite 内の Orchestrator に接続を試みる場合のシナリオについて説明します。次の図とフローでは、ロボットがどのように Orchestrator に接続し、認証が Identity Server を介してどのように行われるかを説明します。

ロボットは、次の URL を使用して Orchestrator と接続します: https://automationsuite.mycompany.com/myorg/mytenant/orchestrator_。
Istio は、その呼び出しをインターセプトし、orchestrator_ のパスに基づいて Orchestrator サービスに転送します。
Orchestrator サービスは、Identity Server を呼び出して、ロボットからの受信リクエストを https://automationsuite.mycompany.com/myorg/mytenant/identity_ を介して認証します。
Istio は、その呼び出しをインターセプトし、identity_ のパスに基づいてリクエストを Identity Server に転送します。
Identity Server は、応答を結果とともに Istio に返します。
Istio は、Orchestrator に応答を返します。呼び出しは HTTPS プロトコルを使用して行われるので、Istio は応答を TLS 証明書とともに返し、接続をセキュリティで保護します。Orchestrator は、Istio によって返されたサーバー証明書を信頼する場合、応答を承認します。信頼しない場合は、応答を拒否します。
Orchestrator は応答を準備し、Istio に返します。
Istio は、リクエストをロボットに転送して戻します。ロボットマシンが証明書を信頼する場合、リクエスト全体が成功します。信頼しない場合、リクエストは失敗します。

証明書に関連するコンテナーアーキテクチャを理解する

コンテナーレベル

この例では、コンテナーに専用のオペレーティングシステム (RHEL OS) があり、サービスは RHEL OS 上で実行される Orchestrator に相当します。

すべての OS には、独自の証明書ストアがあります。 RHEL OS の場合、証明書信頼ストアは /etc/pki/ca-trust/ca/にあります。

RHEL OS では、すべての証明書がこのパスに保存されます。すべてのコンテナーに専用の証明書信頼ストアがあります。Automation Suite の構成の一環として、ルート証明書、すべての中間証明書、リーフ証明書を含むチェーン証明書全体が挿入され、このパスに保存されます。サービスはルート証明書と中間証明書を信頼するので、ルート証明書と中間証明書によって作成される他の証明書も自動的に信頼します。

ポッドレベル

Automation Suite 内では何百ものコンテナーが実行されています。すべてのサービスについて、これらの各コンテナーの証明書を手動で追加するのは手間のかかる作業です。しかし、Automation Suite には、この作業を支援する共有ボリュームと Init コンテナー cert-trustor が含まれています。Init は、ポッド内でアプリコンテナーより先に実行される特殊なコンテナーであり、そのジョブが完了するとすぐにそのライフサイクルが終了します。

次の例では、Orchestrator サービスは 1 つのポッドで実行されています。なお、1 つのポッドに複数のコンテナーを含めることができます。このポッドに、Cert-trustor という Init コンテナーを 1 つ以上挿入します。このコンテナーに、ルート証明書、中間証明書、リーフ証明書が含まれます。

共有ボリュームは、Cert-trustor コンテナーと Orchestrator サービスコンテナーの両方にアタッチされます。パスは RHEL OS 証明書信頼ストアと同じです ( /etc/pki/ca-trust/ca/source/anchors)。

Orchestrator を実行する前に、Cert-trustor は、/etc/pki/ca-trust/ca/source/anchors の場所にある共有ボリュームに証明書を追加するジョブを実行し、終了します。

証明書は、共有ボリュームを通じて Orchestrator サービスで利用できます。

Automation Suite のすべての証明書のリスト

インストール時に生成される証明書

Automation Suite のインストールの一環として、次の証明書が生成されます。

インストール時に生成される自己署名証明書。インストール後に、自己署名証明書をドメイン証明書に置き換えることをお勧めします。「証明書を管理する」をご覧ください。

手記：インストール時に証明書を生成できるのは、インストール時に Automation Suite インストーラーに管理者権限を付与した場合のみです。インストーラーの管理者権限を付与できない場合は、証明書を自分で作成して管理する必要があります。
Identity Server の証明書。認証で使用される JWT トークンに署名するために使われます。JWT トークンに署名するための証明書が提供されていない場合、Automation Suite は、現在設定されている TLS 証明書 (自己署名証明書またはユーザー提供) を使用します。ID トークンに署名するための独自の証明書が欲しい場合は、「証明書を管理する」をご覧ください。

追加の証明書

有効化すると、SAML2 認証プロトコルでサービス証明書を使用できます。
ユーザー名とパスワードを使用して Active Directory を構成する場合、LDAPS (SSL 経由の LDAP) は任意です。LDAPS を選択する場合は、証明書を提供する必要があります。この証明書は、Automation Suite の信頼されたルート証明機関に追加されます。詳細については、Microsoft のドキュメントをご覧ください。

証明書の更新/ローテーションの仕組みを理解する

証明書は次の 2 つの場所に保存されます。

<istio-system> の istio-ingressgateway-certs
<uipath> 名前空間

<istio-system> および <uipath> 名前空間内の証明書を更新するには、uipathctl config update-tls-certificates コマンドを実行する必要があります。

ポッドは、その名前空間にあるシークレットにのみアクセスできます。たとえば、 <uipath> 名前空間で実行されているポッドは、 <istio-system> 名前空間に格納されているシークレットにアクセスできません。したがって、証明書は両方の名前空間にコピーされます。

<uipath> 名前空間では、証明書が必要なポッドに証明書をマウントしてポッドを再起動し、新しい証明書を使用できるようにします。

注:

更新はローリングデプロイ手法を使用して行われます。高可用性を実現するためにマイクロサービスに 2 つのポッドがある場合、更新によりポッドの 1 つが削除され、新しいバージョンのポッドが起動されます。新しいポッドが正常に起動すると、古いポッドは削除されます。古いポッドがまだ終了していない間は、短時間のダウンタイムが発生します。