Ortam ayarlarını güncelleyin

PATCH /v1/environment-settings · izin environment-settings:write

Ortam ayarlarını JSON birleştirme yaması (application/merge-patch+json, RFC 7396) ile günceller. If-Match zorunludur: eksikse 428, sürüm güncel değilse 412 döner. Ayarlar hiç yazılmamışsa sürüm "0" olur ve ilk yazma satırı oluşturur. Hiçbir şeyi değiştirmeyen bir yama hiçbir şey yazmaz ve sürümü korur.

İstek

Davranış

• Gruplar özyinelemeli olarak birleşir: locales, session, signup, security_notifications, account_recovery ve mfa içinde yalnızca değiştirdiğiniz alanları gönderin. Grubun kendisi null olamaz.
• Oturum ömrünü kısaltmak, eşzamanlı oturum sınırını düşürmek, kayıt olma veya hesap kurtarmayı daraltmak, e-posta ikinci faktörünü mfa iken 1fa'ya indirmek ve allowed_first_factors listesinden bir faktörü çıkarmak, yeni oturumlara ve girişlere hemen uygulanır; mevcut oturumlar kendi ömrünü korur.
• Doğrulama hataları alanın JSON işaretçisini taşır; örneğin out_of_range koduyla /session/idle_timeout_s. Liste girdisindeki bir hata girdinin kendisini gösterir: unknown_value (bilinmeyen değer) için /allowed_first_factors/1 veya duplicate (tekrarlanan değer).
• allowed_first_factors, uygulama ve kuruluş politikalarıyla kesiştirilir: bunlar yalnızca bu kümeyi daraltabilir.
• Yeni küme, kendi allowed_first_factors değerine sahip bir uygulamayla ortak hiçbir yöntem bırakmıyorsa istek 422 policy_conflict döner; önce uygulamanın kümesini değiştirin.
• Denetim kaydı ve değişiklik olayı, değiştirilen alanların değerlerini değil yalnızca adlarını taşır. Saldırı koruması ayrı bir kaynaktır ve bu kaynağın parçası değildir.

Yanıt

Güncellenmiş ayarlar ve yeni ETag ile 200 OK.

{
  "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", "magic_link", "enterprise"],
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Hatalar

Örnek

E-posta sihirli bağlantılarını açın ve parolaları kapatın:

curl -X PATCH https://api.eu.keenauth.com/v1/environment-settings \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -H 'If-Match: "0"' \
  -d '{"allowed_first_factors":["passkey","magic_link","social","enterprise"]}'

Oturum ve kayıt ayarları:

curl -X PATCH https://api.eu.keenauth.com/v1/environment-settings \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -H 'If-Match: "0"' \
  -d '{"session":{"idle_timeout_s":3600},"signup":{"mode":"invite_only","email_domain_mode":"allowlist","email_domains":["example.com"]}}'