Keycyte PAM 3.2 · Kurulum Kılavuzu
Hizmet Erişim Anahtarları
Keycyte PAM hizmetleri birbirlerine erişim anahtarlarıyla kimlik doğrular. Her anahtar, bir erişim anahtarı kimliği (access key ID) ile bir gizli değerden (secret) oluşan bir çifttir. Bir hizmet, başka bir hizmete gönderdiği her isteği gizli değerle oluşturulan HMAC-SHA256 HTTP imzasıyla imzalar; isteği alan hizmet imzayı aynı çiftle doğrular.
Erişim anahtarları kapsayıcıların (container) ortamında, kurulum paketinin .env dosyasında tanımlanır. PAM sunucusu anahtarları başlangıçta okur ve bellekte tutar. Erişim anahtarları Yönetici Paneli’nden oluşturulmaz ya da değiştirilmez.
Kurulumdaki Erişim Anahtarları
| Anahtar | İmzalayan | Doğrulayan | .env değişkeni | PAM sunucusundaki değişken | Diğer hizmetteki değişken |
|---|---|---|---|---|---|
| SSH proxy anahtarı | SSH proxy | PAM sunucusu | SSH_PROXY_ACCESS_KEY_ID, SSH_PROXY_ACCESS_KEY_SECRET | KEYCYTE_SSH_PROXY_ACCESS_KEY_ID, KEYCYTE_SSH_PROXY_ACCESS_KEY_SECRET | KEYCYTE_ACCESS_KEY_ID, KEYCYTE_ACCESS_KEY_SECRET (SSH proxy) |
| RADIUS sunucusu anahtarı | RADIUS sunucusu | PAM sunucusu | RADIUS_ACCESS_KEY_ID, RADIUS_ACCESS_KEY_SECRET | KEYCYTE_RADIUS_SERVER_ACCESS_KEY_ID, KEYCYTE_RADIUS_SERVER_ACCESS_KEY_SECRET | KEYCYTE_ACCESS_KEY_ID, KEYCYTE_ACCESS_KEY_SECRET (RADIUS sunucusu) |
| PAM anahtarı | PAM sunucusu | SSH proxy | PAM_ACCESS_KEY_ID, PAM_ACCESS_KEY_SECRET | KEYCYTE_PAM_ACCESS_KEY_ID, KEYCYTE_PAM_ACCESS_KEY_SECRET | KEYCYTE_PAM_ACCESS_KEY_ID, KEYCYTE_PAM_ACCESS_KEY_SECRET (SSH proxy) |
| RDP proxy anahtarı | PAM sunucusu | RDP proxy | RDP_PROXY_ACCESS_KEY_ID, RDP_PROXY_ACCESS_KEY_SECRET | KEYCYTE_RDP_PROXY_ACCESS_KEY_ID, KEYCYTE_RDP_PROXY_ACCESS_KEY_SECRET | KEYCYTE_ACCESS_KEY_ID, KEYCYTE_ACCESS_KEY_SECRET (RDP proxy) |
docker-compose.yml dosyası aynı .env değerini her iki tarafa da aktarır; bu nedenle değeri yalnızca .env dosyasında değiştirdiğiniz sürece çift her zaman eşleşir.
Bir anahtar tanımlı değilse PAM sunucusu yine de başlar ve ilgili hizmet için bir uyarı günlüğe yazar. İlgili hizmet kimlik doğrulayamaz: örneğin SSH proxy anahtarı olmadan yerel SSH ve web terminali oturumları açılamaz, RDP proxy anahtarı olmadan yerel RDP ile başlatma devre dışı kalır.
Not
Hizmet erişim anahtarları, uygulamaların Secrets API üzerinden gizli bilgileri okumak için kullandığı hizmet kimliği API anahtarlarından farklıdır. Hizmet kimliği API anahtarları Yönetici Paneli’nde kullanıcı bazında yönetilir. Bkz. Yönetici Kılavuzu, Kullanıcılar bölümü.
Erişim Anahtarlarını Görüntüleme
PAM sunucusunun yüklediği erişim anahtarlarını görüntülemek için:
-
Yönetici Paneli’nde Ayarlar > Servisler sayfasını açın.
-
Servis AccessKey’leri kartını bulun.
Kart, her Servis için Access Key ID değerini ve Gizli Anahtar değerinin son dört karakterini gösterir. Anahtarı olmayan hizmetler tanımlı değil olarak gösterilir.
Erişim anahtarları kurulumun .env dosyasında saklanır. Bir anahtarı yenilemek için aşağıdaki yordamı izleyin.
Erişim Anahtarını Yenileme
Gizli değerin ifşa olduğundan şüpheleniyorsanız ya da güvenlik politikanız gerektiriyorsa erişim anahtarını yenileyin.
Bir erişim anahtarını yenilemek için:
-
Sunucuda, kurulum paketi klasöründeki
.envdosyasını açın. -
Anahtarın gizli değeri için yeni bir değer belirleyin; örneğin
openssl rand -hex 32ile oluşturulmuş rastgele bir değer. İsterseniz yeni bir erişim anahtarı kimliği de belirleyebilirsiniz. -
Dosyayı kaydedin.
-
Kapsayıcıların yeni değerleri okuması için paket klasöründe kapsayıcıları yeniden oluşturun:
sudo docker compose --env-file .env -f docker-compose.yml up -d
Docker Compose, ortamı değişen kapsayıcıları yeniden oluşturur. Kapsayıcılar başladıktan sonra yeni anahtar kullanılır.
Uyarı
Kapsayıcıların yeniden oluşturulması, bu kapsayıcılar üzerinden yürüyen etkin oturumları keser. Anahtarları bir bakım penceresinde yenileyin.
Uyarı
Erişim anahtarlarının gizli değerlerini hiçbir zaman destek kayıtlarına, e-postalara ya da sohbetlere kopyalamayın. Gizli değere sahip olan herkes dahili API’yi o hizmet adına çağırabilir.