# Sophos Firewall API Kurulumu

## Ne işe yarar?

Sophos cihazınızı Useroam'a eklerken **Firewall API'sini şimdi kur ve otomatik yapılandır** seçeneğini açarsanız, Useroam cihazınızdaki misafir Wi-Fi ayarlarının büyük kısmını sizin yerinize yapar: cihaz eklenince RADIUS, web kimlik doğrulama, 5651 log yönlendirme, walled garden ve firewall kuralları otomatik uygulanır. Böylece Sophos arayüzünde tek tek ayar yapmanız gerekmez.

> **Bu ekranı nasıl açarım?** **Cihaz Seçimi → Yeni Cihaz** ekranında **Cihaz Tipi** olarak *Sophos* seçin. Seçenek, **Cihaz Adresi** alanının altında çıkar. Formun diğer alanları [Yeni Cihaz Ekleme](/books/ayarlar/page/yeni-cihaz-ekleme) sayfasında anlatılır.

## Ne zaman kullanılır?

- Yeni bir Sophos cihazını Useroam'a ekliyorsunuz ve kurulumu elle yapmak istemiyorsunuz.
- Misafir ağının firewall kurallarının (DNS, Useroam, İnternet) otomatik oluşmasını istiyorsunuz.

Cihaz zaten ekliyse API bağlantısını [Cihaz Ayarları → Bağlantılar](/books/ayarlar/page/cihaz-ayarlari) sekmesinden yönetirsiniz.

## Başlamadan önce: Sophos tarafında hazırlık

Formdaki **Sophos API erişimini nasıl açarım?** bağlantısının anlattığı adımlar bunlardır. Useroam'un cihazınıza bağlanabilmesi için Sophos arayüzünde bir kez şunları yapın:

1. Sol menüden **Profiles → Device Access** altında yeni bir yönetici profili oluşturun ve tüm izinleri verin.
2. **Authentication → Users → New user** ile yalnız bu iş için yeni bir kullanıcı oluşturun (ör. *useroam-api*). Kullanıcı profili olarak az önce oluşturduğunuz profili seçin.
3. **Backup & firmware → API** sekmesinde **API configuration** kutusunu işaretleyin (*Enabled*). **Allowed IP address** alanına **104.247.174.120** yazıp **+** ile ekleyin ve **Apply** deyin.
4. Cihazın yönetim portunu bilin (Sophos'ta genelde *4444*).

> **Öneri:** Bu iş için Sophos'ta yalnız API yetkili ayrı bir yönetici hesabı açın. Kimlik AES-256 ile şifreli saklanır. Kendi günlük yönetici hesabınızı kullanmayın.

## Adım adım

1. **Yeni Cihaz** formunda lisansı seçin, **Cihaz Tipi**'ni *Sophos* bırakın, **5651 Loglama**'yı açın, **Cihaz Adresi**'ne cihazın dış IP'sini ve **Cihaz Adı**'nı yazın. Sonra **Firewall API'sini şimdi kur ve otomatik yapılandır** anahtarını açın.
    
    ![Firewall API'sini şimdi kur ve otomatik yapılandır anahtarı](https://help.useroam.com/uploads/images/gallery/2026-09/ayar-sophosapi-adim1.png)
2. Açılan alanlara Sophos'ta oluşturduğunuz hesabı yazın: **Sophos yönetici kullanıcı adı**, **Port** (hazır değer *4444*) ve **Sophos yönetici parolası**. Bu aşamada **Kaydet** düğmesi soluktur; bağlantı doğrulanmadan kayıt yapılamaz.
    
    ![Sophos yönetici kullanıcı adı, port ve parola alanları](https://help.useroam.com/uploads/images/gallery/2026-09/ayar-sophosapi-adim2.png)
3. **API'yi test et** düğmesine basın. **Sophos bağlantısı kontrol ediliyor** penceresi açılır ve sırayla *Cihaza bağlanılıyor...*, *Kimlik doğrulanıyor...*, *Sertifika parmak izi alınıyor...*, *Zone bilgileri okunuyor...* adımlarını gösterir.
    
    ![Sophos bağlantısı kontrol ediliyor penceresi](https://help.useroam.com/uploads/images/gallery/2026-09/ayar-sophosapi-adim3.png)
4. Test başarılıysa kısa bir süre *API bağlantısı doğrulandı.* penceresi görünür. Düğmenin altında yeşil *API bağlantısı doğrulandı.* yazısı ve parantez içinde cihazın sertifika parmak izinin başı çıkar. Altında **Misafir ağı zone'u (firewall kuralları için)** listesi açılır; listede cihazınızdaki zone'lar ad ve tipiyle görünür.
    
    ![API bağlantısı doğrulandı yazısı ve zone listesi](https://help.useroam.com/uploads/images/gallery/2026-09/ayar-sophosapi-adim4.png)
5. Listeden misafirlerin bağlandığı zone'u seçin. Seçtiğiniz misafir ağı zone'u için DNS / Useroam / İnternet kuralları otomatik oluşturulur. Zone seçilince **Kaydet** etkinleşir; basın ve **Kurulum** sorusuna **Evet** deyin.
    
    ![Seçilen zone ve etkinleşen Kaydet düğmesi](https://help.useroam.com/uploads/images/gallery/2026-09/ayar-sophosapi-adim5.png)
6. Kurulum bitince panel **Cihaz Ayarları** ekranını açar. Ekranın üstündeki renkli kutular otomatik kurulumun sonucunu gösterir (aşağıdaki tabloya bakın). **Bağlantılar** sekmesinde entegrasyon **Kalıcı bağlı** modda, **Kimlik kayıtlı** ve (parmak izi alındıysa) **Sertifika sabit** rozetleriyle görünür. Aşağıdaki örnek görünümde kimlik henüz girilmemiştir, bu yüzden **Kimlik yok** rozeti görünür.
    
    ![Cihaz Ayarları, Bağlantılar sekmesinde kayıtlı Firewall API entegrasyonu](https://help.useroam.com/uploads/images/gallery/2026-09/ayar-cihaz-fwkayitli.png)

### Test başarısız olursa

Bağlantı kurulamazsa *Bağlantı doğrulanamadı (kimlik/adres/port/sertifika).* penceresi çıkar ve düğmenin altında aynı yazı kırmızı görünür. **OK** ile kapatın.

![Bağlantı doğrulanamadı penceresi](https://help.useroam.com/uploads/images/gallery/2026-09/ayar-sophosapi-hata.png)

![API'yi test et düğmesinin altındaki kırmızı hata yazısı](https://help.useroam.com/uploads/images/gallery/2026-09/ayar-sophosapi-hata2.png)

Şunları kontrol edin:

- **Cihaz Adresi** cihazın dış IP'si mi?
- **Port** cihazın yönetim portu mu (genelde 4444)?
- Sophos'ta **API configuration** açık ve **104.247.174.120** izinli adresler listesinde mi?
- Kullanıcı adı ve parola doğru mu? **Yanlış parolayla art arda deneme yapmayın**; Sophos hesabı geçici olarak kilitleyebilir.

## Ekrandaki her alan ve düğme

<table id="bkmrk-alan-%2F-d%C3%BC%C4%9Fmene-yapar"><thead><tr><th>Alan / Düğme</th><th>Ne yapar</th><th>Örnek</th></tr></thead><tbody><tr><td>**Firewall API'sini şimdi kur ve otomatik yapılandır**</td><td>Açınca kimlik alanları görünür. Kapalıysa cihaz API kurulmadan eklenir.</td><td></td></tr><tr><td>**Sophos API erişimini nasıl açarım?**</td><td>Sophos tarafında yapılacak hazırlığı hatırlatır; adımlar bu sayfanın başında.</td><td></td></tr><tr><td>**Sophos yönetici kullanıcı adı**</td><td>Sophos'ta API için açtığınız kullanıcı.</td><td>useroam-api</td></tr><tr><td>**Port**</td><td>Sophos yönetim portu.</td><td>4444</td></tr><tr><td>**Sophos yönetici parolası**</td><td>O kullanıcının parolası. Şifreli saklanır.</td><td></td></tr><tr><td>**API'yi test et**</td><td>Cihaza bağlanır, kimliği doğrular, sertifika parmak izini ve zone listesini alır. Kullanıcı adı, parola, port ya da Cihaz Adresi değişirse test sonucu silinir; yeniden test etmeniz gerekir.</td><td></td></tr><tr><td>**Misafir ağı zone'u (firewall kuralları için)**</td><td>Firewall kurallarının kurulacağı misafir zone'u. Liste varsayılanda *Zone seçin* gösterir.</td><td>Misafir (LAN)</td></tr><tr><td>**Kaydet**</td><td>Anahtar açıkken yalnız test başarılı olup zone seçildiğinde etkinleşir.</td><td></td></tr></tbody></table>

### Mesajlar

<table id="bkmrk-mesajneredene-yapmal"><thead><tr><th>Mesaj</th><th>Nerede</th><th>Ne yapmalısınız?</th></tr></thead><tbody><tr><td>Host, yönetici adı ve parola gerekli.</td><td>API'yi test et altında</td><td>Cihaz Adresi, kullanıcı adı ve parolayı doldurun.</td></tr><tr><td>API bağlantısı doğrulandı.</td><td>Pencere ve düğme altı</td><td>Zone seçin.</td></tr><tr><td>Bağlantı doğrulanamadı (kimlik/adres/port/sertifika).</td><td>Pencere ve düğme altı</td><td>Yukarıdaki kontrol listesini uygulayın.</td></tr><tr><td>Önce API'yi test et ile bağlantıyı doğrulayın.</td><td>*Sophos API erişimi* penceresi</td><td>**API'yi test et** düğmesine basın.</td></tr><tr><td>Otomatik kurulum uygulandi: RADIUS sunucusu, Web kimlik dogrulama, ...</td><td>Cihaz Ayarları üstü (yeşil)</td><td>Listelenen adımlar cihazda yapıldı.</td></tr><tr><td>Basarisiz (cihazda dogrulayin): ...</td><td>Cihaz Ayarları üstü (kırmızı)</td><td>Listelenen adımlar yapılamadı. O adımları Sophos kurulum rehberindeki gibi cihazda elle yapın.</td></tr><tr><td>Elle yapilacaklar: ...</td><td>Cihaz Ayarları üstü (sarı)</td><td>Örneğin *Captive portal HTML'ini panelden kopyalayip yapistirin*, *Kimlik dogrulama yontemlerinde Useroam'i uste alin*, *Firewall kurallari (misafir zone belirsiz)*. Bu adımları cihazda siz yapın. Captive portal kodu Cihaz Ayarları → Kurulum sekmesindedir.</td></tr><tr><td>TLS sertifika parmak izi kaydedildi: ...</td><td>Cihaz Ayarları üstü (yeşil)</td><td>Bilgi amaçlı. Cihazın sertifikası değişirse bağlantı reddedilir.</td></tr><tr><td>Firewall API baglantisi dogrulanamadi (kimlik/adres/sertifika). Ayarlar kaydedildi; /device kartindan tekrar deneyin.</td><td>Cihaz Ayarları üstü (kırmızı)</td><td>Cihaz eklendi ama API bağlanamadı. **Bağlantılar** sekmesinde **Bağlantıyı Doğrula** ile yeniden deneyin.</td></tr><tr><td>Firewall API: yonetici kimligi eksik, kurulum atlandi.</td><td>Cihaz Ayarları üstü (kırmızı)</td><td>Cihaz eklendi, API kurulmadı. Bağlantıyı Cihaz Ayarları'ndan kurun.</td></tr></tbody></table>

## Otomatik kurulum ne yapar?

- **RADIUS sunucusu**: Useroam'u cihazınıza kimlik doğrulama sunucusu olarak ekler.
- **Web kimlik doğrulama**: misafirlerin giriş sayfasına yönlendirilmesini ayarlar.
- **5651 log yönlendirme (Syslog)**: yalnız **5651 Loglama** açıksa, cihazın loglarını Useroam'a gönderecek ayarı yapar.
- **Walled garden (izinli adresler)**: misafir giriş yapmadan önce açılması gereken adreslere izin verir.
- **Firewall kuralları**: yalnız zone seçtiyseniz, o zone için DNS, Useroam ve İnternet kurallarını oluşturur.
- **Captive portal HTML**: giriş sayfası kodunu cihaza yükler.

Hangisinin başarılı olduğunu kurulumdan sonra Cihaz Ayarları ekranının üstündeki kutular söyler.

## Sık sorulanlar

**Kaydet düğmesine basamıyorum.**  
Anahtar açıkken Kaydet yalnız **API'yi test et** başarılı olduktan ve zone seçildikten sonra etkinleşir. API kurmak istemiyorsanız anahtarı kapatın.

**Zone listesi çıkmadı.**  
Test başarılı ama cihazdan zone okunamadıysa liste gösterilmez. **Kaydet** etkinleşmezse anahtarı kapatıp cihazı API'siz ekleyin; API'yi sonra Cihaz Ayarları'ndan kurun ve firewall kurallarını cihazda elle oluşturun.

**Parolam güvende mi?**  
Kimlik AES-256 ile şifreli saklanır. Yine de yalnız API için ayrı bir hesap kullanın.

**Cihazı ekledim, API'yi sonradan kurabilir miyim?**  
Evet. [Cihaz Ayarları → Bağlantılar → Firewall API Entegrasyonu](/books/ayarlar/page/cihaz-ayarlari) kartını kullanın.

## İlgili sayfalar

- [Yeni Cihaz Ekleme](/books/ayarlar/page/yeni-cihaz-ekleme)
- [Cihaz Ayarları](/books/ayarlar/page/cihaz-ayarlari)
- [Sophos Entegrasyon Rehberi](/books/kurulum-rehberleri/page/sophos-entegrasyon-rehberi)