Ana içeriğe atla
GOWA yalnızca HTTP Basic Auth destekler: REST API için API anahtarları, bearer token’ları veya JWT’ler yoktur. (MCP ayrıca OAuth token’larını kabul edebilir; bkz. MCP sunucusu.)

Yapılandırma

Virgülle ayrılmış her user:pass çifti geçerli bir oturum açma bilgisidir. Her girdide hem kullanıcı adı hem de parola bulunmalıdır. Loopback dışındaki bir adreste dinleyen sunucu, eksiksiz kimlik bilgileri olmadan başlamayı reddeder. Kimlik doğrulaması olmadan yerel geliştirme için APP_HOST=127.0.0.1 adresine bağlayın. APP_ALLOW_UNAUTHENTICATED=true ayarını yalnızca ters proxy çağrıları yapanların kimliğini doğruladığında ve GOWA’ya doğrudan erişim kısıtlandığında kullanın.

Kimlik bilgilerini gönderme

Yanlış veya eksik kimlik bilgileri 401 Unauthorized döndürür.

Herkese açık yollar

WebSocket

Tarayıcılar WebSocket bağlantılarında üst bilgi ayarlayamadığından /ws, /ws?device_id=my-device&authorization=<base64 user:pass> biçimini de kabul eder. wss:// kullanın ve proxy günlüklerindeki kimlik bilgilerini gizleyin. WebSocket ve durumu değiştiren HTTP yolları, güvenilmeyen tarayıcı origin’lerini reddeder. Panelin tam origin değerini APP_TRUSTED_ORIGINS veya APP_CORS_ALLOWED_ORIGINS içinde ayarlayın. Joker karakterli bir CORS origin’i bu erişimi sağlamaz ve file:// sayfalarından gelen null origin’ler reddedilir. Güvenilmeyen bir origin’den gelen HTTP değişiklik istekleri 403 CROSS_SITE_REQUEST_BLOCKED döndürür. Bkz. tarayıcı erişimi yapılandırması.

Cihaz üst bilgisi

Basic Auth, WhatsApp hesabını değil API çağrısını yapanı tanımlar. Birden fazla cihaz olduğunda cihaz kapsamındaki her çağrı ayrıca X-Device-Id gerektirir. Bkz. Çoklu cihaz.
Basic Auth her istekte kimlik bilgilerini gönderir. Güvenilir bir ağın dışında GOWA’nın önünde her zaman HTTPS kullanın.