Civo API anahtarımı nereden bulurum?

Civo panelinde, hesabınızın Security bölümünde; doğrudan dashboard.civo.com/security adresinden açılır. Anahtarlar orada listelenir ve her birinin yanında bir Regenerate düğmesi vardır. Anahtar ne komut satırında ne de üçüncü taraf bir uygulamada oluşturulur; onlar yalnızca panelde ürettiğiniz anahtarı kullanır.

Civo API anahtarımı yenilersem veya iptal edersem ne olur?

Civo panelindeki yenileme anında geçerli olur, yani eski değeri tutan her istemci bir sonraki istekte hata almaya başlar. Düzeltmesi tek yerde: yeni anahtarı uygulamanın ayarlarına yapıştırırsınız, Keychain kaydının yerine geçer; komut satırı için civo apikey add ve ardından civo apikey current . Başka bir şeye dokunmanız gerekmez, çünkü bölge, firewall seçimi ve IP ön ayarları ayrı saklanır.

Birden fazla Civo hesabı kullanabilir miyim?

CivoCloudManager'da aynı anda kullanamazsınız. Uygulama Keychain'de tek bir API anahtarı tutar, hesap değiştirmek o anahtarı değiştirmek demektir. Burada Civo CLI daha iyi: birden çok adlandırılmış anahtar saklar ve civo apikey current ile aralarında geçiş yapar. Gün boyu hesap değiştiriyorsanız bu iş için komut satırını elinizde tutun, uygulamayı da asıl izlediğiniz hesap için kullanın.

Civo CLI hâlâ gerekli mi?

CI/CD, betik yazımı ve insansız çalışması gereken her şey için evet, doğru araç odur. Mac'te günlük iş için gerekmez. Uygulama aynı Civo REST API v2 ile konuşur, kubectl olmadan istemci sertifikalı mTLS üzerinden Kubernetes API'sine ulaşır ve komut satırında bulunmayan pod logları, S3 nesne gezintisi ve maliyet rakamlarını kapsar. Çoğu kişi sonunda ikisini birden kullanıyor.

Civo API anahtarınızı Mac'te bir kez bağlayın.

Anahtarı Civo panelinde üretin, bir kez yapıştırın, gerisini macOS Keychain tutsun.

Mac'te her Civo hesabı aynı yerden başlar: bir API anahtarı olmadan hiçbir şey çalışmaz. Alışıldık yol Civo CLI. Anahtarı ev dizininizdeki düz bir JSON dosyasına yazar ve oradan yönetmenizi bekler. CivoCloudManager aynı anahtarı alır, siz daha kurulum ekranındayken Civo REST API v2 üzerinde doğrular ve bir dotfile yerine macOS Keychain'e koyar. Aşağıda iki yol da var, hangisi işinize geliyorsa onu seçin.

Anahtarı CivoCloudManager'da bağlamak

01

Menü çubuğundaki kalkanı açın.

Uygulama ilk açılışta menü çubuğuna bir kalkan simgesi koyar. Simgeye tıklayınca altı adımlık kurulum başlar. Açılacak bir hesap, doldurulacak bir kayıt formu yok; uygulama doğrudan Civo ile konuşur.
02

API anahtarını yapıştırın ve doğrulatın.

Anahtar güvenli bir metin alanına girilir. Validate'e bastığınızda uygulama, devam etmenize izin vermeden önce o anahtarla Civo'yu arar. Böylece yanlış yazılmış ya da çoktan yenilenmiş bir anahtar üç ekran sonra değil, burada hata verir. Geçerli anahtar satır içinde onaylanır.
03

Bölgenizi seçin.

Uygulama bölge listesini hesabınızdan canlı çeker ve her bölgeyi ülkesiyle gösterir. Seçtiğiniz bölge, bölge isteyen istekler için varsayılan olur. Tek tek isteklerde açıkça başka bir bölgeyi hedefleyebilirsiniz.
04

Yönetilecek firewall'ları seçin, her birine bir port verin.

Kurulum, hesabınızdaki firewall'ları bölgeye göre gruplayarak bulur; menü çubuğunun yöneteceklerini işaretlersiniz. Her birine bir port düşer, varsayılanı Kubernetes API sunucusu için 6443. Bu adımı atlayıp sonra da ayarlayabilirsiniz.
05

İsterseniz Launch at Login seçeneğini açın.

Bu, uygulamayı SMAppService ile kaydeder; yeniden başlatmadan sonra kalkan menü çubuğunda hazır olur. Süreli firewall erişimi kullanıyorsanız önemli: açtığı kuralı kapatmak için uygulamanın çalışıyor ve Civo'ya erişebiliyor olması gerekir.

Civo API anahtarı nereden geliyor

Anahtar hiçbir istemcide değil, Civo panelinde üretilir. Oturum açın, hesap bölümüne geçin ve doğrudan dashboard.civo.com/security adresinden açılan Security bölümüne gidin; API anahtarlarınız orada listelenir. Civo'nun kendi belgeleri anahtar değişimini de aynı yerde anlatıyor: bir anahtarın yanındaki Regenerate düğmesi onu sıfırlar, değişiklik anında geçerli olur ve sonraki her istek yeni anahtarı kullanmak zorundadır. Değeri bir parola gibi saklayın, çünkü hesabınıza tam erişim taşır. Elinizdeki anahtarın güncel olup olmadığından emin değilseniz bir 401 hatasını kurcalamak yerine anahtarı yenileyin ve yeni değeri yapıştırın.

Karşılaştırma için komut satırı yolu

Resmî Civo CLI anahtarları adlarıyla saklar. civo apikey add <name> <key> ile bir anahtar eklersiniz, civo apikey current <name> ile etkin olanı seçersiniz, civo apikey list ile elinizdekileri görürsünüz. Hepsi, bölge gibi ayarlarla birlikte ev dizininizdeki .civo.json dosyasına iner. Dosyanın yeri CIVO_CONFIG ortam değişkeniyle veya --config bayrağıyla değiştirilebilir. CI/CD ve betik yazımı için doğru araç budur ve açıkça söylemek gerekir: adlandırılmış birden fazla hesabı komut satırı, uygulamadan daha iyi yönetir. Yapmadığı tek şey, anahtarı dosya izinlerinin ötesinde bir şeyle korumak.

Anahtar Mac'inizde nereye gidiyor

CivoCloudManager anahtarı, ev dizinindeki bir yapılandırma dosyasına değil, macOS Keychain'e generic password öğesi olarak yazar; yalnızca Mac kilitli değilken okunabilir. Uygulamanın içinde saklanan gizli bilgileri, yani instance parolalarını, veritabanı parolalarını ve object store secret access key değerlerini göstermek LocalAuthentication üzerinden Touch ID'ye bağlıdır. Civo anahtarınız tek bir adrese gider: api.civo.com, yani Civo REST API v2. Bu yolda yayıncıya ait bir sunucu yoktur ve uygulama telemetri toplamaz. App Sandbox içinde dört yetkiyle çalışır: sandbox, giden ağ istemcisi, dışa aktarmalar için kullanıcı seçimli dosya okuma ve yazma, bir de uygulama kapsamlı yer imleri. Dürüst bir dipnot: güncel adresiniz için firewall açabilmek adına menü çubuğunun genel IP'nizi öğrenmesi gerekir, bunu da bir genel IP yankı servisine sorar. O istek hiçbir Civo kimlik bilgisi taşımaz.

Aynı anahtar Kubernetes API'sine de ulaşır, yani kubectl isteğe bağlı

API anahtarınız cluster kubeconfig'ini Civo'dan çeker ve Kubernetes erişimi asıl kubeconfig'in içindedir. Uygulama kubeconfig'i Swift ile ayrıştırır, PEM sertifikasını ve özel anahtarı SecItemImport ile içe aktarır, SecIdentityCreate ile eşleştirir ve URLSession üzerinden istemci sertifikalı mTLS açar. kubectl yok, openssl yok, kabuğa çıkış yok. O bağlantı için tek güven kökü kubeconfig'teki CA olur; yanlış bir sunucu, alakasız bir CA veya süresi geçmiş bir yaprak sertifika kabul yoluna giremez. Pod logları, iş yükleri, olaylar ve node metrikleri bu bağlantıdan gelir. Canınız istediğinde kubeconfig'i .yaml olarak dışa aktarıp kubectl ile çalışmaya devam edebilirsiniz.

Anahtarı kullanmak için bir şey satın almanız gerekmez

Menü çubuğundan firewall yönetimi kalıcı olarak ücretsiz: güncel genel IP'niz için açma ve kapatma, firewall başına port, adlandırılmış IP ön ayarları, 15 dakika, 30 dakika, bir saat veya iki saatlik süreli erişim ve toplu kapatma. Tam kaynak paneli ilk açılıştan itibaren yedi takvim günü ücretsiz, sonrasında Mac App Store'dan tek seferlik satın alım gerektirir; Family Sharing dahil. Kart yok, abonelik yok, bizim tarafımızda hesap yok. macOS 15 veya üstü gerekir, Apple silicon ya da Intel.

Civo API anahtarı hakkında sorulanlar

Civo API anahtarımı nereden bulurum?: Civo panelinde, hesabınızın Security bölümünde; doğrudan dashboard.civo.com/security adresinden açılır. Anahtarlar orada listelenir ve her birinin yanında bir Regenerate düğmesi vardır. Anahtar ne komut satırında ne de üçüncü taraf bir uygulamada oluşturulur; onlar yalnızca panelde ürettiğiniz anahtarı kullanır.
Civo API anahtarını Mac'te saklamak güvenli mi?: Nereye saklandığına bağlı. Civo CLI anahtarı ev dizinindeki .civo.json dosyasına yazar; yalnızca dosya izinleriyle korunan düz bir dosyadır. CivoCloudManager ise anahtarı macOS Keychain'e generic password öğesi olarak yazar, yalnızca Mac kilitli değilken okunur ve saklanan diğer gizli bilgilerin gösterilmesini Touch ID'nin arkasına alır. Her hâlükârda anahtar hesaba tam erişim verir, bu yüzden ona bir parola gibi davranın.
Civo API anahtarımı yenilersem veya iptal edersem ne olur?: Civo panelindeki yenileme anında geçerli olur, yani eski değeri tutan her istemci bir sonraki istekte hata almaya başlar. Düzeltmesi tek yerde: yeni anahtarı uygulamanın ayarlarına yapıştırırsınız, Keychain kaydının yerine geçer; komut satırı için civo apikey add <name> <key> ve ardından civo apikey current <name>. Başka bir şeye dokunmanız gerekmez, çünkü bölge, firewall seçimi ve IP ön ayarları ayrı saklanır.
Birden fazla Civo hesabı kullanabilir miyim?: CivoCloudManager'da aynı anda kullanamazsınız. Uygulama Keychain'de tek bir API anahtarı tutar, hesap değiştirmek o anahtarı değiştirmek demektir. Burada Civo CLI daha iyi: birden çok adlandırılmış anahtar saklar ve civo apikey current <name> ile aralarında geçiş yapar. Gün boyu hesap değiştiriyorsanız bu iş için komut satırını elinizde tutun, uygulamayı da asıl izlediğiniz hesap için kullanın.
Civo CLI hâlâ gerekli mi?: CI/CD, betik yazımı ve insansız çalışması gereken her şey için evet, doğru araç odur. Mac'te günlük iş için gerekmez. Uygulama aynı Civo REST API v2 ile konuşur, kubectl olmadan istemci sertifikalı mTLS üzerinden Kubernetes API'sine ulaşır ve komut satırında bulunmayan pod logları, S3 nesne gezintisi ve maliyet rakamlarını kapsar. Çoğu kişi sonunda ikisini birden kullanıyor.

Rehberler

Adım adım, ve dürüst karşılaştırmalar.

Derinlemesine

Her Civo ürünü için odaklı okumalar.

CivoCloudManager'ın dokunduğu her Civo yüzeyinin kendi sayfası var: ayrıntılar, ödünleşimler ve mimari kararlar. Bugün yaptığınız işe en yakın olanı seçin.

Menü çubuğu firewall yönetimi ücretsiz.

CivoCloudManager'ı Mac App Store'dan indirin, anahtarınızı bir kez yapıştırın ve güncel IP'niz için firewall erişimini menü çubuğundan ücretsiz açıp kapatın; satın alma gerekmez.

Mac App Store'dan indirin

macOS 15 (Sequoia) veya üstünü gerektirir.

Genel bakışa dön