環境設定を取得する

GET /v1/environment-settings · 権限 environment-settings:read

環境の言語、タイムゾーン、セッション、サインアップ、セキュリティ通知、アカウント回復、多要素認証、Front-Channel Logout、許可された第一要素の設定を返します (環境ごとに 1 つのリソース)。設定が一度も保存されていない場合は、既定値が ETag: "0" と updated_at: null とともに返されます。ETag レスポンスヘッダーには、PATCH で If-Match として送信するバージョンが含まれます。期間は秒単位の整数です。

リクエスト

この操作にはパス、クエリ、ボディのフィールドはありません。環境は認証情報から決まります。

レスポンス

設定と ETag ヘッダーを含む 200 OK。

allowed_first_factors は、環境で許可された第一要素を一覧にし、常に次の順序で返されます: password、passkey、email_otp、magic_link、sms_otp、social、enterprise。既定値は ["password", "passkey", "social", "enterprise"] です。email_otp、magic_link、sms_otp は、追加した場合にのみ有効になります。アプリケーションまたは組織のポリシーで許可できるのは、この集合の絞り込みのみです。

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

エラー

例

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