Bir makineyi etkinleştirme
Etkinleştirme, makineyi hesabınıza bağlar; tıpkı Claude Code veya bir akıllı televizyon gibi: makine bir kod gösterir, siz de zaten oturum açmış olduğunuz bir cihazdan onaylarsınız. Makinede hiçbir parola yazılmaz ve makine kasanızın anahtarını asla almaz.
Başlamadan önce
- Hesapta Studio planı (veya denemesi) etkindir.
- Güvenlik bölümünde iki faktörlü kimlik doğrulama (TOTP) veya bir geçiş anahtarı açıktır: bir makineyi onaylamak her zaman ikinci bir faktör gerektirir. İkisi de yoksa onay reddedilir ve birini açmanızı isteyen bir mesaj gösterilir.
- Kasanın açık olduğu bir cihaz: Konsolity uygulaması (Mac, Windows, Linux, iPhone, iPad, Android) veya
app.konsolity.comweb konsolu.
Etkinleştirmeyi başlatma
Makinede, CLI'yi kullanacak hesapla (bir hizmet için hizmetle aynı hesapla):
konsolity login --name build-01
| Seçenek | İşlevi |
|---|---|
--name <name> |
Makine listesinde gösterilen ad (varsayılan: ana bilgisayar adı). |
--scopes <list> |
İstenen kapsam; hosts, snippets, sessions, mcp arasından, virgülle ayrılmış. |
--read-only |
Salt okunur erişim ister (listeler ve durum, komut yok). |
İstenen kapsam yalnızca bir öneridir: kapsamı onay sırasında siz belirlersiniz. Komut şunu gösterir:
Activating this machine on https://api.konsolity.com
1. Open this address on a device signed in to your account:
https://app.konsolity.com/cli/activate?code=WDJB-MJHT
or in the Konsolity app: Settings › CLI machines › Activate a machine
2. Enter this code: WDJB-MJHT
3. Check that the fingerprint shown is: 7K3Q-9XAD
Waiting for approval...
Terminal izin verdiğinde tam bağlantının bir QR kodu da gösterilir; telefondan onaylamak için kullanışlıdır. Kod 15 dakika geçerli kalır; makine bekler ve başka hiçbir şey yapmaz.
Parmak izini karşılaştırma
Parmak izi (örnekte 7K3Q-9XAD), makinenin az önce oluşturduğu açık anahtardan hesaplanır. Onay ekranı, sunucuya güvenmeden bu anahtardan parmak izini kendisi yeniden hesaplar ve makinenin adı, sistemi, mimarisi, ana bilgisayar adı ve IP adresiyle birlikte gösterir.
Yalnızca konsolity login komutunu bu makinede az önce kendiniz çalıştırdıysanız ve parmak izi aynıysa onaylayın. Tanımadığınız bir istek tek tıklamayla reddedilir.
Uygulamada onaylama
Konsolity'de: Ayarlar › CLI makineleri › Makine etkinleştir, ardından kodu girin. Kasa açık olmalıdır.
Tarayıcıda onaylama
https://app.konsolity.com/cli/activate adresini (veya makinenin gösterdiği tam bağlantıyı) açın, oturum açın, ardından kodu girin. Sayfa, kasayı tarayıcıda açmak için ana parolanızı ister: parola sayfadan asla çıkmaz ve sunucuya asla gönderilmez.
Kapsamı ve geçerlilik süresini seçme
Onaylamadan önce şunları seçersiniz:
- kapsam:
hosts,snippets,sessions,mcp, salt okunur veya tam; - makinenin kullanabileceği sunucular ve parçacıklar (varsayılan: hiçbir sunucu);
- komut kuralları (tam erişim için);
- makinenin geçerlilik süresi.
Varsayılan: hosts ve snippets, salt okunur, hiçbir sunucu. Ayrıntılar Kapsam ve kurallar sayfasındadır.
| Geçerlilik süresi | Tipik kullanım |
|---|---|
| 1 gün | Tek seferlik müdahale |
| 7 gün | Kısa görev, test sunucusu |
| 30 gün | Süren proje |
| 90 gün (varsayılan) | Yönetim sunucusu |
| 1 yıl | Uzun ömürlü makine, her yıl yenilenir |
| Hiçbir zaman | Yakından izlediğiniz makinelere ayırın |
İkinci faktörle doğrulama
Onayla düğmesi TOTP kodunuzu veya geçiş anahtarınızı (Face ID, Touch ID, Windows Hello, güvenlik anahtarı) ister. Sunucu ikinci faktörü onayla aynı istekte doğrular: çalınmış bir kod veya açık bırakılmış bir oturum yeterli değildir.
Onay sırasında neler olur
- Cihazınız rastgele bir makine anahtarı üretir ve bunu makinenin açık anahtarı için mühürler (X25519 anahtar değişimi). Sunucu yalnızca açamadığı opak bir veri bloğu taşır.
- Bu makine anahtarıyla şifreleyerek, kapsamın izin verdiği sunucuları, kimlikleri, SSH anahtarlarını, sabitlenmiş sunucu anahtarlarını ve parçacıkları yalnızca bunları, kurallarla birlikte kopyalar. Kasanın geri kalanı cihazlarınızdan çıkmaz (bkz. Kapsam ve kurallar).
- Makine belirtecini (bir kez) alır, makine anahtarını açar, kurallarının şifresini çözebildiğini doğrular, ardından belirteci ve anahtarı korumalı depolama alanına kaydeder (bkz. Hizmet ve depolama).
- Bir e-posta, bir uygulama bildirimi ve bağladıysanız “Yeni CLI makinesi” başlıklı bir Telegram mesajı alırsınız.
Komut ardından makinenin adını ve hesabın e-posta adresini gösterir. Durumu istediğiniz zaman kontrol edin:
konsolity status
Parmak izi başına bir makine
Her makinenin, sistem tanımlayıcısından (Linux'ta /etc/machine-id, macOS'ta IOPlatformUUID, Windows'ta MachineGuid) hesaplanan bir makine parmak izi vardır. Aynı makinede yapılan yeni bir etkinleştirme öncekinin yerini alır: eski kayıt otomatik olarak iptal edilir. Böylece aynı bilgisayar için hiçbir zaman iki etkin belirteç bulunmaz.
Bu parmak izi her çağrıda gönderilir. Başka bir bilgisayara kopyalanan belirteç reddedilir ve olay bir uyarı oluşturur.
setup-token: CI ve konteynerler
Bir CI çalıştırıcısı veya bir konteyner çoğu zaman her seferinde yeniden oluşturulur: makine tanımlayıcısı değişir ve hiçbir şey kalıcı olarak saklanamaz. Bu durumlar için uzun ömürlü bir belirteç oluşturun:
konsolity setup-token --name ci-deploy
Akış aynıdır (kod, parmak izi, ikinci faktörle onay, kapsam). Sonunda komut, ksetup_ ile başlayan bir belirteci yalnızca bir kez gösterir ve diske hiçbir şey yazmaz:
Long-lived token (shown once):
ksetup_3q2Xk...
Store it in your CI secret manager, then provide it through KONSOLITY_TOKEN.
Belirteci CI gizli bilgi yöneticinizde saklayın, ardından komuta KONSOLITY_TOKEN ortam değişkeniyle sağlayın:
KONSOLITY_TOKEN="$KONSOLITY_TOKEN" konsolity run web-01 -- systemctl status nginx
Uzun ömürlü bir belirteç:
- makine parmak izine bağlı değildir (geçici makinelerde kullanılır): onu bir parola gibi koruyun;
- oluşturulmasından en geç 1 yıl sonra sona ermelidir;
- otomatik olarak yenilenmez;
- listede Uzun ömürlü belirteç olarak, bir makineyle aynı kapsam, aynı günlük ve aynı iptal etme olanağıyla görünür.
Takılırsa
- Kodun süresi doldu:
konsolity loginkomutunu yeniden çalıştırın, yeni bir kod oluşturulur. - İkinci faktör gerekli: Güvenlik bölümünde iki faktörlü kimlik doğrulamayı veya bir geçiş anahtarını açın, ardından yeniden başlayın.
- Abonelik gerekli: onay için Studio planı (veya denemesi) gerekir.
- Reddedildi: makine hiçbir şey kaydetmeden durur.
- Makine zaten etkin:
konsolity logout, ardındankonsolity login.