Yetkilendirme modülü nasıl kullanılır

Auth modülü, kullanıcı yönetimi, grup yönetimi, kullanıcı kaydı, oturum açma ve ilgili işlevler dahil olmak üzere uygulamanız için kimlik doğrulama ve yetkilendirme sağlar. Proje oluşturulduğunda otomatik olarak kurulur.

Varsayılan Yönetici Kullanıcı Girişi ve Şifresi aşağıdaki gibidir:

• Login : [email protected]
• Password : appmaster

Modül ayarları aşağıdaki şekilde yapılandırılabilir:

• SignUp Groups : kullanıcının kaydolabileceği grupların listesini tanımlar;
• SignUp : kullanıcıların uygulamada kaydolmasına ve hesap almasına olanak tanır;
• Session timeout (minutes) : kullanıcı boştaysa, geçerli kullanıcı oturumunun ne kadar süre sonra sona ereceğini tanımlar; varsayılan 60 dk;
• Failed login delay (in ms) : başarısız oturum açma denemelerinden sonraki yanıtlar için gecikme süresini tanımlar; varsayılan 0ms;
• Email confirmation required : kullanıcının kaydı e-posta yoluyla onaylaması gerekip gerekmediğini tanımlar;
• Signed-Up User Active : etkinse, yeni oluşturulan her Kullanıcı nesnesi için active=true ayarlayın;
• Groups sekmesi, kullanıcı gruplarının bir listesini oluşturmaya ve yapılandırmaya izin verir;

Auth modülü kurulduktan sonra User ve User Session modelleri otomatik olarak oluşturulur. Bunları Data Design sekmesinde bulabilirsiniz. Bu modellerin varsayılan özniteliklerini yapılandırmak mümkün değildir, ancak yenilerini eklemek mümkündür.

User, User Session ve Auth Module ile ilgili BP'ler

User ve User Session modelleriyle ilgili önceden kurulmuş iş süreçleri aşağıdaki gibidir:

• User Modeli

  • DB: Delete User: User nesnesini ID göre veritabanından siler;

• • DB: Update User : veritabanındaki belirli bir model nesnesinin tüm alanlarını sıfırlar ve bunları verilen değerlerle günceller ( DB: Patch User yalnızca sağlanan alanları değiştirmek ve diğerlerini olduğu gibi tutmak için kullanılmalıdır);

• • DB: Create User : veritabanında bir kayıt oluşturur ve User model nesnesini döndürür (girdi alanlarına göre User model nesnesi oluşturmak için Make User bloğunun kullanılmasını gerektirir);

• • DB: Soft Delete User Geçici Olarak DB: Delete User yaptığı gibi tüm kaydı kaldırmak yerine seçilen User modeli nesnesinin DeletedAt alanını günceller;

• • DB: Bulk Delete User : User modeli nesne kayıtlarını verilen IDs ( ids dizisi) toplu olarak siler; failed_ids – silinmeyecek bir dizi kullanıcı IDs ;

• • DB: Patch User : Veritabanındaki User modeli nesnesinin seçili alanlarını günceller ( DB: Update User kullanılmalıdır);

• • DB: Search User : Alanlarına göre veritabanında bir veya birkaç User modeli nesnesi bulur ve bunları döndürür;

• • DB: GetOne User : ID göre User model nesnesini bulur ve döndürür;

• • Expand User : seçilen User modeli nesnesinin tüm alanlarını döndürür;

• • Make User : User modelini giriş alanlarına göre yapar (veritabanına kayıt yapmak için DB: Create User kullanılması gerekir);

• User Session

  • DB: Delete User Session : ID göre User Session nesnesini veritabanından siler;

• • DB: Update User Session : veritabanındaki belirli bir model nesnesinin tüm alanlarını sıfırlar ve bunları verilen değerlerle günceller ( DB: Patch User Session yalnızca sağlanan alanları değiştirmek için kullanılmalıdır);

• • DB: Create User Session : veritabanında bir kayıt oluşturur ve User Session model nesnesini döndürür (giriş alanlarına göre User modeli nesnesi oluşturmak için Make User Session bloğunun kullanılmasını gerektirir);

• • DB: Soft Delete User Session : seçilen User Session model nesnesinin DeletedAt alanını günceller;

• • DB: Bulk Delete User Session : User Session modeli nesne kayıtlarını verilen IDs ( ids dizisi) toplu olarak siler; failed_ids dizisi, silme işleminden yok sayılacak olan IDs kümesini tanımlar;

• • DB: Patch User Session : Veritabanındaki User Session model nesnesinin seçili alanlarını günceller ( DB: Update User Session tüm alanları sıfırlamak için kullanılmalıdır);

• • DB: Search User Session : alanlarına göre veritabanında bir veya birkaç User Session model nesnesi bulur ve onları döndürür;

• • DB: GetOne User Session ID User Session model nesnesini bulur ve döndürür;

• • Expand User Session : seçilen User Session model nesnesinin tüm alanlarını döndürür;

• • Make User Session : User Session modelini giriş alanlarına göre yapar (veritabanında kayıt yapabilmek için DB: Create User Session kullanılması gerekir);

• Auth Module

  • Auth: Generate Auth Token : verilen uzunlukta bir yetkilendirme jetonu ( Auth Token ) üretir;

• • Auth: Registration : yeni bir kullanıcı kaydeder;

• • Auth: Authorization : belirli bir Yetkilendirme Auth Token var olup olmadığını kontrol eder ve onunla ilişkili kullanıcıyı döndürür;

• • Auth: Authentification : kullanıcının oturum açma bilgilerini ve parolasını kontrol eder ve Auth Token döndürür;

• • Auth: Logout : Geçerli kullanıcının oturumunu Auth Token dayalı olarak sonlandırır;

• • Auth: Get current user : geçerli User modeli nesnesini döndürür;

• • Auth: Remove user from group : bir kullanıcıyı ID göre seçilen gruptan kaldırır;

• • Auth: Add user to group : ID göre bir kullanıcıyı seçili gruba ekler;

• • Auth: Hash Password : şifre dizesini hash'e dönüştürür;

• • Auth: Restore Password : kullanıcının oturum açmasına göre parolayı geri yükler;

• • Auth: Change Password : kullanıcının parolasını değiştirir;

• • Auth: Probe Password : şifre ve hash arasındaki ilişkiyi kontrol eder;

Auth Module, User ve User Session endpoints

Auth Module önceden kurulmuş Endpoints ve User ve User Session modelleri, proje oluşturulduktan sonra otomatik olarak oluşturulur.

Auth Module

İstek Türü	Endpoint	İlişkili iş süreci
	/logout/	Auth: Logout
	/auth/	Auth: Authentification
	/register/	Auth: Registration
	/confirm/	Auth: Get Current User
	/user/change-password/	Auth: Change Password
	/user/restore-password/	Auth: Restore Password
	/user/profile/	Auth: Get Current User

kullanıcı

İstek Türü	Endpoint	İlişkili iş süreci
	/user/:id/	DB: Update User
	/user/:id/	DB: Delete User
	/user/:id/	DB: GetOne User
	/user/	DB: Search User
	/user/:id/	DB: Patch User
	/user/	DB: Create User

User Session

İstek Türü	Endpoint	İlişkili iş süreci
	/user-session/:id/	DB: Delete User Session
	/user-session/:id/	DB: GetOne User Session
	/user-session/	DB: Search User Session
	/user-session/:id/	DB: Patch User Session
	/user-session/	DB: Create User Session
	/user-session/:id/	DB: Update User Session

Auth Token

Auth Token , yetkili bir kullanıcının oturum belirteci olarak kullanılıyor. Web uygulaması iş süreçlerinde Auth Token, ile etkileşim kurmak mümkündür:

• Get Auth Token , geçerli kullanıcının oturum Auth Token Simgesini döndürür;

• Set Auth Token , geçerli kullanıcının oturum Auth Token Simgesini yeniden yazar;

• Remove Auth Token , geçerli kullanıcının oturum Auth Token Simgesini kaldırır;

Mevcut kullanıcı nasıl edinilir

1. Business logic sekmesine gidin ve Auth: Get current user bloğunu sürükleyin.

2. Endpoints sekmesine gidin ve User bölümünü genişletin. Ardından, 1. adımda oluşturulan iş süreci için bir GET türü yöntemi oluşturun. endpoint URL'si /user_current olacaktır.

3. Web Apps sekmesine gidin ve mevcut kullanıcıyı web uygulaması iş sürecinden almak için Server request GET /user_current ile yeni bir iş süreci oluşturun.