API 키 관리

API 키 관리 화면에서는 사내 시스템이 웍스AI를 호출할 때 쓰는 키를 발급하고 관리할 수 있어요.

시작하기 전에

• 이 기능은 최고 관리자만 쓸 수 있어요.
• 관리자 왼쪽 메뉴의 설정/보안 > API 키 관리에서 들어갈 수 있습니다.

따라하기

1단계. 발급된 키 보기

발급한 키가 표로 보여요. 칸은 이름 · 키(앞뒤 일부만) · 생성일 · 만료일 · 상태 · 허용 IP · 삭제 예요. 상태 는 활성, 만료 21일 전부터 곧 만료, 지나면 만료 로 바뀌어요.

2단계. 새 키 발급하기

+ 새 키 발급 을 누르고 이름(50자까지)과 만료 기간(30일 · 90일 · 1년 · 직접 입력, 기본 1년)을 고른 뒤 발급하기 를 눌러요. 발급 완료 창에서 복사 를 누른 다음에야 복사 완료, 닫기 로 닫을 수 있어요. 창을 닫으면 키를 다시 볼 수 없어요.

발급한 키의 만료일은 나중에 바꾸거나 연장할 수 없어요. 만료 전에 새 키를 발급해 교체해 주세요.

허용 IP를 함께 걸어주세요

허용된 IP 주소 관리 에서 API 키를 쓸 수 있는 서버의 IP를 등록합니다. 이 목록은 따로 정하지 않은 키 모두에 적용돼요. 등록한 IP에서 호출한 키만 허용되므로, 키가 새어 나가도 그 밖에서는 쓸 수 없어요.

키마다 다르게 하려면 키 표의 허용 IP 칸에서 [변경하기] 를 눌러 셋 중 하나를 고르세요.

IP는 적은 뒤 [+ 추가] 를 눌러야 목록에 들어가요. 키마다 최대 100개까지 넣을 수 있어요.

목록이 비어 있으면 회사 목록을 따르는 키는 IP 제한 없이 호출돼요. 키를 쓰는 서버의 IP를 등록해 두시길 권해요.

사내 직원 접속 IP와는 별개입니다. 내부 통제의 접속 제한과 헷갈리지 마세요.

입력은 세 가지 형식을 씁니다. 화면에도 예시가 적혀 있어요.

여러 개를 한 번에 넣으실 때는 콤마(,)로 구분해 주세요.

회사 목록에서는 IP를 적고 + 추가 를 누르면 API Key 허용 IP 관리 확인 창이 떠요. 적용하기 를 누르면 저장돼요. 등록한 IP는 칩 옆 X로 하나씩, 전체 삭제 로 한꺼번에 지울 수 있고, 지울 때도 같은 확인 창이 떠요. 키별로 따로 정할 때는 창 안에서 + 추가 로 목록에 넣은 뒤 저장하기 를 눌러요.

API 키 허용 IP에는 요금이 붙지 않아요. 하루 요금이 붙는 건 내부 통제의 접속 통제예요.

공인 IP만 등록할 수 있어요. 사설 IP는 받지 않습니다.

연동 방법이 궁금하시면

화면 오른쪽 위의 [API 문서] 를 누르면 개발 담당자가 볼 연동 문서로 이동합니다.

키가 새어 나간 것 같으면 바로 삭제하시고 새로 발급해 주세요.

설정 하나하나와 자주 묻는 질문은 관리자 도움말에 정리돼 있어요.