콘텐츠로 이동
EasterAdEasterAdDocs

인증

서버에서 API 키를 준비하고 아래 형식으로 호출합니다. 예제의 조직 ID는 첫 호출 준비에서 확인합니다.

1. 인증 헤더 전송 규약

섹션 제목: “1. 인증 헤더 전송 규약”

모든 API 요청의 HTTP Authorization 헤더에 Bearer 토큰 형태로 API 키를 전달합니다.

Authorization: Bearer ea_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_****************

cURL 호출 예시

섹션 제목: “cURL 호출 예시”
터미널 창
curl -X GET "https://www.easterad.com/api/core/organization/{organizationId}/balance" \
  -H "Authorization: Bearer ea_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_****************" \
  -H "Accept: application/json"

2. API 키 역할 지정하기

섹션 제목: “2. API 키 역할 지정하기”

API 키에 자동화 작업에 필요한 역할을 지정합니다.

flowchart LR
    A["API 키 (ea_...)"] --> B["할당된 역할 (예: Viewer, Finance)"]
    B --> C["리소스별 허용 액션 (조회, 생성, 수정 등)"]
  • 최소 권한 부여: 자동화 작업에 필요한 최소한의 권한(예: 잔액 모니터링에는 잔액 조회 권한만 포함된 커스텀 역할)을 부여합니다.
  • 권한 부족 시 대응: 호출하려는 엔드포인트의 요구 권한이 역할에 포함되어 있지 않으면 403 Forbidden이 반환됩니다. 권한 추가가 필요하면 조직 관리자에게 요청합니다. 상세 진단 방법은 오류 디버깅 가이드에서 확인합니다.

3. 인증 단계 에러 코드

섹션 제목: “3. 인증 단계 에러 코드”

응답의 code에 따라 인증 오류별 조치를 적용합니다.

4. 운영 환경 보안 체크리스트

섹션 제목: “4. 운영 환경 보안 체크리스트”

운영 환경에서 API 키를 안전하게 운용하기 위해 다음 사항을 확인합니다.

  • 환경 변수 주입: API 키는 서버의 비밀 관리 시스템(Vault, AWS Secrets Manager 등)이나 런타임 환경 변수에 보관하고 서버에서만 사용합니다.
  • 고정 공인 IP 허용 목록 적용: 운영 서버에서 사용하는 API 키에는 호출 서버의 고정 공인 IP 주소만 등록합니다.
  • 만료일 설정: 조직의 키 관리 정책에 따라 만료일과 교체 주기를 설정합니다.
  • 무중단 롤링 교체: 키를 교체할 때는 API 키 관리 가이드에 따라 신규 키를 먼저 발급하여 배포한 후 기존 키를 폐기합니다.

다음 단계

섹션 제목: “다음 단계”