keenauth_environment_settings

keenauth_environment_settings 리소스는 환경 설정을 관리합니다. 언어, 시간대, 세션, 가입, 보안 알림, 계정 복구, MFA, Front-Channel Logout, 허용된 첫 번째 인증 요소가 여기에 포함됩니다. 공격 방어는 이 설정에 포함되지 않습니다.

환경당 객체 하나

설정은 환경마다 하나만 존재하며 항상 존재합니다. 프로바이더 구성마다 이 리소스는 최대 한 번만 선언하세요. 리소스를 만들 때는 현재 설정을 읽고, 구성에서 변경한 부분만 기록합니다. 삭제하면 상태에서만 제거되며, 환경의 설정은 그대로 유지됩니다.

작성한 항목만 관리됩니다

구성에서 생략한 속성이나 그룹은 현재 값을 유지합니다. 구성에서 속성을 제거하면 마지막 값이 유지됩니다. allowed_first_factors와 signup.email_domains 같은 목록은 집합이므로 순서는 중요하지 않습니다.

resource "keenauth_environment_settings" "this" {
  default_zoneinfo      = "Europe/Istanbul"
  allowed_first_factors = ["passkey", "password", "social"]

  locales = {
    enabled = ["en", "tr"]
    default = "en"
  }

  session = {
    idle_timeout_s     = 86400
    absolute_timeout_s = 1209600
  }

  signup = {
    mode              = "open"
    email_domain_mode = "denylist"
    email_domains     = ["mailinator.com"]
  }
}

그룹

속성	제어 대상
`locales`	활성화된 언어와 기본 언어. 기본 언어는 반드시 활성화되어 있어야 합니다.
`default_zoneinfo`	기본 IANA 시간대.
`session`	초 단위의 유휴 및 절대 시간 제한, 동시 세션 제한과 제한에 도달했을 때의 동작, 이상 징후 시 동작. 유휴 시간 제한은 절대 시간 제한보다 클 수 없습니다.
`signup`	가입 모드와 이메일 도메인 허용 목록 또는 차단 목록. 도메인은 소문자로 작성하고, 국제화 이름은 A-레이블(`xn--…`)로 작성하세요.
`security_notifications`	마스터 스위치와 알림 이메일을 보내는 이벤트.
`account_recovery`	복구 모드, 대기 시간(시간 단위), 복구가 비활성화되었을 때 표시되는 지원 링크.
`mfa`	두 번째 인증 요소로서의 이메일과 그 보증 수준, TOTP 발급자 레이블, 복구 코드와 그 개수.
`frontchannel_logout_enabled`	OpenID Connect Front-Channel Logout.
`allowed_first_factors`	환경에서 허용된 첫 번째 인증 요소. 애플리케이션 및 조직 정책은 이 집합을 좁힐 수만 있습니다.

안전한 변경

업데이트는 변경된 필드만 If-Match와 함께 JSON 병합 패치로 보냅니다. 계획을 세운 뒤 누군가 설정을 바꾸었다면 API는 412를 반환하고 아무것도 바뀌지 않습니다. plan을 다시 실행하세요.
대시보드에서 한 변경은 다음 plan에서 드리프트로 나타나며, 관리하는 속성에 대해 apply가 이를 되돌립니다.
정책을 강화하면(세션 단축, 세션 제한 하향, 가입이나 복구 강화, 첫 번째 인증 요소 제거) 새 세션과 로그인에 즉시 적용됩니다. 기존 세션은 수명이 끝날 때까지 유지됩니다.

가져오기

tofu import keenauth_environment_settings.this environment-settings