byxlozax 1.0.1

Byxlozax Python tool license, live-control client, and local control server

byxlozax

Byxlozax, Python araçlarına tek run() çağrısı ile lisans doğrulama, canlı oturum kontrolü, HWID, kaynak kod yedekleme, logout ve yerel kontrol merkezi ekler.

Kurulum

pip install byxlozax

Yerel API Başlatma

İlk Super Admin hesabını kendin oluştur:

python -m byxlozax_server.cli create-super-admin --username admin

Şifre terminalde güvenli şekilde sorulur.

Yerel API ve Byxlozax Control:

python -m byxlozax_server.cli run-api

Adres:

http://127.0.0.1:8000

run-api ilk kurulumda sabit şifre kullanmaz. Eğer hiç Super Admin yoksa geçici yerel şifre üretir ve sadece terminale yazar. Üretim veya VDS kurulumunda BYXLOZAX_ADMIN_PASSWORD, BYXLOZAX_SECRET_KEY ve BYXLOZAX_MASTER_KEY ortam değişkenleri kullanılmalıdır.

Python Kullanımı

import byxlozax

byxlozax.run(
    tool_name="Checker Tool",
    version="1.0.0",
    owner_key="OWNER-KEY-HERE",
)

print("Korumalı tool kodu burada başlar.")

Örnek Test

set BYXLOZAX_OWNER_KEY=OWNER-KEY-HERE
set BYXLOZAX_LICENSE_KEY=LICENSE-KEY-HERE
python examples\test_api_tool.py

Etkileşimli örnek:

python examples\example_tool.py

Güvenlik

• Sabit admin şifresi paket içine gömülmez.
• Server imza secret ve master key makineye özel üretilir veya env ile verilir.
• Telegram bot token AES-256-GCM ile şifreli saklanır.
• Source backup içeriği DB içinde şifreli saklanır.
• Lisans key düz yazı yerine HMAC-SHA256 hash + maskeli görünüm olarak tutulur.
• Client tarafında hatırlanan Telegram ve key bilgileri HWID bağlı şifreli cache içinde saklanır.

Şifreleme kasası 10 aşamalı anahtar türetme akışı, rastgele salt, rastgele nonce, context-bound AAD ve AES-256-GCM authenticated encryption kullanır. Güvenlik anahtarı kodun içinde değil, ortam değişkeninde veya makineye özel secret dosyasında tutulur.

API Endpointleri

• POST /api/v1/auth
• POST /api/v1/ping
• POST /api/v1/logout
• POST /api/v1/source-backup

Başarılı cevap:

{"status": "ok", "allowed": true}

Kapatma cevabı:

{"status": "close", "allowed": false, "reason": "session_killed", "message": ""}

Telegram Worker

Bot token, aktif durum ve bot bilgi metni Byxlozax Control içinden kaydedilir. run-api çalışınca yerel API arka planda Telegram worker başlatır. Aktif bot yapılandırması yoksa worker pasif bekler.

python -m byxlozax_server.cli run-telegram-worker

Bot düğmeleri:

• Bilgi Al
• Modül İstiyorum

Modül İstiyorum kullanıcıyı ayarlanan Telegram hesabına yönlendirir.

Yayın Hazırlığı

python -m pytest -q
python -m build
python -m twine check dist/*
python -m twine upload dist/*

Desteklenen Kapanış Nedenleri

• key_expired
• session_killed
• tool_disabled
• maintenance
• key_disabled
• version_blocked
• owner_inactive
• hwid_blocked
• device_limit
• ip_blocked
• server_error