(Chrome/Edge) PNA ポリシーによるローカルネットワークアクセス遮断

お知らせ

このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。

概要

Chrome および Edge 141 以降では、PNA（Private Network Access）ポリシーが強化され、パブリックドメイン（インターネット）からプライベートネットワーク（内部ネットワーク）リソースへアクセスしようとする Web アプリケーションは、ブラウザのプリフライトリクエスト（Preflight）および権限チェックを通過する必要があります。

Kollus Player はローカルネットワークデバイスと通信する構造を使用しているため、このポリシーが適用されたブラウザ環境では、プレイヤー呼び出しおよびフルスクリーン機能の使用時に以下の問題が発生する場合があります。

ブラウザの権限リクエストポップアップが表示され、遮断するとプレイヤーが動作しない
プレイヤーがまったく読み込まれない、または CORS/PNA エラーが発生する
iframe 内でプレイヤーを呼び出す際に内部ネットワークリソースへのリクエストが遮断される

解決方法

方法 1: ブラウザの権限ポップアップを許可する（一般ユーザー）

ブラウザがローカルネットワークアクセス権限を要求するポップアップを表示した場合、必ず [許可] をクリックしてください。一度許可すると、同じサイトで追加のポップアップは表示されなくなり、権限はサイト単位で保存されます。

Chrome/Edge 145 以降: 権限リクエスト項目が 「デバイス上のアプリ」 として表示されます。この場合、[許可] をクリックしてからページを再読み込みしてください。
Chrome/Edge 141 以降（145 未満）: 権限リクエスト項目が 「ローカルネットワークアクセス」 として表示されます。この場合、[許可] をクリックしてからページを再読み込みしてください。

誤って権限を遮断した場合の復元方法

ブラウザのアドレスバーに以下のアドレスを入力し、[Enter] を押してください。
- Chrome: chrome://settings/content/localNetwork
- Edge: edge://settings/content/localNetwork
遮断リストから該当サイトを探し、[許可] に変更してください。
ページを再読み込みしてください。

方法 2: ブラウザフラグ設定を変更する（上級ユーザー）

PNA ポリシーチェックを無効化すると、権限ポップアップなしでローカルネットワークにアクセスできます。

注意

この方法はブラウザ内部の実験的機能（flags）を変更するものであり、ブラウザのアップデート時に設定がリセットされる場合があります。個人 PC 環境のみで使用し、セキュリティポリシーが設けられた企業環境では IT 管理者にお問い合わせください。

Chrome 141 以降の設定

Chrome のアドレスバーに chrome://flags/#local-network-access-check を入力し、[Enter] を押してください。
Local Network Access Checks 項目を見つけ、ドロップダウンから [Disabled] を選択してください。
ページ下部の [再起動] ボタンをクリックしてブラウザを再起動してください。

Edge 142 以降の設定

Edge は 141 バージョンまで PNA ポリシーがデフォルトで無効化されていますが、Edge 142 からデフォルトで有効化される予定です。

Edge のアドレスバーに edge://flags/#local-network-access-check を入力し、[Enter] を押してください。
Local Network Access Checks 項目を見つけ、ドロップダウンから [Disabled] を選択してください。
ページ下部の [再起動] ボタンをクリックしてブラウザを再起動してください。

参考文書

Chrome ローカルネットワークアクセスポリシーガイド

方法 3: `iframe` 属性を設定する（開発者）

この方法は、Kollus Player を iframe で直接埋め込んでサービスを開発する担当者向けの案内です。

パブリックドメインからプライベートネットワークリソースをリクエストする iframe の場合、allow 属性に local-network-access および loopback-network 権限を明示する必要があります。この属性がない場合、Chrome/Edge 141 以降で内部ネットワークリソースへのリクエストが遮断されます。

<iframe src="https://v.jp.kollus.com/s?jwt=..."
        allow="encrypted-media; local-network-access; loopback-network"
        allowfullscreen
        webkitallowfullscreen
        mozallowfullscreen>
</iframe>

各属性の役割は以下のとおりです。

属性	説明
`local-network-access`	Chrome/Edge で `iframe` がプライベートネットワーク（内部ネットワーク）リソースにアクセスすることを許可
`loopback-network`	ループバック（localhost）ネットワークアクセスを許可
`encrypted-media`	DRM および保護コンテンツの再生を許可
`allowfullscreen` `webkitallowfullscreen` `mozallowfullscreen`	フルスクリーン機能を許可

参考文書

プリフライトリクエストガイド

概要​

解決方法​

方法 1: ブラウザの権限ポップアップを許可する（一般ユーザー）​

方法 2: ブラウザフラグ設定を変更する（上級ユーザー）​

Chrome 141 以降の設定​

Edge 142 以降の設定​

方法 3: iframe 属性を設定する（開発者）​

概要