HN 日本語サマリー

← 一覧へ戻る
インフラ・DevOps

WireGuardオープンエンドポイント

Open WireGuard Endpoints (proxylity.com)

20 pointsby mlhpdx2 コメント

要約

UDP Gatewayは、WireGuardリスナーが事前登録なしで接続を受け入れる機能と、Lambda宛先を非同期で呼び出す機能を追加しました。これにより、従来はカスタムインフラを必要とした、パブリックfacingでイベント駆動型のWireGuardサービスが構築可能になります。オープンエンドポイントはHTTPSと同様のモデルで、共有プリシェアードキー(PSK)による認証ゲートも提供可能です。

全文翻訳

利用可能になりました:WireGuardのオープンエンドポイントとLambdaの非同期呼び出し

Lee Harding 著 | 2026年6月3日 | 7分で読めます

[画像: 任意のピアを受け入れるオープンWireGuardエンドポイントと、非同期Lambdaワークフローを示す図]

本日、UDP Gatewayに2つの新機能が追加されました。1つ目は、WireGuardリスナーが事前登録なしで任意のクライアントからの接続を受け入れられるようになる機能です。これは、HTTPSがウェブサイトに対して行うモデルと同じです。2つ目は、Lambda宛先を非同期で呼び出せるようになり、Gatewayが応答を待つことなく、長時間実行されるワークフローにパケットを送信できるようになる機能です。これら2つを組み合わせることで、これまで構築にかなりのカスタムインフラが必要だった、公開 facingでイベント駆動型のWireGuardサービスのクラスが開かれます。

WireGuardオープンエンドポイント

WireGuardリスナーは、常に接続するクライアントごとに事前登録を必要としていました。CloudFormationテンプレートに各ピアの公開鍵をリストし、リスナーは未知の鍵からのハンドシェイクを拒否していました。このモデルは、管理されたデバイスセットを持つプライベートサービスには適しています。しかし、多数または未知のクライアントセットからアクセスする必要があるものにとっては問題となります。

最初の起動時にWireGuardの鍵ペアを生成するモバイルアプリを考えてみてください。あるいは、オンデマンドでプロビジョニングされるデバイスのフリートで、中央での鍵管理が運用上非現実的な場合。あるいは、これまで見たことのないクライアントが接続する必要のある、公開 facingのサービス。以前のモデルでは、これらのクライアントそれぞれが、ハンドシェイクを完了する前に、帯域外の登録ステップとCloudFormationの更新が必要でした。これは、パブリックサービスにスケールするモデルではありません。

新しいAllowUnknownPeersプロパティは、その制限を解除します。WireGuardリスナーでこれをtrueに設定すると、Gatewayは、公開鍵がリストされているかどうかにかかわらず、有効なWireGuardクライアントとのハンドシェイクを完了します。接続は依然として完全に暗号化されます。WireGuardの暗号化特性は変更されません。違いは、リスナーが鍵を事前に知っている必要がなくなったということです。

HTTPSとの類似性は意図的です。HTTPS経由でウェブサイトにアクセスする際、サーバーは暗号化された接続を確立する前に、あなたが誰であるかを知る必要はありません。TLSハンドシェイクが完了し、チャネルが暗号化され、認証(行われる場合)はアプリケーションレイヤーでの別の懸念事項です。オープンWireGuardエンドポイントも同様に機能します。トランスポートは暗号化され、IDはアプリケーションが必要とする方法でLambdaまたはStep Functionsの宛先によって処理されます。

共有資格情報ゲートの追加

完全にオープンな登録(文字通り、任意のWireGuardクライアントを受け入れる)は、一部のサービスに適しています。他のサービスでは、暗号化とオープンハンドシェイクを望みますが、資格情報が発行されていないクライアントからの接続も防止したい場合があります。UnknownPeerPreSharedKeyプロパティは、まさにこのケースのための軽量なゲートを提供します。

UnknownPeerPreSharedKeyが設定されている場合、未知のピアはそのPSKをWireGuard設定に含める必要があります。そうしないとハンドシェイクが失敗します。これはデバイスごとの認証ではありません。すべてのクライアントが同じシークレットを使用しますが、PSKが発行されたクライアントへのアクセスを実質的に制限します。トランスポートレイヤーアクセス用の共有APIキーのようなものと考えてください。強力なIDではありませんが、資格情報が発行されていないクライアントからの任意の接続に対する実際の障壁です。

PSKをクライアントに配布するのは、アプリケーションの責任です。インフラストラクチャ側ではAWS Secrets Managerに保存し、CloudFormationスタックから参照します。クライアント側では、製造時または登録時にデバイスにプロビジョニングします。

WireGuardListener:
  Type: Custom::ProxylityUdpGatewayListener
  Properties:
    ServiceToken: !FindInMap [ProxylityConfig, !Ref "AWS::Region", ServiceToken]
    ApiKey: !FindInMap [ProxylityConfig, Account, ApiKey]
    Protocols:
      - wg
    AllowUnknownPeers: true
    UnknownPeerPreSharedKey: !Sub "{{resolve:secretsmanager:${WireGuardPSK}:SecretString}}"
    Destinations:
      - Name: packet-handler
        DestinationArn: !GetAtt HandlerLambda.Arn
        Role:
          Arn: !GetAtt ProxylityRole.Arn

名前付きピア(Peers配列にリストされている)は、AllowUnknownPeersおよびUnknownPeerPreSharedKeyの影響を受けません。それらは以前と同様に、独自のピアごとのSharedSecretを使用します。2つのモデルは、単一のリスナー上で共存できます。ピアごとのPSKを持つ既知のデバイスの固定セットと、共有資格情報の背後にある動的クライアント用のオープンなスロットです。

Lambda非同期呼び出し

UDP GatewayのLambda宛先は、常に同期的なRequestResponse呼び出しを使用していました。Gatewayはパケットのバッチを配信し、関数が完了するのを待ち、関数の戻り値を使用してクライアントに返信パケットを送信していました。このモデルは、UDPのリクエスト/レスポンスパターンがどのように機能するかを合わせるためのデフォルトです。

しかし、同期呼び出しは、関数のジョブが単一の呼び出しを超えて実行される処理を開始することであるワークロードでは制限的になります。Lambdaの耐久関数(durable functions)はまさにこれを解決します。チェックポイントとリプレイのメカニズムを使用して、耐久関数は最大1年間実行でき、進捗を失うことなく障害後に自動的に再開します。Event呼び出しタイプは、ここで適切な配信モデルです。Gatewayはパケットバッチを送信し、耐久実行が独立して継続する間に先に進みます。

新しいUseAsyncInvoke引数は、呼び出しタイプをLambdaのEventモードに変更します。Gatewayはパケットバッチを配信し、関数の完了を待たずにすぐにHTTP 202 Acceptedを受け取ります。UDPクライアントへの応答は送信されません。関数はGatewayのリクエストライフサイクルとは独立して完了まで実行されます。

主なユースケースは、耐久ワークフローのトリガーです。UseAsyncInvokeで呼び出された関数は、受信したパケットバッチを受け取り、耐久実行を開始します(または、オーケストレーションモデルとしてStep Functionsを使用することを選択した場合、それにディスパッチします)、すぐに返します。リモートクライアントはUDPパケットを送信しました。長時間実行され、耐障害性のあるワークフローが、チェックポイントされた進捗と障害からの自動回復を備えて、そのクライアントの代わりに現在実行されています。これらすべてにおいて、Gatewayが接続を開いたままにしておく必要はありません。

Destinations:
  - Name: workflow-trigger
    DestinationArn: !GetAtt WorkflowTriggerLambda.Arn
    Role:
      Arn: !GetAtt ProxylityRole.Arn
    Arguments:
      UseAsyncInvoke: "true"

非同期呼び出しを使用する際に留意すべき点がいくつかあります。

  • 応答なし: 関数の戻り値は破棄されます。パケットに応答が必要な場合、非同期呼び出しは適切なツールではありません。標準の同期呼び出しまたはレスポンスストリーミングを使用してください。
  • AWSは障害時に再試行します: Lambdaは、失敗した非同期呼び出しを最大2回自動的に再試行します。関数(およびそれが開始するダウンストリームワークフロー)が冪等であることを確認するか、サイレントなデータ損失なしに失敗をキャプチャするためにデッドレターキューを設定してください。
  • ストリーミングとの相互排他: UseAsyncInvokeとUseResponseStreamingは、同じ宛先で同時にtrueにすることはできません。これらは反対の配信モデルを表します。

まとめ

これらの2つの機能は独立していますが、特定のパターンで自然に組み合わされます。それは、長時間実行されるバックエンドワークフローをトリガーする、公開WireGuardエンドポイントです。

デバイスプロビジョニングサービスを想像してみてください。デバイスは事前登録された鍵なしで製造されます。最初の起動時に鍵ペアを生成し、共有PSKを使用してオープンWireGuardリスナーに接続し、プロビジョニングリクエストパケットを送信します。Lambda関数がパケットを受信し、完全なプロビジョニングワークフロー(ID登録、証明書発行、DynamoDBレコード作成、SNS通知など)を処理するStep Functionsステートマシンを開始して返します。ステートマシンは数分または数時間実行されます。デバイスは即時の応答を受け取りません。ワークフローが完了すると、プロビジョニング確認は別のチャネルを通じて送信されます。

これらすべてにおいて、デバイス出荷前に鍵レジストリを管理する必要はありません。プロビジョニングの期間中、Gatewayが接続を開いたままにしておく必要もありません。イベント間のインフラストラクチャを実行することなく、パケットが入り、ワークフローが開始されます。

この同じパターンは、送信者が即時の応答を必要としない、受信者トリガーのワークフローに適用されます。例えば、実行前の複数ステップの検証を開始するデバイスコマンドや、複数のシステムにわたる耐久性のある処理保証を必要とする監査イベントなどです。

開始方法

両方の機能は、UDP Gatewayがサポートされているすべてのリージョンで現在利用可能です。どちらも既存のリスナーまたは宛先の変更を必要としません。AllowUnknownPeersはデフォルトでfalseであり、既存のピアリストの動作は変更されず、Lambda宛先はUseAsyncInvokeが明示的に設定されない限り、同期呼び出しを使用し続けます。

完全な設定詳細については、WireGuardリスナーのドキュメントおよびLambda宛先のドキュメントを参照してください。AllowUnknownPeersおよびUnknownPeerPreSharedKeyの完全なCloudFormationプロパティリファレンスには、単一リスナーでの名前付きピアと未知のピアの混在を含む、すべてのオプションが記載されています。