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

# 외부 연계

> OneS1ght에서 수신 채널을 만들고, GeoSpace 외부연계에 등록하여 태그 데이터 전송 경로를 구성합니다.

## 1) 수신 채널 추가 (OneS1ght)

태그 데이터를 받을 수신 채널을 만들고, 채널에 배정된 주소·포트를 확인합니다.
이 값은 이어지는 [2) 외부 연계 등록](#2-외부-연계-등록-geospace)의 통신 정보에 입력합니다.

OneS1ght([`console.ones1ght.com`](https://console.ones1ght.com))에 로그인합니다.<br />
OneS1ght 로그인이 처음인 경우 [시작하기(초대·로그인)](/quickstart)을 먼저 진행합니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/qFgPfkUC54TCn9Gv/images/geospace-tag/onesight-ds-list.png?fit=max&auto=format&n=qFgPfkUC54TCn9Gv&q=85&s=a06e2e83a50ebad753bbd804cb3d5464" alt="OneS1ght 데이터소스 목록 — 측위데이터 (태그) 카드가 표시된 화면" width="3020" height="788" data-path="images/geospace-tag/onesight-ds-list.png" />
</Frame>

1. OneS1ght 사이드바에서 \[데이터소스]로 이동합니다.

2. 데이터소스 목록에서 **측위데이터 (태그)** 카드의 \[열기]를 클릭합니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/qFgPfkUC54TCn9Gv/images/geospace-tag/onesight-ds-tag.png?fit=max&auto=format&n=qFgPfkUC54TCn9Gv&q=85&s=f31f602d05d100ef2755a263866b1138" alt="측위데이터 (태그) 화면 — 데이터 현황과 수신 채널 목록, 채널 추가 버튼" width="3012" height="1606" data-path="images/geospace-tag/onesight-ds-tag.png" />
</Frame>

3. 수신 채널 영역 우측 상단의 \[채널 추가]를 클릭합니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/qFgPfkUC54TCn9Gv/images/geospace-tag/onesight-ds-channel.png?fit=max&auto=format&n=qFgPfkUC54TCn9Gv&q=85&s=dd63b0a3a1bc78cddd6274bf0a59b6e3" alt="수신 채널을 만들었습니다 팝업 — 배정된 주소와 포트가 표시된 화면" width="3004" height="1596" data-path="images/geospace-tag/onesight-ds-channel.png" />
</Frame>

4. 채널이 생성되면 배정된 **주소 : 포트**가 표시됩니다. \[복사]를 클릭하여 값을 복사한 후 \[확인]을 클릭합니다.

5. 수신 채널 목록에서 해당 채널의 **수집** 토글을 ON으로 변경합니다. 토글이 켜지면 '수집 중'으로 표시됩니다.

<Danger>
  태그 데이터가 수집되려면 아래 두 가지가 모두 충족되어야 합니다.

  * OneS1ght: 수신 채널의 **수집** 토글이 ON('수집 중')
  * GeoSpace: [2) 외부 연계 등록](#2-외부-연계-등록-geospace)의 **통신 정보에 이 채널의 주소·포트가 등록**되고, 해당 연계의 **송신** 토글이 ON

  한쪽이라도 꺼져 있으면 데이터가 전송되지 않으며, 수신 채널의 수집 개수가 계속 0으로 표시됩니다.
</Danger>

<Info>
  수신 채널은 여러 개를 만들 수 있으며, 채널마다 서로 다른 포트가 배정됩니다.
  수신 채널 목록에서 각 채널의 수집 개수와 연결 상태를 확인할 수 있습니다.
</Info>

## 2) 외부 연계 등록 (GeoSpace)

<Frame>
  <img src="https://mintcdn.com/onecheck/qFgPfkUC54TCn9Gv/images/geospace-tag/tag-home.png?fit=max&auto=format&n=qFgPfkUC54TCn9Gv&q=85&s=2bbce6c8568a8f6d83215d184e35d091" alt="GeoSpace 첫 화면 — 프로젝트 선택과 객체 관리 메뉴" width="1907" height="961" data-path="images/geospace-tag/tag-home.png" />
</Frame>

1. GeoSpace 로그인 후 첫 화면에서 프로젝트를 확인합니다.

2. \[객체 관리]를 클릭하면 스페이스 관리 화면이 표시됩니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/qFgPfkUC54TCn9Gv/images/geospace-tag/tag-menu.png?fit=max&auto=format&n=qFgPfkUC54TCn9Gv&q=85&s=db9297d32658bdd581a360db7dde09aa" alt="객체 관리 화면 — 좌측 사이드바에서 외부연계 메뉴로 이동" width="1913" height="963" data-path="images/geospace-tag/tag-menu.png" />
</Frame>

3. 좌측 사이드바에서 외부연계 아이콘에 마우스를 올립니다.

4. 표시되는 \[외부연계]를 클릭합니다.

포맷 등록 → 통신 정보 입력 → 송신 순서로 진행합니다.<br />
포맷을 먼저 등록해야 통신 정보에서 해당 포맷을 선택할 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/qFgPfkUC54TCn9Gv/images/geospace-tag/tag-external-link.png?fit=max&auto=format&n=qFgPfkUC54TCn9Gv&q=85&s=1b302598f0282eabdc9a1bf58677bfad" alt="외부연계 화면 — 연계 추가, 포맷 추가, 통신 정보 입력, 송신 토글" width="1836" height="925" data-path="images/geospace-tag/tag-external-link.png" />
</Frame>

5. **연계 추가**
   * 외부연계 목록 상단의 \[+]를 클릭하여 새 연계를 추가합니다.

6. **포맷 추가 열기**
   * 포맷 정보 영역의 \[+]를 클릭하면 아래 포맷 추가 입력 영역이 표시됩니다.

7. **포맷 정보 입력**

| 항목    | 입력 값                                                                                                                 |
| ----- | -------------------------------------------------------------------------------------------------------------------- |
| 이름    | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>포맷을 식별할 이름 입력</span></span>     |
| 버전    | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>`1` 선택</span></span>            |
| 정보 유형 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>`TAG_LOCATION` 선택</span></span> |
| 유형    | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>`JSON` 선택</span></span>         |

8. **포맷 저장**
   * 포맷 추가의 저장 버튼을 클릭합니다. 저장된 포맷이 포맷 정보 목록에 표시됩니다.

9. **통신 정보 입력**

| 항목       | 입력 값                                                                                                                                                                                                                                      |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 이름       | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>연계를 식별할 이름 입력</span></span>                                                                                                                          |
| 포맷       | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>⑧에서 저장한 포맷 선택</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>포맷 정보 목록에 있는 포맷만 선택 가능</span></span> |
| 프로토콜     | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>`UDP` 선택</span></span>                                                                                                                               |
| 아이피 · 포트 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>[1) 수신 채널 추가](#1-수신-채널-추가-ones1ght)에서 복사한 주소와 포트 입력</span></span>                                                                                    |
| 사용여부     | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>ON으로 변경한 후 통신 정보의 저장 버튼 클릭</span></span>                                                                                                             |

10. **송신**

* 외부연계 목록에서 등록한 항목의 송신 토글을 ON으로 변경합니다.

<Danger>
  통신 정보에 입력하는 아이피·포트 값은 OneS1ght에서 수신 채널을 추가하면 배정됩니다.
  외부 연계를 등록하기 전에 [1) 수신 채널 추가](#1-수신-채널-추가-ones1ght)를 먼저 진행하십시오.
  임의로 지정하지 말고 안내받은 값을 입력하십시오.
  안내받지 못한 경우 <span className="support-mail">[onesight-support@onecheck.co.kr](mailto:onesight-support@onecheck.co.kr)</span> 로 문의하십시오.
</Danger>

<Danger>
  송신 토글을 켜도 OneS1ght 쪽 수신 채널의 **수집** 토글이 꺼져 있으면 데이터가 수집되지 않습니다.
  [1) 수신 채널 추가](#1-수신-채널-추가-ones1ght)에서 해당 채널의 수집 토글이 '수집 중'인지 확인하십시오.
</Danger>

<Info>
  송신이 켜지면 태그 이벤트가 발생할 때마다 등록된 서버로 데이터가 전송됩니다.
</Info>

## 3) API 키 확인 (GeoSpace)

<Frame>
  <img src="https://mintcdn.com/onecheck/qFgPfkUC54TCn9Gv/images/geospace-tag/tag-api-key.png?fit=max&auto=format&n=qFgPfkUC54TCn9Gv&q=85&s=9f13be1ea6d5f1d3e5b8e43de0eac626" alt="GeoSpace 계정 정보 — API 키 복사" width="1914" height="948" data-path="images/geospace-tag/tag-api-key.png" />
</Frame>

1. 화면 우측 상단의 계정 아이콘을 클릭하면 계정 정보가 표시됩니다.

2. API 키 항목의 복사 버튼을 클릭하여 키 값을 복사합니다.

복사한 키는 [측위 연결](/geospace-tag/connect)에서 입력합니다.

## 체크리스트

<Note>
  아래 항목이 모두 확인되면 다음 단계로 진행할 수 있습니다.

  | # | 확인 항목                                             |  확인 |
  | - | ------------------------------------------------- | :-: |
  | 1 | 수신 채널을 추가하고 배정된 주소·포트를 확인했습니다.                    |  ☐  |
  | 2 | 수신 채널의 수집 토글이 '수집 중'으로 표시됩니다.                     |  ☐  |
  | 3 | 외부연계 통신 정보에 수신 채널의 주소·포트를 입력하고 사용여부를 ON으로 저장했습니다. |  ☐  |
  | 4 | 외부연계 목록에서 해당 항목의 송신 토글을 ON으로 변경했습니다.              |  ☐  |
  | 5 | 계정 정보에서 API 키를 복사했습니다.                            |  ☐  |
</Note>