設定ファイルを使用した Windows クライアントからの接続

必須項目。TLS サーバのアドレス。IP アドレス、ローカル・ドメイン内の非修飾ホスト名、または完全修飾ホスト名を指定できます (注意 ：Address と Port または TelnetPort の両方の値がクライアント・アプリケーションの接続先のサーバと一致する場合にのみ、クライアントは指定された構成を使用します)。

必須項目。TLS サーバが接続を受け付けるポート番号 (注意 ： Address と Port または TelnetPort の両方の値がクライアント・アプリケーションの接続先のサーバと一致する場合にのみ、クライアントは指定された構成を使用します)。

TLS で保護されている InterSystems Telnet 接続を受け入れる TLS サーバ上のポート番号。この値を指定しない場合、InterSystems IRIS Telnet を使用する接続で TLS はサポートされません (注意 ： Address と Port または TelnetPort の両方の値がクライアント・アプリケーションの接続先のサーバと一致する場合にのみ、クライアントは指定された構成を使用します)。

必須項目。この定義で指定されたサーバに接続する場合に、クライアントが使用する TLS 構成。各構成は、専用のセクションで定義します。

非推奨。代わりに TLSMinVersion と TLSMaxVersion を使用します。

この構成でサポートする TLS プロトコルのバージョン。このプロトコルの各バージョンには、TLSMinVersion と TLSMaxVersion に挙げた数字が割り当てられています。複数のバージョンのプロトコルをサポートするよう指定するには、その値の合計を使用します。例えば、TLS v1.1 と TLS v1.2 のサポートを指定する場合は値 24 を使用します。

このプロパティは、管理ポータルの [TLS 構成] ページの [プロトコル] フィールドと同じです。

v1.3 がサポートされる構成の場合は必須項目。この構成でサポートする TLS プロトコルの最小バージョン。サポート対象プロトコルの各バージョンを以下の数字で指定します。

• TLS v1 — 4

• TLS v1.1 — 8

• TLS v1.2 — 16

• TLS v1.3 — 32

このプロパティは、管理ポータルの [TLS 構成] ページの [最小プロトコル・バージョン] フィールドと同じです。

v1.3 がサポートされる構成の場合は必須項目。この構成でサポートする TLS プロトコルの最新バージョン。サポート対象プロトコルの各バージョンを以下の数字で指定します。

• TLS v1 — 4

• TLS v1.1 — 8

• TLS v1.2 — 16

• TLS v1.3 — 32

このプロパティは、管理ポータルの [TLS 構成] ページの [最大プロトコル・バージョン] フィールドと同じです。

必須項目。クライアントが接続先サーバの証明書を検証する必要があるかどうか。

• 0 — 相手検証は不要です (実行されません)。すべての状況で接続が確立されます。

• 1 — 相手検証が必要です。検証が成功した場合にのみ接続が確立されます。これが推奨値です。この値を選択する場合は、CAFile プロパティの値を指定する必要があります。

このプロパティは、管理ポータルの [TLS 構成] ページの [サーバ証明書の検証] フィールドと同じです。

サーバの証明書の Common Name フィールドまたは subjectAlternativeName フィールドが接続定義で指定されているホスト名または IP アドレスと一致するかをクライアントが確認するかどうか。

• 0 — 確認しません。

• 1 — 確認します。

このプロパティと同等の機能は、管理ポータルにはありません。ただし、これは %Net.HttpRequestOpens in a new tab クラスの SSLCheckServerIdentity プロパティと同じタイプの確認です。

TLS v1.2 以前を使用する接続がサポートされる構成の場合は必須項目。クライアントが暗号化およびハッシュのためにサポートする一連の暗号スウィート。このプロパティの構文の詳細は、OpenSSL のドキュメントで ciphersOpens in a new tab コマンドを参照してください。

既定値は ALL:!aNULL:!eNULL:!EXP:!SSLv2 です。この値を使用することを強くお勧めします。InterSystems IRIS におけるこの構文の詳細は、"暗号スウィート構文の有効化" を参照してください。

このプロパティは、管理ポータルの [TLS 構成] ページの [有効な暗号化スウィート] フィールドと同じです。

TLS v1.3 を使用する接続がサポートされる構成の場合は必須項目。クライアントが暗号化およびハッシュのためにサポートする一連の暗号。このプロパティの構文の詳細は、OpenSSL のドキュメントで ciphersOpens in a new tab コマンドを参照してください。

インターシステムズでは、この既定値 TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 を使用することを強くお勧めします。InterSystems IRIS におけるこの構文の詳細は、"暗号スウィート構文の有効化" を参照してください。

クライアントの信頼された認証機関 (CA) のファイルを含むファイルの絶対パスと名前。クライアントに CA がない場合は、このプロパティの値を指定しないでください。指定する場合、これは PEM 形式の X.509 証明書で、証明書チェーンを含めることができます。この値を使用する方法は、"必須証明書チェーンの確立" を参照してください (Windows の証明書のエクスポート ウィザードからエクスポートした証明書は、既定の DER でエンコードしたバイナリ X.509 ではなく、PEM でエンコードした X.509 形式とする必要があることに注意してください)。

このプロパティは、管理ポータルの [TLS 構成] ページの [このクライアントの証明書を含むファイル] フィールドと同じです。

構成の秘密鍵ファイルの絶対パスと名前。クライアントに秘密鍵がない場合は、このプロパティの値を指定しないでください。

このプロパティは、管理ポータルの [TLS 構成] ページの [関連づけられた秘密鍵を含むファイル] フィールドと同じです。

構成の秘密鍵を解読するためのパスワード。パスワードを設定した秘密鍵を使用する場合、このプロパティは必須です。クライアントの証明書を使用しない場合、または秘密鍵にパスワードがない場合は、このプロパティの値を指定しないでください (秘密鍵がパスワードで保護されている場合、ここで値を指定しないと、InterSystems IRIS は秘密鍵を解読および使用できません)。

このプロパティは、管理ポータルの [TLS 構成] ページの [秘密鍵パスワード] フィールドと同じです。

構成に秘密鍵と証明書がある場合に、構成の秘密鍵を保存する形式。

• DSA — 1

• RSA — 2

このプロパティは、管理ポータルの [TLS 構成] ページの [秘密鍵タイプ] フィールドと同じです。

必須項目。サーバの信頼された認証機関 (CA) のファイルを含むファイルの絶対パスと名前。これは PEM 形式の X.509 証明書です。以下の点に注意してください。

• VerifyPeer 値を 1 に指定した場合は、この値を指定する必要があります。

• これは、接続するサーバの CA の証明書であり、自身が使用する CA の証明書ではありません。

このプロパティは、管理ポータルの [TLS 構成] ページの [信頼済み認証局の証明書を含むファイル] フィールドと同じです。ただし、ポータルとは異なり、%OSCertificateStore 文字列の使用はサポートしていません。