# API 키 관리

> 원문: https://boltena.com/docs/apikey · 볼테나 ERP 도움말 · 최종 확인 2026-08-10

외부 시스템(생산 현장 MES·물류사·자체 개발 프로그램)이 우리 회사 데이터를 주고받을 때 쓰는 열쇠를 발급·폐기하는 화면입니다. 아래쪽 "연동 문서"에 어떤 API 가 열려 있고 어떻게 호출하는지가 정리되어 있어, 그 내용을 연동 담당 개발자에게 그대로 전달하면 됩니다.

- 대상: 관리자
- 화면: 볼테나 ERP > API 키 관리

## 먼저 알아둘 것

- 키는 우리 회사 전용입니다 — 그 키로는 다른 회사의 데이터에 닿을 수 없고, 상대에게 회사코드를 알려줄 필요도 없습니다(키에 담겨 있습니다).
- 발급된 키의 실제 값은 발급 직후 팝업에 한 번만 보입니다. 서버에는 원본이 저장되지 않으므로(비밀번호와 같은 취급) 팝업의 [키 복사]를 그 자리에서 눌러 안전한 곳에 보관하세요. 창을 닫으면 다시 볼 수 없고, 잃어버리면 새로 발급하면 됩니다.
- 연동 상대마다 이름을 달리해 따로 발급하세요 — 문제가 생겼을 때 그 상대의 키만 폐기하면 나머지 연동은 계속 돕니다. 목록의 "마지막 사용"으로 어느 연동이 살아 있는지 확인합니다.
- 외부연동은 연동(CONN) 모듈 계약이 있어야 열립니다. 계약이 끝나면 기준정보 내려받기와 이미 보낸 자료의 취소는 계속 되지만, 새 자료를 보내는 것과 AI 비서 연결은 닫힙니다 — 정리할 길은 항상 열어 두되, AI 조회는 이 모듈이 제공하는 기능 자체이기 때문입니다.
- 계약이 끝나 AI 연결이 닫혀도 장부 자료는 그대로입니다 — 재고·매출·미수채권·시산표를 화면에서 계속 보시고 엑셀로 내보낼 수 있습니다. 다시 열려면 [시스템 > 계약·라이선스]에서 신청하시면 되고, 이미 발급한 키를 새로 만들 필요는 없습니다.
- 기준정보(품목·거래처 등)는 ERP 가 원본입니다. 외부에서 만들거나 고치는 API 는 열어 두지 않습니다 — 장부가 둘이 되면 어느 쪽이 맞는지 아무도 답할 수 없기 때문입니다.
- 이 키는 사람 계정이 아니라 회사 단위입니다 — 키를 가진 쪽이 곧 조회 범위이므로, 개인 비밀번호처럼 관리하고 필요 없어지면 바로 폐기하세요. 개인별 화면 권한과는 별개로 동작합니다.
- AI 비서(Claude·ChatGPT 등) 연결도 이 키를 씁니다. 발급할 때 "AI 조회 범위"에서 읽을 자료를 골라 두면 그 키는 나머지를 보지도 못합니다 — 아무것도 고르지 않으면 전부 열립니다. 재고만 여는 키, 회계만 여는 키를 따로 발급해 두는 편이 안전합니다.
- AI 가 무엇을 언제 읽었는지는 기록에 남습니다(사용현황 화면에서 확인). 사람이 화면에서 본 것과 구분되어 쌓입니다.

## 이 화면으로 하는 일

- 외부 시스템 연동용 키 발급·폐기
- 연동 담당자에게 전달할 API 문서 확인

## 순서

1. 연동 상대 이름을 넣습니다
2. AI 비서용 키라면 "AI 조회 범위"에서 읽게 할 자료만 고릅니다(고르지 않으면 전부 열립니다)
3. [발급]을 누릅니다 — 키가 화면 가운데 팝업으로 뜹니다
4. 팝업의 [키 복사]를 그 자리에서 누릅니다. 창을 닫으면 다시 볼 수 없습니다
5. 복사한 키를 상대에게 안전한 경로로 전달합니다(메신저 평문 전송은 피하세요)
6. 아래 "연동 문서"의 내용을 함께 전달합니다
7. 연동이 끝나거나 상대가 바뀌면 그 키를 [폐기]합니다

## 수정·삭제·잠금

- 수정: 발급된 키의 이름·값·AI 조회 범위는 바꿀 수 없습니다 — 새로 발급하고 옛 키를 폐기하세요. 범위를 나중에 넓힐 수 있게 두면 "이 키는 재고만 본다"는 약속이 조용히 깨집니다.
- 삭제: 폐기해도 목록에서 사라지지 않고 "폐기됨"으로 남습니다(누가 언제 무엇을 썼는지의 증적을 지우지 않습니다).
- 잠금: 관리자만 발급·폐기할 수 있고, 서버가 최후로 막습니다. 연동(CONN) 모듈이 없으면 화면과 API 모두 열리지 않습니다.

## 자주 묻는 질문

### 키를 잃어버렸습니다.

다시 볼 수 없습니다(서버에 원본이 없습니다). 새로 발급하고 옛 키는 폐기하세요.

### 외부에서 우리 품목을 등록하게 할 수 있나요?

아니요. 기준정보 쓰기 API 는 열지 않습니다. 내려받기(조회)만 가능합니다.

### 같은 실적을 두 번 보냈습니다.

보내는 쪽 고유번호(extRef)가 같으면 중복 저장되지 않고 처음 결과를 그대로 돌려줍니다. 통신 실패 후 재전송은 안전합니다.

### AI 가 우리 급여·개인정보도 볼 수 있나요?

아니요. AI 에게 여는 것은 재고·매출·채권·수주/발주 잔량·시산표 같은 조회 자료뿐이고, 급여·개인정보 화면은 도구로 제공하지 않습니다. 입력·수정·삭제 도구도 없습니다.

### 이미 발급한 키의 AI 조회 범위를 좁히고 싶어요.

기존 키는 범위를 바꿀 수 없습니다. 범위를 지정해 새 키를 발급하고 상대에게 교체 요청한 뒤 옛 키를 폐기하세요. (예전에 발급된 키는 범위가 "전체"로 표시됩니다.)

### AI 가 무엇을 읽었는지 확인할 수 있나요?

예. 사용현황 화면에 조회한 자료와 시각이 남습니다. 거래처 보안 점검에서 이 기록으로 답할 수 있습니다.

---

이 문서는 볼테나 ERP 제품 안의 사용설명서에서 생성되었습니다(최종 확인 2026-08-10).
제품에서 보기: https://boltena.com/signup — 30일 무료로 전 기능을 직접 확인할 수 있습니다.