API 키 관리
API 키 관리는 스페이스 유저들이 외부 시스템 연동용으로 만든 API 키를 관리자가 한눈에 보고 통제하는 화면이에요. 퇴사자·종료된 프로젝트의 키처럼 더 이상 쓰지 않는 키를 찾아 막을 수 있어요.
- “스페이스 유저가 만든 API 키를 확인하고, 필요하면 비활성화하거나 삭제할 수 있어요. 키 전체 값은 관리자도 볼 수 없어요.”
- **어드민·마스터(스페이스 소유자)**만 들어올 수 있어요. 그룹 관리자에게는 메뉴가 보이지 않아요.
어디서
섹션 제목: “어디서”- 어드민 설정 왼쪽 관리 메뉴 [크레딧 결제] 아래 [API 키 관리]
- 어드민 설정 들어가기 —
새 메뉴: 왼쪽 아래 프로필(내 계정) 메뉴 › 어드민 설정 (이전 메뉴: 왼쪽 사이드바 하단 › 어드민 설정)
1. 키 현황 보기
섹션 제목: “1. 키 현황 보기”| 열 | 설명 |
|---|---|
| 키 이름 | 키를 만들 때 붙인 이름. 이름 없이 예전에 만든 키는 “기존 연동 키”로 보여요 |
| 소유자 | 키를 만든 유저 — 그 키로 쓴 크레딧은 이 사람 몫으로 차감돼요 |
| 키 | 앞부분과 끝 4자리만 보여요(예: tmly-sk-7Fq2 •••• a91c) |
| 상태 | 사용 중 · 비활성 · 만료(만료일이 있으면 함께 표시) |
| 마지막 사용 | 방금 / N분 전 / N시간 전 / 어제 / N일 전 / 날짜 — 한 번도 안 썼으면 - |
| ⋯ | 그 키에 할 수 있는 작업 |
- 위쪽 API 키 N에 전체 개수가 보여요.
- 검색칸(“키 이름, 소유자 검색”)으로 찾고, **[CSV 내려받기]**로 목록을 파일로 받을 수 있어요(“다운로드가 완료되었습니다.”).
2. 키 비활성화·다시 사용·삭제
섹션 제목: “2. 키 비활성화·다시 사용·삭제”행 오른쪽 **⋯**를 누르면 상태에 따라 메뉴가 달라요.
| 키 상태 | ⋯ 메뉴 |
|---|---|
| 사용 중 | (내 키만) 재발급 · 비활성화 · 삭제 |
| 비활성 | 다시 사용 · 삭제 |
| 만료 | 삭제 |
| 작업 | 확인 창 | 결과 |
|---|---|---|
| 비활성화 | 「(이름)」 키를 비활성화할까요? — “비활성화하면 이 키로 들어오는 요청이 막혀요. 언제든 다시 사용할 수 있어요.” | “API 키를 비활성화했어요.” |
| 다시 사용 | — | “API 키를 다시 사용할 수 있어요.” |
| 삭제 | 「(이름)」 키를 삭제할까요? — “삭제한 키는 되돌릴 수 없고, 이 키로 들어오는 요청이 막혀요.” | “API 키를 삭제했어요.” |
| 재발급 (내 키만) | 「(이름)」 키를 재발급할까요? — “새 키 값을 발급하고 지금 키 값은 바로 막아요. 이 키를 쓰는 곳에 새 값을 넣어야 해요.” | “API 키를 재발급했어요” 창에 새 키가 한 번만 보여요 |
- 다른 유저의 키는 재발급할 수 없어요. 키 값이 필요하면 소유자가 직접 새로 만들어야 해요.
3. 관리자 본인 키 만들기
섹션 제목: “3. 관리자 본인 키 만들기”- 오른쪽 위 **[API 키 만들기]**를 누르세요 — “만든 키는 바로 쓸 수 있어요. 키 전체 값은 만든 직후 한 번만 보여요.”
- 항목을 채우고 **[만들기]**를 누르세요.
- API 키를 만들었어요 창에서 [복사] 또는 **[복사하고 닫기]**로 키를 안전한 곳에 보관하세요 — “이 창을 닫으면 키 전체를 다시 볼 수 없어요. 지금 복사해서 안전한 곳에 보관해 주세요.”
| 항목 | 설명 | 제한 |
|---|---|---|
| 발급 대상 | 나 (이름) 고정 — “내 크레딧에서 차감돼요. 다른 유저의 키는 그 유저가 직접 만들어요.” | 관리자가 남의 키를 대신 만들 수 없어요 |
| 키 이름 (필수) | “목록에서 키를 구분할 때 써요.” | 최대 30자 |
| 설명 | “어디에 쓰는 키인지 적어 주세요.” | 최대 100자 |
| 만료 | 30일 · 90일(기본) · 180일 · 365일 · 만료 없음 — 날짜가 함께 보여요 | 만료일이 지나면 상태가 만료로 바뀌고 요청이 막혀요 |
자주 묻는 질문
섹션 제목: “자주 묻는 질문”Q. 관리자인데 키 전체 값을 볼 수 없나요?
섹션 제목: “Q. 관리자인데 키 전체 값을 볼 수 없나요?”네, 볼 수 없어요. 키는 만든 직후 한 번만 보여 주고 서버에도 원문을 남기지 않아요. 잃어버린 키는 소유자가 재발급하거나 새로 만들어야 해요.
Q. 키로 쓴 크레딧은 누구 몫인가요?
섹션 제목: “Q. 키로 쓴 크레딧은 누구 몫인가요?”키 소유자의 사용량으로 잡혀요. 소유자의 그룹 한도도 그대로 적용돼요.
Q. 비활성화와 삭제 중 무엇을 써야 하나요?
섹션 제목: “Q. 비활성화와 삭제 중 무엇을 써야 하나요?”잠시 막아 두거나 확실하지 않을 때는 비활성화(언제든 다시 사용 가능), 다시 쓸 일이 없으면 삭제(되돌릴 수 없음)를 쓰세요.
Q. 키를 바꾼 기록이 남나요?
섹션 제목: “Q. 키를 바꾼 기록이 남나요?”네. 키 만들기·삭제·비활성화·재발급 같은 작업은 통계의 관리자 감사 로그(보안 관리)에 남아요.