# 공격 방어 설정 업데이트

`PATCH /v1/attack-protection` · 권한 `attack-protection:write`

JSON 병합 패치(`application/merge-patch+json`, RFC 7396)로 공격 방어 객체를 업데이트합니다. `If-Match`는 필수입니다. 없으면 `428`, 오래된 `ETag`이면 `412`가 반환됩니다. 아무것도 바꾸지 않는 패치는 아무것도 기록하지 않으며 `ETag`도 유지됩니다.

## 요청

| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| `If-Match` | 헤더 | 예 | 마지막으로 읽은 객체의 `ETag`. 없으면 `428`; 오래되었으면 `412`. |
| 본문 | 객체 | 예 | 병합 패치. 필드는 [공격 방어 설정 전체 교체](put.md)에 나열되어 있습니다. |

## 동작

- 섹션은 재귀적으로 병합됩니다. 변경하는 필드만 보내십시오.
- `null`은 필드 또는 섹션 전체를 제거하여 기본값으로 되돌립니다. `allowlist`와 `allowed_countries` 같은 목록은 통째로 교체됩니다.
- 병합된 객체는 `PUT` 본문과 똑같이 검사됩니다.

## 응답

[공격 방어 설정 조회](get.md)에서와 같은 객체와 새 `ETag`가 포함된 `200 OK`입니다.

## 오류

| HTTP | 코드 | 발생 시점 |
|---|---|---|
| 400 | `unknown_field` | 섹션 또는 필드가 객체에 없습니다. `errors[]`에 포인터가 나열됩니다. |
| 400 | `malformed_request` | 본문이 올바른 JSON이 아니거나 `If-Match` 헤더가 잘못되었습니다. |
| 401 | `unauthenticated` | 자격 증명이 없거나, 잘못되었거나, 폐기되었습니다. |
| 403 | `insufficient_permissions` | 자격 증명에 `attack-protection:write` 권한이 없습니다. |
| 403 | `plan_feature_unavailable` | `risk_policy.mode`가 `enforce`인데 요금제에 포함되지 않습니다. 본문에 `feature`와 `required_plan`이 포함됩니다. |
| 412 | `precondition_failed` | 읽은 후 객체가 변경되었습니다. 다시 읽고 재시도하십시오. |
| 413 | `payload_too_large` | 객체가 32 KiB보다 큽니다. |
| 422 | `validation_failed` | 병합된 객체에서 값의 타입이 잘못되었거나 범위를 벗어났거나, `block_threshold`가 `challenge_threshold`보다 크지 않습니다. `errors[]`에 포인터가 나열됩니다. |
| 422 | `below_security_floor` | 값이 보안 하한선보다 낮습니다. `errors[]`의 각 항목은 `detail`에 필드와 하한선을 적습니다. |
| 422 | `allowlist_range_too_broad` | 허용 목록 접두사가 IPv4는 /8, IPv6는 /32보다 넓습니다. |
| 428 | `precondition_required` | `If-Match`가 없습니다. |
| 429 | `rate_limited` | 요청 한도를 초과했습니다. `Retry-After` 시간 후에 다시 시도하십시오. |
| 503 | `service_unavailable` | 종속 서비스를 일시적으로 사용할 수 없습니다. `Retry-After` 시간 후에 다시 시도하십시오. |

오류 종류가 여러 개이면 가장 심각한 것만 다음 순서로 반환됩니다: `unknown_field`, `validation_failed`, `below_security_floor`, `allowlist_range_too_broad`, `plan_feature_unavailable`. 입력한 값은 응답에 다시 나타나지 않습니다.

## 예시

```bash
curl -X PATCH https://api.eu.keenauth.com/v1/attack-protection \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -H 'If-Match: "3f1c9a0b5d7e2a4c6b8d0e1f2a3b4c5d"' \
  -d '{"risk_policy": {"block_threshold": 9}, "sms_protection": null}'
```