Ortam ayarlarını alın

GET /v1/environment-settings · izin environment-settings:read

Ortamın dil, saat dilimi, oturum, hesap oluşturma, güvenlik bildirimi, hesap kurtarma, MFA, Front-Channel Logout ve izin verilen birincil kimlik doğrulama faktörü ayarlarını döndürür (ortam başına tek bir kaynak). Ayarlar hiç yazılmamışsa varsayılanlar ETag: "0" ve updated_at: null ile döner. ETag yanıt üstbilgisi, PATCH isteğinde If-Match olarak göndermeniz gereken sürümü taşır. Süreler tam saniye olarak verilir.

İstek

Bu işlemin yol, sorgu ya da gövde alanı yoktur. Ortam kimlik bilgisinden gelir.

Yanıt

ETag üstbilgisiyle birlikte ayarlar içeren 200 OK.

allowed_first_factors, ortamda izin verilen birincil faktörleri listeler ve her zaman bu sırayla döner: password, passkey, email_otp, magic_link, sms_otp, social, enterprise. Varsayılan ["password", "passkey", "social", "enterprise"] değeridir; email_otp, magic_link ve sms_otp yalnızca siz eklerseniz etkin olur. Bir uygulama ya da kuruluş politikası bu kümeyi yalnızca daraltabilir.

{
  "locales": {"enabled": ["en", "tr"], "default": "tr"},
  "default_zoneinfo": "Europe/Istanbul",
  "session": {"idle_timeout_s": 3600, "absolute_timeout_s": 2592000, "max_concurrent": 5, "concurrent_mode": "evict_oldest", "anomaly_action": "enforce"},
  "signup": {"mode": "invite_only", "email_domain_mode": "allowlist", "email_domains": ["example.com"]},
  "security_notifications": {"enabled": true, "events": ["password_changed", "password_reset"]},
  "account_recovery": {"mode": "self_service_waiting", "waiting_hours": 72, "support_url": ""},
  "mfa": {"email_second_factor_enabled": false, "email_second_factor_acr": "1fa", "totp_issuer_label": "Acme", "recovery_codes_enabled": true, "recovery_code_count": 10, "required": false, "min_acr": "1fa", "enrollment_grace_days": 0},
  "frontchannel_logout_enabled": false,
  "allowed_first_factors": ["password", "passkey", "social", "enterprise"],
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Hatalar

HTTP	kod	Ne zaman
401	`unauthenticated`	Kimlik bilgisi eksik, geçersiz ya da iptal edilmiş.
403	`insufficient_permissions`	Kimlik bilgisinin gerekli izni yok.
429	`rate_limited`	İstek sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin.
503	`service_unavailable`	Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin.

Örnek

curl https://api.eu.keenauth.com/v1/environment-settings \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"