Geliştirme dokümantasyonu

Bu belgeler Keydra'nın geliştirilmekte olan hâlini anlatır; yayımlanmış bir sürüm değildir. Anlatılanlar bir sürüm çıkana kadar değişebilir.

Başlangıç

Keydra'yı depoyla gelen yerel Redis ve Valkey sunucularıyla ayağa kaldırın, ilk yöneticiyi oluşturun ve oturum açın.

Keydra’yı ilk kez çalıştırma#

Keydra’yı ve depoyla birlikte gelen iki yerel hedefi ayağa kaldırın; böylece herhangi bir ayar yapmadan önce bağlanabileceğiniz bir sunucu olur.

Ön koşullar

Podman kurulu ve rootless kapsayıcılar çalışır durumda olmalı.
İmaj yerine kaynaktan çalıştıracaksanız Java 21 ve Node 24.19.0 gerekir. Depo ./mvnw ile gelir; sistemdeki Maven’ı kullanmayın.

Prosedür

Yerel hedefleri ve Keydra’nın kendi PostgreSQL’ini başlatın:
bash
```
podman play kube deploy/keydra-dev.yaml
```
Bu komut Redis’i 6479, Valkey’i 6480, PostgreSQL’i 5442, Keydra’nın kendi deposu için bir Redis’i 6481 ve ClickHouse’u 8223 portunda yayımlar. Portlar bilinçli olarak varsayılanlardan kaydırılmıştır: makinenizde zaten bir Redis ya da PostgreSQL çalışıyorsa pod yine de açılır.
Arka ucu başlatın:
bash
```
cd backend && ./mvnw quarkus:dev
```

İkinci bir terminalde ön ucu başlatın:

bash

cd frontend && nvm use && yarn install && yarn dev

http://localhost:9000 adresini açın.

Doğrulama

Arka uç, arayüze gerek kalmadan da yanıt verir:

bash

curl -s http://localhost:8181/api/v1/about
curl -s http://localhost:8181/q/health/ready

Sonraki adımlar

İlk yöneticiyi oluşturma#

Hiç hesabı olmayan bir kurulum sizden oturum açmanızı istemez; bunun yerine hesap oluşturmayı önerir. Bu işi yapan uç nokta, ilk hesap oluşturulur oluşturulmaz kapanır. Yani açık kalan bir kapı değil, tek seferlik bir fırsattır.

Ön koşullar

Keydra çalışıyor ve erişilebilir olmalı.
Bu kurulumda henüz hiç hesap oluşturulmamış olmalı.

Prosedür

Keydra’yı açın. Hesap bulunmadığı için sayfada Keydra’ya giriş yapın yerine Keydra’yı kurun yazar.
Kullanıcı adı girin.
Parola girin ve aynısını Parolayı tekrarlayın alanına yazın. Form en az kaç karakter gerektiğini belirtir. Karakter çeşidi zorunluluğu yoktur; bu tür kurallar parolaları güçlendirmez, zayıflatır.
İsterseniz Ad ve e-posta (isteğe bağlı) bölümünü açın. Parola sıfırlama bağlantısı ileride buradaki e-posta adresine gönderilir.
Yöneticiyi oluştur düğmesine tıklayın.

Doğrulama

Oturumunuz açılır ve gezinmenin tamamı kullanıma hazır olur: ilk hesap, bütün izinleri taşıyan yerleşik admin rolüne sahiptir.

Sonraki adımlar

Oturum açma#

Ön koşullar

Bir yöneticinin size açtığı hesap olmalı ya da bir kimlik sağlayıcı tanımlı olmalı ve oradaki hesabınız Keydra’daki bir gruba eşlenmiş olmalı.

Prosedür

Size verilen adresi açın.
Keydra hesabıyla girmek için Kullanıcı adı ve Parola alanlarını doldurup Giriş yap düğmesine tıklayın.
Sağlayıcıyla girmek için Veya şununla giriş yapın başlığı altındaki düğmeyi kullanın. Düğmede {name} ile devam et yazar.

Doğrulama

Üst çubukta kullanıcı adınız görünür ve gezinme, yetkilerinizin kapsadığı sayfaları listeler. Erişemediğiniz sayfalar listelenmez. İsteği zaten arka uç reddeder; gizlenen bağlantı bir güvenlik önlemi değil, ekranı sadeleştiren bir kolaylıktır.

Not

Arka arkaya başarısız denemeler sınırlandırılır. Form Çok fazla giriş denemesi yapıldı diyorsa birkaç dakika bekleyin. Sayaç yeniden başlatmadan etkilenmez ve hem hesap hem ağ bazında sayar — bkz. Giriş koruması.

Bu sayfayı düzenle