WhatsApp ile Giriş Ayarları
Soplog Hotspot modülünde misafirler, telefonlarına WhatsApp üzerinden gelen doğrulama kodu ile internete giriş yapabilir. Mesajlar Meta WhatsApp Cloud API ile doğrudan işletmenizin kendi WhatsApp Business hesabından gönderilir; arada aracı firma yoktur, mesaj ücreti doğrudan Meta'ya ödenir. Bu dokümanda Meta tarafındaki hazırlıktan Soplog ve firewall ayarlarına kadar tüm adımlar anlatılmaktadır.
1 - Ön Gereksinimler
Kuruluma başlamadan önce aşağıdakilerin hazır olduğundan emin olunuz:
- business.facebook.com adresinde bir Meta Business hesabı (İşletme Portföyü).
- Bu hesaba bağlı bir WhatsApp Business hesabı ve WhatsApp Business Platform'a kayıtlı bir işletme telefon numarası. Bu numara aynı anda WhatsApp veya WhatsApp Business uygulamasında kullanılamaz.
- developers.facebook.com adresinde İşletme türünde, WhatsApp ürünü eklenmiş bir Meta uygulaması. (WhatsApp hesabını ilk kez kuruyorsanız Meta'nın kurulum sihirbazı bu uygulamayı sizin için oluşturur.)
- WhatsApp Business hesabında tanımlı bir ödeme yöntemi. Ödeme yöntemi olmadan Meta şablon mesajı göndermez.
- Soplog sunucusunun graph.facebook.com adresine 443 (HTTPS) portundan erişebilmesi.
Dikkat !
Meta'nın verdiği test numarası ile yalnızca Meta panelinde izin listesine eklediğiniz (en fazla 5) numaraya mesaj gönderilebilir. Misafirlerin giriş yapabilmesi için kendi işletme numaranızı kaydetmeniz gerekir.
2 - Phone Number ID Bilgisinin Alınması
- WhatsApp Yöneticisi > Telefon numaraları sayfasını açınız.
- Hotspot doğrulama mesajlarının gönderileceği numaraya tıklayınız.
- Açılan panelde numaranın altında yer alan Telefon numarası kodu (Phone number ID) değerini kopyalayınız.
Not: Phone Number ID, telefon numarasının kendisi değildir; Meta'nın numaraya verdiği 15-16 haneli kimliktir.
3 - Kalıcı Access Token (Jeton) Oluşturulması
Soplog, Meta'ya bir Sistem kullanıcısı adına üretilmiş, süresi dolmayan bir erişim jetonu (Access Token) ile bağlanır. Bu işlem üç adımdan oluşur: sistem kullanıcısını oluşturmak, ona uygulamayı ve WhatsApp hesabını atamak, jetonu üretmek.
3.1 - Sistem kullanıcısının oluşturulması
- Ayarlar > Kullanıcılar > Sistem kullanıcıları sayfasını açınız.
- Sağ üstteki Ekle butonu ile Admin erişimli bir sistem kullanıcısı oluşturunuz (örn. soplog). Daha önce oluşturulmuş bir sistem kullanıcınız varsa onu kullanabilirsiniz.
3.2 - Uygulama ve WhatsApp hesabının atanması
- Sistem kullanıcısını seçip Varlıklar Atayın butonuna tıklayınız.
- Sol listeden Uygulamalar seçiniz, Meta uygulamanızı işaretleyiniz ve Tam erişim > Uygulamayı yönetir iznini açınız.
- Aynı pencerede sol listeden WhatsApp Hesapları seçiniz, WhatsApp Business hesabınızı işaretleyiniz ve Tam erişim > Her şey iznini açınız.
- Varlıkları ata butonu ile kaydediniz.
3.3 - Jetonun oluşturulması
- Sistem kullanıcısı seçiliyken Jeton oluştur butonuna tıklayınız.
- Uygulama seç adımında Meta uygulamanızı seçip İleri butonuna tıklayınız.
- Son tarihi belirle adımında jeton süre sonu olarak Asla seçeneğini işaretleyiniz.
- İzinler ata adımında whatsapp_business_messaging ve whatsapp_business_management izinlerini işaretleyip Jeton oluştur butonuna tıklayınız.
- Oluşan jetonu kopyalayınız. Jeton bu pencere kapandıktan sonra bir daha gösterilmez.
Not: İzinler ata adımında Uygun izin yok uyarısı görüyorsanız sistem kullanıcısına uygulama atanmamıştır; 3.2 adımını tamamlayıp tekrar deneyiniz.
Dikkat !
Meta uygulama panelindeki API Setup ekranında görünen geçici jeton 24 saat sonra, süre sonu 60 gün seçilen jeton ise 60 gün sonra geçersiz olur ve misafirlere kod gönderilemez. Soplog'a mutlaka süre sonu Asla olan sistem kullanıcısı jetonunu giriniz.
4 - Doğrulama Mesajı Şablonunun Oluşturulması
WhatsApp, işletmenin başlattığı mesajlarda serbest metin gönderilmesine izin vermez; doğrulama kodu Meta tarafından onaylanmış bir Kimlik Doğrulama şablonu ile gönderilir.
- WhatsApp Yöneticisi > Mesaj şablonları > Şablonları yönet sayfasında Şablon oluştur butonuna tıklayınız.
- Kategori olarak Kimlik Doğrulama, mesaj türü olarak Tek kullanımlık geçiş kodu seçip İleri butonuna tıklayınız.
- Şablon adı ve dili bölümünde şablona küçük harf ve alt çizgiden oluşan bir ad veriniz (örn. hotspot_dogrulama) ve dili seçiniz (örn. Turkish).
- Kod gönderim kurulumu bölümünde Kodu kopyala seçeneğini işaretleyiniz. Önizlemede mesajın altında Kodu kopyala butonu görünmelidir.
- İsteğe bağlı olarak İçerik bölümünden güvenlik tavsiyesi ve kodun son kullanma zamanı bilgisini ekleyip Gönder butonu ile şablonu onaya gönderiniz.
- Şablonun durumu Aktif olana kadar bekleyiniz (genellikle birkaç dakika sürer).
Not: Şablon adını ve dilini bir kenara not ediniz; Soplog'a birebir aynı girilmelidir. Meta şablonu ad ve dil ikilisiyle eşleştirir: örneğin English (en) ile English (US) (en_US) farklı şablonlardır. Zero-tap ve Tek dokunmayla otomatik doldurma seçenekleri mobil uygulamalar içindir; hotspot girişi için Kodu kopyala seçilmelidir.
5 - Soplog WhatsApp Ayarları
- Ayarlar > WhatsApp Ayarları sayfasını açınız.
- Phone Number ID: 2. adımda kopyaladığınız Telefon numarası kodu.
- Access Token: 3. adımda oluşturduğunuz kalıcı token. Token şifreli saklanır; kaydedildikten sonra sayfada gizli olarak görünür.
- Şablon Adı: 4. adımda oluşturduğunuz şablonun adı (örn. hotspot_dogrulama).
- Şablon Dili: Şablonun Meta'daki dili (örn. Turkish (tr)).
- API Sürümü: Varsayılan değeri değiştirmeyiniz. Meta eski API sürümlerini yaklaşık iki yıl sonra kapatır; böyle bir duyuru gelirse güncelleyiniz.
- Test Mesajı Gönder alanına WhatsApp kullanan bir telefon numarası girip Gönder butonuna tıklayınız. Başarılı sonuç aldıktan sonra WhatsApp Ayarlarını Kaydet butonu ile ayarlarınızı kaydediniz.
Dikkat !
Test sonucunun başarılı olması, mesajın Meta tarafından kabul edildiği anlamına gelir; teslim bilgisi Meta'dan ayrıca gelmez. Mesaj telefona ulaşmadıysa numarada WhatsApp kurulu olduğunu ve numarayı ülke koduyla girdiğinizi kontrol ediniz.
6 - Hotspot Ayarlarında WhatsApp ile Girişin Açılması
- Ayarlar > Hotspot Ayarları sayfasında Hotspot Ayarları sekmesini açınız.
- Kullandığınız hotspot ayar şablonunu düzenleyiniz ya da Yeni Hotspot Ayarı ile yeni bir şablon oluşturunuz.
- Oturum Açma Yöntemleri tablosunda WhatsApp ile Giriş satırının Doğrulama Aktif/Pasif kutusunu işaretleyiniz. İsteğe bağlı olarak aynı satırda Gizli Kelime ve Admin Onayı seçeneklerini de açabilirsiniz.
- Formun altında açılan WhatsApp Ayarları bölümünde, misafirden telefon numarasıyla birlikte ad ve soyad bilgisi de almak istiyorsanız WhatsApp ile girişte ad soyad bilgisi al seçeneğini işaretleyiniz.
- Hotspot Ayarlarını Kaydet butonu ile kaydediniz.
Not: Ayarlar > WhatsApp Ayarları sayfası kaydedilmemişse, WhatsApp ile Giriş açık bir hotspot ayarı kaydedilemez.
7 - Firewall Üzerinde WhatsApp Adreslerine Erişim
Misafir, doğrulama kodunu WhatsApp'tan okuyabilmek için internete çıkabilmelidir; ancak bu aşamada hotspot oturumu henüz açılmamıştır. Mobil verisi açık olan telefonlar kodu mobil veri üzerinden alır. Mobil verisi olmayan cihazların da kodu okuyabilmesi için firewall üzerinde *.whatsapp.com ve *.whatsapp.net adreslerine oturum öncesi (pre-auth) erişim tanımlanmalıdır. Kullandığınız cihazın sekmesindeki adımları uygulayınız.
Sophos'ta hotspot misafirleri, Soplog'dan giriş yapana kadar yalnızca kimlik doğrulama istemeyen firewall kurallarına uyan adreslere erişebilir; diğer tüm trafik Hotspot İnternet Çıkış Kuralı'na düşer ve misafir giriş sayfasına yönlendirilir. WhatsApp adreslerine oturum öncesi erişim vermek için bu adreslerden oluşan bir grup ve kimlik doğrulama istemeyen ayrı bir firewall kuralı oluşturulur.
Aşağıdaki adımlar SFOS 22 arayüzüne göre hazırlanmıştır. Hotspot için gereken temel ayarlar (Web Authentication, Soplog Server Erişim Kuralı, Hotspot İnternet Çıkış Kuralı) için Sophos Hotspot Ayarları dokümanına bakınız.
7.1.1 - WhatsApp adreslerinin tanımlanması
- Hosts and services > FQDN host sayfasını açıp Add butonuna tıklayınız.
- Name alanına WhatsApp_com, FQDN alanına *.whatsapp.com yazıp Save butonu ile kaydediniz.
- Aynı şekilde Name değeri WhatsApp_net, FQDN değeri *.whatsapp.net olan ikinci kaydı oluşturunuz.
- Hosts and services > FQDN host group sayfasını açıp Add butonuna tıklayınız.
- Name alanına WhatsApp yazınız. Select host alanında WhatsApp_com ve WhatsApp_net kayıtlarını işaretleyip Apply 2 selected items butonuna, ardından Save butonuna tıklayınız.
Not: FQDN adresinin başında *. olmalı ve küçük harfle yazılmalıdır. WhatsApp mesaj, medya ve bağlantı için farklı alt alan adları kullandığından yalnızca whatsapp.com girmek yeterli değildir. Aynı FQDN daha önce farklı bir adla tanımlandıysa Sophos ikinci kaydı kabul etmez; bu durumda mevcut kaydı gruba ekleyiniz.
7.1.2 - WhatsApp erişim kuralının oluşturulması
- Rules and policies > Firewall rules sayfasını açınız ve Add firewall rule > New firewall rule seçeneğine tıklayınız.
-
Alanları aşağıdaki gibi doldurunuz:
- Rule name: Hotspot_WhatsApp_Erisimi
- Action: Accept
- Rule group: Hotspot kurallarınızın bulunduğu grup (grup kullanmıyorsanız None)
- Rule position: Top
- Source zones: Hotspot ayarları yapılan zone
- Source networks and devices: Any
- Destination zones: WAN
- Destination networks: WhatsApp (listede varsayılan olarak seçili gelen Any işaretini kaldırıp WhatsApp grubunu seçiniz)
- Services: Any
- Match known users seçeneğini işaretlemeyiniz. Bu seçenek işaretlenirse kural yalnızca giriş yapmış misafirlere uygulanır ve kod okunamaz.
- Save butonu ile kaydediniz.
Not: Kuralda ayrıca NAT tanımlamanız gerekmez; Sophos'un varsayılan Default SNAT IPv4 kuralı WAN'a çıkan trafiği maskeler. Bu kural cihazınızda kaldırıldıysa kural ekranındaki Create linked NAT rule ile kaynak adresi MASQ olan bir NAT kuralı ekleyiniz.
7.1.3 - Kural sırası
Sophos firewall kurallarını yukarıdan aşağıya işler ve ilk uyan kuralı uygular. WhatsApp kuralı, Hotspot İnternet Çıkış Kuralı'nın (Match known users ve Use web authentication for unknown users seçenekleri işaretli olan kural) üstünde olmalıdır; aksi halde WhatsApp trafiği de giriş sayfasına yönlendirilir.
- Kural Rule position: Top ile eklendiğinde grubun en üstüne yerleşir. Hotspot kurallarınız farklı bir düzende ise Rules and policies > Firewall rules listesinde Hotspot_WhatsApp_Erisimi kuralını satırın solundaki tutamaçtan sürükleyerek Hotspot İnternet Çıkış Kuralı'nın üstüne taşıyınız.
Dikkat ! Sophos, *. ile başlayan FQDN adreslerinin IP'lerini misafirlerin DNS sorgularından öğrenir. Hotspot ağına DHCP ile dağıtılan DNS sunucusu olarak Sophos'un hotspot arayüz IP adresinin verilmesi önerilir (Network > DHCP > ilgili DHCP sunucusu > DNS server). Misafirlerin DNS sorgularına izin veren kural da bulunmalıdır.
Palo Alto'da hotspot misafirleri Authentication Policy ile giriş sayfasına yönlendirilir: kimliği bilinmeyen (unknown) kullanıcıların web (HTTP/HTTPS) trafiği, Soplog'dan giriş yapılana kadar captive portal'a düşer. WhatsApp adreslerine oturum öncesi erişim vermek için bu adreslerden oluşan bir Custom URL Category ve bu kategoriyi giriş sayfasından muaf tutan bir Authentication kuralı oluşturulur.
Aşağıdaki adımlar PAN-OS 11.1 arayüzüne göre hazırlanmıştır. Hotspot için gereken temel ayarlar için Palo Alto Hotspot Ayarları dokümanına bakınız.
7.2.1 - WhatsApp URL kategorisinin oluşturulması
- Objects > Custom Objects > URL Category sayfasını açıp Add butonuna tıklayınız. Alan adlarının sonuna eğik çizgi eklendiğini anlatan bilgi penceresi açılırsa kapatınız.
- Name alanına WhatsApp yazınız, Type olarak URL List seçili kalmalıdır.
-
Liste altındaki Add butonu ile aşağıdaki dört girişi ekleyiniz:
- *.whatsapp.com
- *.whatsapp.net
- whatsapp.com
- whatsapp.net
- OK butonu ile kaydediniz.
Not: WhatsApp adresleri için Objects > Addresses altında FQDN türünde adres nesnesi kullanmayınız. FQDN adres nesneleri *. ile başlayan adresleri kabul etmez ve yalnızca yazılan adı çözer; WhatsApp ise g.whatsapp.net, mmg.whatsapp.net gibi farklı alt alan adlarına bağlandığından kod okunamaz.
7.2.2 - WhatsApp muafiyet kuralının oluşturulması
- Policies > Authentication sayfasını açınız. Kuralın giriş sayfasına yönlendiren kuraldan önce eklenmesi için listede bu kuralın üstündeki bir kuralı seçip Add butonuna tıklayınız.
-
Sekmeleri aşağıdaki gibi doldurunuz:
- General > Name: Hotspot_WhatsApp_Erisimi
- Source > Source Zone: Hotspot zone'u (Source Address ve Source User: any)
- Destination > Destination Zone: WAN (Destination Address: any)
- Service/URL Category > Service: service-http ve service-https
- Service/URL Category > URL Category: Any işaretini kaldırıp WhatsApp kategorisini ekleyiniz
- Actions > Authentication Enforcement: default-no-captive-portal
- OK butonu ile kaydediniz.
7.2.3 - Kural sırası ve Commit
Palo Alto Authentication kurallarını yukarıdan aşağıya işler ve ilk uyan kuralı uygular. Hotspot_WhatsApp_Erisimi kuralı, kullanıcısı unknown olan ve misafiri giriş sayfasına yönlendiren kuralın üstünde olmalıdır; değilse kuralı seçip Move ile yukarı taşıyınız.
- Değişiklikleri uygulamak için sağ üstteki Commit butonuna tıklayınız.
Not: Authentication kuralı yalnızca giriş sayfası yönlendirmesini atlatır. Hotspot zone'undan WAN'a çıkan trafiğe izin veren Security kuralında Source User alanı known-user ise, kimliği bilinmeyen misafirin trafiği burada engellenir; bu durumda WhatsApp trafiğine izin veren ayrı bir Security kuralı gerekir.
Ruijie'de hotspot misafirlerinin kimlik doğrulaması firewall kurallarından (Security Policy) ayrı olarak Authentication Policy ile yapılır: misafirin internete çıkışına izin veren güvenlik kuralı bulunsa da, Soplog'dan giriş yapılana kadar trafik giriş sayfasına yönlendirilir. WhatsApp adreslerine oturum öncesi erişim vermek için bu adresler kimlik doğrulama Allowlist'ine eklenir; ayrıca bir firewall kuralı oluşturmanız gerekmez.
Aşağıdaki adımlar Ruijie Z Series (NGFW_NTOS 1.0R13) arayüzüne göre hazırlanmıştır. Hotspot için gereken temel ayarlar (Wifidog, Authentication Policy, NAT ve SopLog Server Erişim Kuralı) için Ruijie Firewall Hotspot Ayarları dokümanına bakınız.
7.3.1 - WhatsApp adreslerinin Allowlist'e eklenmesi
- Object > User Authentication > Authentication Settings sayfasını açınız. Allowlist sekmesinde URL başlığını seçip Create butonuna tıklayınız.
- Allowlist Type olarak URL seçili olmalıdır. URL alanına *.whatsapp.com yazınız, isteğe bağlı olarak Description alanına bir açıklama giriniz ve Save butonu ile kaydediniz.
- Aynı şekilde *.whatsapp.net için ikinci kaydı oluşturunuz.
Not: Adresin başında *. olmalıdır. WhatsApp mesaj, medya ve bağlantı için farklı alt alan adları kullandığından yalnızca whatsapp.com girmek yeterli değildir. Src. IP ya da Src. MAC türünü seçmeyiniz; bu türler ilgili cihazın tüm trafiğini kimlik doğrulamadan muaf tutar.
Dikkat ! Hotspot zone'undan internete (untrust) ve DNS'e çıkışa izin veren Security Policy kuralları bulunmalıdır. Allowlist yalnızca kimlik doğrulamayı atlatır; güvenlik kuralı trafiği engelliyorsa kod yine gelmez.
8 - Misafir Giriş Akışı
- Misafir hotspot giriş sayfasında WhatsApp ile Giriş yöntemini seçer ve telefon numarasını girer.
- Soplog, kayıtlı şablonla doğrulama kodunu misafirin WhatsApp hesabına gönderir.
- Misafir gelen mesajdaki Kodu kopyala butonu ile kodu kopyalar, giriş sayfasına yapıştırır ve oturumu açar.
Not: Her doğrulama mesajı Meta tarafından kimlik doğrulama kategorisi ücretiyle ücretlendirilir. Güncel fiyatlar için WhatsApp fiyatlandırma sayfasına bakınız.
9 - Sık Karşılaşılan Hatalar
Test mesajı gönderilemediğinde Meta'nın döndürdüğü hata kodu ve açıklaması sayfada gösterilir. Sık karşılaşılan durumlar:
- Access Token geçersiz, süresi dolmuş (Meta kodu 190): Geçici token kullanılmış ya da token iptal edilmiştir. 3. adımdaki gibi süre sonu Asla olan yeni bir token oluşturunuz.
- Token'ın bu numara için yetkisi yok (10, 131005): Sistem kullanıcısına WhatsApp hesabı atanmamış ya da whatsapp_business_messaging izni verilmemiştir.
- Geçersiz parametre (100): Phone Number ID yerine telefon numarasının kendisi girilmiş olabilir; Phone Number ID ve API sürümünü kontrol ediniz.
- Şablon bulunamadı (132001): Şablon adı ya da dili Meta'dakiyle birebir aynı değildir veya şablon henüz onaylanmamıştır.
- Şablon değişken sayısı uyuşmuyor (132000, 132012): Şablon Kimlik doğrulama kategorisinde ve Kodu kopyala butonlu oluşturulmamıştır.
- Alıcı numara izinli listede değil (131030): Meta test numarası kullanılıyordur; alıcıyı test listesine ekleyiniz ya da işletme numaranıza geçiniz.
- Ödeme yöntemi tanımlı değil (131042): WhatsApp Business hesabına ödeme yöntemi ekleyiniz.
- Meta sunucusuna ulaşılamadı: Soplog sunucusunun graph.facebook.com adresine 443 portundan erişimini, proxy ve güvenlik duvarı ayarlarını kontrol ediniz.
Hotspot üzerinde misafire kod gönderilemediğinde misafir yalnızca genel bir hata mesajı görür; Meta'nın döndürdüğü ayrıntılı hata Soplog olay günlüğüne (kod 210) yazılır.