> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/keeperpam/jp/self-managed-keeper/self-managed-keeper-overview/installation/tls-certificates.md).

# TLS証明書

セルフマネージド型KeeperのTLS証明書の仕組み、証明書を用意する方法、正しく設定されているかの確認方法

セルフマネージド型Keeperは、ブラウザ、API、PAM接続のすべてのトラフィックを処理する単一のリバースプロキシ (フロントドア) でTLSを終端します。使い始めるために、特別な操作は必要ありません。証明書を構成せずにインストールすると、自己署名証明書が自動的に生成され、そのまま動作します。この証明書は評価用には問題ありませんが、本番環境には適していません。

### いずれかを選択 <a href="#choose-one" id="choose-one"></a>

|                   | 使用する場面                          | 必要なもの                           |
| ----------------- | ------------------------------- | ------------------------------- |
| **自己署名**          | 評価、開発、エアギャップ環境、DNSなし            | 不要 (デフォルト)                      |
| **独自の証明書**        | 本番環境、パブリック、企業、社内の認証局            | PEM形式の証明書と鍵、必要な場合はプライベートのルート認証局 |
| **Let's Encrypt** | ホストにパブリックなDNS名があり、インターネットに接続できる | 管理しているパブリックなDNSゾーン              |

{% hint style="danger" %}
どの証明書の方法を選択した場合も、証明書は4つの名前すべてをカバーしている必要があります。[証明書がカバーする必要がある名前](#names-your-certificate-must-cover)をご参照ください。
{% endhint %}

### 自己署名 <a href="#self-signed" id="self-signed"></a>

デフォルトの方法です。証明書を構成せずにインストールすると、ローカルの認証局と、その認証局が署名するリーフ証明書が生成されます。名前は、デプロイメントのドメインから導出された正しいものになります。認証局の証明書は、展開したバンドル内の `install/services/local-proxy/ssl/ca.crt` に書き込まれます。

各クライアントのオペレーティングシステムまたはブラウザでは、署名されたリーフ証明書ではなく、生成された `ca.crt` を信頼します。ブラウザの証明書の警告を無視しても、そのページは信頼されたセキュアコンテキストにはなりません。証明書が信頼されていないページでは、ブラウザは意図的にWebAuthn (セキュリティキー/YubiKey、パスキーの登録) を拒否し、クリップボード、マイク、サービスワーカーのキャッシュなどのAPIも使えません。生成された証明書でブラウザのすべての機能を有効にするには、`ca.crt` を信頼するか、パブリックまたは企業で信頼された証明書に切り替える必要があります。

### 独自の証明書 <a href="#your-own-certificate" id="your-own-certificate"></a>

インストール中にPEM形式の証明書と鍵を指定します (既存のデプロイメントでは、直接構成します)。プライベートのルート認証局は、証明書のルートがプライベートである場合のみ追加します。たとえば、パブリックの信頼ストアにない企業や社内の認証局が該当します。

要件は以下のとおりです。

* **PEM形式**で、証明書ファイルはフルチェーン (リーフ証明書、続いて中間証明書の順) である必要があります。リーフ証明書のみの場合、ブラウザ (中間証明書をキャッシュします) では検証に成功しますが、他の環境では失敗します。インストーラはリーフ証明書のみのファイルを拒否しないため、ご自身で確認してください。
* **最初の証明書は、認証局の証明書ではなく、エンドエンティティのリーフ証明書である必要があります。** 認証局の証明書をリーフ証明書として使用すると、PAMのトンネルと接続が動作しなくなります。
* **リーフ証明書は、現在有効で、TLSサーバーとしての使用が許可されている必要があります。**
* **秘密鍵は、パスフレーズで保護されていてはいけません。**
* **絶対パス:** これらはファイルとしてバインドマウントされるため、デプロイメントが起動時に読み取る場所から読み取れる必要があります。

証明書と鍵は組み合わせて指定し、実際に対になっている必要があります。これらのチェックと、以下で説明する必要な名前は、何かが起動する前に検証され、後で気付かないまま失敗するのではなく、分かりやすいメッセージが表示されます。

### Let's Encrypt <a href="#lets-encrypt" id="lets-encrypt"></a>

Let's Encryptは、上記の「独自の証明書」と同じ仕組みで無料の証明書を発行します。ファイルの生成には `certbot` を使用します。ホストにパブリックなDNS名とアウトバウンドのインターネット接続が必要なため、エアギャップ環境のインストールでは利用できません。

証明書には、ドメイン配下の複数の名前が必要です (以下をご参照ください)。そのため、DNS-01チャレンジを推奨します。すべての名前を一度に発行でき、インバウンドのポートを開ける必要もありません。HTTP-01チャレンジは、どのDNSプロバイダーでも使用できますが、すべての名前についてインターネットからポート80に到達できる必要があります。

Let's Encryptの証明書は有効期間が短く、更新は自動ではありません。有効期限が切れる前に、ご自身で更新して証明書を再読み込みしてください。

発行されたら、上記の「独自の証明書」と同じ方法で、証明書と鍵を指定します。

### 証明書がカバーする必要がある名前 <a href="#names-your-certificate-must-cover" id="names-your-certificate-must-cover"></a>

デプロイメントのメインドメインとサービスドメインから導出される、4つの名前です。サービスドメインはインストーラが尋ねます。デフォルトでは、メインのホスト名と同じです。ワイルドカードは1つのラベルにしか一致せず、`push.services.example.com` のような複数ラベルの名前には一致しないため、ワイルドカードだけでは足りません。

| 名前                                | 用途                               |
| --------------------------------- | -------------------------------- |
| メインドメイン                           | ボルト、管理コンソール、API、最新のクライアント向けのプッシュ |
| `connect.<service domain>`        | PAMのトンネルと接続                      |
| `push.services.<service domain>`  | サーバーが指定するレガシーのソケットURL            |
| `files.services.<service domain>` | ファイルと添付ファイルのストレージ                |

{% hint style="danger" %}
証明書の名前が不足していると、製品の機能に悪影響があります。4つすべての名前が割り当てられていることを確認してください。
{% endhint %}

### 確認 <a href="#verify" id="verify"></a>

インストール後や証明書の変更後に、また、一見無関係に見える問題 (ログインが進まない、PAMトンネルが動作しないなど) が実は証明書の問題である可能性がある場合は、`./smk doctor` を実行します。構成された証明書が上記の必要な名前すべてをカバーしているかに加え、有効なエンドエンティティのサーバー証明書であること、構成された認証局につながること、鍵と一致することを確認します。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.keeper.io/keeperpam/jp/self-managed-keeper/self-managed-keeper-overview/installation/tls-certificates.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
