Adımlar

1. Admin panele giriş yapın — Yönetici hesabı ile giriş yapın.
2. Müşteri (tenant) oluşturun — Admin → Müşteriler → Yeni müşteri.
3. MikroTik cihazı ekleyin — Cihazlar → Yeni cihaz; IP, API kullanıcı/şifre ve Device Token ile kaydedin.
4. Heartbeat kurun — Cihaz detayında verilen script'i MikroTik'e yapıştırıp zamanlayıcı ekleyin.
5. Portal ayarlarını yapın — Müşteri → Portal ayarları ile logo, başlık ve renkleri belirleyin.

Adımlar

1. Admin → Cihazlar — Cihazlar sayfasına gidin, "Yeni cihaz" veya ekle butonuna tıklayın.
2. Cihaz bilgilerini girin — Cihaz adı, IP/host, API kullanıcı adı ve şifresi. MikroTik'te API'nin açık olduğundan emin olun.
3. Kaydedin — Kaydettikten sonra cihaza bir Device Token atanır. Bu token'ı heartbeat script'inde kullanacaksınız.

Adımlar

1. Winbox ile giriş — MikroTik'e Winbox veya SSH ile bağlanın.
2. IP → Services — API satırında "Apply" ile API'yi etkinleştirin. Port genelde 8728 (TCP).
3. Kullanıcı oluşturun (önerilen) — System → Users → yeni kullanıcı; gruplar: full veya read,write. API için bu kullanıcıyı panelde girin.
4. Allow From (isteğe bağlı) — Güvenlik için sadece panel sunucusu IP'sine izin verin.

Adımlar

1. Cihaz detayına gidin — Admin → Cihazlar → ilgili cihaz.
2. Script'i kopyalayın — "MikroTik Scriptleri" bölümünde 1. Heartbeat script'i kopyalayın (baseUrl ve token dolu gelir).
3. MikroTik'te System → Scripts — Yeni script ekleyin, adı: atlas-heartbeat (sabit kalmalı). İçeriği yapıştırın.
4. Zamanlayıcı ekleyin — 2. Zamanlayıcı komutunu Terminal'de çalıştırın; her 5 dakikada script çalışır.

Adımlar

1. Hotspot sunucuyu yapılandırın — IP → Hotspot → Server; HTTP port ve hotspot arayüzü doğru olsun.
2. Login by HTTP (veya HTML override) — Portal adresi olarak Safir Cloud Hotspot portal URL'inizi girin (tenant ve cihaz bilgisi ile).
3. RADIUS (isteğe bağlı) — FreeRADIUS kullanıyorsanız RADIUS client ve accounting ayarlarını yapın.

Kontrol listesi

• ✓MikroTik API erişilebiliyor — Panelden "Test bağlantı" başarılı
• ✓Heartbeat script çalışıyor — Cihaz "çevrimiçi", Son IP dolu
• ✓Portal açılıyor — Hotspot'a bağlanan cihazda login sayfası geliyor
• ✓Giriş sonrası internet açılıyor — Kullanıcı eklenip MikroTik'e senkron oluyor

Adımlar

1. Müşteri → SMS Ayarları — İlgili müşteri için SMS Ayarları sekmesine gidin.
2. Sağlayıcı seçin — Posta Güvercini veya NetGSM. Gerekli API bilgilerini girin.
3. Test SMS gönderin — Test butonu ile ayarların çalıştığını doğrulayın.
4. Portal'da SMS girişi — Portal ayarlarında "SMS ile giriş" etkinse misafirler telefon numarası ile giriş yapabilir.

Adımlar

1. Müşteri → Portal Ayarları / Hotspot Ayarları — Portal başlığı, hoş geldin metni, birincil renk alanlarını doldurun.
2. Logo yükleme — Logo dosyasını seçip yükleyin; URL otomatik kaydedilir ve portalda gösterilir.
3. Arka plan — Renk veya görsel arka plan seçeneği varsa buradan ayarlayın.

Adımlar

1. Admin → Planlar (veya müşteri bazlı) — Yeni plan ekleyin.
2. Ad, hız ve kota — Plan adı, download/upload hız limitleri (MikroTik queue ile uyumlu), isteğe bağlı veri kotası.
3. Kaydedin — Plan portalda ve kullanıcı atamalarında seçilebilir olur.

Adımlar

1. Hotspot Kullanıcıları / Voucher bölümü — İlgili müşteri veya cihaz için voucher oluşturma ekranına gidin.
2. Adet ve süre — Kaç adet voucher, süre ve hangi plan ile oluşturulacak seçin.
3. Oluştur ve dağıt — Oluşan kodları yazdırıp veya paylaşıp misafirlere verin.

Adımlar

1. MikroTik dışarı çıkış — Heartbeat ve portal için MikroTik'in panele (HTTPS) çıkışına izin verin.
2. Panel gelen bağlantı — Nginx/SSL ile 443 açık; gerekirse UFW'de 80/443 izinli.
3. NAT (Quick Setup) — RSC/Quick Setup ile NAT kuralı eklenmişse masquerade doğru arayüzde olmalı.

Adımlar

1. Cihazlar listesi — Admin → Cihazlar; "Son görülme" veya durum sütununa bakın.
2. Son IP — Heartbeat çalışıyorsa Son IP güncel olur; 0.0.0.0 ise heartbeat gelmiyor olabilir.
3. Test bağlantı — Cihaz satırında "Test" veya "Bağlantı testi" ile API erişimini deneyin.

Adımlar

1. MikroTik Terminal'de bağlantı testi — /tool fetch url="https://PANEL-ADRESINIZ/api/health" mode=https allow-insecure=yes
2. Panel logları — Sunucuda uygulama loglarında heartbeat veya API hatalarını arayın.
3. Cihaz token — Token değiştiyse yeni token ile heartbeat script'ini güncelleyin.

Kontrol listesi

• ✓Portal sayfası açılıyor ve doğru tenant/cihaz bilgisi geliyor
• ✓Kullanıcı adı/şifre veya SMS ile giriş çalışıyor
• ✓Giriş sonrası internet erişimi var
• ✓Cihaz panelde çevrimiçi ve Son IP dolu
• ✓Planlar ve voucher (kullanıyorsanız) test edildi