API 키 관리: 비활성화 및 재활성화
Klaviyo에서는 비공개 API 키를 영구적으로 삭제하지 않고도 비활성화했다가 다시 활성화할 수 있어요. 나중에 복원할 수 있는 옵션은 유지하면서 키의 활동을 일시적으로 중지하려는 경우(예: 의심스러운 행동을 조사하는 동안) 유용해요.
이 문서에서는 다음을 다룹니다.
- API 키를 비활성화하는 방법입니다.
- API 키를 다시 활성화하는 방법입니다.
- Klaviyo가 사용자를 대신하여 키를 비활성화한 경우 어떻게 해야 하나요?
시작하기 전에 알아야 할 것
API 키를 비활성화하거나 다시 활성화하려면 API 키를 편집할 수 있는 권한이 필요해요. 아래에 설명된 옵션을 사용할 수 없다면, 도움을 받기 위해 계정 소유자 또는 관리자에게 문의해 주세요.
API 키를 비활성화하는 방법입니다.
참고: 키를 비활성화하면 해당 키에 의존하는 연동 또는 자동화의 API 호출이 중단돼요. 비활성화하기 전에 어떤 항목에서 이 키를 사용하는지 알고 있는지 확인해 주세요. 최근 API 호출을 검토하려면 API 키 페이지에서 개발자 도구 보기를 선택한 다음 로그를 선택하세요.
- Klaviyo 계정에 로그인합니다.
- 설정 > API 키로 이동하세요.
- 비공개 API 키에서 활성 또는 비활성 탭에서 키를 찾으세요. 키 이름이나 키 값의 일부를 사용해 키를 식별할 수 있어요.
- 키 옆의 ... (추가 옵션) 메뉴를 클릭합니다.
- 비활성화를 선택합니다.
키를 비활성화하면 이를 사용하는 API 호출이 중지돼요. 비활성화됨 탭에 표시돼요. 데이터는 삭제되지 않으며, 다시 사용할 준비가 되면 키를 다시 활성화할 수 있어요.
API 키를 다시 활성화하는 방법입니다.
Klaviyo에서 키가 노출되었거나 비정상적인 활동이 의심되어 비활성화한 경우, 다시 활성화하기 전에 아래 안내를 검토해 주세요.
- Klaviyo 계정에 로그인합니다.
- 설정 > API 키로 이동하세요.
- 비공개 API 키에서 비활성화됨 탭을 선택한 다음 키를 찾으세요.
- 키 옆의 ... (추가 옵션) 메뉴를 클릭합니다.
- 활성화를 선택하세요.
키를 다시 활성화하면 이를 사용하는 API 호출이 다시 실행돼요.
Klaviyo에서 API 키를 비활성화했다면 어떻게 해야 하나요?
Klaviyo는 730일 동안 사용하지 않은 비공개 API 키를 자동으로 비활성화할 수 있어요. 한 번도 사용된 적 없는 키의 경우, 이 기간은 키가 생성되는 시점부터 시작돼요. 이는 사용되지 않고 방치된 키가 악용될 위험을 줄이기 위한 보안 조치예요. Klaviyo는 키가 노출되어 악용될 위험이 있다고 판단되면, 대신 키를 비활성화할 수도 있어요.
이러한 이유 중 하나로 키가 비활성화되었다면 비활성화됨 탭에서 확인할 수 있어요. 사유와 다음 단계는 계정의 보안 담당자에게 전송된 알림에서 확인해 주세요.
방법:
- 비활성 상태로 인해 키가 비활성화되었는데도 계속 필요하다면, 위의 “API 키를 다시 활성화하는 방법” 섹션에 있는 단계를 따라 진행한 다음 연동에서 계속 사용하세요.
- Klaviyo에서 노출 의심 또는 비정상적인 활동 때문에 키를 비활성화했다면 개발자 도구 > 로그에서 활동을 검토해 보세요. 활동이 정상이라면 키를 다시 활성화할 수 있어요. 키가 노출되었거나 활동이 의심스러워 보인다면 이를 삭제하고 새 비공개 API 키를 생성한 다음, 기존 키를 사용하던 연동을 업데이트하세요. 확실하지 않다면 도움을 받기 위해 알림에 답장해 주세요.
- 키가 더 이상 필요하지 않다면 비활성화 상태로 두거나 영구적으로 삭제할 수 있어요. 삭제하려면 … 메뉴를 열고 삭제를 선택한 다음 삭제로 확인해 주세요.
참고: 비활성 기준을 계속 충족하는 다시 활성화된 키는 다시 비활성화될 수 있어요. 다시 활성화만으로는 마지막 사용 날짜가 재설정되지 않아요.
관련 문서
Learn more about managing and securing your Klaviyo API keys:
- 비공개 API 키를 생성하거나 복제하는 방법
API 호출에 사용되는 고유 식별자인 비공개 API 키를 만들고, 범위를 정의하는 방법을 알아보세요.