> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 인증

> API 키를 사용하여 ARGOS Omni API에 인증하는 방법을 알아보세요.

## API 키 인증

모든 Omni API 요청은 `x-api-key` 헤더를 통한 인증이 필요합니다.

```bash theme={null}
curl -X GET "http://client-omni-api.argosidentity.com/v1/projects/{projectId}" \
  -H "x-api-key: your-api-key-here"
```

## API 키 발급 방법

<Steps>
  <Step title="Omni 대시보드 로그인">
    지정된 URL에서 Omni 대시보드에 접속합니다.
  </Step>

  <Step title="프로젝트 설정으로 이동">
    프로젝트를 선택하고 설정 페이지로 이동합니다.
  </Step>

  <Step title="API 키 복사">
    프로젝트 설정에 표시된 API 키를 복사하여 안전하게 보관합니다.
  </Step>
</Steps>

<Warning>
  API 키를 클라이언트 측 코드, 공개 저장소, 로그에 노출하지 마세요. 환경 변수 또는 시크릿 매니저를 사용하여 안전하게 저장하세요.
</Warning>

## Base URL

모든 API 요청은 다음 Base URL로 전송됩니다:

```
http://client-omni-api.argosidentity.com/v1
```

<Info>
  방화벽·프록시로 네트워크를 제한하는 환경에서는 Omni API 호출을 위해 \*\*`client-omni-api.argosidentity.com`\*\*에 대한 아웃바운드 HTTP(**80**)를 허용하세요. HTTPS를 사용하는 경우 **443**도 허용하세요.
</Info>

## 요청 헤더

모든 요청에 다음 헤더를 포함해야 합니다:

| 헤더             | 값                                           | 필수                  |
| -------------- | ------------------------------------------- | ------------------- |
| `x-api-key`    | API 키 (UUID 형식)                             | 예                   |
| `Content-Type` | `application/json` 또는 `multipart/form-data` | 예 (POST/PATCH 요청 시) |

## 에러 응답

인증 실패 시 API는 다음을 반환합니다:

```json theme={null}
{
  "error": {
    "code": "UNAUTHORIZED",
    "status": 401,
    "message": "Invalid or missing API key"
  }
}
```