콘텐츠로 이동
10월 27일 업데이트 — 스페이스 유저가 만든 API 키를 한 화면에서 확인하고 비활성화·삭제할 수 있어요.
이 기능은 아직 운영에 공개되지 않았습니다 — 검증 환경에서만 쓸 수 있어요. 운영에 열리는 날 이 안내는 자동으로 사라집니다.

API 키 관리

API 키 관리는 스페이스 유저들이 외부 시스템 연동용으로 만든 API 키를 관리자가 한눈에 보고 통제하는 화면이에요. 퇴사자·종료된 프로젝트의 키처럼 더 이상 쓰지 않는 키를 찾아 막을 수 있어요.

  • “스페이스 유저가 만든 API 키를 확인하고, 필요하면 비활성화하거나 삭제할 수 있어요. 키 전체 값은 관리자도 볼 수 없어요.”
  • **어드민·마스터(스페이스 소유자)**만 들어올 수 있어요. 그룹 관리자에게는 메뉴가 보이지 않아요.
  • 어드민 설정 왼쪽 관리 메뉴 [크레딧 결제] 아래 [API 키 관리]
  • 어드민 설정 들어가기 — 새 메뉴: 왼쪽 아래 프로필(내 계정) 메뉴 › 어드민 설정 (이전 메뉴: 왼쪽 사이드바 하단 › 어드민 설정)
열 설명
키 이름 키를 만들 때 붙인 이름. 이름 없이 예전에 만든 키는 “기존 연동 키”로 보여요
소유자 키를 만든 유저 — 그 키로 쓴 크레딧은 이 사람 몫으로 차감돼요
키 앞부분과 끝 4자리만 보여요(예: tmly-sk-7Fq2 •••• a91c)
상태 사용 중 · 비활성 · 만료(만료일이 있으면 함께 표시)
마지막 사용 방금 / N분 전 / N시간 전 / 어제 / N일 전 / 날짜 — 한 번도 안 썼으면 -
⋯ 그 키에 할 수 있는 작업
  • 위쪽 API 키 N에 전체 개수가 보여요.
  • 검색칸(“키 이름, 소유자 검색”)으로 찾고, **[CSV 내려받기]**로 목록을 파일로 받을 수 있어요(“다운로드가 완료되었습니다.”).

2. 키 비활성화·다시 사용·삭제

섹션 제목: “2. 키 비활성화·다시 사용·삭제”

행 오른쪽 **⋯**를 누르면 상태에 따라 메뉴가 달라요.

키 상태 ⋯ 메뉴
사용 중 (내 키만) 재발급 · 비활성화 · 삭제
비활성 다시 사용 · 삭제
만료 삭제
작업 확인 창 결과
비활성화 「(이름)」 키를 비활성화할까요? — “비활성화하면 이 키로 들어오는 요청이 막혀요. 언제든 다시 사용할 수 있어요.” “API 키를 비활성화했어요.”
다시 사용 — “API 키를 다시 사용할 수 있어요.”
삭제 「(이름)」 키를 삭제할까요? — “삭제한 키는 되돌릴 수 없고, 이 키로 들어오는 요청이 막혀요.” “API 키를 삭제했어요.”
재발급 (내 키만) 「(이름)」 키를 재발급할까요? — “새 키 값을 발급하고 지금 키 값은 바로 막아요. 이 키를 쓰는 곳에 새 값을 넣어야 해요.” “API 키를 재발급했어요” 창에 새 키가 한 번만 보여요
  • 다른 유저의 키는 재발급할 수 없어요. 키 값이 필요하면 소유자가 직접 새로 만들어야 해요.
  1. 오른쪽 위 **[API 키 만들기]**를 누르세요 — “만든 키는 바로 쓸 수 있어요. 키 전체 값은 만든 직후 한 번만 보여요.”
  2. 항목을 채우고 **[만들기]**를 누르세요.
  3. API 키를 만들었어요 창에서 [복사] 또는 **[복사하고 닫기]**로 키를 안전한 곳에 보관하세요 — “이 창을 닫으면 키 전체를 다시 볼 수 없어요. 지금 복사해서 안전한 곳에 보관해 주세요.”
항목 설명 제한
발급 대상 나 (이름) 고정 — “내 크레딧에서 차감돼요. 다른 유저의 키는 그 유저가 직접 만들어요.” 관리자가 남의 키를 대신 만들 수 없어요
키 이름 (필수) “목록에서 키를 구분할 때 써요.” 최대 30자
설명 “어디에 쓰는 키인지 적어 주세요.” 최대 100자
만료 30일 · 90일(기본) · 180일 · 365일 · 만료 없음 — 날짜가 함께 보여요 만료일이 지나면 상태가 만료로 바뀌고 요청이 막혀요

Q. 관리자인데 키 전체 값을 볼 수 없나요?

섹션 제목: “Q. 관리자인데 키 전체 값을 볼 수 없나요?”

네, 볼 수 없어요. 키는 만든 직후 한 번만 보여 주고 서버에도 원문을 남기지 않아요. 잃어버린 키는 소유자가 재발급하거나 새로 만들어야 해요.

Q. 키로 쓴 크레딧은 누구 몫인가요?

섹션 제목: “Q. 키로 쓴 크레딧은 누구 몫인가요?”

키 소유자의 사용량으로 잡혀요. 소유자의 그룹 한도도 그대로 적용돼요.

Q. 비활성화와 삭제 중 무엇을 써야 하나요?

섹션 제목: “Q. 비활성화와 삭제 중 무엇을 써야 하나요?”

잠시 막아 두거나 확실하지 않을 때는 비활성화(언제든 다시 사용 가능), 다시 쓸 일이 없으면 삭제(되돌릴 수 없음)를 쓰세요.

네. 키 만들기·삭제·비활성화·재발급 같은 작업은 통계의 관리자 감사 로그(보안 관리)에 남아요.

관련 문서: 통계 · 권한