---
schema_version: "1"
id: 4a6f0b5252a27e5779c8f6f6dab756a6c167865b7ef7f0b18f6b1f099c0f645a
title: プロキシサーバー経由のエージェントへの接続
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/runtime-manager/rtm-agent-proxy-config.md
canonical_url: https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-proxy-config
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 2c68f9f9b1a0b7e37bb422f7d5977f0471ec043ef465945be47f4fd3f845039e
description: MuleSoft Documentation Site
latest: true
---
# プロキシサーバー経由のエージェントへの接続

 [![logo server active](/mulesoft/current/ja-jp/_/img/icons/server-cloud.svg "Anypoint Platform PCE")Private Cloud Edition](deployment-strategies#anypoint-platform-private-cloud-edition)

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。</p>
</div>
</td>
</tr>
</tbody></table>

プロキシサーバーを介して外部通信が制限されるファイアウォールの内側で Mule Runtime Engine を実行する場合は、Runtime Manager エージェントがトラフィックをプロキシサーバー経由で Runtime Manager に転送するように設定できます。

Runtime Manager エージェントは、プロキシを使用した通信で、基本アクセスと Kerberos v5 (SPNEGO 経由) 認証スキームをサポートします。

## [](#プロキシサーバー経由で接続するためのエージェントの設定)プロキシサーバー経由で接続するためのエージェントの設定

プロキシサーバー経由で接続するようにエージェントを設定するには、次の作業を行う必要があります。

- `amc_setup`​ コマンドを実行して、​`$MULE_HOME/conf/mule-agent.yml`​ ファイルを作成する。
- `$MULE_HOME/conf/wrapper.conf`​ ファイルでプロキシサーバー設定をセットアップする。

### [](#mule-agent-yml-を作成するための-amc_setup-の実行)mule-agent.yml を作成するための amc\_setup の実行

Runtime Manager エージェントをすでにインストール済みで、プロキシを使用するように設定を変更するには、​`mule-agent.yml`​ ファイルにプロキシ設定を追加します。

プロキシサーバー接続を設定する手順は、次のとおりです。

1. `mule-agent.yml`​ ファイルでパスワードを暗号化する場合、​`AGENT_VAR_master_password`​ 環境変数をメインパスワードに設定します。
    
    `export AGENT_VAR_master_password=myPassword`
2. 次のコマンドを実行します。
    
    基本認証では、-P パラメーターによって認証済みプロキシを設定します。
    
    ```console
    $MULE_HOME/bin/amc_setup -H token server-name -P proxy-host proxy-port proxy-user proxy-password
    ```
    
    Kerberos 認証では、新しいパラメーターを使用して、このプロトコルを設定ファイルパスと共に使用することを指定します。
    
    ```console
    $MULE_HOME/bin/amc_setup -H token server-name -P proxy-host proxy-port proxy-user proxy-password --use-kerberos-proxy krb5-configuration-path jaas-configuration-path
    ```

プロキシサーバーで認証が必要ない場合は、​_proxy-user_​ と ​_proxy-password_​ は不要です。これらのオプションは、​_\--use-kerberos-proxy_​ で Kerberos 認証を使用する場合には必須です。

- **amc\_setup -P パラメーター:**
    
    _proxy-host_​
    
    希望するプロキシサーバーのホスト名を指定します (例: `proxy.acme.com`​)。 ホスト名には ​`http://`​ や ​`https://`​ を含めないでください。
    
    _proxy-port_​
    
    希望するプロキシサーバーのポートを指定します。
    
    _proxy-user_​
    
    必要であれば、プロキシでのユーザー認証情報を指定します。
    
    _proxy-password_​
    
    必要であれば、​_proxy-user_​ の認証情報で使用するパスワードを指定します。
- **amc\_setup --use-kerberos-proxy パラメーター:**
    
    _krb5-configuration-path_​
    
    Kerberos KDC との通信で必要な ​`krb5.conf`​ ファイルへのパスを指定します。
    
    これは Kerberos の種類によって異なります。ほとんどの UNIX システムと Windows システムの標準である MIT 実装のリファレンスは、 [MIT Kerceros ドキュメント](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html)​を参照してください。
    
    _jaas-configuration-path_​
    
    Kerberos KDC へのログインで必要な JAAS ログイン設定ファイルへのパスを指定します。
    
    このファイル形式のリファレンスは、 [「JAAS ログイン設定ファイル^」](https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/LoginConfigFile.html)​を参照してください。

次の例では、プロキシサーバー (​`acme.proxy.com`​) と連携して動作するようにエージェントを設定し、Runtime Manager トークンを設定しています。

```console
amc_setup -H myToken myMuleServer -P acme.proxy.com 443
```

次の例では、エージェントが認証が必要なプロキシサーバーと連携するようにエージェントを設定しています。

```console
amc_setup -H myToken myMuleServer -P acme.proxy.com 443 internalAdmin Ins1d3V0icePassword
```

### [](#wrapper-conf-ファイルでのプロキシサーバー設定のセットアップ)wrapper.conf ファイルでのプロキシサーバー設定のセットアップ

`$MULE_HOME/conf/wrapper.conf`​ ファイルでプロキシサーバー設定を指定するには、次のプロパティにプロキシサーバー情報を追加します。

- `wrapper.java.additional.<n>=-Danypoint.platform.proxy_host={hostname}`
- `wrapper.java.additional.<n>=-Danypoint.platform.proxy_port={port}`
- `wrapper.java.additional.<n>=-Danypoint.platform.proxy_username={username}`
- `wrapper.java.additional.<n>=-Danypoint.platform.proxy_password={password}`

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">これらは、Java の起動時に渡す追加パラメーターです。&lt;n&gt; 要素は、設定の追加パラメーターの数を指します。​<code>1</code>​ からの整数として示され、隙間なく連続している必要があります。</td></tr></tbody></table>

## [](#プロキシサーバーが-runtime-manager-証明書を変更しないことの確認)プロキシサーバーが Runtime Manager 証明書を変更しないことの確認

ファイアウォールやプロキシが Runtime Manager 証明書を遮断したり変更したりしないことを確認するため、Runtime Manager エージェントのバージョンに応じて次のいずれかのコマンドを実行します。

これらのコマンドは、プローブを実行して、ファイアウォールやプロキシが証明書を改ざんしているかどうかを判断します。

- バージョン 1.12.0 以降と 2.2.0 以降のエージェント:
    
    ```console
    echo -e "GET / HTTP/1.0\r\n" | openssl s_client -connect runtime-manager.anypoint.mulesoft.com:443 -ign_eof
    ```
    
    このコマンドの出力には次の情報が含まれています。
    
    ```console
    -----END CERTIFICATE-----
    subject=/C=US/ST=California/L=San Francisco/O=salesforce.com, inc./CN=runtime-manager.anypoint.mulesoft.com issuer=/C=US/O=DigiCert Inc/CN=DigiCert TLS RSA SHA256 2020 CA1
    ```

想定される情報が出力に含まれていない場合は、​`openssl`​ コマンドの出力をネットワークチームに送信してください。

## [](#既知の問題)既知の問題

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15%;">
<col style="width: 85%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">問題</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>SE-8011</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>エージェントのセットアップが、セットアップ中にプロキシ情報を渡すときに ​<code>407 Proxy Authentication Required</code>​ を返す。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

- [既存の mule-agent.yml ファイルでのパスワードの暗号化](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#encrypt_password)​。
- [How to troubleshoot communication issues between the Mule Runtime Agent and the OnPrem server (Mule Runtime Engine とオンプレミスサーバーの通信に関する問題のトラブルシューティング方法)](https://help.mulesoft.com/s/article/How-to-troubleshoot-communication-issues-between-the-Mule-Runtime-Agent-and-the-OnPrem-server)​。