> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.9.4/admin-management/settings/anonymous-call.md).

# 인증 키 없이 호출

「인증 키 없이 호출」은 모델 서빙·코드 서빙·워크플로우·MCP 서버·서비스 라우터를 **인증 키(Bearer 토큰) 없이도 외부에서 호출할 수 있게 여는 리소스 단위 옵션**입니다. 기본값은 «허용 안 됨»이고, 켜는 것(허용)과 끄는 것(해제) 모두 결재를 거쳐야 반영됩니다.

진입 경로는 각 리소스 상세 화면의 **인증 키** 탭입니다. 탭 상단 액션 영역(`[+ 인증 키 생성]` 왼쪽)에 라벨·도움말·현재 상태·토글이 한 줄로 놓이고, 인증 키 목록 아래에 이 설정의 **결재 이력**이 붙습니다. 결재 처리는 **승인** 메뉴에서 하며, 신규 승인 유형을 만들지 않고 기존 «인증 키» 유형을 그대로 씁니다.

허용으로 바뀌면 게이트웨이가 해당 리소스 경로의 인증 키 검증을 건너뜁니다. 기존 인증 키 호출은 그대로 동작하며, 인증 키 없는 호출은 호출자를 특정할 수 없어 **호출자 기준 통제와 사용량 집계가 적용되지 않습니다.**

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FOMfpaMH7QPvaBDDEVct5%2F01_authkey_tab_overview.png?alt=media&amp;token=6c6b9978-dc5c-4dcd-85d6-d97ea91aae84" alt=""><figcaption></figcaption></figure>

### 적용 대상 리소스

| 리소스     | 인증 키 탭 위치                |
| ------- | ------------------------ |
| 모델 서빙   | 서빙 > 모델 서빙 > 상세 > 인증 키   |
| 코드 서빙   | 서빙 > 코드 서빙 > 상세 > 인증 키   |
| 워크플로우   | 에이전트 > 워크플로우 > 상세 > 인증 키 |
| MCP 서버  | 도구 > MCP 서버 > 상세 > 인증 키  |
| 서비스 라우터 | 서비스 라우터 > 상세 > 인증 키      |

설정은 리소스 1건 단위입니다. 서빙 리비전별·인증 키별 설정이 아니라 리소스 전체에 걸립니다. 모델 서빙은 LLM 서빙 화면과 임베딩 서빙 화면 두 곳에 인증 키 탭이 있으며 둘 다 같은 리소스로 동작합니다.

A2A 에이전트에는 별도 화면이 없습니다. A2A 호출은 워크플로우 인증 키로 검증되므로, 워크플로우에서 허용하면 그 워크플로우의 A2A 외부 호출도 인증 키 없이 열립니다.

### 인증 키 탭의 컨트롤

인증 키 탭 상단에 `인증 키 없이 호출` 라벨 → 도움말 아이콘 → 상태 텍스트 → 토글 순서로 놓입니다.

| 상태 표시  | 의미                       | 토글                    |
| ------ | ------------------------ | --------------------- |
| 허용 안 됨 | 인증 키가 있어야만 호출됩니다(기본값).   | 꺼짐 · 조작 가능            |
| 승인 대기  | 허용 또는 해제 신청이 결재 대기 중입니다. | 잠김(회색) · 값은 직전 상태를 표시 |
| 허용됨    | 인증 키 없이 호출할 수 있습니다.      | 켜짐 · 조작 가능            |

승인 대기 중 토글에 마우스를 올리면 "승인 대기 중에는 변경할 수 없습니다." 툴팁이 뜨고, 눌러도 값이 바뀌지 않고 안내 토스트만 표시됩니다.

인증 키 탭은 해당 리소스의 쓰기 권한 보유자에게만 열리며, 쓰기 권한이 없으면 이 컨트롤도 노출되지 않습니다. 결재 대기 배너와 결재 이력은 권한과 무관하게 표시됩니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FxSOJ0UZvu8q6HOJ1ThRT%2F02_anonymous_call_control_help.png?alt=media&amp;token=3e8a3f45-aace-4fa4-861d-b9b81a9868ad" alt=""><figcaption></figcaption></figure>

### 허용·해제 신청

토글을 켜면 «허용 신청», 끄면 «해제 신청» 모달이 열립니다.

| 구분 | 허용 신청                                                                      | 해제 신청                   |
| -- | -------------------------------------------------------------------------- | ----------------------- |
| 제목 | 인증 키 없이 호출 허용 신청                                                           | 인증 키 없이 호출 해제 신청        |
| 안내 | 승인 시 인증 키 없이 호출할 수 있습니다. 이 호출은 호출자를 특정할 수 없어 호출자 기준 통제와 사용량 집계가 적용되지 않습니다. | 승인 시 인증 키 없는 호출이 차단됩니다. |

* **신청 사유는 필수**입니다. 최대 255자이며 초과 입력·붙여넣기는 그 자리에서 잘립니다.
* `[승인 신청]` 버튼은 사유를 채우기 전까지 비활성입니다. 모달을 다시 열면 입력값은 비워집니다.
* 신청에 성공하면 "승인 신청이 완료되었습니다." 토스트가 뜨고 상태가 «승인 대기»로 바뀝니다.
* 같은 리소스에 처리 대기 중인 신청이 있으면 중복 신청할 수 없습니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FH0t8Ovau0u5XooepTr6A%2F03_allow_request_modal.png?alt=media&amp;token=2dbf54fd-f3b5-4c77-95a7-50128c9cf935" alt=""><figcaption></figcaption></figure>

### 승인 대기 중 화면

대기 건이 있는 동안 인증 키 탭 최상단에 안내 배너가 뜹니다. 배너는 화면에 들어온 모든 사용자에게 보입니다.

| 신청 방향 | 배너 제목                 | 배너 설명                                       |
| ----- | --------------------- | ------------------------------------------- |
| 허용 신청 | 인증 키 없이 호출 허용 승인 대기 중 | 승인 완료 후 적용됩니다. 대기 중에는 인증 키 없는 호출이 계속 차단됩니다. |
| 해제 신청 | 인증 키 없이 호출 해제 승인 대기 중 | 승인 완료 후 해제됩니다. 대기 중에는 인증 키 없는 호출이 계속 허용됩니다. |

배너 오른쪽에는 신청일시와 신청자가 표시되고, `[신청 취소]` 버튼은 신청자 본인에게만 노출됩니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FG8yKb6tdRQSCG46MUd9Y%2F04_pending_banner.png?alt=media&amp;token=a62e40b4-1e89-4d81-bbc4-dcff842bca38" alt=""><figcaption></figcaption></figure>

### 신청 취소

`[신청 취소]`를 누르면 "신청을 취소 하시겠습니까?" 확인 모달이 뜨고, `[예]`를 누르면 **결재 없이 즉시** 취소됩니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FvqcnQEKXvqm3mtkY8waJ%2F05_cancel_confirm_modal.png?alt=media&amp;token=6d48d7bb-c83a-4b57-9b9e-b2c85a6d3387" alt=""><figcaption></figcaption></figure>

* 취소는 신청자 본인만 할 수 있습니다.
* 취소 직전에 결재가 확정된 경우에는 "이미 결재가 완료된 요청입니다." 안내가 뜬 뒤 확정된 결과로 갱신됩니다.
* 취소된 건은 결재 이력에 «신청 취소»로 남고, 결재자·결재일시는 비어 있습니다.

### 승인 메뉴에서 결재하기

운영 > **승인** 메뉴에서 처리합니다. 승인 유형은 기존 «인증 키»를 그대로 쓰고, 상태값만 «신청(인증 키 없이 호출 허용)» / «신청(인증 키 없이 호출 해제)»로 구분됩니다.

무인증 호출 행은 체크박스 일괄 처리 대상이 아니며, 맨 오른쪽 `[검토]` 버튼으로 단건 처리합니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2F5GiWd2Wk0MnrIBKKPcud%2F06_approval_list_row.png?alt=media&amp;token=aa13f755-0dbd-4168-a579-4761ddd54c39" alt=""><figcaption></figcaption></figure>

| 검토 모달 항목    | 내용                                    |
| ----------- | ------------------------------------- |
| ID          | 결재 ID                                 |
| 승인 상태       | 신청(인증 키 없이 호출 허용) / 신청(인증 키 없이 호출 해제) |
| 요청 유형       | «호출 허용» 또는 «호출 해제»                    |
| 대상          | 리소스명                                  |
| 변경 전 / 변경 후 | «인증 키 필수» ↔ «인증 키 없이 호출 허용»           |
| 요청자 / 요청 일시 | 신청한 사용자와 신청 시각                        |
| 신청 사유       | 신청자가 입력한 사유                           |

* 모달 하단 버튼은 `[닫기]` · `[반려]` · `[승인]` 입니다.
* 허용 신청 건에는 "인증 키 없이 들어온 호출은 호출자를 특정할 수 없어 호출자 기준 통제와 사용량 집계가 적용되지 않습니다." 경고가 함께 표시됩니다.
* `[반려]`는 반려 사유가 필수이며, 입력한 사유는 결재 이력의 「반려 사유」 열에 표시됩니다.
* 결재 권한이 없으면 모달에 `[승인]`·`[반려]`가 노출되지 않습니다(내용 확인 전용).
* 결재하려면 대상 리소스가 속한 관리 그룹의 «인증 키 승인» 쓰기 권한과 대상 리소스 쓰기 권한을 동시에 보유해야 합니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2F8G8VRS2hVBtxTrVCPPts%2F07_approval_review_modal.png?alt=media&amp;token=bacf1d11-82bd-4aa2-ad9b-1bbef0ddeb05" alt=""><figcaption></figcaption></figure>

### 결재 이력

인증 키 탭 하단에 **결재 이력** 섹션이 있습니다. 이력은 리소스 단위로 분리되어 다른 리소스의 건은 보이지 않습니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FgE8SIHazgUGXO0UWPGe9%2F08_approval_history_pending.png?alt=media&amp;token=19c00bc0-74ea-4570-8a3d-1c9025270925" alt=""><figcaption></figcaption></figure>

| 열          | 내용                   |
| ---------- | -------------------- |
| ID         | 결재 ID                |
| 유형         | 호출 허용 / 호출 해제        |
| 신청자 / 신청일시 | 신청자와 신청 시각           |
| 결재자 / 결재일시 | 미확정(대기·신청 취소) 건은 `-` |
| 상태         | 대기 / 승인 / 반려 / 신청 취소 |
| 반려 사유      | 반려 건에만 값이 있음         |

* 기본 정렬은 신청일시 최신순이고, 신청일시·결재일시로 정렬할 수 있습니다. 페이지당 10건입니다.
* 검색은 ID · 신청자 · 결재자 · 반려사유 중 하나를 골라 입력합니다.
* 다중 선택 필터는 결재 유형(호출 허용·호출 해제)과 결재 상태(대기·승인·반려·신청 취소) 2종입니다.

조건에 맞는 이력이 없으면 검색 결과 없음 상태가, 아직 결재 이력이 없으면 안내 문구가 표시됩니다.

<figure><img src="https://1274363562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoJuB29xjw7zmR91VXmqf%2Fuploads%2FlwShgv06KxrPbXwckNUj%2F09_approval_history_empty.png?alt=media&amp;token=7a4a72fa-cc66-4d01-a19f-6ba8298ca7ae" alt=""><figcaption></figcaption></figure>

### 알림

| 시점              | 알림               |
| --------------- | ---------------- |
| 허용 신청           | 인증 키 없이 호출 허용 신청 |
| 해제 신청           | 인증 키 없이 호출 해제 신청 |
| 승인 / 반려 / 신청 취소 | 기존 결재 결과 알림      |

모델 서빙 건은 알림·승인 목록의 분류명이 모델 유형에 따라 «LLM 서빙»·«임베딩 서빙»·«VLM 서빙» 등으로 세분 표기됩니다.

### 허용된 뒤의 실제 호출 동작

* 게이트웨이는 인증 정보가 전혀 없는 요청에 한해, 허용 플래그가 켜져 있으면 인증 키 검증을 건너뜁니다. 인증 키를 들고 온 호출은 종전대로 검증됩니다.
* 무인증으로 통과한 요청은 호출자를 특정할 수 없으므로 요청에 실려 온 주체·라우팅 관련 헤더를 제거한 뒤 전달합니다.
* 허용 여부는 승인 시점에 반영되며, 내부 캐시 때문에 허용·해제 전환이 수 초 늦게 보일 수 있습니다.
* 삭제되었거나 존재하지 않는 리소스로 들어온 무인증 호출은 항상 차단됩니다.

#### 크레딧·사용량

| 호출 방식      | 크레딧 차감                    | 사용 이력        |
| ---------- | ------------------------- | ------------ |
| 인증 키로 호출   | 기존 정책 그대로(인증 키 소유자 기준 차감) | 적재           |
| 인증 키 없이 호출 | 차감 없음(과금 주체를 특정할 수 없음)    | 적재(주체 없이 기록) |

서빙 리비전의 월 예산은 무인증 호출에도 그대로 적용·차단됩니다. 예산은 사용자가 아니라 리비전 단위로 판정하기 때문입니다.

#### 리소스를 삭제하면

허용 상태인 리소스를 삭제하면 무인증 호출이 자동으로 해제됩니다. 결재 이력에는 «호출 해제 / 승인» 1행이 "리소스 삭제에 의한 노출 해제" 사유와 함께 남고, 대기 중이던 신청은 같은 사유로 «신청 취소» 처리됩니다.

### 자주 마주치는 안내 문구

| 상황                       | 문구                                           |
| ------------------------ | -------------------------------------------- |
| 대기 중인 신청이 있는데 다시 신청      | 해당 서빙에 처리 대기 중인 승인 건이 있습니다. 먼저 처리 후 신청해 주세요. |
| 권한이 없는 리소스에 신청·결재        | 권한이 없습니다.                                    |
| 이미 승인·반려된 건을 취소하거나 다시 결재 | 이미 결재가 완료된 요청입니다.                            |
| 반려 사유 없이 반려              | 반려 사유를 입력해야 합니다.                             |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://genos-docs.gitbook.io/default/v1.9.4/admin-management/settings/anonymous-call.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.