API Keys 페이지에서는 애플리케이션이 FourA API를 호출하는 데 사용하는 키를 생성, 확인 및 관리할 수 있습니다.

키 확인하기

이 페이지에는 액세스 권한이 있는 모든 키가 표시됩니다. 여기에는 개인 키와 소속된 조직이 소유한 모든 키가 포함됩니다. 멤버십을 통해 접근 권한이 부여되므로 일반 멤버도 조직의 키를 볼 수 있습니다.

열 표시 내용
Name 표시 이름 및 설정된 경우 설명
Owner Personal 또는 조직 이름
Key Prefix 키의 앞부분 문자와 마스크(pk_live_a1b2••••••••), Reveal 버튼 또는 레거시 키의 자물쇠 아이콘
Status Active 또는 Inactive
Created 키 생성 일시
Last Used 키를 사용해 마지막으로 요청이 발생한 일시

이름이나 설명으로 검색하고, Active 또는 Inactive로 필터링하며, Name, Owner, Status, Created 또는 Last Used 기준으로 정렬할 수 있습니다. 정렬 방향은 내림차순, 오름차순, 정렬 해제 순으로 순환합니다.

Owner 필터

하나 이상의 조직에 속해 있는 경우 검색 상자 옆에 Owner 드롭다운이 나타납니다. 옵션은 Everything, Personal 또는 각 조직 항목입니다. 선택한 소유자의 키만 표시되도록 목록을 좁히며, Overview, Metrics, Activity, Proxy 페이지의 동일한 컨트롤도 이 선택을 따르므로 5개 페이지에서 조회하는 트래픽 주체가 항상 일치합니다.

키 생성하기

목록 상단의 Create Key를 클릭하고(첫 번째 키를 만들기 전 빈 페이지에서는 Create API key) 다음 항목을 입력합니다.

필드 필수 여부 설명
Name 필수 "production-scraper" 또는 "staging-test"와 같은 식별용 라벨
Description 선택 이 키의 용도에 대한 메모
Owner 조직에 속해 있는 경우 필수 Personal 또는 속한 조직. 조직이 하나 이상 있을 때만 선택 도구가 표시됩니다.

조직의 구성원은 역할에 관계없이 조직 소유의 키를 생성할 수 있습니다. 이것이 이 설정의 목적입니다. 조직 키의 사용량은 조직 소유자에게 청구되므로, 개발자가 회사 대신 개인에게 청구되는 개인 키를 사용할 필요가 없습니다.

생성 직후 복사 가능한 대화 상자에 전체 키가 한 번 표시됩니다. 나중에 Reveal을 사용하여 다시 확인할 수 있습니다. 키는 pk_live_ 접두사를 사용하며 pk_live_a1b2c3d4e5f6... 형식으로 표시됩니다. 키가 생성되었다는 확인 이메일이 발송됩니다.

보유할 수 있는 활성 키의 수는 요금제에 따라 결정됩니다. 여기에는 개인 키와 본인이 소유한 조직의 키가 포함됩니다. 조직용으로 생성된 키는 해당 조직 소유자의 요금제 한도에 반영됩니다. 한도에 도달하면 요금제 한도 숫자가 포함된 메시지와 함께 키 생성이 거부되므로, 더 이상 사용하지 않는 키를 비활성화하거나 삭제하거나 요금제를 업그레이드하십시오.

키 확인하기 (Reveal)

키의 마스킹된 접두사 옆에 있는 눈 아이콘을 클릭하면 전체 시크릿을 다시 볼 수 있습니다. 대시보드에서 확인을 요청한 다음, 플레인 키, 복사 버튼, 짧은 카운트다운이 포함된 대화 상자가 열립니다. 카운트다운이 끝나면 대화 상자는 페이지에서 시크릿을 지웁니다.

유효한 자격 증명이 노출되므로 모든 키 확인 내역은 감사 로그에 기록됩니다.

키를 공유받은 사람은 누구나 이를 확인할 수 있습니다. 개인 소유자 또는 키를 소유한 조직의 모든 구성원이 해당합니다.

레거시 키

표시 기능이 출시되기 전에 생성된 키는 눈 아이콘 대신 자물쇠 아이콘이 표시되며 확인할 수 없습니다. 해시만 저장되었으므로 원래 시크릿은 복구할 수 없습니다. 레거시 키를 전환하려면 작업 메뉴를 열고 Regenerate를 선택하십시오. 그 이후부터는 새 시크릿을 확인할 수 있습니다.

역할별 권한

개인 키에서는 모든 작업을 수행할 수 있습니다. 조직 키에는 세 가지 등급이 적용됩니다.

작업 Member Admin Owner
키 사용 및 시크릿 확인 예 예 예
이름 변경, 설명 수정 예 예 예
활성화 또는 비활성화 아니요 예 예
시크릿 재생성 아니요 예 예
삭제 아니요 예 예
조직 외부로 이동 아니요 아니요 예

비활성화 및 수정은 해당 행에 유지되지만 비활성화 사유와 함께 회색으로 표시됩니다. Regenerate, Transfer, Delete는 역할상 사용할 수 없는 경우 메뉴에 표시되지 않습니다. API도 동일한 작업을 거부하므로 통합 시스템이 인터페이스를 우회할 수 없습니다.

이러한 구분은 각 작업이 키를 공유하는 사람들에게 미치는 영향을 기준으로 합니다. 이름 변경은 영향을 주지 않습니다. 재생성이나 비활성화는 수행 즉시 동료의 모든 통합을 중단시킵니다. 키를 외부로 이동하면 회사에서 키가 제거되고 해당 키의 사용량이 이전받은 사람의 요금제에 청구되므로, 이는 소유자만 수행할 수 있습니다.

키 수정

Edit을 클릭하여 이름과 설명을 업데이트하십시오. 이 대화 상자에서는 소유권을 변경할 수 없습니다. Transfer를 사용하십시오.

작업 메뉴의 View Metrics를 선택하면 해당 키로 필터링된 Overview가 열립니다.

활성화 및 비활성화

해당 행에서 Disable 또는 Enable을 사용하십시오. 키를 비활성화하면 해당 키를 사용하는 모든 API 요청이 차단되며, 언제든지 다시 활성화할 수 있습니다. 변경 사항은 1분 이내에 적용됩니다.

키 재생성

키가 노출된 것으로 의심되는 경우 작업 메뉴를 열고 Regenerate를 선택하십시오. 동일한 키 ID에 대해 새 시크릿이 생성됩니다. 기존 시크릿은 1분 이내에 작동을 멈춥니다. 이름, 소유자 및 기타 모든 설정은 그대로 유지됩니다.

대화 상자가 닫힌 후에도 새 시크릿을 계속 확인할 수 있으므로 처음에 완벽하게 복사하지 않아도 됩니다.

키 이전

작업 메뉴의 Transfer를 사용하면 시크릿을 재생성하지 않고도 개인 소유권과 조직 소유권 간에 키를 이동할 수 있습니다. 키 ID, 지표 및 활동 기록은 보존됩니다. 소유자만 변경되며, 이에 따라 사용량 청구 대상도 변경됩니다.

이동 수행 가능 대상
개인 키를 조직으로 이동 해당 조직에 속한 모든 사용자
조직 키를 외부(본인)로 이동 조직의 소유자
두 조직 간 이동 키가 나가는 조직의 소유자

조직으로 이동한 키는 기본 "Everyone" 팀에 속하게 되며, 이에 따라 구성원에게 표시됩니다. 외부로 이동한 키는 속해 있던 모든 팀에서 제거됩니다.

키 삭제

작업 메뉴를 열고 삭제를 선택합니다. 이전에 사용한 키를 삭제하면 비활성화됩니다. 해당 키는 인증을 중지하고 목록에 비활성 상태로 유지되므로 활동 및 메트릭 기록에 이름이 계속 표시됩니다. 한 번도 사용되지 않은 키는 즉시 완전히 제거됩니다.

키가 삭제되면 이메일이 발송됩니다.

조직 키 및 결제

누가 request를 보냈든 조직 소유 키의 사용량은 조직 소유자의 플랜에 반영됩니다. 소유자의 사용량 및 한도 페이지에서는 이러한 키를 개인 키와 함께 집계하며 두 항목을 구분하여 표시합니다.

최근 업데이트: 2026년 11월 5일