Netlen Cloud WISECP Modülü

Genel Bakış

Netlen Cloud modülü, WISECP üzerinden NetlenVM sanal sunucularını otomatik açar/yönetir. Modül, Netlen panelinin API v2'sini (https://{host}/v2, Bearer kimlik doğrulama) kullanır.

Bayi (wholesale) modeli: WISECP son müşteriyi faturalar; Netlen paneli ise bayinin Netlen bakiyesini düşer. Böylece çift faturalama olmaz.

WISECP v3.1.9+ PHP 8.1+ API v2

Özellikler

Yaşam döngüsü

Sunucu oluşturma (paket & özel/custom spec) — Idempotency-Key = WISECP sipariş no
Askıya alma / geri alma (stop / start)
Sonlandırma (terminate)
Paket yükseltme (prorated upgrade)
Mevcut sunucuları içe aktarma (import / list_vps)

Müşteri paneli yönetimi

Güç: Başlat / Durdur / Yeniden Başlat
Konsol (VNC) — güvenli, tek kullanımlık görüntüleyici bağlantısı
İşletim sistemi yeniden kurulumu (OS seçimli)
Root parola değiştirme
Snapshot & Backup (liste / oluştur / geri yükle / sil)
Güvenlik duvarı kuralları (liste / ekle / sil)
IP adresleri (satın al / bırak / rDNS)
Canlı metrikler (CPU / RAM / Disk)

Gereksinimler

WISECP v3.1.9 veya üzeri
PHP 8.1 – 8.4
ionCube Loader v14+ (sunucunun PHP sürümüne uygun)
PHP eklentileri: cURL + OpenSSL (JSON 8.x'te dahilidir)
api.netlen.com.tr:443 adresine giden HTTPS erişimi
Netlen panelinden alınmış bir API v2 anahtarı (Bearer token)
WISECP sunucunuzun genel IP adresinin API anahtarı için izinli listede olması

Kurulum

Modülü WISECP kurulumunuza kopyalayın:
```
coremio/modules/Servers/NetlenCloud/
```
WISECP admin → Sunucular → yeni sunucu ekleyin:
- Modül: NetlenCloud
- Hostname: api.netlen.com.tr (yalnız host — https:// veya /v2 yazmayın)
- Secure: açık (https)
- Access Hash: Netlen API v2 token'ınız
- IP Adresi / Kullanıcı Adı: WISECP bu alanları zorunlu ister ama modül kullanmaz. Herhangi bir değer girin (ör. IP = api.netlen.com.tr, Kullanıcı Adı = netlen).
Test Connection'a basın (GET /v2/billing/balance çağrılır).
Netlen panelinde bu WISECP sunucusunun IP adresini API anahtarı için izinli listeye ekleyin.
NetlenCloud modülünü kullanan bir ürün oluşturun ve aşağıdaki alanları doldurun.

Ürün Yapılandırması

Ürün → Module Settings altında:

Alan	Açıklama
Plan ID	Netlen paket/plan id (`GET /v2/plans`). Özel (custom) ürün için boş bırakın.
Location ID	Netlen lokasyon id (`GET /v2/locations`).
OS Version ID	Varsayılan işletim sistemi sürüm id (`GET /v2/operating-systems`).
IPv6 Count	Kurulumda verilecek IPv6 adedi (varsayılan 1).

Hostname; sipariş seçeneklerinden (hostname/domain) alınır, yoksa otomatik üretilir. Root parolası sipariş verisinden alınır ya da güçlü bir parola otomatik oluşturulur.

Ek IPv4 (Configurable Option)

Tam adı Extra IPv4 olan (adet tipi) bir Configurable Option ekleyin. Provizyon sırasında modül seçilen adedi okur ve o kadar IPv4 adresini POST /v2/servers/{id}/ips ile satın alır (her biri bayi bakiyesine faturalanır).

WISECP, seçeneği son müşteriye faturalar; sağlayıcı tarafını (IP ekleme) modül yürütür. Paket modunda da doğru ücretlendirme için ek IP, oluşturmadan sonra ayrı uçla alınır.

Müşteri, sipariş sonrası IP Adresleri sayfasından da tek tek IP alabilir/bırakabilir.

İşletim Sistemi (Configurable Option)

Ürün ayarındaki OS Version ID varsayılan işletim sistemidir. Müşterinin sipariş sırasında OS seçebilmesi için — Ek IPv4 ile aynı şekilde — tam adı Operating System olan bir Configurable Option (açılır menü) ekleyin.

Her seçeneğin değeri = Netlen os_version_id olmalı. Bu id'leri, ürün Module Settings'teki OS Version ID açılır menüsünde (#id) olarak görebilirsiniz.
Modül siparişte bu seçimi (Operating System) okur; boşsa ürün varsayılan OS'una düşer.
Yeniden Kur sayfasındaki OS listesi zaten API'den canlı gelir; ayrıca bir şey gerekmez.

Admin ürün ayarındaki Plan / Lokasyon / OS Version ID alanları API'den gelen açılır menülerdir (API'ye ulaşılamazsa metin kutusuna düşer).

Yedek / Snapshot (Ücretli Eklenti Olarak Satma)

Yedek ve snapshot Netlen tarafında ücretlidir (bayinin bakiyesinden aylık koruma ücreti düşer). Bunu son müşteriye ücretli sunmak için WISECP Ürün Eklentisi (Product Addon) kullanılır.

Ürüne aylık, kendi fiyatınızla bir Configurable Option ekleyin; adı tam Backup olsun (Ek IPv4 ile aynı mantık).
Ürün Module Settings → Yedek / Snapshot faturalama alanını addon yapın.
Bu modda müşteri, Backup eklentisini satın almadan Snapshot/Backup sayfalarını kullanamaz (butonlar gizlenir, işlem reddedilir). Eklentiyi alınca açılır.

WISECP eklentiyi son müşteriye faturalar; Netlen bayiyi ücretlendirir → marj sizde kalır.
Modül eklenti hook'ları: addon_create/addon_unsuspend açar, addon_suspend/addon_cancelled kapatır.
free modunda (varsayılan) Snapshot/Backup her zaman açıktır (ücreti bayi karşılar).

Müşteri Paneli

Hizmet detay sayfasında müşteri şunları görür:

Ana sayfa: durum + CPU/RAM/Disk grafikleri + spec + IP listesi
Başlat / Durdur / Yeniden Başlat (duruma göre)
Konsol (VNC)
Yeniden Kur — OS seçimi + opsiyonel yeni parola
Parola Değiştir
Anlık Görüntüler / Yedekler — oluştur, geri yükle, sil
Güvenlik Duvarı — kural ekle/sil
IP Adresleri — al, bırak, rDNS

Admin Paneli

Hizmet yönetim sekmesinde (order-detail.php) admin şunları görür:

Güç butonları (Başlat / Durdur / Yeniden Başlat)
Sunucu kimliği (entity id)
Admin'e özel yeni parola alanı (reset password)
Durum ve IP özeti

API Uçları

İşlev	Uç
Oluştur	POST /v2/servers
Askı / Geri al	POST /v2/servers/{id}/actions/stop · start
Sonlandır	DELETE /v2/servers/{id}
Paket yükselt	POST /v2/servers/{id}/actions/upgrade
Yeniden kur	POST /v2/servers/{id}/actions/reinstall
Parola sıfırla	POST /v2/servers/{id}/actions/reset_password
Konsol (VNC)	GET /v2/servers/{id}/console
Snapshot	GET/POST /v2/servers/{id}/snapshots · restore · delete
Backup	GET/POST /v2/servers/{id}/backups · restore · delete
Firewall	GET · POST/PATCH/DELETE /v2/servers/{id}/firewall/rules
IP	GET · POST · DELETE · PUT /v2/servers/{id}/ips
Metrik	GET /v2/servers/{id}/metrics
Katalog	GET /v2/plans · /locations · /operating-systems
Test Connection	GET /v2/billing/balance

Güvenlik

Bearer kimlik doğrulama: token yalnız Authorization başlığında; URL/logda görünmez.
IP izinli liste: API anahtarı, WISECP sunucusunun IP'sine kısıtlanır.
Parola politikası: min 8 karakter, büyük+küçük harf, rakam ve sembol.
Idempotency: oluşturma, sipariş no anahtarıyla; tekrar denemede çift provizyon olmaz.
Hatalar müşteriye güvenli mesaja çevrilir; tam detay WISECP modül loguna (save_log) yazılır.

Sorun Giderme

Belirti	Çözüm
Test Connection başarısız	Hostname'i yalnız host olarak (`api.netlen.com.tr`) girin; Access Hash'i ve IP izinli listeyi kontrol edin.
"API authentication failed"	Access Hash (Bearer token) yanlış veya süresi dolmuş.
"IP not allowlisted"	WISECP sunucusunun IP'sini Netlen panelinde API anahtarına ekleyin.
Oluşturma "balance insufficient"	Bayi Netlen bakiyesi yetersiz.
Ek IP gelmedi	Modül logunu kontrol edin; bakiye/limit yetersizse IP alımı durur (sunucu yine açılır).

Destek

API dokümantasyonu: https://api.netlen.com.tr/v2/docs

Bayi paneli: https://panel.netlen.com → Bayi → API