> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# サードパーティ署名検証用のプラグイン署名

> Dify Community Edition で署名検証を完全に無効化することなく、署名付き `.difypkg` のインストールを有効にします（鍵の生成、パッケージの署名、公開鍵の配布）

> [!WARNING]
>
> サードパーティ署名検証は **Dify Community Edition** の機能です。Dify Cloud は署名を一元管理しており、これらの制御は公開されていません。

セルフホストの Dify はデフォルトで署名検証を強制します。サードパーティ署名検証により、管理者は検証を完全に無効化することなく、マーケットプレイスにないプラグインを安全にインストールできます。

2 つのシナリオ：

> [card] 管理者が承認したプラグインに署名する
>
> 管理者は信頼できる開発者からの `.difypkg` をレビューし、インストール前に自分の鍵で署名します。

> [card] 開発者が署名済みプラグインを配布する
>
> 開発者が `.difypkg` に署名し、対応する公開鍵を公開します。その開発者を信頼する管理者は、その公開鍵を検証リストに追加します。

どちらの場合も仕組みは同じです：キーペアを生成し、秘密鍵で署名し、公開鍵で検証します。

## キーペアの生成

```bash theme={null}
dify signature generate -f your_key_pair
```

現在のディレクトリに 2 つのファイルが生成されます：

| ファイル | 用途 |
| :- | :- |
| `your_key_pair.private.pem` | プラグインの署名（秘密にする） |
| `your_key_pair.public.pem` | 署名の検証（公開する） |

> [!WARNING]
>
> 秘密鍵を保護してください。秘密鍵を持つ人は誰でも、あなたの公開鍵を信頼するインストール環境で検証に合格するプラグインに署名できます。

## プラグインの署名と検証

**1. パッケージに署名する**

```bash theme={null}
dify signature sign your_plugin_project.difypkg -p your_key_pair.private.pem
```

同じディレクトリに `your_plugin_project.signed.difypkg` が生成されます。

**2. 署名済みパッケージを検証する**

```bash theme={null}
dify signature verify your_plugin_project.signed.difypkg -p your_key_pair.public.pem
```

配布またはインストール前に署名が一致することを確認します。

> [!NOTE]
>
> `-p` を省略した場合、`dify signature verify` は Dify マーケットプレイスの公開鍵に対して検証します。Dify によって署名されていないプラグインは、そのモードでは検証に失敗します。

## デーモンでの検証の有効化

管理者は、信頼する公開鍵のリストをプラグインデーモンに提供することで、署名済みプラグインをインストールします。

**1. 公開鍵を配置する**

`.public.pem` ファイルをデーモンコンテナがアクセスできる場所に配置します。Docker Compose インストールの場合：

```bash theme={null}
mkdir -p docker/volumes/plugin_daemon/public_keys
cp your_key_pair.public.pem docker/volumes/plugin_daemon/public_keys/
```

**2. デーモン環境を設定する**

`plugin_daemon` サービスで以下の変数を設定します：

| 変数 | 値 |
| :- | :- |
| `FORCE_VERIFYING_SIGNATURE` | `true` |
| `THIRD_PARTY_SIGNATURE_VERIFICATION_ENABLED` | `true` |
| `THIRD_PARTY_SIGNATURE_VERIFICATION_PUBLIC_KEYS` | コンテナ内の公開鍵へのカンマ区切りパス |

`docker-compose.override.yaml` のスニペット：

```yaml theme={null}
services:
  plugin_daemon:
    environment:
      FORCE_VERIFYING_SIGNATURE: true
      THIRD_PARTY_SIGNATURE_VERIFICATION_ENABLED: true
      THIRD_PARTY_SIGNATURE_VERIFICATION_PUBLIC_KEYS: /app/storage/public_keys/your_key_pair.public.pem
```

> [!NOTE]
>
> `docker/volumes/plugin_daemon` はコンテナ内の `/app/storage` にマウントされるため、`THIRD_PARTY_SIGNATURE_VERIFICATION_PUBLIC_KEYS` のパスはコンテナ内パスを使用する必要があります。

**3. Dify を再起動する**

```bash theme={null}
cd docker
docker compose down
docker compose up -d
```

検証付きインストールが強制されます：設定された公開鍵に一致する署名済み `.difypkg` ファイルは正常にインストールされ、未署名または不一致のものは拒否されます。

## 関連リソース

* [ローカルファイルとしてパッケージ化して共有](https://enterprise-docs.dify.ai/ja/3.13.x/develop/plugins/publishing/marketplace-listing/release-by-file.md)
* [個人 GitHub リポジトリに公開](https://enterprise-docs.dify.ai/ja/3.13.x/develop/plugins/publishing/marketplace-listing/release-to-individual-github-repo.md)
* [プラグイン開発ガイドライン](https://enterprise-docs.dify.ai/ja/3.13.x/develop/plugins/publishing/standards/contributor-covenant-code-of-conduct.md)
* [公開 FAQ](https://enterprise-docs.dify.ai/ja/3.13.x/develop/plugins/publishing/faq/faq.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.