웹훅 설정

웹훅은 다른 프로그램이 스페이스빌더의 지정된 폴더로 파일을 자동 전송할 때 사용하는 전용 접수 주소입니다. 예를 들어 스캐너, 업무 시스템 또는 자동화 프로그램에서 생성한 파일을 사람의 조작 없이 폴더에 저장할 수 있습니다.

이 페이지에서는 관리자가 서버 전체의 웹훅 사용 범위와 제한을 설정합니다. 실제 폴더에 웹훅을 만들고 접수 주소를 사용하는 방법은 폴더 웹훅 사용법을 참고하세요.

설정 전에 확인할 사항

• 외부에서 웹훅을 호출하려면 스페이스빌더에 접속할 수 있는 주소가 준비되어 있어야 합니다.
• 웹훅 주소에는 인증용 비밀값이 포함됩니다. 주소 전체는 관리자와 연결 프로그램 담당자만 공유합니다.
• 인터넷에 공개할 때는 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. 작은 테스트 파일을 먼저 전송해 저장 위치와 권한을 확인합니다.

문제가 발생할 때

관련 문서

• 폴더 웹훅 사용법
• 디바이스 정보
• 접속 도메인 설정