Referans
#Komut satırı
Her komut gateway konteynerinin içinde çalışır (imza anahtarı hariç; o worker'da):
docker compose exec -T gateway node apps/gateway/dist/cli/<komut>.js [seçenekler]
Konsolun yaptığı her iş komut satırından da yapılabilir; ikisi aynı veri katmanını kullanır. Parola ve anahtar gibi gizli değerler argüman olarak değil standart girişten alınır, böylece kabuk geçmişine girmez.
#create-admin
Konsol yöneticisini oluşturur ya da --replace ile üzerine yazar. Parola standart girişten.
printf '%s' 'PAROLA' | ... create-admin.js --email [email protected] [--replace] [--tenant <id>]
#create-api-key
Uygulama anahtarları. Anahtar bir kez basılır.
| Seçenek | Anlamı |
|---|---|
--label <ad> | Yeni anahtar üretir; etiket konsolda görünür |
--purpose <metin> --legal-basis <sebep> | İşleme amacı ve KVKK Md. 5 hukuki sebebi; üretirken ya da --key ile sonradan |
--list | Anahtarları listeler: etiket, kimlik, geçerli mi |
--key <key_id> --revoke | İptal eder; kayıt silinmez |
--key <key_id> --set-policy '<json>' | Anahtar başına politika üstyazımı; none kaldırır |
--tenant <id> | Bulut kurulumunda kurum |
Hukuki sebep değerleri: explicit_consent, law_provides, vital_interest, contract, legal_obligation, made_public, legal_claim, legitimate_interest.
#create-target
Sağlayıcı hedefleri. Aynı --name ile tekrar çalıştırmak günceller.
| Seçenek | Anlamı |
|---|---|
--name <ad> | Hedefin adı |
--api-style openai|anthropic | İstek biçimi |
--base-url <adres> | OpenAI biçiminde /v1 ile biter, Anthropic biçiminde bitmez |
--region <etiket> | Bölge etiketi; EU_REGIONS ile birebir karşılaştırılır |
--declared | Bölge sizin beyanınız (araya giren proxy). Raporda "(beyan)" |
--auth-kind bearer|x-api-key|api-key | Kimlik başlığı |
--secret-env <AD> ya da --secret-ref <ad> | Anahtar: .env değişkeninin adı, ya da kasadaki sırrın adı |
--models <desen,...> | Bu hedefin karşıladığı modeller; * önek eşleşir |
--map 'model=bölge,...' | Araya giren proxy'de modelden bölgeye eşleme |
--default | Aynı biçimde birden fazla hedef varsa kazanan |
--azure-api-version <sürüm> --azure-deployment model=deployment | Azure OpenAI |
--list | Hedefler ve seçim sırası |
--name <ad> --disable / --enable / --delete | Durum |
#set-policy
Kurum politikası. Verilmeyen seçenekler olduğu gibi kalır.
| Seçenek | Değerler |
|---|---|
--mode | fast, deep, strict |
--pii | mask, block, hold |
--injection | off, flag, block, hold |
--buffered | on, off |
--rate-limit | sayı ya da off |
--budget, --key-budget | aylık token sayısı ya da off |
--models | virgülle liste ya da any |
--allowed-tools | virgülle liste, none ya da off |
Komut, önceki ve sonraki değerleri yan yana basar.
#set-secret
Sağlayıcı anahtarını şifreli kasaya yazar. Değer standart girişten.
printf '%s' "$OPENAI_KEY" | ... set-secret.js --tenant default --name openai
#create-fingerprint-keyring
İçerik parmak izi anahtar dosyasını üretir ya da döndürür. Döndürme ekler, değiştirmez: eski sürüm dosyada kalır, yoksa eski parmak izleri doğrulanamaz.
... create-fingerprint-keyring.js --out /var/lib/nev/gateway-keys/fingerprint.json --version k1
Aynı komut --out .../vault.json ile kasa anahtarını üretir.
#create-tenant (bulut kurulumu)
Kurum kaydı: --id, --name, --region; --list; --status active|suspended; --plan <ad> --plan-tokens <sayı|off> ya da --plan none. On-prem kurulumda gerekmez.
#create-signing-key (worker)
Günlük checkpoint imza anahtarı. Yanına .pub dosyasını yazar; denetçiye verilecek olan odur.
docker compose exec -T worker node apps/worker/dist/cli/create-signing-key.js --out /var/lib/nev/keys/checkpoint.pem
#nev-verify
Bağımsız doğrulayıcı; ağ geçidine bağlı değildir. Bkz. Bağımsız doğrulama.