メインコンテンツへスキップ
GOWAには2種類の認証があります。
  1. APIアクセス: GOWAを呼び出す可能性があります。これがHTTPベーシック認証です。
  2. WhatsAppのペアリング:WhatsAppのWebをリンクするように、WhatsAppアカウントをデバイススロットにリンクします。

APIアクセス: Basic認証

Basic Authは唯一のAPI認証方法です。REST呼び出しのAPIキーやJWTはありません。 1つ以上の user:password ペアを設定してください。カンマ区切り:
すべてのエントリには、ユーザー名とパスワードを含める必要があります。デフォルトのリスナーである APP_HOST=0.0.0.0、完全な資格情報なしで開始することを拒否します。認証なしのローカル開発では、APP_HOST=127.0.0.1 をバインドします。 リバースプロキシがすべての呼び出し元を認証する場合、APP_ALLOW_UNAUTHENTICATED=true または --allow-unauthenticated=true は、Basic 認証なしでノンループバックリスナーを明示的に許可します。 リクエストごとに認証情報を送信:
認証情報が見つからないか間違っていると、 401 Unauthorized が返されます。

Basic 認証の背後にないもの

/、/mcp、/wsのダッシュボードを含めると、基本的な認証が必要になります。

WebSocket

ブラウザーはWebSocket接続でヘッダーを設定できないため、/wsはクエリ文字列の認証情報を取得します。
authorization は base64(user:password) です。TLS (wss://) を使用して、プロキシログのクエリ文字列をredact します。 WebSocket は、状態変化する HTTP 要求に使用されるのと同じ信頼できるオリジンとブラウザーのオリジンを照合します。 現在のWebSocketハブは、接続されているすべてのソケットにイベントをブロードキャストします。 device_id クエリは、接続のデバイスコンテキストを選択しますが、イベントの配信は分離されません。 イベントのデバイス識別子を使用して、ダッシュボードビューをフィルタリングし、すべてのデバイスで信頼されている呼び出し元のみに API アクセスを許可します。 イベントコード、ペイロード、クライアントの例については、WebSocket リファレンスを参照してください。

CORS

CORS はデフォルトで任意のオリジンを許可します。APP_CORS_ALLOWED_ORIGINS=https://ui.example.com (カンマ区切り)でそれを制限してください。許可されているリクエストヘッダーは Origin 、 Content-Type 、 Accept 、 Authorization 、 X-Device-Id です。 CORSとブラウザーのオリジンチェックは分離されています。ワイルドカードCORSオリジンは状態を変更するリクエストやWebSocketを許可しません。 GOWAは、リクエスト自身のホスト、特定のCORSオリジン、APP_TRUSTED_ORIGINSを信頼し、OAuth発行者とChatwootコールバックURLに設定されたオリジンを信頼します。 別のダッシュボードの場合、その正確な原点を設定します。
信頼されていないブラウザーからの変更リクエストには、403 CROSS_SITE_REQUEST_BLOCKED が返されます。ログイン、ログアウト、再接続、招待リンクのリセットを行う GET ルートも対象です。curl など、ブラウザーのオリジンを示すヘッダーを送信しないクライアントは引き続き利用できます。 nullオリジンは信頼されていません。file://のURLとして開く代わりに、HTTPまたはHTTPS経由でgowa-ui.htmlを提供します。 リバースプロキシの背後で、 Host を保持し、 X-Forwarded-Host で信頼できるプロキシを設定し、 APP_TRUSTED_ORIGINS で公開オリジンを一覧表示します。

WhatsAppのペア

すべてのWhatsAppアカウントはデバイススロットにあります。まずスロットを作成し、ペアリングしてください。 /devices/{device_id}の下のルートは、デバイスをパスから取ります。同等のルート/app/*は、X-Device-Idヘッダーを使用します。

QR code

qr_linkを開き、電話からスキャンします: 設定 → リンクされたデバイス → デバイスをリンク。 qr_duration秒後に新しいコードを要求します。/のダッシュボードはQRを直接表示し、WebSocketを介してライブで更新します。

Pairing code

応答には results.pair_code が含まれています。電話では電話番号とリンク を選択し、入力してください。 phone は、国コードと連携させるアカウントの数でなければなりません。

パスワード

QR ログイン中にパスキーの確認を求められた場合、GOWAはWebAuthnチャレンジを保存し、WebSocketにPASSKEY_REQUESTをブロードキャストします。 ダッシュボードがこのフローを処理します。自分でドライブするには次のようにします。
  1. GET /app/passkey は保留中のチャレンジを返します。
  2. POST /app/passkey/response は WebAuthn assertion(PublicKeyCredential.toJSON()形式)を送信します。
  3. PASSKEY_CONFIRMATION を待ちます。result.skip_handoff_ux がtrueの場合、有効なQRフローは自動的に確認を送信します。 それ以外の場合は、result.code と電話のコードを比較し、POST /app/passkey/confirm を呼び出します。
3つの呼び出しすべてにX-Device-Idを送信します。

結果を確認する

results.is_connected と results.is_logged_in は、アカウントがリンクされると両方の true になります。セッションは storages/で継続されるので、再起動にはペアリングは必要ありません。

ログアウトして削除

電話からリンクされていないアカウント (format@@0 → format@@1) は同じようにログアウトされます。

セキュリティチェックリスト

  • ネットワークから到達可能なものには、強力なパスワードを必ずAPP_BASIC_AUTHに設定してください。
  • リバースプロキシで TLS を終了します。Basic Auth 資格情報は base64 エンコードのみです。
  • ブラウザUIがAPIを呼び出すときに、APP_CORS_ALLOWED_ORIGINS を制限します。
  • openssl rand -hex 32 を使用して安定した WHATSAPP_WEBHOOK_SECRET を生成します。シークレットを空または公開した例は、再起動時に変更されるプロセスごとにランダムなキーに置き換えられます。
  • storages/を機密として扱います。リンクされたアカウントのセッションキーがすべて含まれています。 新しいSQLiteファイルは、所有者のみの権限を使用し、それらのために作成されたディレクトリは0700を使用します。同じ注意を払ってバックアップを保護します。