# 인증

> Bearer API 키 인증, 키 관리, 키가 속하는 조직과 프로젝트를 설명합니다.

Source: https://kiln.bricksum.com/docs/ko/authentication

모든 요청은 `Authorization` 헤더에 API 키를 Bearer 토큰으로 담아 인증합니다. 키는 sk-bk-로 시작하며 하나의 조직에 속합니다. x-api-key 헤더도 받지만 요청에 Authorization 헤더가 없을 때만 읽습니다. Bearer 형식이 아닌 Authorization 헤더는 x-api-key로 넘어가지 않고 401로 거부합니다.

**header**
```http
Authorization: Bearer sk-bk-...
```

주의

API 키는 비밀 정보입니다. 키를 가진 사람은 누구나 크레딧을 소진할 수 있습니다. 커밋하거나 프런트엔드 코드에 넣거나 공유하지 마세요. 환경 변수에 저장하고, 노출되면 즉시 폐기하세요.

## 키 관리

[콘솔 → API 키](https://kiln.bricksum.com/app/keys)에서 키를 발급하고, 이름을 붙이고, 폐기합니다. 전체 시크릿은 발급할 때 한 번만 표시되며, 이후에는 마스킹된 값만 보입니다.

- 애플리케이션·환경(prod, staging, local)별로 키를 분리해 발급하세요.
- 노출이 의심되면 즉시 키를 폐기하세요. 폐기는 즉시 반영됩니다.
- 주기적으로 키를 교체하세요. 보유 가능한 키 수에는 제한이 없습니다.

## 조직과 프로젝트

각 키는 하나의 조직과 프로젝트에 속합니다. 사용량과 크레딧 차감은 해당 조직 기준으로 집계되므로 과금과 레이트 리밋도 조직 단위로 적용됩니다. 콘솔에서 활성 조직을 전환해 해당 조직의 키와 크레딧을 관리하세요. 역할·초대·프로젝트·키 한도·예산·크레딧은 [조직과 예산](https://kiln.bricksum.com/docs/ko/organizations) 페이지를 참고하세요.

요청이 거부되면 [에러](https://kiln.bricksum.com/docs/ko/errors) 페이지에서 401/403 상태 코드와 의미를 확인하세요.