인증 - ARGOS Identity

API 키 인증

모든 Omni API 요청은 x-api-key 헤더로 인증합니다. 키는 프로젝트 단위로 발급되며, 그 키로는 해당 프로젝트에 속한 리소스만 다룰 수 있습니다.

curl "https://client-omni-api.argosidentity.com/v1/projects/{projectId}" \
  -H "x-api-key: your-api-key-here"

프로젝트 선택

Omni 대시보드에 로그인해 프로젝트 목록에서 프로젝트를 엽니다. 프로젝트를 만들면 API 키가 함께 발급됩니다.

프로젝트 관리 → API 키 탭

사이드바의 프로젝트 관리에서 API 키 탭을 엽니다. 키는 가려져 있으며 표시 또는 복사 버튼으로 확인합니다.

안전하게 보관

환경 변수나 시크릿 매니저에 저장하세요. 클라이언트 코드, 공개 저장소, 로그에 노출하지 마세요.

키가 노출됐다고 의심되면 같은 탭에서 재발급하세요. 재발급 즉시 이전 키는 무효화되고, 교체를 끝낼 때까지 API 호출은 401을 받습니다. 절차는 API 키를 참조하세요.

https://client-omni-api.argosidentity.com/v1

헤더	값	필수
`x-api-key`	프로젝트 API 키	모든 요청
`Content-Type`	`application/json` 또는 `multipart/form-data`(파일 업로드)	POST · PATCH

방화벽·프록시 환경에서는 client-omni-api.argosidentity.com의 HTTPS(443) 아웃바운드를 허용하세요.

{
  "code": "OMNI_4005",
  "message": "Invalid API key"
}

에러 본문 형식은 API 개요를 참조하세요.