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

# 개발자 허브

> 하나의 워크스페이스에서 Living Security Public API의 서비스 계정, API 키, 요청 로그를 관리합니다.

개발자 허브는 조직의 Public API 액세스를 운영하는 워크스페이스입니다. 대시보드에서 **설정 → 연동 및 개발자 → 개발자 허브** 경로로 이동하여 사용할 수 있으며, 서비스 계정, 서비스 계정이 보유한 API 키, 해당 키에서 생성되는 요청 로그라는 세 가지 항목을 한곳에서 관리할 수 있습니다.

<Note>
  개발자 허브가 표시되지 않는 경우 조직 관리자에게 액세스 권한 확인을 요청하거나 Living Security 지원팀에 문의하시기 바랍니다.
</Note>

API를 처음 사용하신다면 먼저 [인증](/ko/developers/v1/authentication)에서 API 키 또는 OAuth 클라이언트 자격 증명 중 사용할 방식을 선택하십시오. API 키 연동에는 OAuth가 필요하지 않습니다. [퀵스타트](/ko/developers/v1/quickstart)에서는 서비스 계정을 생성하는 단계부터 API 키로 첫 번째 인증된 요청을 보내는 단계까지 안내합니다.

## 서비스 계정

서비스 계정은 연동을 위해 이름이 지정된 ID입니다. 서비스 계정은 API 키와 OAuth 클라이언트를 소유할 수 있습니다. 각 계정에는 부여된 고유한 권한 집합(예: `entity:read` 또는 `reporting:read`)이 있으며, 이 권한 집합은 해당 계정 아래에서 생성되는 모든 자격 증명의 상한선으로 작동합니다. 연동마다 계정을 하나씩 생성하고, 계정 단위로 사용 또는 사용 안 함을 설정하며, 권한은 언제든지 수정할 수 있습니다.

## API 키

API 키는 Public API에 대한 요청을 인증합니다. 키는 서비스 계정의 세부 정보 페이지에서 생성하며, 항상 해당 계정 권한의 하위 집합으로 범위가 제한됩니다. 모든 키에는 `ak_`로 시작하는 식별자와 `lsk_live_`로 시작하는 시크릿이 있으며, 시크릿은 생성 또는 교체 시 **한 번만** 표시됩니다. 만료 기한은 필수이고, 교체 시에는 중복 적용 기간이 제공되어 다운타임 없이 배포를 순차적으로 전환할 수 있으며, 폐기는 즉시 적용됩니다. 키는 조직의 리전별 `/v1` 호스트에서만 인증됩니다. [리전](/ko/developers/v1/regions)을 참조하십시오.

## 요청 로그

**요청 로그** 탭에는 조직의 Public API 트래픽이 표시됩니다. 최근 24시간 동안의 요청 수, 오류율, 속도 제한이 적용된 요청과 함께 개별 요청을 검색할 수 있는 로그를 확인할 수 있습니다. 서비스 계정, API 키, 메서드, 상태 클래스, 결정 또는 기간별로 필터링하거나, API 응답에서 반환된 `Request-Id`를 조회하여 해당 요청이 어떻게 처리되었는지 정확히 추적할 수 있습니다.

## 가이드

<CardGroup cols={2}>
  <Card title="인증" href="/ko/developers/v1/authentication">
    API 키와 OAuth 중 적합한 방식을 선택하고 서비스 계정 ID를 이해합니다.
  </Card>

  <Card title="서비스 계정" href="/ko/developers/developer-hub/service-accounts">
    워크로드별 ID를 설계하고 수명 주기를 관리합니다.
  </Card>

  <Card title="API 키" href="/ko/developers/developer-hub/api-keys">
    자격 증명을 안전하게 생성, 범위 지정, 교체 및 폐기합니다.
  </Card>

  <Card title="요청 로그" href="/ko/developers/developer-hub/request-logs">
    트래픽을 추적하고, 자격 증명별로 필터링하며, 요청 ID로 문제를 디버깅합니다.
  </Card>

  <Card title="API 퀵스타트" href="/ko/developers/v1/quickstart">
    처음부터 첫 번째 인증된 요청까지 안내합니다.
  </Card>

  <Card title="Power BI" href="/ko/developers/v1/powerbi">
    Power BI를 `/v1`에 연결하고, 운영용 세분성과 보고용 세분성 중 하나를 선택하며, 안전하게 새로 고칩니다.
  </Card>
</CardGroup>


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