> ## 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가 사용하는 단일 SDK 키를 발급·폐기하고 접근 범위를 설정하는 화면입니다.

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

## 모바일 SDK 키란?

**모바일 SDK 키 관리**는 고객 앱에 탑재한 OneS1ght SDK가 사용하는 **API 키**를 발급·폐기하는 화면입니다.
키는 `ock_sdk_...` 형식의 **단일 키**이며, 목록에서는 마스킹되어 표시됩니다. 개발/운영 등 환경 구분은 없습니다.
실제 앱 연동 방법은 [모바일 SDK](/sdk/overview) 섹션의 연동 가이드를 참고하세요.

## 접근 범위 (Scope)

키를 발급할 때 접근 범위(scope)를 선택합니다.

| 범위                    | 설명                                                 | 배지    |
| --------------------- | -------------------------------------------------- | ----- |
| 전체 접근 (모든 측위 연결에서 측정) | 모든 측위 연결(별칭)에서 측정합니다. (`scope_mode: all`)          | 전체    |
| 특정 별칭에서만 측정           | 선택한 측위 연결(별칭)에서만 측정합니다. (`scope_mode: restricted`) | 별칭 N개 |

<Note>
  **측위 연결(별칭)** 은 측위 관리 화면에서 관리합니다. [측위정보 연동](/locator/positioning-data)을 참고하세요.
</Note>

## 키 발급

<Steps>
  <Step title="API 키 발급">
    **API 키 발급**을 누릅니다.
  </Step>

  <Step title="접근 범위 선택">
    **전체 접근** 또는 **특정 별칭에서만 측정**을 선택합니다. 특정 별칭을 선택하면 측정을 허용할 측위 연결(별칭)을 지정합니다.
  </Step>

  <Step title="키 1회 노출 · 복사">
    발급 직후 전체 키 값이 **딱 한 번만** 표시됩니다. 이때 복사해 안전한 곳에 보관하세요. 창을 닫으면 전체 값을 다시 확인할 수 없습니다.
  </Step>

  <Step title="앱에 적용">
    복사한 키를 SDK에 설정합니다. 자세한 방법은 [모바일 SDK 연동 가이드](/sdk/overview)를 참고하세요.
  </Step>
</Steps>

<Warning>
  발급된 키의 전체 값은 발급 직후 한 번만 표시되며, 이후에는 마스킹되어 다시 확인할 수 없습니다. 반드시 안전하게 보관하세요.
</Warning>

## 키 관리

| 항목    | 내용                           |
| ----- | ---------------------------- |
| 키 형식  | `ock_sdk_...` (목록에서는 마스킹 표시) |
| 접근 범위 | 전체 / 별칭 N개                   |
| 상태    | 활성 / 폐기됨                     |
| 발급일   | 키가 발급된 날짜                    |

### 범위 편집

발급 이후에도 **범위 편집**으로 접근 범위를 변경할 수 있습니다(전체 ↔ 특정 별칭, 허용 별칭 조정).

### 폐기

활성 키는 **폐기**할 수 있습니다. 폐기하면 해당 키는 **즉시 사용할 수 없으며 되돌릴 수 없습니다**(확인 모달을 거칩니다).

## 연동 가이드

<Card title="모바일 SDK 연동 가이드" icon="mobile-screen" href="/sdk/overview">
  발급한 SDK 키로 고객 앱에서 측위를 연동하는 방법을 안내합니다.
</Card>

## 관련 문서

<CardGroup cols={2}>
  <Card title="측위정보 연동" icon="plug" href="/locator/positioning-data">
    측위 연결(별칭)과 실제 도면을 연동합니다.
  </Card>

  <Card title="구역 관리" icon="draw-polygon" href="/locator/areas">
    도면 위에서 존/포인트를 편집합니다.
  </Card>
</CardGroup>