Bir makineyi etkinleştirme

Güncellenme: 10 Kasım 2026

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.com web 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

  1. 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.
  2. 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).
  3. 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).
  4. 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 login komutunu 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ından konsolity login.