Oxaa
ログインダウンロード
  1. ローカル環境を、そのままオンラインへ。ネットワークを開放せずに。
  2. ユースケース
  3. プレビュー環境

ローカル開発向けの安全な公開エンドポイント

プレビュー環境

プレビュー環境。実用的な手順、製品動作、制限、証拠、Oxaa で次に行う操作を説明します。

要点

プレビュー環境 では、ローカルで動くコードに対して実際の外部 workflow を完了します。外部 request、callback、connection が対象 handler に到達し、期待する結果を返すことが成功条件です。

ローカルサービスから実際の外部リクエストまで

  1. 承認済みの署名付き Oxaa パッケージをインストールして検証します。
  2. oxaa login を実行し、デバイスを登録します。
  3. 対象のローカルサービスを起動し、health check を行います。
  4. oxaa http <port> を実行し、edge-ready になるまで待ちます。
  5. Provider sandbox、別のブラウザ、スマートフォン、または別ネットワークからリクエストを送信します。
  6. ローカルアプリと Inspector で request/response を確認します。
  7. 終了時にルートを停止し、callback、capture、テスト用認証情報を削除します。

技術詳細

  • 実際の外部タスクと明確な完了条件
  • 前提条件、ローカル handler、edge-ready
  • Provider・browser・device からの request と期待する response
  • signature、proxy、cookie、protocol の注意点
  • Inspector のデータ処理と安全なトラブルシューティング
  • クリーンアップ、反復 workflow、本番への引き継ぎ

トラフィックと Inspector データの扱い

Oxaa の公開エッジでは、正確なホスト名を解決し、現在認証されているルートを特定してリクエストを転送するために公開 TLS を終端します。登録済みデバイスと Oxaa の間のセッションは暗号化され、そのセッションを通じて選択したローカルサービスだけにリクエストが届きます。

サービスの運用と保護に必要な範囲で、アカウント、ルート、使用量、セキュリティ、請求、サポート、診断のメタデータを保持します。Inspector の body キャプチャは通常の転送とは別の、明示的なデバッグ操作です。ローカル Inspector に表示される制限付きの request/response body コピーは開発者端末に残り、マスキング、即時削除、自動失効が可能です。公開トラフィックはエッジで処理されるため、「Oxaa はトラフィックを見られない」ではなく「Inspector のコピーはローカルに残る」と説明します。

ルートの識別と公開範囲

接続は登録済みデバイスから開始されます。ローカル生成のデバイス ID、所有証明、短期間のルート世代、正確な Host マッチングによって、ホスト名を現在のルートに結び付けます。不明、不正、失効済み、古い所有状態は、別の宛先へ送らず fail-closed で拒否します。

Oxaa が公開するのは設定したローカル宛先だけです。プライベートネットワーク宛先は明示的な許可が必要で、public、metadata、link-local、multicast などの危険な宛先クラスはポリシーでブロックします。

トラブルシューティング

最初にローカルプロセス、ポート、scheme を確認します。次に認証と時刻、DNS、UDP/443、TCP/443 fallback、社内 proxy または TLS interception、ルート所有状態、edge-ready を確認します。oxaa routes list、oxaa diagnose --network、安定した error ID を使用し、共有前に secret、body、プライベートパスを除去します。

クリーンアップと本番環境への移行

外部 callback、preview URL、DNS 設定を削除し、テスト用認証情報をローテーションし、ローカルキャプチャを削除してルートを停止します。必要に応じてデバイスまたはセッションを失効させ、本番トラフィックはデプロイ済みアプリ、production ingress、またはイベント配信基盤へ移行します。

Oxaa が行うこと・行わないこと

Oxaa は、登録済みデバイスと認証済みルートが有効な間、選択したローカル HTTP/HTTPS サービスを外部から利用できるようにする開発用接続です。アプリのホスティング、一般的な VPN、forward proxy、恒久的な本番配備、raw TCP/UDP トンネル、任意の TLS passthrough、CDN/WAF、または本番 Webhook 配信基盤ではありません。

よくある質問

Oxaa はアプリをデプロイしますか？

いいえ。アプリは登録済みデバイス上で動作し続けます。認証済みルートが有効な間だけ、選択したローカルサービスへリクエストを転送します。

受信ポートを開ける必要がありますか？

通常は不要です。登録済みデバイスからセッションを開始します。ただし、制限の強いネットワークでは DNS、UDP/443、TCP/443 がブロックされたり、TLS がインターセプトされたりする場合があります。

Inspector の body コピーはどこに保存されますか？

制限付きキャプチャを明示的に有効にした場合、ローカル Inspector に表示されるコピーは開発者端末に残ります。公開トラフィックの処理と制限付き運用メタデータの保持は別に行われます。

本番ホスティングとして使えますか？

いいえ。本番トラフィックには、デプロイ済みアプリ、production ingress、またはイベント配信基盤を使用してください。