> ## 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](/ja/sdk/overview)セクションの連携ガイドを参照してください。

## アクセス範囲（スコープ）

キーを発行する際に、アクセス範囲（スコープ）を選択します。

| 範囲                 | 説明                                              | バッジ  |
| ------------------ | ----------------------------------------------- | ---- |
| 全アクセス（すべての測位接続で測定） | すべての測位接続（別名）で測定します。（`scope_mode: all`）          | 全体   |
| 特定の別名でのみ測定         | 選択した測位接続（別名）でのみ測定します。（`scope_mode: restricted`） | 別名N件 |

<Note>
  **測位接続（別名）** は測位管理画面で管理します。[測位情報連携](/ja/locator/positioning-data)を参照してください。
</Note>

## キーの発行

<Steps>
  <Step title="APIキーを発行">
    **APIキーを発行**を押します。
  </Step>

  <Step title="アクセス範囲を選択">
    **全アクセス**または**特定の別名でのみ測定**を選択します。特定の別名を選ぶ場合は、測定を許可する測位接続（別名）を指定します。
  </Step>

  <Step title="1回限りのキーをコピー">
    キーの全体の値は、発行直後の**一度だけ**表示されます。今すぐコピーして安全な場所に保管してください。ウィンドウを閉じると全体の値を再確認できません。
  </Step>

  <Step title="アプリに設定">
    コピーしたキーをSDKに設定します。詳しくは[モバイルSDK連携ガイド](/ja/sdk/overview)を参照してください。
  </Step>
</Steps>

<Warning>
  発行されたキーの全体の値は、発行直後の一度だけ表示され、その後はマスキングされて再確認できません。必ず安全に保管してください。
</Warning>

## キーの管理

| 項目     | 内容                         |
| ------ | -------------------------- |
| キー形式   | `ock_sdk_...`（一覧ではマスキング表示） |
| アクセス範囲 | 全体 / 別名N件                  |
| 状態     | 有効 / 失効済み                  |
| 発行日    | キーが発行された日付                 |

### 範囲の編集

発行後も**範囲編集**でアクセス範囲を変更できます（全体 ↔ 特定の別名、許可する別名の調整）。

### 失効

有効なキーは**失効**できます。失効したキーは**直ちに使用できなくなり、元に戻せません**（確認モーダルを経由します）。

## 連携ガイド

<Card title="モバイルSDK連携ガイド" icon="mobile-screen" href="/ja/sdk/overview">
  発行したSDKキーで、アプリに測位を連携する方法を案内します。
</Card>

## 関連ドキュメント

<CardGroup cols={2}>
  <Card title="測位情報連携" icon="plug" href="/ja/locator/positioning-data">
    測位接続（別名）と実際の図面を連携します。
  </Card>

  <Card title="エリア管理" icon="draw-polygon" href="/ja/locator/areas">
    図面上でゾーン/ポイントを編集します。
  </Card>
</CardGroup>