Servis hesapları ve API belirteçleri
Otomasyon için servis hesapları oluşturun, rol verin ve anahtarlarını yönetin; sizin adınıza işlem yapan API belirteçlerini oluşturun, yenileyin ve iptal edin.
Servis hesapları ve API belirteçleri, betiklerin ve araçların konsola giriş yapmadan REST API’yi çağırmasını sağlar.
- API belirteci, onu oluşturan üye olarak işlem yapar. O üyenin rollerinin izin verdiklerini, belirteç için seçtiğiniz izin kapsamlarıyla sınırlı olarak yapabilir. Gizli anahtarı
pc_live_ile başlar. - Servis hesabı, kuruluşunuzun bir makine kimliğidir. Kendi rollerini alır ve anahtarları servis hesabı olarak işlem yapar. Anahtarlarının gizli anahtarları
sak_live_ile başlar. Bir kişiye bağlı olmadığı için servis hesabı, üyeler ayrıldığında veya rolleri değiştiğinde çalışmaya devam eder.
İkisi de openstack CLI veya Terraform gibi OpenStack araçlarıyla çalışmaz. Bu araçlar için bir uygulama kimlik bilgisi oluşturun. İsteklerinizle bir belirteç veya anahtar göndermek için bkz. API belirteçleriyle kimlik doğrulama.
Başlamadan önce
- Servis hesaplarını, anahtarlarını ve rol bağlamalarını oluşturmak ve yönetmek için Sahip rolüne ya da Identity & Access için Yönet erişimi olan özel bir role sahip olmanız gerekir.
- API belirteçlerini oluşturmak, yenilemek ve iptal etmek için Sahip rolüne ya da API Tokens için Yönet erişimi olan özel bir role sahip olmanız gerekir.
- Identity & Access için Oku erişimi olan herhangi bir rol, servis hesaplarını görüntülemeye yeterlidir. API Tokens için Oku erişimi olan herhangi bir rol, API belirteçlerini görüntülemeye yeterlidir.
Servis hesabı oluşturma
Konsolda Kimlik & ErişimServis Hesapları sayfasına gidin ve Servis hesabı oluştur düğmesini seçin.
Kimlik altında Hesap adı alanına bir ad ve isteğe bağlı olarak Açıklama alanına bir açıklama girin.
Rol bağlamaları altında verilecek rolleri seçin. Roller geçerli projede verilir.
Anahtar altında, ilk anahtarı şimdi oluşturmak için Anahtar oluştur ve kimlik bilgisini indir seçeneğini açık bırakın ya da kapatın.
Oluştur + anahtarı indir düğmesini ya da anahtarı kapattıysanız Servis hesabı oluştur düğmesini seçin.
Bir anahtar oluşturduysanız JSON indir düğmesini seçin ve dosyayı güvenli bir yerde saklayın. Ardından Kaydettim — servis hesaplarına git düğmesini seçin.
| Alan | Kurallar |
|---|---|
| Hesap adı | Tek bir harf ya da 3–30 karakter: küçük harfler, rakamlar ve kısa çizgiler; bir harfle başlamalı ve bir harf veya rakamla bitmelidir. Ad benzersiz olmalıdır ve daha sonra değiştirilemez. |
| Açıklama | İsteğe bağlı. |
| Roller | İsteğe bağlı. Rol verilmezse servis hesabı oluşturulur, ancak hiçbir şeye erişemez. Yalnızca vermeye yetkili olduğunuz rolleri verebilirsiniz. |
Anahtarları yönetme
Anahtar, bir JSON kimlik bilgisi dosyasıdır. sak_live_ ile başlayan secret alanı, Authorization: Bearer <secret> olarak gönderdiğiniz değerdir. Dosya ayrıca bir özel anahtar içerir; platform bu özel anahtarı istekleri doğrulamak için kullanmaz.
Anahtar oluşturma. Servis hesabını açın ve Anahtar oluştur düğmesini seçin. Anahtar hemen oluşturulur. İletişim kutusunda JSON indir düğmesini seçin, dosyayı saklayın ve Kaydettim — kapat düğmesini seçin.
Önemli
Anahtarın kimlik bilgisi yalnızca bir kez gösterilir ve yeniden indiremezsiniz. Kaybederseniz yeni bir anahtar oluşturun ve eskisini iptal edin.
Anahtarı iptal etme. Anahtarlar sekmesinde anahtarın satırında İptal et düğmesini seçin ve onaylayın. Anahtarla yapılan istekler hemen reddedilir. Bu işlemi geri alamazsınız.
| Anahtar kuralı | Değer |
|---|---|
| Servis hesabı başına anahtar | İptal edilmemiş en fazla 5 anahtar. İptal edilen anahtarlar listede kalır ve sayılmaz. |
| Geçerlilik süresi | Oluşturulduktan sonra 365 gün. Ardından anahtar çalışmayı bırakır. |
| Durum | Etkin, son 30 günde Yakında sona eriyor, Süresi doldu veya İptal edildi. |
Bir anahtarı kesinti olmadan değiştirmek için yeni bir anahtar oluşturun, istemcilerinize dağıtın ve ardından eskisini iptal edin. Konsol, 90 günden eski anahtarları işaretler.
Anahtar oluşturmak veya devre dışı bırakılmış bir servis hesabını etkinleştirmek için servis hesabının rol bağlamalarının verdiği her izne sahip olmanız gerekir.
Rol bağlaması verme ve kaldırma
Servis hesabını açın ve Rol bağlamaları sekmesine gidin.
Bağlama ekle düğmesini seçin.
Bir Rol ve bir Kapsam seçin: geçerli proje veya abonelik. Abonelik yalnızca abonelikte rol verebiliyorsanız sunulur.
Ver düğmesini seçin.
Abonelikteki bir bağlama, abonelikteki her projeye uygulanır. Bir bağlamayı kaldırmak için satırında Kaldır düğmesini seçin ve Bağlamayı kaldır ile onaylayın. Servis hesabı bu erişimi hemen kaybeder. Bir servis hesabına rolün sayfasından da rol verebilirsiniz. Bkz. Yerleşik ve özel rolleri kullanma.
Servis hesabını devre dışı bırakma, etkinleştirme veya silme
| Eylem | Ne olur |
|---|---|
| Devre dışı bırak | Servis hesabının anahtarlarıyla yapılan istekler hemen reddedilir. OpenStack uygulama kimlik bilgileri silinir. |
| Etkinleştir | Anahtarları, süresi dolmadıysa veya iptal edilmediyse yeniden çalışır. Silinen OpenStack uygulama kimlik bilgileri geri gelmez. |
| Sil | Hesabın adını yazarak onaylarsınız. Servis hesabı, anahtarları ve rol bağlamaları kaldırılır; OpenStack uygulama kimlik bilgileri silinir. Bu işlemi geri alamazsınız. |
API belirteci oluşturma
Kimlik & ErişimAPI belirteçleri sayfasına gidin ve Belirteç oluştur düğmesini seçin.
Belirteç adı alanına bir ad girin.
Kapsamlar altında, belirtecin ihtiyaç duyduğu her hizmet için Oku veya Yazma seçeneğini seçin: Compute, Depolama, Ağ veya Faturalandırma. Faturalandırmanın yalnızca okuma kapsamı vardır.
Sona erme alanında 30 gün, 60 gün, 90 gün, Sona erme yok veya Özel tarih seçeneğini seçin. Varsayılan 90 gündür.
İsteğe bağlı: IP izin listesi altında belirteci kullanmasına izin verilen adresleri girin.
Belirteç oluştur düğmesini seçin.
Belirteci kopyala düğmesini seçin ve belirteci gizli anahtar yöneticinizde saklayın. Sakladığınızı onaylayın ve Tamam düğmesini seçin.
| Alan | Kurallar |
|---|---|
| Belirteç adı | 2–63 karakter: küçük harfler, rakamlar ve kısa çizgiler; bir harf veya rakamla başlamalıdır. |
| Kapsamlar | En az bir. |
| Özel sona erme tarihi | Yarından itibaren. Belirtecin süresi o tarihte 00:00 UTC’de dolar. |
| İzin verilen kaynak IP'ler / CIDR'ler | Her satıra bir tane ya da virgülle ayrılmış IP adresleri veya CIDR aralıkları. Tüm adreslere izin vermek için boş bırakın. Diğer adreslerden gelen istekler reddedilir. |
Gizli anahtar yalnızca bir kez gösterilir. Belirteci tanıyabilmeniz için belirtecin sayfası, ilk 12 karakterini Ön ek altında gösterir.
Bir belirteç, yalnızca oluşturduğunuz projede değil, kuruluşunuzda rolünüzün olduğu her projede çalışır. Kimlik & ErişimAPI belirteçleri sayfası, geçerli projede oluşturulan belirteçleri listeler. Her kapsamın neye izin verdiği için bkz. Belirteç kapsamları.
API belirtecini yenileme
Bir belirtecin gizli anahtarını kesinti olmadan değiştirmek için belirteci yenileyin. Bir belirteci yalnızca onu oluşturan üye yenileyebilir.
Kimlik & ErişimAPI belirteçleri sayfasında belirtecin satırındaki menüyü açın ve Döndür seçeneğini seçin.
Belirtecin sayfasında Döndür düğmesini seçin.
Yeni gizli anahtarı kopyalayın. Gizli anahtar yalnızca bir kez gösterilir.
Önceki gizli anahtar 24 saat boyunca çalışmaya devam eder; bu sürede istemcilerinizi güncelleyebilirsiniz. Gizli anahtar sızdıysa belirteci yenilemek yerine iptal edin.
API belirtecini iptal etme
Kimlik & ErişimAPI belirteçleri sayfasında belirtecin satırındaki menüyü açın ve İptal et seçeneğini seçin.
Onaylayın. Bu andan itibaren belirteçle yapılan istekler 401 Unauthorized alır.
İptal işlemini geri alamazsınız. Sahip rolüne ya da API Tokens için Yönet erişimi olan özel bir role sahip herkes, diğer üyelerin oluşturduğu belirteçler dahil projede listelenen belirteçleri iptal edebilir.
Bir üyenin belirteçleri, üye devre dışıyken de çalışmaz; üye kuruluşunuzdan kaldırıldığında ise iptal edilir. Bkz. Üyeyi devre dışı bırakma, yeniden etkinleştirme veya kaldırma.