---
title: "CLOVA OCR VM PROXY 연동 가이드"
slug: "ai-application-service-ocr-vm-proxy"
tags: ["CLOVA OCR", "VM PROXY"]
updated: 2026-09-17T09:10:00Z
published: 2026-09-17T09:10:00Z
canonical: "api-fin.ncloud-docs.com/ai-application-service-ocr-vm-proxy"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLOVA OCR VM PROXY 연동 가이드

CLOVA OCR 서비스를 사내에서 이용하기 위해 CLOVA OCR VM PROXY를 연동하는 방법을 안내합니다. CLOVA OCR 서비스를 사용하려면 API Gateway 연동이 필요합니다. 이 가이드에서는 다음 내용에 대해 설명합니다.

- API Gateway 연동 방법
- 사내 내부망에서 화이트리스트로 관리할 IP 정보 또는 APIGW Invoke URL로 제어 정보 지정 방법
- CLOVA OCR 호출에 필요한 Secret Key 미노출 방법

위 내용을 참고하여 CLOVA OCR VM PROXY를 연동하여 API 호출하는 것을 권장합니다.

              참고

              

API GW Invoke URL에 할당된 IP 정보는 변경될 수 있습니다.

## 구성 방법

구성 방법은 다음과 같습니다.

1. [VM 생성](/docs/ai-application-service-ocr-vm-proxy#1vm%EC%83%9D%EC%84%B1)
2. [Ngnix Proxy 구성](/docs/ai-application-service-ocr-vm-proxy#2NgnixProxy%EA%B5%AC%EC%84%B1)

### 1. VM 생성

VM 생성과 관련된 내용은 네이버 클라우드 플랫폼 [Server 시작](https://api.ncloud-docs.com/docs/compute-server)을 참조해 주십시오.

### 2. Ngnix Proxy 구성

ngnix.config 파일에 다음과 같은 설정을 추가한 후 서비스를 시작해 주십시오.

```
server {
    ....
    location /ocrproxy {
        proxy_set_header x-ocr-secret {앱 등록 시 발급받은 Secret Key};
        rewrite ^/ocrproxy/(.*)$ break;
        proxy_pass {앱 등록 시 발급받은 Invoke URL};
    ....
}
```

## 요청 예시

요청 예시는 다음과 같습니다.

```
curl -X POST http://{VM IP}/ocrproxy
-d '{"images": [{"format": "jpg","name": "proxytest","data": null,"url": "{your image url}"}],"lang": "ko","requestId": "string","timestamp": 0,"version": "V2"}'
```

## 응답 예시

응답 예시는 다음과 같습니다.

- [General OCR 응답 예시](/docs/ai-application-service-ocr-ocr#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [Template OCR 응답 예시](/docs/clova-ocr-template-api#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [명함 OCR 응답 예시](/docs/ai-application-service-ocr-ocrdocumentocr-namecard#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [사업자등록증 OCR 응답 예시](/docs/ai-application-service-ocr-ocrdocumentocr-bizlicense#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [신용카드 OCR 응답 예시](/docs/ai-application-service-ocr-ocrdocumentocr-creditcard#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [영수증 OCR 응답 예시](/docs/ai-application-service-ocr-ocrdocumentocr-receipt#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [여권 OCR 응답 예시](/docs/ai-application-service-ocr-ocrdocumentocr-passport#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [외국인등록증 OCR 응답 예시](/docs/ai-application-service-ocr-ocrdocumentocr-alienregistration#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [운전면허증 OCR 응답 예시](/docs/ai-application-service-ocr-ocrdocumentocr-driverlicense#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [주민등록증 OCR 응답 예시](/docs/ai-application-service-ocr-ocrdocumentocr-identitycard#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)
- [의료비영수증 OCR 응답 예시](/docs/ai-application-service-ocr-ocrdocumentocr-medicalreceipt#%EC%9D%91%EB%8B%B5%EC%98%88%EC%8B%9C)