# keenauth_api_key

`keenauth_api_key` 리소스는 관리 API 키를 추적하고, 삭제할 때 키를 폐기합니다.

## 프로바이더가 키를 만들지 않는 이유

API는 키를 생성하는 응답에서만 원본 키를 한 번 반환합니다. 프로바이더가 만든 키는 잃어버리거나 상태(state) 파일에 기록해야 합니다. 그래서 프로바이더는 API 키를 만들지 않으며, 원본 키를 보거나 저장하지 않습니다. 키를 만드는 플랜은 플랜 단계에서 실패합니다.

## CLI로 만든 뒤 가져오기

1. `keenauth api-keys create`로 키를 만드세요.
2. 원본 키를 Vault나 클라우드 시크릿 관리자 같은 시크릿 관리 도구에 저장하세요.
3. ID로 키를 가져오세요:

```terraform
import {
  to = keenauth_api_key.ci
  id = "key_01j9zq3v8c5m2x7k4t6r1n0b3d"
}

resource "keenauth_api_key" "ci" {
  name        = "ci"
  type        = "restricted"
  permissions = ["applications:read", "users:read"]
  expires_at  = "2027-01-31T00:00:00Z"
}
```

원본 키를 가져오기 ID로 절대 전달하지 마세요.

## 키는 변경할 수 없습니다

모든 속성은 선택 사항입니다. 속성을 설정하면 키와 일치해야 합니다. `expires_at`은 UTC로, `Z`를 붙이고 초 단위로 끝나게 작성하세요. 키를 변경하려면 CLI로 새 키를 만들거나(`keenauth api-keys rotate`로 교체), 새 키를 가져온 뒤 기존 리소스를 제거하세요.

## 시간이 지나면 일어나는 일

- `tofu destroy`(또는 리소스 제거)는 키를 폐기합니다.
- 폐기되었거나 만료된 키는 다음 새로 고침 때 상태에서 제거됩니다.
- 상태에는 원본 키, 마지막 네 글자, 마지막 사용 IP 접두사, 생성자 정보가 포함되지 않습니다.