# ローカルネットワークへのアクセスを有効にする

アプリのプレビューでローカルネットワークアクセス (LNA) を有効にします。

## ローカルネットワークへのアクセス権

一部の新しいバージョンのインターネットブラウザでは、LNA の制限が実装されています。このセキュリティ機能により、[巧妙な追跡方法](https://localmess.github.io)や自宅または職場のネットワーク上のデバイス (プリンターやルーターなど) を標的とする攻撃から、あなたを保護します。

たとえば、Chrome (バージョン 142 以降) は [すべてのローカルネットワークアクセスに対する新しい権限プロンプト](https://developer.chrome.com/blog/local-network-access)を追加します。つまり、ユーザーのローカルネットワークに接続するサイトに対して明示的に許可を与える必要があるのです。この点については[仕様](https://wicg.github.io/local-network-access)で詳しくご説明しています。

## Stripe Apps の LNA 利用要件

[アプリをプレビュー](https://docs.stripe.com/stripe-apps/create-app.md#preview-app)する際、ブラウザがローカルの HTTP サーバーから静的アセット (JavaScript バンドルなど) をダウンロードできるようにするため、ブラウザは LNA の許可を必要とします。このローカル HTTP サーバーは、[その`stripe apps start` CLI コマンド](https://docs.stripe.com/stripe-apps/reference/cli.md#command-overview)によって開始されたものです。これにより、ダッシュボード内でアプリの変更をプレビューできるようになります。

## Stripe Apps のローカルネットワークへのアクセスを許可する

Stripe Apps の LNA を許可するには以下の手順に従ってお手続きください。

1. ターミナルを開いて `stripe apps start` を実行します。
2. [プレビューページの有効化](https://dashboard.stripe.com/apps/enable-preview)のページに、LNA にStripe ダッシュボードへのアクセス権を付与するよう求めるプロンプトが表示されます。詳細は [Stripe Apps を始める](https://docs.stripe.com/stripe-apps/create-app.md#preview-app)でご確認ください。

権限を付与した後、ローカル HTTP サーバーにリクエストを送信して、Stripe App JavaScript のバンドルをダウンロードできます。

## トラブルシューティング

ローカルネットワークへのアクセスをブロックした場合は、権限の設定を更新できます。

### Chrome

Chrome LNA 権限設定を更新するには、以下のようにします。

1. [Stripe ダッシュボード](https://dashboard.stripe.com/) を Chrome で開きます。
2. アドレスバーにあるサイトの設定をクリックしてください。Chrome ではこのサイトの設定は、URL の最初の文字の横にある、Google が「チューンアイコン」と呼ぶものの裏にあります。
3. **サイトの設定** を選択します。
4. **ローカルネットワーク**を見つけます。
5. **許可** をクリックします。
6. Stripe ダッシュボードのページを更新します。

または、`chrome://settings/content/localNetworkAccess` ページを使用して、現在のローカルネットワークアクセス設定を調査および調整します。

権限を付与しても Chrome がローカルネットワークにアクセスできない場合は、権限が付与されているように見えてもローカルネットワークリクエストがブロックされる macOS のバグがある可能性があります。この問題を修正する手順については、Terminal ネットワーク要件の[ブラウザのローカルネットワークアクセス](https://docs.stripe.com/terminal/network-requirements.md#browser-lna)を参照してください。

### Firefox

Firefox の LNA 権限設定を更新するには、Mozilla のドキュメントの [Firefox での個人用デバイスとローカルネットワークの権限の制御](https://support.mozilla.org/en-US/kb/control-personal-device-local-network-permissions-firefox#w_manage-access-permissions-to-your-device-and-local-network)を参照してください。

### macOS

macOS では、アプリがローカルネットワークにアクセスすることを明示的に許可する必要があります。Chrome または Firefox がローカルネットワークにアクセスできることを確認するには、以下のようにします。

1. **システム設定**を開きます。
2. **プライバシーとセキュリティ**をクリックします。
3. **ローカルネットワーク**をクリックします。
4. Chrome または Firefox がトグルを有効にしてリストされていることを確認します。

### ブラウザ拡張機能

ブラウザの拡張機能は、ローカルネットワークリクエストに干渉する可能性があります。原因として拡張機能を除外するには、プライベートウィンドウまたはシークレットウィンドウでリーダーに接続してみてください。これにより、ほとんどの拡張機能がデフォルトで無効になります。