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

# API 키

> Living Security Public API에 대한 요청을 인증하는 자격 증명을 생성, 교체 및 해지합니다.

API 키는 `/v1` Public API에 대한 요청을 인증합니다. 모든 키는 [서비스 계정](/ko/developers/developer-hub/service-accounts)에 속하며, 해당 계정의 상세 페이지에서 [Developer Hub](/ko/developers/developer-hub/overview)를 통해 생성됩니다.

비밀 값을 안전하게 저장하고 교체하는 것으로 요구 사항이 충족되는 경우, 비공개 백엔드 연동에는 범위가 지정된 API 키를 사용하십시오. OAuth 클라이언트나 토큰 교환이 필요하지 않습니다. 조직에서 수명이 짧은 OAuth 액세스 토큰을 요구하는 경우에는 [인증](/ko/developers/v1/authentication)을 참조하십시오.

## 키의 구성

* **식별자** — `ak_`로 시작합니다. 티켓, 로그, 구성에서 참조해도 안전하며, 그 자체로는 아무 권한도 부여하지 않습니다.
* **비밀 값** — `lsk_live_`로 시작합니다. 연동이 제시하는 자격 증명입니다. 생성 또는 교체 시 **한 번만** 표시되며, 이후에는 다시 확인할 수 없습니다. 키 목록에는 마지막 네 자리(예: `lsk_live_…xQc4`)만 표시되므로 목록의 행을 호출자가 보유한 자격 증명과 대조할 수 있습니다.
* **권한** — 키를 소유한 서비스 계정 권한의 하위 집합이며, 생성 시 선택합니다. 키는 계정이 허용하는 범위를 넘어서는 작업을 수행할 수 없습니다.
* **만료** — 필수입니다. 모든 키에는 만료일이 있습니다.

<Warning>
  비밀 값은 표시되는 즉시 비밀 관리자에 저장하십시오. 버전 관리 시스템에 커밋하거나, 클라이언트 측 코드에 포함하거나, 채팅으로 공유하지 마십시오. 비밀 값을 가진 사람은 누구나 해당 키의 권한으로 작업을 수행할 수 있습니다.
</Warning>

## 키 생성

서비스 계정의 상세 페이지에서 네 단계를 거쳐 키를 생성합니다. 이름을 지정하고, 이 키에 필요한 권한을 선택하고, 만료 기간(30일, 90일, 365일 또는 최대 1년까지의 사용자 지정 기간)을 선택한 다음 검토합니다. 비밀 값은 완료 시 한 번만 표시됩니다.

계정에서 더 많은 권한을 허용하더라도, 각 키의 범위는 호출자에게 필요한 최소한의 권한 집합으로 지정하십시오. 키가 유출될 경우 해당 키의 권한이 피해 범위가 됩니다.

## 중단 없이 교체

교체하면 새 비밀 값이 발급되고 중첩 기간(1시간, 24시간 또는 7일)이 시작되며, 이 기간 동안에는 **이전 비밀 값도 계속 작동합니다**. 따라서 새 비밀 값을 원하는 속도로 각 배포 환경에 적용할 수 있습니다.

<Steps>
  <Step title="키 교체">
    가장 느린 배포 경로까지 포함할 수 있는 중첩 기간을 선택하십시오. 새 비밀 값은 한 번만 표시되므로 즉시 저장하십시오.
  </Step>

  <Step title="연동 업데이트">
    이전 비밀 값이 구성된 모든 위치에서 교체하십시오. 중첩 기간이 끝날 때까지 키의 상태는 중첩 중으로 표시됩니다.
  </Step>

  <Step title="기간이 종료되기 전에 확인">
    [요청 로그](/ko/developers/developer-hub/request-logs)를 사용하여 트래픽이 새 비밀 값으로 전환되었는지 확인하십시오. 중첩 기간이 끝나면 이전 비밀 값은 더 이상 인증되지 않습니다.
  </Step>
</Steps>

만료 전에 미리 교체하는 것도 좋습니다. 만료일이 가까운 키는 키 목록에서 만료 예정으로 표시됩니다. 만료된 키는 더 이상 인증되지 않으며, 해당 키로 보낸 요청은 코드 [`credential_expired`](/ko/developers/v1/errors/credential_expired)와 함께 `401`를 반환합니다.

## 즉시 해지

해지는 즉시 적용되며 영구적입니다. 중첩 기간이 없고 되돌릴 수도 없습니다. 비밀 값이 노출되었다고 의심되는 즉시 키를 해지하십시오. 정상적인 자격 증명을 교체하는 경우에는 해지 대신 교체하십시오.

해지된 키로 보낸 요청은 코드 [`credential_revoked`](/ko/developers/v1/errors/credential_revoked)와 함께 `401`를 반환합니다. 연동이 보유한 모든 키를 한 번에 중지해야 하는 경우에는 해당 서비스 계정을 비활성화하십시오.


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