GOWA は HTTP Basic Auth をサポートしています。API キー、所有者トークン、REST API の JWT は存在しません。 (MCP は OAuth トークンを追加で受け入れることができます。MCP サーバ を参照してください。
設定
カンマで区切られた user:passペアは有効なログインです。すべてのエントリにはユーザー名とパスワードの両方が必要です。 非ループバックリスナーは、完全な資格情報なしで開始することを拒否します。 APP_HOST=127.0.0.1 を認証されていないローカル開発にバインドします。リバースプロキシが発信者を認証し、GOWAへの直接アクセスが制限されている場合にのみ、 APP_ALLOW_UNAUTHENTICATED=true を使用してください。
資格情報を送信
認証情報が間違っているか不足している場合は、 401 Unauthorized を返します。
公共ルート
WebSocket
ブラウザはWebSocket接続でヘッダを設定できないため、/wsは/ws?device_id=my-device&authorization=<base64 user:pass>を受け付けます。wss://を使用してプロキシログからのredactクレデンシャルを使用してください。
WebSocketと状態を変更するHTTPルートは、信頼できないブラウザの起源を拒否します。APP_TRUSTED_ORIGINS または APP_CORS_ALLOWED_ORIGINS でダッシュボードの正確な起点を設定します。 CORS のワイルドカードはこのアクセスを許可しません。file://からのnullオリジンは拒否されます。 信頼できないオリジンからの HTTP 変更は 403 CROSS_SITE_REQUEST_BLOCKED を返します。ブラウザのアクセス設定 を参照してください。
デバイスヘッダー
Basic AuthはWhatsAppアカウントではなく、API呼び出し元を識別します。 複数のデバイスが存在する場合、すべてのデバイススコープの呼び出しには X-Device-Id が必要です。 Multi-device を参照してください。
Basic 認証は、すべてのリクエストに対して資格情報を送信します。信頼できるネットワーク外の GOWA の前で HTTPS を使用します。