웹훅 설정

웹훅은 다른 프로그램이 스페이스빌더의 지정된 폴더로 파일을 자동 전송할 때 쓰는 전용 접수 주소입니다. 스캐너, 업무 시스템, 자동화 프로그램이 만든 파일을 사람이 조작하지 않아도 폴더에 저장할 수 있습니다.

이 문서에서는 서버 전체의 웹훅 사용 범위와 제한을 설정하는 방법을 안내합니다. 폴더에 웹훅을 만들고 접수 주소를 쓰는 방법은 폴더 웹훅을 참고합니다.

설정 전에 확인할 사항

• 외부에서 웹훅을 호출하려면 스페이스빌더에 접속할 수 있는 주소가 준비되어 있어야 합니다.
• 웹훅 주소에는 인증용 비밀값이 포함됩니다. 주소 전체는 관리자와 연결 프로그램 담당자만 공유합니다.
• 인터넷에 공개한다면 HTTPS를 사용합니다.
• 큰 파일을 받을수록 서버의 메모리와 저장 공간 사용량이 늘어납니다.

웹훅 정책 설정

서비스 구성 > 파일 영역의 웹훅 (자동 데이터 수신) 카드에서 웹훅을 사용할 대상과 보안 수준을 정합니다.

용량 및 요청 제한 설정

웹훅으로 한 번에 받을 수 있는 크기와 요청 횟수를 설정합니다. 대부분의 환경에서는 기본값을 그대로 사용합니다.

페이로드는 웹훅으로 전달되는 파일과 요청 정보를 합친 전체 내용입니다. 파일 외 정보도 포함되므로 실제 파일보다 조금 클 수 있습니다.

설정한 크기를 초과하면 파일이 저장되지 않고 413 Request Entity Too Large 응답이 반환됩니다. 대용량 파일을 자주 전송하는 환경에는 일반 파일 업로드 방식이 더 적합합니다.

한 번에 받을 수 있는 크기 늘리기

8 MB보다 큰 파일을 웹훅으로 받아야 할 때 다음과 같이 변경합니다.

1. 관리자 페이지에서 서비스 구성 > 파일 영역을 열고 웹훅 (자동 데이터 수신) 카드를 펼칩니다.
2. 최대 페이로드 크기 입력란에 필요한 크기를 입력합니다.
3. 입력란 오른쪽에서 MB 또는 GB 단위를 선택합니다.
4. 저장을 선택합니다.
5. 작은 파일로 전송을 확인한 뒤 필요한 파일을 전송합니다.

예를 들어 20 MB 안팎의 파일을 받으려면 20을 입력하고 MB를 선택합니다. 설정할 수 있는 범위는 1 KB~1 GB입니다.

웹훅을 인터넷에 공개한다면 Cloudflare나 Nginx에도 요청 제한을 설정해 과도한 요청을 서버에 닿기 전에 걸러냅니다.

권장 설정 순서

1. 인바운드 웹훅 기능 사용을 켭니다.
2. 폴더에서 웹훅을 만들 수 있도록 사용자 API 키 발급 허용을 켭니다.
3. 개인 폴더로 받아야 할 때만 개인 폴더 웹훅 허용을 켭니다.
4. 용량과 요청 제한은 기본값을 사용합니다.
5. 저장을 선택한 뒤 실제 사용할 폴더에서 웹훅을 만듭니다.
6. 작은 테스트 파일을 먼저 전송해 저장 위치와 권한을 확인합니다.

문제가 발생할 때

관련 문서

• 폴더 웹훅
• 디바이스 정보
• 외부 접속 방식 선택