Smarter by Design.Simpler for Business
ags local-user
ags local-user komutu, bir yerel veritabanındaki kullanıcı hesaplarını yönetir: kullanıcı adı, parola, profil ve kurum bilgileri, gruplar ve özel öznitelikler. Panel karşılığı Local Databases ekranının Users sekmesidir.
Hesaplar bir veritabanına bağlıdır; veritabanı ags local-database ile oluşturulur ve parola kuralları oradan gelir.
Komut Özeti
admin@TR7LBWAF01> ags local-user list # hepsini listele
admin@TR7LBWAF01> ags local-user show <kimlik> # birini göster
admin@TR7LBWAF01> ags local-user add databaseId <veritabanı> username <ad> …
admin@TR7LBWAF01> ags local-user update id <kimlik> … # değiştir
admin@TR7LBWAF01> ags local-user delete <kimlik> # sil
admin@TR7LBWAF01>
Zorunlu Alanlar
| Sıra | Alan | Durum | Değer |
|---|---|---|---|
| 1 | databaseId | Zorunlu | Hesabın açılacağı veritabanı (Tab ile seçilir) |
| 2 | username | Zorunlu | Giriş formunda kullanılacak kullanıcı adı; aynı veritabanında benzersiz olmalıdır |
| 3 | newPassword | Koşullu zorunlu | Yalnız --assignNewPassword true yazıldığında; komuttan sonra gizli olarak sorulur |
Parola atanmadan hesap açılabilir
--assignNewPassword yazılmazsa hesap parolasız oluşturulur. Böyle bir hesabın parola doğrulamasından geçmesi beklenmez; hesap açılırken parola atanmalıdır.
Parola Atama
Parola komut satırına yazılmaz. --assignNewPassword true verildiğinde komut çalıştırıldıktan sonra ayrı bir satırda, ekranda görünmeden sorulur. Girilen parola veritabanının politikasına göre denetlenir; kurala uymayan parola hata döner.
admin@TR7LBWAF01> ags local-user add databaseId <veritabanı> username ahmet --assignNewPassword true
New password: ••••••••
admin@TR7LBWAF01>
İsteğe Bağlı Alanlar
| Alan | Varsayılan | Değer |
|---|---|---|
--enabled | true | Hesabın etkin olup olmadığı; kapalı hesaplar erişim akışında devre dışı sayılır |
--email | — | Hesabın e-posta adresi; parola sıfırlama ve e-posta ile kod gönderme akışlarında kullanılır |
--displayName · --firstName · --lastName | — | Ad bilgileri |
--phone | — | Telefon numarası |
--picture | — | Hesap resminin adresi |
--company · --department · --title · --employeeId | — | Kurum bilgileri |
--groups.0 | Boş | Hesabın üye olduğu gruplar; her grup kendi indeksiyle serbest metin olarak yazılır |
--customAttributes.0.name · --customAttributes.0.value | Boş | Hesap kaydında saklanan ad ve değer çiftleri; her çift kendi indeksiyle |
--passwordHistory.0 | Boş | Hesabın önceki parola özetleri; yeni parolanın eskilerinden biriyle aynı olmasını engelleyen listeyi taşır, her giriş kendi indeksiyle |
Alanlar oturuma taşınır
Yerel veritabanı sağlayıcısının varsayılan eşlemesi, dolu bırakılan bu alanları aynı adla oturum özniteliklerine taşır. Böylece arka uca kimlik aktarırken ya da koşul yazarken kullanılabilirler.
Örnekler
admin@TR7LBWAF01> ags local-user add databaseId <veritabanı> username ahmet \
--assignNewPassword true --email ahmet@kurum.local --displayName "Ahmet Yılmaz"
New password: ••••••••
admin@TR7LBWAF01>
admin@TR7LBWAF01> ags local-user add databaseId <veritabanı> username ayse \
--assignNewPassword true --department "Bilgi İşlem" --title "Sistem Uzmanı" --employeeId 10428 \
--groups.0 yoneticiler --groups.1 bt
New password: ••••••••
admin@TR7LBWAF01>
admin@TR7LBWAF01> ags local-user update id <kimlik> \
--customAttributes.0.name sube --customAttributes.0.value ankara
admin@TR7LBWAF01>
Güncelleme ve Silme
Güncelleme kimliği id alanıyla ister. Parola değiştirmek için yine --assignNewPassword true yazılır ve yeni parola gizli olarak sorulur.
admin@TR7LBWAF01> ags local-user update id <kimlik> --enabled false # hesabı devre dışı bırak
admin@TR7LBWAF01> ags local-user update id <kimlik> --assignNewPassword true # parolayı yenile
admin@TR7LBWAF01> ags local-user update id <kimlik> --groups.delete # grupları boşalt
admin@TR7LBWAF01> ags local-user delete <kimlik>
admin@TR7LBWAF01>
Bilinmesi Gerekenler
- Kullanıcı adı veritabanı içinde benzersizdir. Aynı ad farklı veritabanlarında kullanılabilir; aynı veritabanında çakışırsa kayıt oluşmaz.
- Parola ekranda görünmez. Komut satırına yazılmaz, çalıştırma sonrası gizli olarak sorulur ve veritabanının politikasına göre denetlenir.
- Hesap devre dışı bırakılabilir. Silmek yerine
--enabled falseyazmak, hesabı kaydı korunarak erişim dışında bırakır. - Boşluklu değerler tırnak ister. Görünen ad, birim ve unvan gibi alanlar çift tırnakla yazılır.
