이 기능은 일부 미리보기로 제공됩니다.
웹훅을 사용하면 플로우가 외부 링크 또는 API를 사용하여 데이터를 전송하거나 수신할 수 있습니다. 웹훅 단계를 사용하면 Google Workspace Studio에서 직접 지원하지 않는 내부 및 외부 리소스에 연결할 수 있습니다. 하지만 조직의 데이터를 외부에 공유할 때는 주의해야 합니다.
조직의 데이터를 보호하기 위해 Workspace Studio에는 여러 보안 보호 조치가 포함되어 있습니다.
- 기본적으로 사용 중지됨: 관리자가 조직 단위에 대해 명시적으로 사용 설정할 때까지 웹훅이 사용 중지됩니다.
- URL 허용 목록: 지원되는 버전에서 웹훅은 조직의 URL 허용 목록에 지정된 도메인 및 엔드포인트로만 데이터를 전송합니다.
- 사용자 승인: 기본적으로 각 웹훅 단계가 실행되기 전에 사용자가 검토하고 확인해야 합니다.
- 감사 로깅: 웹훅 실행 요청 및 HTTP 응답 상태 코드가 관리자 감사 로그에 기록됩니다.
1단계: 웹훅 사용 설정 또는 사용 중지
-
Google 관리 콘솔에서 메뉴
앱
Google Workspace
Workspace Studio 로 이동합니다.서비스 설정 관리자 권한이 필요합니다.
- 웹훅 설정 을 클릭합니다.
- (선택사항) 부서나 팀에 설정을 적용하려면 옆에 있는 조직 단위 를 선택합니다.
- 선택한 조직 단위의 사용자가 플로우에서 웹훅 단계를 사용하도록 허용하려면 사용 을 선택하고 웹훅 단계를 차단하려면 사용 중지 를 선택합니다.
-
저장 을 클릭합니다. 또는 조직 단위에 대해 재정의 를 클릭할 수도 있습니다.
상속된 값을 나중에 복원하려면 상속 을 클릭합니다.
2단계: (선택사항) 웹훅을 URL 허용 목록으로 제한
이 기능을 사용할 수 있는 버전: Business Plus, Enterprise Standard, Enterprise Plus, Education Standard, Education Plus 사용 중인 버전 비교하기.웹훅 단계가 특정 허용된 도메인 및 URL에서만 데이터를 전송하거나 수신하도록 제한할 수 있습니다. 이렇게 하면 Google Drive, Docs, Sheets, Apps Script의 공유 URL 허용 목록이 사용됩니다.
참고: URL 허용 목록을 지원하지 않는 버전의 경우 이 기능이 사용 설정되어 있으면 웹훅이 모든 유효한 URL에 연결할 수 있습니다.
URL 허용 목록 관리
-
Google 관리 콘솔에서 메뉴
앱
Google Workspace
Drive 및 Docs
기능 및 애플리케이션으로 이동합니다.서비스 설정 관리자 권한이 필요합니다.
- URL에서 불러오기 및 가져오기 를 클릭합니다.
- 다음 URL에서만 불러오기 및 가져오기 허용 을 선택합니다.
- 승인된 URL 또는 도메인 (예: https://api.example.com)을 입력합니다.
- 저장 을 클릭합니다.
웹훅 단계에 대한 사용자 승인
웹훅 단계는 외부 엔드포인트와 통신하므로 민감한 작업으로 취급됩니다. 플로우에서 웹훅 단계를 사용하는 경우 Workspace Studio에서는 플로우를 실행하거나 시작하는 사용자가 실행 전에 작업을 검토하고 확인하도록 요구합니다.
관리 콘솔에서 사용자 승인 설정을 관리할 수 있습니다. 자세한 내용은 외부 사용자가 포함된 플로우에 승인 필요를 참고하세요.
감사 로그에서 웹훅 활동 모니터링
관리 콘솔의 Workspace Studio 로그 이벤트를 사용하여 웹훅 사용량을 검토하고 플로우 실패 문제를 해결할 수 있습니다.
-
Google 관리 콘솔에서 메뉴
보고
감사 및 조사
Workspace Studio 로그 이벤트로 이동합니다.감사 및 조사 도구 관리자 권한이 필요합니다.
이벤트 이름으로 필터링합니다.
workflow_execution_successworkflow_execution_failure
이벤트 매개변수를 검사합니다.
- 웹훅 요청 URL: 웹훅 단계에서 호출된 타겟 URL입니다.
- 웹훅 응답 코드: 타겟 엔드포인트에서 반환된 HTTP 상태 코드입니다. 예:
200,404,500