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

# 전역 하네스

> 하네스를 운영 시스템에 등록하고 전체 또는 특정 스페이스에 공유합니다.

<Card>
  운영 시스템에서 하네스를 한 번 등록하고 적용 범위를 설정하면, 여러 스페이스에서 동일한 하네스 실행 환경을 사용할 수 있습니다. 구성원은 하네스 접속 주소나 인증 정보를 직접 설정하지 않아도 전역 하네스를 에이전트와 봇의 실행 환경으로 활용할 수 있습니다.
</Card>

<AccordionGroup>
  <Accordion title="운영 시스템 접속 방법">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/global-model01.png" />
    </Frame>

    대시보드 우측 상단의 프로필 아이콘을 클릭하면 운영 시스템에 접속할 수 있습니다.

    <Tip>
      [운영 시스템 관리자 권한을 부여](/ko/enterprise/user-management#관리자-권한-부여)받은 사용자 계정으로만 접속 가능합니다.
    </Tip>
  </Accordion>
</AccordionGroup>

## 전역 하네스 추가

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/global-harness01.png" />
</Frame>

> 운영 시스템의 에이전트・봇 페이지에서 하네스 연결 `추가하기`를 클릭하고 아래의 설정값을 입력하면 하네스가 등록됩니다.

| 설정 항목             | 설명                                                     |
| :---------------- | :----------------------------------------------------- |
| **이름**            | 하네스 연결의 고유 식별 이름                                       |
| **하네스 종류**        | 연결할 하네스 서비스의 종류를 선택 (예: Codex CLI, OpenClaw, Hermes 등) |
| **Gateway URL**   | 연결할 하네스 서버의 접속 URL                                     |
| **Wrapper Token** | 하네스 인증에 필요한 Wrapper Token 또는 Gateway Token             |
| **Session ID**    | 고정 세션 ID, 입력하지 않으면 Porter 스레드별로 세션 ID가 자동 생성           |
| **Default Model** | 하네스에서 기본으로 사용할 모델 (선택 사항)                              |

## 적용 범위 설정

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/global-harness02.png" />
</Frame>

> 추가한 하네스의 설정 창에서 적용 범위 탭을 선택하면 `전체 적용`, `화이트리스트`, `블랙리스트` 방식으로 사용 가능한 스페이스를 선택적으로 설정할 수 있습니다.