> ## 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.

# 모바일 SDK 키 관리

> 고객 앱의 OneS1ght SDK가 사용하는 API 키를 발급·확인·폐기하는 화면입니다.

> [!NOTE]
>
> 이 페이지는 **관리자(Manager)** 이상만 접근할 수 있습니다(권한 `manage` — 최고 관리자(Owner) 또는 관리자).

## 모바일 SDK 키란?

콘솔 사이드바의 **모바일 SDK**는 고객 앱에 탑재한 OneS1ght SDK가 사용하는 **API 키**를 발급·관리하는 화면입니다.
키는 `ock_sdk_...` 형식이며, 목록에서는 앞뒤 일부만 보이도록 마스킹되어 표시됩니다.
실제 앱 연동 방법은 [모바일 SDK 연동 가이드](/developers/sdk/overview)를 참고하세요.

화면 상단에서 **SDK 연결 디바이스** 수(활성화된 운영 API 키 기준)를 확인할 수 있고,
키 목록은 **사용중 / 폐기** 탭으로 나뉩니다.

## 키 발급

아래 그림의 번호 순서대로 진행합니다.

![모바일 SDK 키 발급 화면 — 번호 순서대로 진행](https://mintcdn.com/onecheck/qFgPfkUC54TCn9Gv/images/geospace/sdk-key-issue.png?fit=max\&auto=format\&n=qFgPfkUC54TCn9Gv\&q=85\&s=6a7044215ec327a4b37e8ac0e386fb9a)

**1. 모바일 SDK 화면 열기**

1. 콘솔 사이드바에서 **모바일 SDK**로 이동합니다.
2. 우측 상단 **\[API 키 발급]** 을 누릅니다.

**2. 이름 · 실행 환경 지정 후 발급**

3. **키 이름** — 비워두면 자동으로 지정됩니다 (예: `production#12`).
4. **실행 환경** — 배포용 앱이면 **Production (운영)** 을 선택합니다.
5. **\[API 키 발급]** 을 누르면 목록 맨 위에 추가됩니다.

## 키 확인 · 수정 · 폐기

목록에서 키의 **\[키 설정]** 을 누르면 전체 값을 확인하고, 이름·실행 환경을 바꾸거나 폐기할 수 있습니다.

![모바일 SDK 키 설정 화면 — 값 확인 · 이름/환경 변경 · 폐기](https://mintcdn.com/onecheck/qFgPfkUC54TCn9Gv/images/geospace/sdk-key-manage.png?fit=max\&auto=format\&n=qFgPfkUC54TCn9Gv\&q=85\&s=f6b197a4093c7d642160ccf7e5ddeb5d)

| 항목 | 내용 |
| - | - |
| 키 값 | `ock_sdk_...` — **언제든 다시 확인·복사**할 수 있습니다 |
| 키 이름 | 자유롭게 변경할 수 있습니다 (비우면 자동 지정) |
| 실행 환경 | Production (운영) 등 — 발급 후에도 변경할 수 있습니다 |
| 폐기 | **\[폐기]** 를 누르면 그 키는 즉시 사용할 수 없습니다 (되돌릴 수 없음) |

변경한 내용은 **\[저장]** 을 눌러야 반영됩니다.

> [!NOTE]
>
> **예전에 발급된 일부 키는 전체 값을 다시 볼 수 없습니다.** 키 값을 보관하지 않던 시기에 만들어진 키로,
> 화면에도 "값이 필요하면 새 키를 발급해 주세요"라고 안내됩니다. 이 경우 새로 발급해 쓰면 됩니다.

## 목록에서 보이는 정보

| 열 | 설명 |
| - | - |
| 키 이름 | 발급 시 지정한 이름 (미지정 시 자동) · 아래에 마스킹된 키 값 |
| 실행 환경 | Production (운영) 등 |
| 상태 | 활성 / 폐기됨 |
| 발급일 | 키를 발급한 날짜 |
| 최근 사용일 | 이 키로 마지막 요청이 들어온 날짜 (한 번도 안 썼으면 `-`) |
| 관리 | **\[키 설정]** — 값 확인 · 이름/환경 변경 · 폐기 |

> [!TIP]
>
> **최근 사용일**을 보면 실제로 쓰이는 키와 방치된 키를 구분할 수 있습니다.
> 쓰지 않는 키는 폐기해 두는 것이 안전합니다.

## 연동 가이드

> **[모바일 SDK 연동 가이드](/developers/sdk/overview)**
>
> 발급한 SDK 키로 고객 앱에서 측위를 연동하는 방법을 안내합니다.

## 관련 문서

> **[측위 연결 (설정)](/console/positioning-data)**
>
> GeoSpace 파트너 키를 등록해 실제 도면과 연동합니다.

> **[구역 관리](/console/areas)**
>
> 도면 위에서 존/포인트를 편집합니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.