계정의 API 키를 관리하는 방법

Klaviyo 계정의 API 키에 액세스하고 관리하는 방법을 알아보세요.

비공개 API 키 생성 또는 복제에 대해 자세히 알아보려면 비공개 API 키를 생성하는 방법을 읽어 보세요.

공개 키와 비공개 API 키의 차이점

공개 API 키는 사이트 ID라고도 합니다. 짧은 영숫자 값입니다. 이 공개 키는 Klaviyo 계정의 고유 식별자이며, 계정당 1개만 있습니다. 웹사이트 코드에 공개 API 키를 포함할 수 있어요. 비공개 계정 데이터를 읽을 수 있는 권한을 부여하지는 않아요.

비공개 API 키를 사용하면 선택한 권한(범위)에 따라 목록과 같은 Klaviyo 계정의 데이터를 애플리케이션에서 읽거나 변경할 수 있어요. 비공개 API 키는 비밀번호처럼 취급하세요. 안전한 곳에 보관하고 절대 공개하지 마세요. Klaviyo 계정은 필요한 만큼 비공개 API 키를 생성할 수 있어요.

API 키가 노출된 경우 대처 방법

공개 API 키는 공개 웹사이트 코드에서 사용하도록 설계되어 있어요. 이 키로는 비공개 계정 데이터를 읽을 수는 없지만, 이벤트 및 프로필 업데이트와 같은 클라이언트 API를 통해 데이터를 제출하는 데 사용할 수 있어요.

비공개 API 키는 기밀로 유지해 주세요. 비공개 키를 가진 사람은 해당 권한을 사용해 고객 데이터를 보거나 수정할 수 있어요.

비공개 API 키가 노출된 경우 즉시 삭제한 다음 새 비공개 API 키를 생성하세요. 노출된 키를 사용하던 각 애플리케이션을 새 키를 사용하도록 업데이트해 주세요. 교체 키에는 애플리케이션에 필요한 권한만 부여하고, 애플리케이션마다 서로 다른 비공개 API 키를 사용하세요.

API 키 찾기

1. 왼쪽 하단에서 계정 이름을 클릭합니다.
2. 설정을 클릭해 주세요.
   

3. API 키 탭을 선택합니다.
4. 공개 API 키(사이트 ID)를 확인해 보세요.
5. 비공개 API 키에서 키 이름과 액세스 수준을 확인해 주세요. 마지막 4자리 문자로 키를 식별할 수 있지만, 여기서는 전체 키를 확인하거나 복사할 수 없어요.

키가 활성 탭에 없으면, 해당 탭이 표시되는 경우 비활성 또는 사용 안 함을 확인해 보세요.

비공개 API 키 복제

기존 비공개 API 키를 복제하면, 복제된 키는 다음과 같습니다:

• 원본과 완전히 다른 키가 됩니다.
• 원본과 동일한 이름을 사용합니다.
• 더 이상 지원되지 않는 폐기된 scope를 제외하면, 원본과 동일한 scope를 갖습니다.

복제해도 원래 키는 그대로 유지돼요. 복제된 키를 복사하거나 다운로드한 다음, 안전하게 보관해 주세요. 애플리케이션에서 사용하려면, 새 키로 해당 애플리케이션의 설정을 업데이트해 주세요. 더 이상 필요하지 않으면 원래 키를 삭제해 주세요.

비공개 API 키 삭제

비공개 API 키를 삭제하면 되돌릴 수 없어요. 이를 사용하는 API 요청은 작동이 중지됩니다. 노출되지 않은 키를 교체하는 경우, 삭제하기 전에 해당 키를 사용하는 애플리케이션을 업데이트하고 테스트해 주세요. 키가 노출되면 즉시 삭제해 주세요.

1. 위의 단계에 따라 API 키 탭을 열어 주세요. 비공개 API 키 아래에서 삭제하려는 키를 찾으세요.
2. 키 옆의 점 3개 메뉴를 열고 삭제를 선택해 주세요.
3. 확인 대화상자에서 삭제를 클릭해 주세요.

추가 자료