CLOVA OCR VM PROXY 연동 가이드

개요

CLOVA OCR 상품을 사내에서 이용할 경우 API 게이트웨이 연동이 필요합니다.

이 때 VM PROXY 연동을 통해 사내 내부망에서 CLOVA OCR 상품에 대해 화이트리스트로 관리할 IP 정보, 또는 APIGW Invoke URL로 제어할 정보를 지정할 수 있습니다. 또한 본 가이드는 CLOVA OCR 상품 호출에 필요한 SecretKey를 노출하지 않는 방법에 대해서도 안내합니다.

NCP는 아래 과정을 통해 CLOVA OCR VM PROXY를 연동하여 API를 호출하는 것을 권장합니다.

구성 방법은 아래와 같습니다.

VM 생성

VM 생성에 관한 내용은 Server 시작을 참조해 주십시오.

Nginx Proxy 구성

nginx.config 파일에 아래와 같이 설정을 추가 후 서비스를 시작합니다.

server {
    ....
    location /ocrproxy {
        proxy_set_header x-ocr-secret {your secret key};
        rewrite ^/ocrproxy/(.*)$ break;
        proxy_pass {your api gw Invoke url};
    ....
}

예시

요청 예시

curl -XPOST 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 응답 예시, Template OCR 응답 예시, Document OCR 응답 예시에서 확인 가능합니다.