환경 설정 업데이트

PATCH /v1/environment-settings · 권한 environment-settings:write

병합 패치(application/merge-patch+json, RFC 7396)로 환경 설정을 업데이트합니다. If-Match는 필수입니다. 누락되면 428, 오래된 버전이면 412가 반환됩니다. 설정이 한 번도 기록되지 않았다면 버전은 "0"이며, 첫 기록 시 행이 생성됩니다. 변경 사항이 없는 패치는 아무것도 기록하지 않으며 버전도 그대로 유지됩니다.

요청

동작

• 그룹은 재귀적으로 병합됩니다. locales, session, signup, security_notifications, account_recovery, mfa 안에서는 변경하는 필드만 보내십시오. 그룹 자체는 null일 수 없습니다.
• 세션 수명 단축, 동시 세션 한도 낮추기, 가입 또는 계정 복구 범위 축소, 이메일 두 번째 요소를 mfa에서 1fa로 낮추기, allowed_first_factors에서 요소 제거는 새 세션과 로그인에 즉시 적용됩니다. 기존 세션은 각자의 수명을 유지합니다.
• 검증 오류에는 필드의 JSON 포인터가 포함됩니다. 예를 들어 /session/idle_timeout_s와 코드 out_of_range입니다. 목록 항목의 오류는 해당 항목을 가리킵니다. /allowed_first_factors/1에 unknown_value(알 수 없는 값) 또는 duplicate(반복된 값).
• allowed_first_factors는 애플리케이션 및 조직 정책과 교차 적용됩니다. 이들은 이 집합을 좁힐 수만 있습니다.
• 새 집합이 자체 allowed_first_factors를 가진 애플리케이션과 공통 방법을 하나도 남기지 않으면 요청은 422 policy_conflict를 반환합니다. 먼저 애플리케이션의 집합을 변경하십시오.
• 감사 기록과 변경 이벤트에는 변경된 필드의 이름만 포함되며 값은 포함되지 않습니다. 공격 방어는 별도의 리소스이며 이 리소스에 포함되지 않습니다.

응답

200 OK와 함께 업데이트된 설정 및 새 ETag를 반환합니다.

{
  "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"
}

오류

예시

이메일 매직 링크를 켜고 비밀번호를 끄는 예시:

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"]}'

세션 및 가입 설정 예시:

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"]}}'