プロキシ環境下でUnity を利用するために Web プロキシの証明書を信頼する

• 企業のネットワークにおいて Web プロキシを利用している
• Web プロキシにおいて SSL インスペクションの機能を利用している
• クライアントマシンにおいて Web プロキシの SSL/TLS 証明書を受け入れるよう構成されている

概要：

Unity アプリケーションが SSL インスペクションを使用している Web プロキシ環境で正常に通信を行うためにクライアントマシンに以下の設定する必要があります。

• プロキシ環境下でUnity を利用するために自動プロキシ設定を有効化する
• Web プロキシの証明書をクライアントマシンに設定し、信頼する

このKBでは Web プロキシの証明書をクライアントマシンに設定し、信頼するための手順を説明します。

注意：この KB は Unity のドキュメント「Use Unity through web proxies」- 「Trusting the web proxy security certificate」の翻訳となります。最新の情報はドキュメントを参照してください。

手順：

1. NODE_EXTRA_CA_CERTS 環境変数に証明書を設定します

1. 1 つ以上のカスタム認証局(CA) の 証明書を含むテキスト ファイルを作成します。ファイルは、Privacy-Enhanced Mail (PEM) 形式の 1 つ以上の信頼された証明書で構成されている必要があります。詳細については、御社のIT部門へお問い合わせ頂くか、使用されている外部のWeb プロキシ ソフトウェアのヘルプを参照してください。
2. 1. の手順で作成した .pem ファイルを、Unity のインスタンスがある各コンピューターに配布します。
3. NODE_EXTRA_CA_CERTS 環境変数を構成して、2. で配置した証明書へのパスを設定してください。

例：以下の例では、mycert.pem が証明書ファイル名で、ユーザーのホームディレクトリに配置されています。
Windows

set NODE_EXTRA_CA_CERTS=C:\Users\username\mycert.pem

macOS / Linux

export NODE_EXTRA_CA_CERTS=/Users/username/mycert.pem

NODE_EXTRA_CA_CERTS 環境変数についての詳細は次のドキュメントを参照してください - Node.js のドキュメント

1. の手順を実施することができない場合は、2. の手順を代わりに実施してください。

2. 設定ファイルに証明書ファイルを指定します。

1. upmconfig.toml global configuration ファイルの位置を確認します。ファイルが存在しない場合は作成してください。
   Windows: %ALLUSERSPROFILE%\Unity\config\upmconfig.toml 
   (例： C:\ProgramData\Unity\config\upmconfig.toml)
   macOS / Linux: /etc/upmconfig.toml
   
   upmconfig.toml 構成ファイルのデフォルトの場所を上書きするカスタムの場所を定義できます。これを行うには、UPM_GLOBAL_CONFIG_FILE 環境変数を作成し、その値をファイル名を含む構成ファイルの絶対パスに設定します。

2. 1 つ以上のカスタム認証局(CA) の 証明書を含むテキスト ファイルを作成します。ファイルは、Privacy-Enhanced Mail (PEM) 形式の 1 つ以上の信頼された証明書で構成されている必要があります。
   
   以下はその例です。

   -----BEGIN CERTIFICATE-----
   MIIC+zCCAeOgAwIBAgIJAO0U6hVJnbvjMA0GCSqGSIb3DQEBBQUAMBQxEjAQBgNV
   BAMMCWxvY2FsaG9zdDAeFw0xOTAzMTIwMTIxMzRaFw0yOTAzMDkwMTIxMzRaMBQx
   中略
   LFwHSUdqk0lJK4b0mCwyTHNvYO1IDziE5EKwfuaKVgOa62iCHVahgIVa+een4EfS
   hCCr3M3cq11Mi+mnRi1scxxrOno4OEEChWg2szZLlxBrkVJllrrq620XJ6RLB/8=
   -----END CERTIFICATE-----
   -----BEGIN CERTIFICATE-----
   MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl
   MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
   中略
   H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe
   +o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g==
   -----END CERTIFICATE-----

3. 2. の証明書ファイルを 可能な限り upmconfig.toml global configuration ファイルと同じフォルダーに保存します。

4. upmconfig.toml global configuration ファイルに、caFileキーを追加し、その値に2. の証明書ファイルの絶対パスを指定します。
   
   重要：TOML ファイル内で Windows 上のパスを設定する場合は、スラッシュ (/) または二重のバックスラッシュ (\\) を使用します。単一のバックスラッシュ (\) はエスケープ シーケンスを示す特殊文字であり、TOML 解析エラーを引き起こす可能性があるため、使用しないでください。

   Windows

   caFile = "C:\\ProgramData\\Unity\\config\\cert.pem"

   macOS / Linux

   caFile = "/etc/cert.pem

参考情報：

• Trusting the web proxy security certificate  - Unity マニュアル