/v1 Public API에 대한 요청을 인증합니다. 모든 키는 서비스 계정에 속하며, 해당 계정의 상세 페이지에서 Developer Hub를 통해 생성됩니다.
비밀 값을 안전하게 저장하고 교체하는 것으로 요구 사항이 충족되는 경우, 비공개 백엔드 연동에는 범위가 지정된 API 키를 사용하십시오. OAuth 클라이언트나 토큰 교환이 필요하지 않습니다. 조직에서 수명이 짧은 OAuth 액세스 토큰을 요구하는 경우에는 인증을 참조하십시오.
키의 구성
- 식별자 —
ak_로 시작합니다. 티켓, 로그, 구성에서 참조해도 안전하며, 그 자체로는 아무 권한도 부여하지 않습니다. - 비밀 값 —
lsk_live_로 시작합니다. 연동이 제시하는 자격 증명입니다. 생성 또는 교체 시 한 번만 표시되며, 이후에는 다시 확인할 수 없습니다. 키 목록에는 마지막 네 자리(예:lsk_live_…xQc4)만 표시되므로 목록의 행을 호출자가 보유한 자격 증명과 대조할 수 있습니다. - 권한 — 키를 소유한 서비스 계정 권한의 하위 집합이며, 생성 시 선택합니다. 키는 계정이 허용하는 범위를 넘어서는 작업을 수행할 수 없습니다.
- 만료 — 필수입니다. 모든 키에는 만료일이 있습니다.
키 생성
서비스 계정의 상세 페이지에서 네 단계를 거쳐 키를 생성합니다. 이름을 지정하고, 이 키에 필요한 권한을 선택하고, 만료 기간(30일, 90일, 365일 또는 최대 1년까지의 사용자 지정 기간)을 선택한 다음 검토합니다. 비밀 값은 완료 시 한 번만 표시됩니다. 계정에서 더 많은 권한을 허용하더라도, 각 키의 범위는 호출자에게 필요한 최소한의 권한 집합으로 지정하십시오. 키가 유출될 경우 해당 키의 권한이 피해 범위가 됩니다.중단 없이 교체
교체하면 새 비밀 값이 발급되고 중첩 기간(1시간, 24시간 또는 7일)이 시작되며, 이 기간 동안에는 이전 비밀 값도 계속 작동합니다. 따라서 새 비밀 값을 원하는 속도로 각 배포 환경에 적용할 수 있습니다.1
키 교체
가장 느린 배포 경로까지 포함할 수 있는 중첩 기간을 선택하십시오. 새 비밀 값은 한 번만 표시되므로 즉시 저장하십시오.
2
연동 업데이트
이전 비밀 값이 구성된 모든 위치에서 교체하십시오. 중첩 기간이 끝날 때까지 키의 상태는 중첩 중으로 표시됩니다.
3
기간이 종료되기 전에 확인
요청 로그를 사용하여 트래픽이 새 비밀 값으로 전환되었는지 확인하십시오. 중첩 기간이 끝나면 이전 비밀 값은 더 이상 인증되지 않습니다.
credential_expired와 함께 401를 반환합니다.
즉시 해지
해지는 즉시 적용되며 영구적입니다. 중첩 기간이 없고 되돌릴 수도 없습니다. 비밀 값이 노출되었다고 의심되는 즉시 키를 해지하십시오. 정상적인 자격 증명을 교체하는 경우에는 해지 대신 교체하십시오. 해지된 키로 보낸 요청은 코드credential_revoked와 함께 401를 반환합니다. 연동이 보유한 모든 키를 한 번에 중지해야 하는 경우에는 해당 서비스 계정을 비활성화하십시오.