# Mikrotik Entegrasyon Rehberi

## Video anlatım

Kurulumu önce videodan izleyebilirsiniz. Videonun altında aynı kurulumun yazılı, adım adım ve görselli anlatımı var.

<iframe allowfullscreen="allowfullscreen" height="450" src="https://www.youtube.com/embed/30AHssM7mZ0" style="width: 805px; height: 450px;" width="805"></iframe>

## Ne işe yarar?

Bu rehber, bir MikroTik yönlendiriciyi Useroam'a bağlayıp misafir Wi-Fi girişini (hotspot), Useroam girişini (RADIUS) ve 5651 yasal loglamasını kurmanızı anlatır. Kurulum iki parçadır:

1. **Cihazı panele bağlamak:** cihazın terminaline tek satır yapıştırırsınız. Bu satır cihazınızda yalnız panelin güvenli bağlanması için gereken en küçük ayarı yapar; mevcut ayarlarınıza dokunmaz.
2. **Misafir ağını kurmak:** panel cihazınızı okur, size hangi portu misafir ağı yapmak istediğinizi sorar ve cihazınıza özel bir kurulum kodu üretir. Kodu okuyup onayladıktan sonra yine tek satırla uygularsınız.

> **Cihazınızı internete açmak istemiyor musunuz?** Bu rehberdeki otomatik kurulumda panel cihazınıza internet üzerinden bağlanır. Cihaz dışarıya kapalı kalsın istiyorsanız ya da panel cihaza ulaşamıyorsa [MikroTik'i internete açmadan (offline) kurulum](/books/kurulum-rehberleri/page/mikrotiki-internete-acmadan-offline-kurulum) sayfasındaki yolu kullanın. Offline yolda panel size iki soru sorar (misafir arayüzü ve internet çıkışının adı), kurulum script'ini hazırlar ve terminale yapıştıracağınız tek satırı verir. Yeni cihaz eklerken **Kurulum yöntemi** olarak **Offline**'ı seçmeniz ya da **Cihaz Ayarları** &gt; **Kurulum**'daki **Cihaz dışarıya kapalı mı? Offline kurulum** düğmesine basmanız yeterli.

## Ne zaman kullanılır?

- Yeni bir MikroTik cihazı Useroam'a ilk kez bağlıyorsunuz.
- Eski yöntemle (hotspot dosyalarını elle yükleyerek) kurduğunuz cihazı yeni kuruluma geçirmek istiyorsunuz.
- Cihazı sıfırladınız ya da değiştirdiniz ve bağlantıyı yeniden kurmanız gerekiyor.

## Başlamadan önce

- **Cihazın internete çıktığı adres, panelde kayıtlı Cihaz Adresi ile aynı olmalı.** Kurulum kodu yalnız bu adresten gelen isteği kabul eder. En sık görülen sorun budur. Cihazınız başka bir modemin arkasındaysa panelde, modemin dış (public) adresi yazılı olmalı.
- **Panel cihazınıza dışarıdan ulaşabilmeli.** Cihaz doğrudan internete bakıyorsa ek bir şey gerekmez (port 443). Başka bir modem ya da güvenlik duvarının arkasındaysa o cihazda bir port yönlendirmesi yapın: dış port (ör. *8443*) MikroTik'in *443* portuna gitmeli. Dış portu panelde **Erişim portu** alanına yazacaksınız. Bu mümkün değilse (ör. operatörün ortak IP'si, CGNAT) [offline kurulum](/books/kurulum-rehberleri/page/mikrotiki-internete-acmadan-offline-kurulum)'u kullanın.
- **RouterOS 7.1 veya üzeri** gerekir. RouterOS 6'da REST API yoktur, panel cihazı yönetemez.
- **RouterOS 7.23.3 ve üzerindeyse** önce cihaz modunu açmanız ve cihazın elektriğini çekip takmanız gerekir (3. adım). Sürümünüzü terminalde `/system resource print` ile görebilirsiniz.
- Cihaza **Winbox** ya da **SSH** ile yönetici olarak bağlanabilmelisiniz (terminal açmak için).
- Cihaz panelde ekli olmalı. Değilse 1. adımdan başlayın.

## Adım adım

1. **Cihazı panele ekleyin.** **Cihaz Seçimi** ekranında **Yeni Cihaz**'a basın. **Cihaz Tipi** olarak **MikroTik**'i seçin. Altında çıkan **Kurulum yöntemi**'nde **Otomatik** seçili kalsın (bu rehberin yolu). **SSL Port** alanını cihaz doğrudan internete bakıyorsa *443* bırakın, bir modemin arkasındaysa yönlendirdiğiniz dış portu yazın. **Cihaz Adresi**'ne cihazın internete çıktığı dış IPv4 adresini (ör. *203.0.113.10*), **Cihaz Adı**'na panelde göreceğiniz adı (ör. *Kafe-Merkez*) yazın, **5651 Loglama**'yı açın ve **Kaydet**'e basın. Formun tüm alanları [Yeni Cihaz Ekleme](/books/ayarlar/page/yeni-cihaz-ekleme) sayfasında.
    
    ![Yeni Cihaz formunda MikroTik seçili, SSL Port, Cihaz Adresi, Cihaz Adı ve Kaydet](https://help.useroam.com/uploads/images/gallery/2026-09/mt-yeni-cihaz.png)
2. **Kurulum kodunu üretin.** Sol menüden **Cihaz Ayarları**'nı açın ve **Kurulum** sekmesine geçin. **1. Adım: Cihazı panele bağla** kartında *Henüz kurulum kodu üretilmedi.* yazar. **Erişim portu** alanını kontrol edin (1. adımdaki SSL Port ile aynı gelir) ve **Kurulum kodu üret**'e basın.
    
    ![1. Adım kartında Erişim portu alanı ve Kurulum kodu üret düğmesi](https://help.useroam.com/uploads/images/gallery/2026-09/mt-kart-bos.png)
3. **(Yalnız RouterOS 7.23.3 ve üzeri) Cihaz modunu açın.** Kartın üstündeki sarı kutuda *RouterOS 7.23.3 ve üzeri: önce cihaz modunu açın* yazar. **Kopyala**'ya basın, komutu cihazın terminaline yapıştırıp Enter'a basın. Ardından **cihazın elektriğini çekip yeniden takın**; MikroTik bu değişikliği fiziksel onay olmadan uygulamaz. Sürümünüz daha eskiyse bu adımı atlayın.
    
    ```
    /system device-mode update mode=advanced
    ```
    
    ![Cihaz modu uyarısı ve Kopyala düğmesi](https://help.useroam.com/uploads/images/gallery/2026-09/mt-devmode.png)
4. **Tek satırı kopyalayın.** Kod üretilince kartta *Kod hazır, cihazdan bağlantı bekleniyor.* yazar ve üç kısa talimatın altında tek satırlık komut çıkar. **Kopyala**'ya basın. Komutun altında kodun hangi saate kadar geçerli olduğu yazar (**Kod bu saate kadar geçerli**); kod 30 dakika geçerlidir ve tek kullanımlıktır.
    
    ![Kod hazır durumu, komut kutusu ve Kopyala düğmesi](https://help.useroam.com/uploads/images/gallery/2026-09/mt-kart-kod.png)
5. **Satırı cihazın terminaline yapıştırın.** Winbox ya da SSH ile cihaza bağlanın, **New Terminal** açın, satırı olduğu gibi yapıştırıp Enter'a basın. Ekranda *Useroam: starting...* ile başlayan satırlar akar; en sonda çerçeve içinde *USEROAM: connected. The panel can reach this router. Setup complete.* görmelisiniz.
    
    ![Terminalde bağlantı kurulumunun örnek çıktısı](https://help.useroam.com/uploads/images/gallery/2026-09/mt-terminal.png)
    
    *Görsel örnek bir terminal çıktısıdır; satırlar kurulum dosyasının kendi mesajlarıdır, sürümünüze göre RouterOS'un kendi satırları da görünebilir.*
6. **Paneli yenileyin.** **Cihaz Ayarları** sayfasını yenileyin. Kartta *Bağlandı.* yazmalı ve altında **2. Adım: Misafir ağı kurulumu** kutusu çıkmalı. **Kurulum ekranını aç**'a basın.
    
    ![Bağlandı durumu ve Kurulum ekranını aç düğmesi](https://help.useroam.com/uploads/images/gallery/2026-09/mt-kart-hazir.png)
7. **Misafir ağını seçin.** MikroTik Yönetimi konsolunun **Kurulum** bölümü açılır. **Cihazın Mevcut Durumu** kartı cihazda neyin var neyin yok olduğunu gösterir. **Kurulum Sihirbazı** kartında **Misafir ağı hangi arayüzde olacak** listesinden misafir ağının portunu ya da köprüsünü seçin, **Misafir ağ geçidi adresi**'ni ve **Portal alan adı**'nı kontrol edin.
    
    ![Kurulum Sihirbazı kartında arayüz, ağ geçidi ve portal alan adı](https://help.useroam.com/uploads/images/gallery/2026-09/mk-kur-secim.png)
8. **Güvenlik adımlarını seçip İleri'ye basın.** **Güvenlik ve uyum adımları** altındaki kutular varsayılan olarak işaretlidir; 5651 loglama zorunludur ve kaldırılamaz. İşaretli bırakmanızı öneririz. **İleri**'ye basın.
    
    ![Güvenlik ve uyum adımları kutuları ve İleri düğmesi](https://help.useroam.com/uploads/images/gallery/2026-09/mk-kur-ops.png)
9. **Script'i okuyup onaylayın.** Cihazda çalışacak kurulum script'inin tamamı gösterilir. Okuyun, *Script'i okudum ve bu cihazda çalıştırılmasını onaylıyorum.* kutusunu işaretleyin ve **Onaylıyorum, kodu göster**'e basın.
    
    ![Script onayı: onay kutusu ve Onaylıyorum, kodu göster düğmesi](https://help.useroam.com/uploads/images/gallery/2026-09/mk-kur-onay.png)
10. **Kurulum satırını cihaza yapıştırın.** **Cihazın terminaline yapıştırılacak tek satır** çıkar. **Kopyala**'ya basın ve 5. adımdaki gibi terminale yapıştırıp Enter'a basın. Script önce mevcut ayarlarınızın yedeğini alır (*useroam-oncesi-...rsc*), sonra misafir ağını kurar.
    
    ![Kurulum kodu kartında komut ve Kopyala düğmesi](https://help.useroam.com/uploads/images/gallery/2026-09/mk-kur-kod.png)
    
    ![Terminalde misafir ağı kurulumunun örnek çıktısı](https://help.useroam.com/uploads/images/gallery/2026-09/mt-terminal-kurulum.png)
    
    *Görsel örnek bir terminal çıktısıdır; satırlar kurulum script'inin kendi mesajlarıdır.*
11. **Sonucu kontrol edin.** Konsolda **Useroam Bağlantısı** bölümünü açın. Üstte *Useroam bağlantısı kurulu görünüyor* yazmalı. Sonra misafir ağına bir telefonla bağlanıp herhangi bir web sayfası açın: Useroam karşılama sayfası açılmalı. Giriş yapan misafiri **Misafir Wi-Fi** bölümündeki **Şu An Bağlı Misafirler** listesinde görürsünüz.
    
    ![Useroam bağlantısı kurulu görünüyor durumu ve RADIUS sunucusu](https://help.useroam.com/uploads/images/gallery/2026-09/mk-rad-kurulu.png)

## Kurulum kartındaki durumlar

<table id="bkmrk-kartta-yazanne-anlam"><thead><tr><th>Kartta yazan</th><th>Ne anlama gelir</th><th>Ne yapmalısınız</th></tr></thead><tbody><tr><td>*Henüz kurulum kodu üretilmedi.*</td><td>Bu cihaz için hiç kod üretilmemiş.</td><td>**Kurulum kodu üret**'e basın.</td></tr><tr><td>*Kod hazır, cihazdan bağlantı bekleniyor.*</td><td>Kod üretildi, cihaz henüz kodu çekmedi.</td><td>Satırı cihaz terminaline yapıştırın. Süre dolduysa **Yeni kod üret**'e basın.</td></tr><tr><td>*Cihaz kurulum dosyasını aldı, bildirim bekleniyor.*</td><td>Cihaz dosyayı indirdi ama "hazırım" bildirimi gelmedi.</td><td>Terminal çıktısının sonuna bakın (aşağıdaki hata tablosu). Kısa süre bekleyip sayfayı yenileyin.</td></tr><tr><td>*Bağlandı.*</td><td>Panel cihaza ulaşabiliyor.</td><td>2. Adım kutusundaki **Kurulum ekranını aç**'a basın.</td></tr><tr><td>*Cihaz farklı bir adresten bağlandı. Panelde kayıtlı cihaz adresini düzeltip yeni kod üretin.* ve altında **Son hata**: *ip\_mismatch:...*</td><td>Cihaz internete panelde yazan adresten farklı bir adresle çıkıyor. Son hatadaki adres cihazın gerçek çıkış adresidir.</td><td>**Cihaz Ayarları**'nda Cihaz Adresi'ni o adresle değiştirin, kaydedin, **Yeni kod üret**'e basın.</td></tr></tbody></table>

![Cihaz kurulum dosyasını aldı, bildirim bekleniyor durumu](https://help.useroam.com/uploads/images/gallery/2026-09/mt-kart-indirildi.png)

![Cihaz farklı bir adresten bağlandı uyarısı ve son hata](https://help.useroam.com/uploads/images/gallery/2026-09/mt-kart-ip.png)

## Kartın düğmeleri ve alanları

<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>**Erişim portu**</td><td>Panelin cihaza ulaşacağı port. Doğrudan internete bakan cihazda 443; modem arkasındaysa yönlendirdiğiniz dış port (yönlendirme hedefi MikroTik'in 443 portu olmalı).</td><td>443 ya da 8443</td></tr><tr><td>**Kurulum kodu üret** / **Yeni kod üret**</td><td>30 dakika geçerli, tek kullanımlık yeni bir kod üretir. Yeni kod eskisini geçersiz yapar; aynı anda tek kod geçerlidir.</td><td></td></tr><tr><td>**Kopyala**</td><td>Komut satırını panoya kopyalar.</td><td></td></tr><tr><td>**Kodu iptal et**</td><td>Kullanılmamış kodu geçersiz yapar. Kodu yanlış kişiyle paylaştıysanız kullanın.</td><td></td></tr><tr><td>**Kurulum Dökümanı**</td><td>Bu sayfayı açar.</td><td></td></tr><tr><td>**MikroTik Yönetimi**</td><td>Cihaz bağlandıktan sonra MikroTik konsolunu açar.</td><td></td></tr><tr><td>**Eski kurulum yöntemi (arşiv)**</td><td>Hotspot dosyalarını elle yükleyerek kurulmuş eski cihazlar için eski yol. Yeni kurulumda kullanmayın.</td><td></td></tr></tbody></table>

## Tek satır cihazda ne yapar?

1\. adımdaki satır (bağlantı kurulumu) cihazda yalnız şunları yapar; misafir ağı, köprü, DHCP ve mevcut güvenlik duvarı kurallarınıza dokunmaz:

1. Sürüm kontrolü: RouterOS 6 ise durur.
2. HTTPS yönetimi için bir sertifika oluşturur (yoksa).
3. Yalnız Useroam panelinin adresinden (*104.247.174.120*) giriş yapabilen *useroam-api* adlı bir kullanıcı ekler.
4. Cihazın web servisini (www-ssl, REST API) açar. Kendi sertifikanız varsa değiştirmez.
5. Güvenlik duvarına yalnız panel adresi için tek bir izin kuralı ekler (*useroam-api-allow*).
6. Daha önce Useroam RADIUS kaydı varsa onun Message-Authenticator zorunluluğunu kapatır.
7. Panele "hazırım" bildirimi gönderir; panel de hemen cihaza bağlanmayı dener.

Bu bağlantıyı geri almak isterseniz terminalde şu üç satırı çalıştırın:

```
/user remove [find name="useroam-api"]
/user group remove [find name="useroam-api"]
/ip firewall filter remove [find comment="useroam-api-allow"]
```

## Terminalde görebileceğiniz hata mesajları

Cihazın terminaline yazılan mesajlar İngilizcedir (RouterOS terminali Türkçe karakterleri güvenilir göstermez). Anlamları:

<table id="bkmrk-terminalde-yazananla"><thead><tr><th>Terminalde yazan</th><th>Anlamı</th><th>Ne yapmalısınız</th></tr></thead><tbody><tr><td>*Setup code is invalid or malformed.*</td><td>Kod eksik ya da bozuk kopyalandı.</td><td>Satırı **Kopyala** ile yeniden kopyalayın.</td></tr><tr><td>*Setup code is invalid or has already been used.*</td><td>Kod tanınmadı ya da kullanıldı.</td><td>**Yeni kod üret**'e basın.</td></tr><tr><td>*Setup code was cancelled in the panel. Generate a new one.*</td><td>Kod panelde iptal edildi ya da yerine yeni kod üretildi.</td><td>Panelde en son üretilen kodu kullanın.</td></tr><tr><td>*Setup code has expired. Generate a new one in the Useroam panel.*</td><td>Kodun süresi doldu (bağlantı kodu 30, kurulum kodu 60 dakika).</td><td>Yeni kod üretin.</td></tr><tr><td>*This device reached us from ... but the panel has ... Fix the device IP in the panel, then retry.*</td><td>Cihazın internete çıktığı adres paneldeki Cihaz Adresi ile aynı değil.</td><td>Paneldeki Cihaz Adresi'ni ilk adresle düzeltin, yeni kod üretin.</td></tr><tr><td>*This device is already connected to Useroam.*</td><td>Cihaz zaten bağlı.</td><td>Bir şey yapmanız gerekmez; **Kurulum ekranını aç**'a geçin.</td></tr><tr><td>*Setup code was already used. Generate a new one in the panel.*</td><td>Aynı kod ikinci kez çalıştırıldı.</td><td>Yeni kod üretin.</td></tr><tr><td>*USEROAM ERROR: RouterOS 6 detected ...*</td><td>Cihaz RouterOS 6 kullanıyor.</td><td>Cihazı RouterOS 7.1 veya üzerine yükseltin.</td></tr><tr><td>*USEROAM ERROR: certificate signing timed out.*</td><td>Cihaz sertifikayı 90 saniyede oluşturamadı.</td><td>Satırı yeniden çalıştırın (yeni kod gerekebilir).</td></tr><tr><td>*USEROAM: device registered, but the panel could NOT connect back.* ve *TCP 443 from 104.247.174.120 must reach THIS router.*</td><td>Cihaz kaydoldu ama panel cihaza ulaşamıyor. Genelde cihaz bir modemin arkasındadır.</td><td>Modemde dış portu MikroTik'in 443 portuna yönlendirin, **Erişim portu**'na dış portu yazıp yeni kod üretin.</td></tr><tr><td>*USEROAM WARNING: could not reach the Useroam panel.*</td><td>Cihaz panele ulaşamadı (internet ya da DNS yok).</td><td>Cihazın internet ve DNS ayarını kontrol edip satırı yeniden çalıştırın.</td></tr><tr><td>*Useroam panel could not read the generated credentials. Generate a new code.* / *Useroam panel database is unavailable, try again later.*</td><td>Panel tarafında geçici bir sorun.</td><td>Birkaç dakika sonra yeni kod üretin; sürerse destek ekibine yazın.</td></tr></tbody></table>

## Sık sorulanlar

**Kodu yapıştırdım ama kartta hala "Kod hazır" yazıyor.**  
Terminal çıktısına bakın. Çoğunlukla cihazın panele ulaşamadığını ya da adresin eşleşmediğini söyleyen bir mesaj vardır (yukarıdaki tablo). Mesaj yoksa sayfayı yenileyin.

**Cihazım bir modemin arkasında, ne yapmalıyım?**  
Modemde bir dış portu (ör. 8443) MikroTik'in 443 portuna yönlendirin. Panelde **Erişim portu**'na 8443 yazıp **Yeni kod üret**'e basın. Panelde kayıtlı Cihaz Adresi modemin dış adresi olmalı.

**Tek satır mevcut ayarlarımı bozar mı?**  
Hayır. Bağlantı satırı yalnız sertifika, *useroam-api* kullanıcısı, web servisi ve tek bir izin kuralı ekler. Misafir ağını kuran ikinci satır ise ayarları değiştirir; bu yüzden panel size önce script'in tamamını gösterir ve ilk iş olarak yedek alır. Ayrıntılar [Kurulum Sihirbazı](/books/mikrotik-yonetimi/page/kurulum-sihirbazi) sayfasında.

**RouterOS 7.23.3 kullanıyorum, hotspot kurulmuyor.**  
Cihaz modunu açmadınız ya da komuttan sonra cihazın elektriğini çekip takmadınız. 3. adımı yapın.

**Kodu başkasıyla paylaştım, sorun olur mu?**  
Kod yalnız panelde kayıtlı cihaz adresinden gelen istekte çalışır ve tek kullanımlıktır. Yine de emin değilseniz **Kodu iptal et**'e basın.

## İlgili sayfalar

- [Yeni Cihaz Ekleme](/books/ayarlar/page/yeni-cihaz-ekleme)
- [Cihaz Ayarları](/books/ayarlar/page/cihaz-ayarlari)
- [MikroTik Kurulum Sihirbazı](/books/mikrotik-yonetimi/page/kurulum-sihirbazi)
- [MikroTik Yönetimi](/books/mikrotik-yonetimi/page/mikrotik-yonetimi)
- [Misafir Wi-Fi ve Useroam Bağlantısı](/books/mikrotik-yonetimi/page/misafir-wi-fi-ve-useroam-baglantisi)