> For the complete documentation index, see [llms.txt](https://orbitron.gitbook.io/orbitron-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitron.gitbook.io/orbitron-docs/documentation/ko/user-guide/authentication.md).

# 인증

Orbitron은 **기능에 액세스하기 전에 사용자 인증이 필요합니다**. **플랫폼에 초대받은** 사용자만 로그인할 수 있습니다.

> 아직 초대받지 않았다면 **AlphaCode 관리자** 또는 **조직의 Orbitron 관리자**에게 액세스를 요청하세요.

***

### 🚪 로그인 요구사항

* Orbitron을 사용하려면 **로그인해야 합니다**.
* 처음으로 Orbitron을 실행하고 로그인하지 않은 경우 **인증 다이얼로그가 자동으로 나타납니다**.
* 언제든지 **수동으로 로그인 다이얼로그를 열** 수도 있습니다:
  * 명령어 입력:

    ```bash
    /login
    ```
  * 또는 단축키 사용:

    ```
    Ctrl + A
    ```

***

### 🌐 웹 브라우저를 통한 로그인

다음을 선택하여 브라우저를 사용해 Orbitron에 로그인할 수 있습니다:

<div align="left"><figure><img src="/files/a0GBwRy9rTJaLzAeVy6f" alt="" width="563"><figcaption></figcaption></figure></div>

이렇게 하면 기본 웹 브라우저가 실행되고 인증 과정을 안내합니다.

***

### 🔑 토큰 입력을 통한 로그인

또는 액세스 토큰을 입력하여 수동으로 인증할 수 있습니다:

**단계:**

1. [Orbitron Web](https://orbitron.megaone.com/ko/dashboard) 인터페이스를 방문하여 로그인합니다.
2. 상단의 **설정** 메뉴로 이동합니다.
3. **"인증 토큰"** 탭을 선택합니다.
4. `액세스 토큰`과 `새로고침 토큰`을 복사합니다.

<div align="left"><figure><img src="/files/UA2HiPvCltRaplOIoqUJ" alt="" width="563"><figcaption></figcaption></figure></div>

5. 요청시 Orbitron CLI 프롬프트에 붙여넣습니다.

<div align="left"><figure><img src="/files/Y9qYW2NFsIrADgOYPQtS" alt="" width="563"><figcaption></figcaption></figure></div>

> 💡 터미널이 브라우저 로그인을 지원하지 않거나 헤드리스 환경에서 작업하는 경우 이 방법을 사용하세요.

***

#### ✅ 요약

| 단계       | 작업                        |
| -------- | ------------------------- |
| 🔐 인증    | 브라우저 로그인 또는 토큰 기반 로그인     |
| 🔑 토큰 위치 | Orbitron Web → 설정 → 인증 토큰 |

***

### 🔧 문제 해결

#### Cloudflare WARP로 인한 인증 실패

> 💡 회사나 조직에서 WARP를 사용하는 환경인 경우 발생할 수 있는 문제입니다.

**문제 증상**

* 로그인 시 인증 오류 발생
* 브라우저 로그인이 실패하거나 무한 로딩

**원인**

* Cloudflare WARP가 OAuth 인증에 필요한 도메인을 차단하여 발생

**해결 방법**

1. Cloudflare Zero Trust 관리자에게 문의
2. Split Tunneling의 **Exclude 목록**에 다음 도메인 추가 요청:
   * `oauth2.googleapis.com`
   * `supabase.co`
3. 설정 적용 후 Orbitron 재시작