TCP デバイスを使用して TLS を使用するための InterSystems IRIS の構成

TLS を使用して TCP 接続を開く

ここでは、TLS を使用する指定の接続を開き、特定のマシンやポート番号と通信します。以下はその方法です。

1. 接続しているデバイスを以下のように指定します。

    Set MyConn = "|TCP|1000"

   

   TCP の文字列は、これが TCP デバイスであることを指定しています。TCP 接続を開始する方法の詳細は、"TCP デバイスの OPEN コマンド" を参照してください。

2. 接続を開き、/TLS パラメータで、TLS の使用を指定します。

    OPEN MyConn:(SvrID:1000:/TLS="MyCfg")

   

   各項目の内容は次のとおりです。

   • MyConn は以前指定されたデバイスです。

   • SvrID は、解決可能な DNS 名または IP アドレスの文字列です。

   • MyCfg は、保存 (および有効化された) TLS 構成です。

   この呼び出しでは、TLS を使用してポート 1000 のループバック・プロセッサ (つまり、ローカル・マシン) への TCP 接続を開きます。MyCfg 構成で指定した特性に従い、TLS が使用されます。

   オプションとして、プライベート・キー・ファイルのパスワードを以下のように含めることができます。

    OPEN MyConn:(SvrID:1000:/TLS="MyCfg|MyPrivateKeyFilePassword")
   

   

   ここでは、すべての引数が示されており、MyPrivateKeyFilePassword が実際のパスワードになります。

   Important:

   TLS を使用している TCP 接続を開くときにパスワードを含める機能は、リアルタイム・インタラクティブを使用する場合にのみ有効です。保護していない秘密鍵パスワードを永続的に保存することは絶対に避けてください。そのようなパスワードを保存する必要がある場合は、Security.SSLConfigsOpens in a new tab クラスの PrivateKeyPassword プロパティを使用します。

   TCP デバイスを開く方法の詳細は、"TCP デバイスの OPEN コマンド・キーワードと USE コマンド・キーワード" を参照してください。

接続を一度確立すると、他の TCP 接続と同様に使用できます。

TLS を使用した既存の TCP 接続の保護

ここでは、特定のマシンやポート番号への既存の接続に TLS を追加します。以下はその方法です。

1. 接続しているデバイスの名前を決定します。例えば、以下のコードを使用して接続が確立されているとします。

    SET MyConn="|TCP|1000"
    OPEN MyConn:("localhost":1000)
   

   

   TCP の文字列は、これが TCP デバイスであることを指定しています。TCP 接続を開始する方法の詳細は、"TCP デバイスの OPEN コマンド" を参照してください。

2. /TLS パラメータで、TLS の使用を以下のように指定します。

    USE MyConn:(::/TLS="MyCfg")
   

   

   各項目の内容は次のとおりです。

   • MyConn は以前指定されたデバイスです。

   • MyCfg は、TLS 構成です。

   オプションとして、プライベート・キー・ファイルのパスワードを以下のように含めることができます。

    USE MyConn:(::/TLS="MyCfg|MyPrivateKeyFilePassword")
   

   

   ここでは、すべての引数が示されており、MyPrivateKeyFilePassword が実際のパスワードになります。

   Important:

   TLS を使用している既存の TCP 接続を開くときにパスワードを含める機能は、リアルタイムのインタラクティブを使用する場合にのみ有効です。保護していない秘密鍵パスワードを永続的に保存することは絶対に避けてください。そのようなパスワードを保存する必要がある場合は、Security.SSLConfigsOpens in a new tab クラスの PrivateKeyPassword プロパティを使用します。

   TCP デバイスを開く方法の詳細は、"TCP デバイスの OPEN コマンド・キーワードと USE コマンド・キーワード" を参照してください。

接続に TLS セキュリティを追加しても、以前と同様にその接続を使用できます。

TLS が必要な TCP ソケットを開く

TLS が必要なソケットを開くには、以下の手順を実行します。

1. 以下のように、接続を受け入れるデバイスを指定します。

    SET MySocket = "|TCP|1000"

   

   TCP の文字列は、これが TCP デバイスであることを指定しています。TCP 接続を開始する方法の詳細は、"TCP デバイスの OPEN コマンド" を参照してください。

2. 接続を開き、/TLS パラメータで、TLS の使用を指定します。

    OPEN MySocket:(:1000:/TLS="MyCfg")

   

   オプションとして、プライベート・キー・ファイルのパスワードを以下のように含めることができます。

    OPEN MySocket:(:1000:/TLS="MyCfg|MyPrivateKeyFilePassword")
   

   

   この呼び出しでは、TLS を使用してポート 1000 の TCP ソケットを開きます。TCP デバイスを開く方法の詳細は、"TCP デバイスの OPEN コマンド・キーワードと USE コマンド・キーワード" を参照してください。

   Important:

   TLS を使用している TCP 接続を開くときにパスワードを含める機能は、リアルタイム・インタラクティブを使用する場合にのみ有効です。保護していない秘密鍵パスワードを永続的に保存することは絶対に避けてください。そのようなパスワードを保存する必要がある場合は、Security.SSLConfigsOpens in a new tab クラスの PrivateKeyPassword プロパティを使用します。

TLS を使用したソケットへの既存の TCP 接続の保護

ここでは、特定のマシンやポート番号のソケットへの既存の接続に TLS を追加します。以下はその方法です。

1. ソケットが開いているデバイスの名前を判断します。例えば、以下のコードを使用して接続が確立されているとします。

    SET MySocket = "|TCP|1000"
    OPEN MySocket:(:1000)
   

   

   TCP の文字列は、これが TCP デバイスであることを指定しています。TCP 接続を開始する方法の詳細は、"TCP デバイスの OPEN コマンド" を参照してください。

2. /TLS パラメータで、TLS の使用を以下のように指定します。

    USE MySocket:(::/TLS="MyCfg")
   

   

   各項目の内容は次のとおりです。

   • MySocket は以前指定されたデバイスです。

   • MyCfg は、TLS 構成です。

   オプションとして、プライベート・キー・ファイルのパスワードを以下のように含めることができます。

    USE MySocket:(::/TLS="MyCfg|MyPrivateKeyFilePassword")
   

   

   TCP デバイスを開く方法の詳細は、"TCP デバイスの OPEN コマンド・キーワードと USE コマンド・キーワード" を参照してください。

   Important:

   TLS を使用している既存の TCP 接続を開くときにパスワードを含める機能は、リアルタイムのインタラクティブを使用する場合にのみ有効です。保護していない秘密鍵パスワードを永続的に保存することは絶対に避けてください。そのようなパスワードを保存する必要がある場合は、Security.SSLConfigsOpens in a new tab クラスの PrivateKeyPassword プロパティを使用します。

ソケットに TLS セキュリティを追加しても、以前と同様にソケットへの接続を使用できます。