Oturum açma nasıl yapılandırılır ve oturumlar nasıl yönetilir

Kümenin tüm oturum açma ayarları tek bir yerdedir: parola uzunluğu, parola bileşimi için dört gereksinim, başarısız deneme sınırı, sayım penceresi ve kilitleme süresi. Ayarlar kümenin tamamına uygulanır; bir VDC (sanal veri merkezi) veya rol için ayrı bir ilke yoktur.

Bu sayfa oturumları da ele alır. Kümeye gönderilen her istek bir oturum gerektirir: geçerli bir oturum olmadan istek, işlem ayrıştırılmadan önce reddedilir. Bir oturumu neyin geçersiz kıldığını anlamak, bildirimleri incelerken zaman kazandırır: "açıklanamayan" reddetmelerin yarısı, parola değişikliğinden sonra geçersiz hâle gelen oturumlar olarak ortaya çıkar.

Ön koşullar

• Güvenlik ayarlarını değiştirmek ve hesapların kilidini açmak için Cluster master rolü. Yetkili her kullanıcı parola gereksinimlerini görüntüleyebilir.
• Küme arayüzünde etkin bir oturum.
• Rol modeline ilişkin bilgi — bkz. vStack Center erişim modeli.

Oturumlar nasıl çalışır

Oturum açıldığında küme bir oturum belirteci verir; bu belirteç daha sonra her istekle birlikte sunulur. Belirteç küme içinde aktarılmaz: girişte sayısal bir kullanıcı tanımlayıcısına dönüştürülür ve tüm izin denetimlerinde bu tanımlayıcı kullanılır. Belirteç içermeyen bir istek -9494 "No session token" hatasıyla reddedilir. Bu bir izin reddi değil, kimlik doğrulama reddidir ve işlemin kendisi hiç başlamaz.

Bir belirteç üç durumda geçersiz hâle gelir: kullanıcı oturumu kapatır, oturumun süresi dolar veya kullanıcının parolası değiştirilir. Geçersiz bir belirteç -11000 hatasıyla sonuçlanır: oturum etkin oturumlar arasında değildir.

Adım 1. Geçerli ayarları gözden geçirin

1. Settings bölümünü açın ve Security policy bloğunu bulun.

2. Parola gereksinimlerini gözden geçirin: en küçük uzunluk ve dört karakter gereksinimi — bir büyük harf, bir küçük harf, bir rakam ve bir özel karakter.

3. Kilitleme ayarlarını gözden geçirin: kaç başarısız denemeye izin verildiği, denemelerin hangi pencerede sayıldığı ve hesabın ne kadar süre kilitli kalacağı.

Parola gereksinimleri yetkili her kullanıcıya görünür: parola değiştirme formu bunları herkese göstermelidir. Kilitleme ayarlarına erişim, rol numarasıyla değil, Edit Security Settings yetkisiyle (9001) verilir. Cluster Master bu yetkiye sahiptir ve yetki özel bir role de atanabilir: özel roller için yalnızca rol yönetimi yetkileri (7111, 7112, 7113) yasaktır. Bu nedenle "blokta kilitleme ayarları yok" ifadesi "9001 yetkisi eksik" anlamına gelir ve mutlaka "küme yöneticisi değilsiniz" anlamına gelmez.

İlkeyi düzenlemek, okumaktan daha kısıtlıdır: değişiklikleri yalnızca Cluster Master kaydedebilir; tek başına 9001 yetkisi yeterli değildir.

Adım 2. İlkeyi değiştirin

1. Settings → Security policy öğesini açın.

2. Sayısal ayarlara yeni değerler girin ve parola gereksinimlerini açıp kapatın. İlkenin tamamını değiştirmeniz gerekmez: değiştirmediğiniz ayarlar önceki değerlerini korur.

3. Değişiklikleri kaydedin.

Parametre	Değer	Neyi denetler
max_failed_attempts	tamsayı, en az 1	kilitlemeden önce izin verilen başarısız deneme sayısı
failed_attempts_window_minutes	tamsayı, en az 1	denemelerin sayıldığı dakika cinsinden pencere
lockout_duration_minutes	tamsayı, en az 0	dakika cinsinden kilitleme süresi; 0 yalnızca elle kilit açma anlamına gelir
password_min_length	tamsayı, en az 1	en küçük parola uzunluğu
password_require_uppercase	açma/kapama	büyük harf [A-Z] zorunluluğu
password_require_lowercase	açma/kapama	küçük harf [a-z] zorunluluğu
password_require_digits	açma/kapama	rakam [0-9] zorunluluğu
password_require_special	açma/kapama	özel karakter zorunluluğu

İki değer platformun davranışını diğerlerinden daha güçlü biçimde etkiler. Sıfır kilitleme süresi otomatik kilitlemeyi kalıcı hâle getirir: kilit süresi dolmaz ve hesabın kilidini yalnızca küme yöneticisi açabilir. Bu mod her olayın incelendiği ortamlar için uygundur, ancak kullanıcıyı desteğe başvurana kadar erişimsiz bırakır. Bir başarısız denemelik sınır, hesabı ilk yazım hatasından sonra kilitler.

Adım 3. İlkenin çalıştığını doğrulayın

En hızlı denetim, bir test hesabı için gereksinimleri karşılamadığı bilinen bir parola ayarlamaktır. Kısa bir değer -22730 "Password is too short" döndürür. Diğer her gereksinimin kendi hata kodu vardır.

Kod	İlke gereksinimi
-22730	en küçük parola uzunluğu
-22731	bir büyük harf
-22732	bir küçük harf
-22733	bir rakam
-22734	bir özel karakter
-22735	parola hesap adıyla aynı olmamalıdır
-22737	yeni parola aynı hesabın geçerli parolasıyla aynı olmamalıdır

Son iki gereksinim her zaman geçerlidir ve ayarlardan devre dışı bırakılamaz.

Ardından kilitlemeyi denetleyin: test hesabıyla başarısız deneme sınırına ulaşın ve hesabın durumunu Users & Roles bölümünde, Users sekmesinde kontrol edin. Kilit açma talimatları için bkz. Kullanıcılar nasıl yönetilir.

Oturum nasıl sonlandırılır

Arayüzden oturumu kapatma işlemi kümeye ulaşır: oturum belirteci hemen çalışmayı bırakır. Her kullanıcı herhangi bir yetki olmadan oturumu kapatabilir ve oturumu kapatmak her iki modda da diğer kullanıcıların oturumlarını etkilemez.

Oturum kapatma kapsamı	Ne olur	Ne zaman kullanılır
geçerli oturum (varsayılan)	yalnızca oturumu kapattığınız oturum sonlandırılır; aynı kullanıcının diğer oturumları etkin kalır	arayüzden normal oturum kapatma
tüm kullanıcı oturumları	bu hesaba verilmiş tüm oturumlar sonlandırılır	tüm cihazlardan oturumu kapatma, örneğin başka birinin iş istasyonunu kullandıktan sonra

Küme başarılı bir oturum kapatmayı kullanıcı, zaman ve adres bilgisiyle tek bir auth.logout güvenlik olayı olarak kaydeder. Olay yalnızca başarılı bir oturum kapatmadan sonra görünür: zaten geçersiz kılınmış bir belirteçle oturumu yeniden kapatma girişimi kimlik doğrulama sırasında reddedilir ve ikinci bir olay oluşturmaz.

İlk oturum açmada zorunlu parola değişikliği

Bir hesap için ilk oturum açmada parola değiştirme zorunluluğu tanımlanabilir. Oturum açtıktan sonra kullanıcı arayüz yerine parola değiştirme formuna yönlendirilir ve parola değiştirilene kadar yalnızca bu form kullanılabilir. Form, geçerli parola gereksinimlerini bir reddetmeden sonra değil, gönderimden önce gösterir.

Kullanıcının parolayı değiştirmek için 5 dakikası vardır; bu süreden sonra yeniden oturum açması gerekir. İzin tek kullanımlıktır ve yalnızca kullanıcının kendi parolası için geçerlidir; başka bir hesabın parolasını değiştirmek için kullanılamaz. Başarılı bir değişiklikten sonra zorunluluk kaldırılır ve kullanıcı normal şekilde oturum açar.

Bir işlem reddedilirse

Kod	Neden	Ne yapılmalı
-9494 "No session token"	istek oturum belirteci olmadan gönderildi	arayüzde yeniden oturum açın
-11000	oturum etkin oturumlar arasında değil: süresi doldu, kullanıcı oturumu kapattı veya parola değiştirildi	yeniden oturum açın
-403 "Access denied"	güvenlik ayarlarını küme yöneticisi dışında bir kullanıcı değiştiriyor	işlemi Cluster master olarak gerçekleştirin
-29101 "Security settings not found"	ayarlar küme başına tek bir kayıtta saklanır ve bu kayıt eksik	desteğe başvurun: ayarlar okunabilir ve güncellenebilir, ancak yeniden oluşturulamaz
-29102	ayarlar okunurken veya yazılırken bir veritabanı hatası oluştu	yeniden deneyin; yeniden deneme işe yaramazsa desteğe başvurun
-125 "Temp token expired or invalid"	ilk oturum açmada parola değiştirilirken 5 dakikadan fazla zaman geçti veya değişiklik zaten tamamlandı	yeniden oturum açın ve parolayı hemen değiştirin
-126 "Method not allowed with temp token"	ilk oturum açmada parola değiştirilmeden önce başka bir işlem istendi	parolayı değiştirin, normal şekilde oturum açın ve işlemi yeniden deneyin
-127 "Temp token allows changing own password only"	ilk oturum açmada başka bir hesabın parolasını değiştirme girişimi	ilk oturum açma formu yalnızca kendi parolanızı değiştirebilir
-22730…-22735, -22737	yeni parola ilkeyi karşılamıyor	geçerli gereksinimleri Settings → Security policy içinde görüntüleyin

Ayrıca bkz.

• Bir hesabın kilidini açma ve yönetici olarak parola değiştirme — Kullanıcılar nasıl yönetilir.
• Roller, yetkiler ve kapsamlar — vStack Center erişim modeli.
• Tam alan kümeleri ve hata kodlarının özeti — Erişim yöntemlerinin alanları ve hata kodları.
• auth kategorisindeki olaylar — oturum açmalar, oturum kapatmalar ve kimlik doğrulama retleri — Günlüğü okuma ve olayları filtreleme sayfasında ele alınmıştır; günlüğün yapısı Güvenlik günlüğü sayfasında açıklanmıştır.

API yöntemleri

Bu sayfada ele alınan API işlemleri: auth-security-settings-get, auth-security-settings-set, auth-logout, user-set-password, user-unlock — bkz. API başvurusu.