Web インタフェースの基本設定

• [Web サーバを有効化]: リモート Python コマンドを実行できるようになります。これを選択すると、次のオプションが利用できます。

• [ポート]: サーバのポートが表示されます。このポートで、SSL および非 SSL 要求が処理されます。

• [暗号化された HTTPS のみ]: VRED が暗号化されていない接続要求を拒否するようにします。有効にすると、Web ブラウザと VRED 間の暗号化されていない通信を記録することはできません。これが既定値の状態です。

  注:

  既存の設定(バージョン 2024 より前に作成)は変更されません。ただし、新しい設定は、このオプションが無効になっていない限り、https のみを受け入れます。

• [安全な Python]: オンの場合は、リモートの場所から Python コマンドを実行できるようになります。

• [デバッグ モードを有効化]: VRED ターミナルへの拡張ログインを実行できるようになります。

• [証明書ファイル]: 自己署名入り証明書を生成します。使用する証明書を定義し、ブラウザが信頼する証明書を定義する必要があります。これは自己署名証明書を使用して行われます。Windows 証明書信頼ストアにこの証明書をインストールすると、信頼できない無効な証明書に関するブラウザの警告が表示されなくなります。

  [証明書ファイルを選択]: 使用する証明書を定義します。

  [自己署名入り証明書を作成]: [自己署名入り証明書を作成]ダイアログ ボックスを開き、個々の VRED Web サーバ インスタンスに署名するために使用する自己署名入り VRED 証明書を作成します。

  [証明書情報]: [証明書情報]ダイアログ ボックスを開き、バージョン、シリアル番号、有効性など、証明書に関する情報を表示します。

これらのオプションは、カスタム Web ルート ディレクトリを有効にして、設定するためのものです。任意のデバイスから Web ブラウザを通してアクセスできる VREDStimeaApp のような組み込みの VRED Stream を使用して、独自の Web アプリケーションを作成した場合は、カスタム Web ページをローカル ファイルの場所に保存します。[ディレクトリ]でこの設定を定義して、VRED WebServer が Web ページを実行できるようにします。

VRED Stream に新しい URL プロパティも追加され、全画面の設定、キーボード入力の無効化、URL でのナビゲーションの直接の無効化を行えるようになりました。

• [ファイル アクセスを有効化]: [ディレクトリ]オプションで指定されたカスタム Web ルート ディレクトリへのファイル アクセスを有効にします。

• [ディレクトリ] :* [ファイル アクセスを有効化]がオンになっている場合のみ使用できます。*ファイル アクセス用の Web ルート ディレクトリを指定します。

  [Web ルート ディレクトリを選択]: 使用する Web ルート ディレクトリを定義します。

これらのオプションは、Web ブラウザが信頼するソースを設定します。

• [制約]: Web ブラウザが信頼するソースについての制約があるかどうかを決定します。

  • [制約なし]: 制約を適用しません。この Web ブラウザはすべてのソースを信頼します。
  • [ローカル ホスト]: ローカル ホストを除く他のすべてのホストへのアクセスを拒否します。Web ブラウザはローカル ホストのみを信頼します。
  • [ホスト リスト]: ホスト名を入力できるようにします。Web ブラウザは、リストされたいずれかのホストのすべてのソースを信頼します。

• [ホスト リスト]: 制約ホスト リストが設定されている場合は、[ホスト リスト]フィールドが有効になり、Web ブラウザが信頼するホストを入力できるようになります。リストを修正するには、右クリック メニューを使用します。

セキュリティは強化されますが、ユーザはログインしてパスワードを入力するよう要求されます。

• [認証モード]: Web サーバの認証が不要な場合は、[認証なし]を選択します。ユーザおよびパスワードを設定して、セキュリティを強化するには、[ユーザ名とパスワードでログイン]を選択します。このフィールドの下にあるボタンを使用して、ユーザの追加や削除、パスワードの変更を行います。

VRED によって自己署名 VRED 証明機関が追加されました。個々の VRED Web サーバ インスタンスに署名するには、この証明書を使用します。証明書を作成し、アクセス権を定義し、必要に応じて認証を設定する必要があります。

自己署名入り証明書を作成する

1. [編集] > [基本設定] > [一般設定] > [Web インタフェース]を選択します。

2. [証明書ファイル]の横にあるをクリックして、使用する証明書を定義します。

3. ([自己署名入り証明書を作成]ボタン)をクリックして証明書を作成し、証明書の一意の名前を入力して、[保存]をクリックします。

4. [ホスト アクセス]セクションの[制約]で、Web ブラウザが信頼するソースを設定します。

5. [認証]セクションで、[認証モード]を[ユーザ名とパスワードでログイン]に変更します。

6. [追加]ボタンをクリックして、ユーザ名とパスワードを追加します。

7. [OK]をクリックします。新しいユーザが[ユーザ]セクションに表示されます。

   

この機能を使用すると、VRED 上で実行されている Web アプリケーションから別の Web サイトのコンテンツにアクセスして、YouTube ビデオの再生などを行うことができます。

• [クロスオリジン リクエストを有効化]: Web ページ上のリソースを、最初のリソースの提供元となるドメインの外部の別のドメインから要求できるようにします。

• [許可されたオリジン] : *[クロスオリジン リクエストを有効化]が有効になっている場合のみ使用できます。*Web インタフェースでクロスオリジン リクエストを共有している場合に表示される URL ドメインを入力します。許可されたオリジンのリストを修正するには、右クリック メニューを使用します。

一部の要求に応え、VREDServer に対するクロスオリジン リソース共有(CORS)も実装されました。

• [CORS の HTTP ヘッダ]: クロスオリジン リクエストを共有するための HTTP ヘッダは次のとおりです。

プリフライト(オプション)

Access-Control-Allow-Origin: *

Access Control Allow methods: GET,HEAD,PUT,PATCH,POST,DELETE

Access Control Allow Headers: content-type

実際のリクエスト(GET)

Access-Control-Allow-Origin: *

この拡張の仕組み

ホストまたはポートが、現在の Web サイト/Web アプリケーションの実行場所にあるホストやポートと異なる場合に、Web アプリケーションが JavaScript を介してこの他のホストに要求を送信しようとすると、ホストはこの要求に同意します。それ以外の場合、ブラウザは要求を送信しません。

1. ホストが同意している場合、ブラウザは HTTP メソッド「OPTIONS」を使用して、プリフライト要求内で異なるホストまたはポートを要求します。上記のプリフライトのように HTTP ヘッダーを使用してホストが応答する場合は、実際の要求が使用されます。

2. ブラウザは実際の要求を送信します。ここでも上記のように、HTTP ヘッダーを実際の要求に含める必要があります。この設定を行わない場合、ブラウザは応答を処理しません。

ヘッダーの詳細とその仕組みについては、「Access-Control-Allow-Origin」および「クロスオリジン リソース共有(CORS)」を参照してください。