クラウド自動化とツールのコールバック

要点

クラウド自動化とツールのコールバックでは、ローカルで動くコードに対して実際の外部 workflow を完了します。外部 request、callback、connection が対象 handler に到達し、期待する結果を返すことが成功条件です。

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

承認済みの署名付き Oxaa パッケージをインストールして検証します。
oxaa login を実行し、デバイスを登録します。
対象のローカルサービスを起動し、health check を行います。
oxaa http <port> を実行し、edge-ready になるまで待ちます。
Provider sandbox、別のブラウザ、スマートフォン、または別ネットワークからリクエストを送信します。
ローカルアプリと Inspector で request/response を確認します。
終了時にルートを停止し、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、またはイベント配信基盤を使用してください。