API 키 관리 화면의 모든 것
사람이 아니라 시스템이 웍스AI를 쓸 때 필요한 열쇠예요.
관리자 > API 키 관리 에서 회사 시스템이 웍스AI를 부를 때 쓰는 키를 발급합니다.
API 키가 뭔가요
사람이 아니라 시스템이 웍스AI를 쓸 때 필요한 열쇠예요. 사내 프로그램에서 자동으로 문서를 요약하거나 번역하게 할 때 씁니다.
직원이 화면에서 쓰는 것과는 별개예요. 일반 사용에는 필요 없습니다.
화면에 있는 것
새 API 키 발급
키 만들기
이름
어디에 쓰는 키인지 (예: production-system-key)
만료 기간
30일 / 90일 / 1년 / 직접 지정 (기본값은 1년)
생성일 / 만료일
언제 만들고 언제 끝나는지
곧 만료 / D-일
만료가 가까우면 표시
API Key 허용 IP 관리
이 키를 쓸 수 있는 IP 제한
발급할 때 주의할 것
발급 직후 화면에서만 키를 볼 수 있어요. 창을 닫으면 다시 볼 수 없습니다. 꼭 복사해서 안전한 곳에 보관해 주세요.
이름은 나중에 알아볼 수 있게 지으세요. 키가 여러 개면 어떤 시스템 것인지 구분이 안 됩니다.
만료 기간
30일 / 90일 / 365일 중에 고르거나 직접 날짜를 정합니다.
짧게 잡는 게 안전합니다. 키가 유출돼도 자동으로 못 쓰게 되니까요. 다만 만료되면 그 키를 쓰는 시스템이 멈추니 미리 새 키로 바꿔주셔야 해요.
목록에서 만료가 가까운 키는 곧 만료 로 표시됩니다.
허용 IP 제한
이 키를 어느 IP에서만 쓸 수 있는지 정합니다. 키가 유출돼도 등록한 IP 밖에서는 못 씁니다.
공인 IP만 등록할 수 있어요. 세 가지 형식을 지원합니다.
단일 IP
218.144.97.227
범위
218.144.97.227-218.144.97.230
CIDR
218.144.97.224/29
여러 개는 콤마(,)로 구분해서 넣습니다.
이 기능은 회사당 하루 3,000원(30일 기준 약 9만원)의 부가서비스예요.
자주 묻는 질문
Q. 키를 잃어버렸어요. 다시 볼 수 있나요?
없습니다. 발급 직후에만 보여요. 새로 발급받고 예전 키는 삭제해 주세요.
Q. 키를 삭제하면 어떻게 되나요?
그 키를 쓰는 시스템이 바로 멈춥니다. 삭제 전에 새 키로 바꿔두세요.
Q. API 키로 쓴 사용량은 어디에 나오나요?
관리자 > 이용 현황 의 사용자 목록에서 부가서비스/API 로 모여 보입니다. → 사용자 목록에 있는 '부가서비스/API'는 무엇인가요
Q. 키마다 사용량을 따로 볼 수 있나요?
지금은 하나로 합쳐서 보입니다.
Q. 만료된 키는 어떻게 하나요?
새로 발급받아 시스템에 넣고, 예전 키는 삭제해 주세요.
Q. "잘못된 IP 형식이 포함되어 있습니다" 라고 나와요.
사설 IP(192.168. 로 시작하는 것 등)는 등록할 수 없어요. 회사 공인 IP를 전산 담당자에게 확인해 주세요.
Q. 우리 회사 공인 IP를 모르겠어요.
전산 담당자에게 문의해 주세요. 웍스AI에서는 알려드릴 수 없습니다.
Q. 직원 로그인 IP 제한과 같은 건가요?
다릅니다.
API 키 허용 IP — 시스템이 키로 부를 때
내부 통제의 IP 주소 관리 — 직원이 로그인할 때
Q. 키를 몇 개까지 만들 수 있나요?
시스템마다 따로 만드시는 걸 권합니다. 문제가 생겼을 때 그 키만 지우면 되니까요.
Q. API 사용법 문서가 있나요?
연동 방식은 담당자가 안내해 드려요. 고객지원으로 문의해 주세요.
이럴 땐 문의해 주세요
API 연동 방법을 알고 싶을 때
키가 유출된 것 같을 때 (바로 삭제 후 문의)
Last updated