본문으로 건너뛰기

Google Drive 이벤트 채널

Google Drive 이벤트 채널 메뉴는 SHIELD DRM 서비스를 Google Drive에 적용하기 위해, 드라이브 단위로 변경 알림(웹훅) 채널을 설치하고 관리하는 화면입니다.

Microsoft 365의 이벤트 리시버에 대응하는 Google Workspace 전용 연동 관리 메뉴이며, Google Workspace를 사용하는 고객사에게만 표시됩니다.

Google Drive는 드라이브 단위로 채널을 설치하는 변경 알림(웹훅) 방식입니다. 채널에는 만료 시각이 있어 주기적으로 자동 재등록됩니다. 채널이 설치되지 않은 드라이브의 문서 이벤트는 수신되지 않으며, 조건부 정책도 적용되지 않습니다.


선행 조건​

Google Drive 이벤트 채널을 사용하려면 아래 조건이 순서대로 갖춰져야 합니다. 앞 단계가 갖춰지지 않으면 뒤 단계를 실행해도 상태가 바뀌지 않습니다.

#조건갖추는 주체
1고객사가 Google Workspace를 사용하며, 테넌트가 SHIELD DRM에 연동되어 있어야 합니다.고객사 관리자 · 구축 담당자
2Google Drive 이벤트 채널 역할 권한이 있어야 합니다.SHIELD DRM 관리자
3각 사용자의 SHIELD ID 계정에 Google Workspace 계정이 연결되어 있어야 합니다.SHIELD ID 관리자 (인사연동)
4대상 사용자·드라이브가 목록에 반영되어 있어야 합니다.SHIELD DRM 관리자 (동기화)

조건 1·2가 갖춰진 뒤의 순서는 다음과 같습니다. 계정 연결(1단계)은 SHIELD DRM이 아니라 SHIELD ID에서 이루어집니다.

사용자 계정 연결 (조건 3)​

내 드라이브 채널은 사용자 단위로 설치되므로, 대상 사용자의 Google Workspace 계정을 알 수 있어야 설치할 수 있습니다. 이 연결은 SHIELD ID의 인사연동(디렉터리 동기화) 으로 만들어집니다.

연결이 만들어지는 경로실행 주체
SHIELD ID 인사연동 — 자동 동기화설정되어 있으면 주기적으로 자동 반영
SHIELD ID 인사연동 — 수동 동기화SHIELD ID 관리자가 직접 실행
사용자가 Google 계정으로 SHIELD ID에 로그인사용자 본인 (로그인 시 자동 연결)

⚠️ 자동 동기화가 설정되어 있지 않으면, 계정이 SHIELD ID와 Google Workspace 양쪽에 모두 있어도 연결되지 않습니다. 이 경우 SHIELD ID 관리자가 수동 동기화를 실행해야 연결됩니다. 신규 구성원이 합류했거나 목록의 사용자 ID가 비어 있다면 먼저 이 항목을 확인하십시오.

  • 연결 여부는 내 드라이브 탭의 사용자 ID 열로 확인합니다. 연결된 사용자에게만 Google Workspace 이메일 주소가 표시됩니다.
  • 연결되지 않은 사용자는 채널 설치 대상이 아닙니다. 채널 설치나 전체 설치를 실행해도 해당 사용자의 상태는 바뀌지 않습니다.
  • 연결이 완료되었음을 알리는 별도의 안내 화면은 없습니다. 위 사용자 ID 열로 확인하십시오.

화면 구성​

SHIELD DRM 관리자페이지에서 연동 관리 > Google Drive 이벤트 채널 메뉴를 클릭하여 접속합니다.

이벤트 수신 대상의 차이에 따라 두 개의 탭으로 구분되어 제공됩니다.

  • 내 드라이브 탭: 사용자 단위로 개인 드라이브(내 드라이브)의 채널 설치 상태를 관리합니다.
  • 공유 드라이브 탭: 조직의 공유 드라이브 단위로 채널 설치 상태를 관리합니다.

두 탭은 각각 독립적으로 조회·설치·동기화됩니다. 탭을 전환하면 검색어와 필터, 페이지 위치는 초기화됩니다.

각 탭에는 새로 생긴 대상에 채널을 자동으로 설치하는 실시간 감지 스위치가 있습니다. 자세한 내용은 아래 「실시간 감지」를 참고해 주세요.


내 드라이브​

목록 정보​

항목설명
사용자SHIELD ID 사용자의 표시 이름입니다.
사용자 IDSHIELD ID 사용자 계정에 연동된 Google Workspace 이메일 주소입니다. 연결된 계정이 존재하는 경우에만 정보가 표시됩니다. 비어 있으면 채널 설치 대상이 아닙니다 (선행 조건 3).
채널 설치 상태해당 사용자의 내 드라이브에 변경 알림 채널이 설치되어 있는지 표시합니다.
마지막 확인 날짜채널 상태가 마지막으로 점검된 시각입니다. 접속 환경의 시간대 기준으로 표시됩니다.

채널 설치 상태​

  • 설치 : 변경 알림 채널이 정상적으로 설치된 상태입니다.
  • 미설치 : 채널이 설치되지 않은 상태입니다. 해당 드라이브의 문서 이벤트는 수신되지 않습니다.
  • 지원하지 않음 : Google Drive를 사용할 수 없는 계정 등 채널 설치 대상이 아닌 경우입니다.

채널 설치 상태 열의 필터 아이콘을 클릭하면 상태별로 목록을 걸러 볼 수 있습니다. 상태는 한 번에 하나만 선택할 수 있으며, 초기화 버튼으로 해제합니다.

상태가 설치가 아닐 때 확인 순서​

사용자 ID 열을 먼저 확인하십시오. 같은 조직의 사용자라도 인사연동 반영 여부에 따라 상태가 다르게 표시될 수 있습니다.

상태먼저 확인할 것조치
미설치사용자 ID 열에 이메일이 표시되는지비어 있으면 → SHIELD ID 인사연동 반영 후 동기화 (선행 조건 3) 표시되면 → 채널 설치 또는 전체 설치 실행
지원하지 않음사용자 ID 열에 이메일이 표시되는지비어 있으면 → SHIELD ID 인사연동 반영 후 동기화 (선행 조건 3) 표시되면 → 해당 계정의 Google Drive 사용 가능 여부 확인
설치를 실행했는데 그대로실행한 지 얼마 지나지 않았는지요청 접수 방식이므로 잠시 후 새로 고침으로 다시 확인

검색​

우측 상단 검색창에 사용자 이름 또는 이메일을 입력하고 Enter 키를 누르거나 검색 아이콘을 클릭하면 해당 사용자만 조회됩니다.


공유 드라이브​

목록 정보​

항목설명
드라이브 이름공유 드라이브의 이름입니다.
드라이브 ID공유 드라이브의 고유 식별자입니다.
채널 설치 상태해당 공유 드라이브에 변경 알림 채널이 설치되어 있는지 표시합니다.
마지막 확인 날짜채널 상태가 마지막으로 점검된 시각입니다.

공유 드라이브는 모두 채널 설치 대상이므로, 내 드라이브와 달리 지원하지 않음 상태가 표시되지 않습니다. 사용자 계정 연결(선행 조건 3)과도 무관합니다.

검색창에는 드라이브 이름을 입력합니다.


채널 설치 및 해제​

선택한 대상 설치·해제​

  1. 목록에서 대상 항목의 체크박스를 선택합니다. 헤더의 체크박스를 클릭하면 현재 페이지에 표시된 전체 항목이 선택됩니다.
  2. 채널 설치 또는 채널 해제 버튼을 클릭합니다. 선택된 항목이 없으면 두 버튼은 비활성화 상태입니다.
  3. 요청이 접수되면 안내 팝업이 표시되고 목록이 다시 조회됩니다.

채널 설치·해제는 요청 접수 방식으로 동작합니다. 요청 직후에는 목록에 상태가 반영되지 않을 수 있으며, 잠시 후 새로 고침 버튼으로 다시 확인해 주세요.

전체 설치 및 전체 삭제​

목록의 모든 대상을 한 번에 처리할 때 사용합니다.

  • 전체 설치 : 현재 탭 목록에 있는 모든 대상에 변경 알림 채널을 설치합니다.
  • 전체 삭제 : 현재 탭 목록에 있는 모든 대상의 변경 알림 채널을 해제합니다.
  1. 처리할 탭(내 드라이브 / 공유 드라이브)을 선택합니다.
  2. 전체 설치 또는 전체 삭제 버튼을 클릭합니다.
  3. 확인 창에서 대상 범위를 확인한 뒤 진행합니다.

두 버튼은 행 선택과 무관하게 현재 선택된 탭의 목록 전체를 대상으로 합니다. 체크박스로 고른 항목만 처리하려면 채널 설치 · 채널 해제 버튼을 사용해 주세요.

  • 두 탭은 각각 독립적으로 동작하므로, 내 드라이브와 공유 드라이브 모두를 처리하려면 탭을 바꿔 각각 실행해야 합니다.
  • 대상 수에 비례해 시간이 걸릴 수 있습니다. 선택 실행과 마찬가지로 요청 접수 방식이므로, 잠시 후 새로 고침으로 결과를 확인해 주세요.
  • 내 드라이브 탭에서 전체 설치를 실행해도 계정이 연결되지 않은 사용자는 설치되지 않습니다 (선행 조건 3).

동기화 및 새로 고침​

  • 동기화 : 현재 선택된 탭의 목록을 다시 가져와 반영합니다. 내 드라이브와 공유 드라이브는 각각 실행해야 합니다.
    • 내 드라이브: SHIELD ID의 활성 사용자 목록과, 사용자마다 연결된 Google Workspace 계정을 가져옵니다.
    • 공유 드라이브: 고객사 설정에 등록된 연동용 관리자 계정으로 Google Workspace의 공유 드라이브 목록을 가져옵니다.
  • 새로 고침 : 저장된 목록을 다시 조회합니다. SHIELD ID와 Google Workspace 조회는 수행하지 않습니다.

이 화면의 동기화는 SHIELD DRM의 목록 갱신입니다. 선행 조건 3의 SHIELD ID 인사연동과는 다른 작업이며, 이 버튼으로는 사용자 계정 연결이 만들어지지 않습니다. 인사연동으로 연결이 만들어진 뒤 동기화를 실행하거나 목록 자동 갱신을 기다리면 사용자 ID 열에 표시됩니다.

처음 사용할 때와 목록 자동 갱신​

  • 처음 사용하는 고객사는 동기화를 실행하기 전까지 두 탭 목록이 모두 비어 있습니다.
  • 동기화로 목록이 한 번 채워진 뒤에는 SHIELD DRM이 1시간마다 두 탭의 목록을 자동으로 갱신합니다.
  • 공유 드라이브 목록은 연동용 관리자 계정이 등록되어 있어야 갱신됩니다.
  • 동기화는 같은 탭에서 1분에 한 번만 실행할 수 있습니다. 1분 안에 다시 실행하면 오류 안내가 표시됩니다.

실시간 감지​

실시간 감지를 활성화하면 새로 생긴 사용자와 공유 드라이브에 변경 알림 채널이 자동으로 설치됩니다. 동기화나 목록 자동 갱신을 기다렸다가 관리자가 직접 설치하지 않아도 됩니다.

각 탭의 버튼 영역에 있는 실시간 감지 스위치로 설정합니다. 내 드라이브와 공유 드라이브는 따로 설정하며, 처음에는 두 탭 모두 비활성화되어 있습니다.

탭자동 설치 시점자동 설치 대상
내 드라이브Google Workspace나 SHIELD ID에 사용자가 새로 추가될 때사용자 계정 연결(선행 조건 3)이 된 사용자의 내 드라이브
공유 드라이브Google Workspace에 공유 드라이브가 새로 생성될 때새로 생성된 공유 드라이브

활성화하기 전에 준비할 것​

두 탭 모두 Google 감사 로그로 새 사용자와 공유 드라이브를 감지합니다. 활성화하려면 아래 두 가지가 준비되어 있어야 합니다.

  • 고객사 설정에 연동용 Google 관리자 계정이 등록되어 있어야 합니다. 공유 드라이브 목록을 동기화할 때 사용하는 계정과 같습니다.
  • Google 관리 콘솔의 도메인 전체 위임에 감사 로그 조회 범위가 추가되어 있어야 합니다. 범위는 https://www.googleapis.com/auth/admin.reports.audit.readonly 입니다. 범위 추가가 필요하면 구축 담당자에게 문의해 주세요.

설정 방법​

  1. 내 드라이브 또는 공유 드라이브 탭을 선택합니다.
  2. 실시간 감지 스위치를 클릭합니다.
  3. 확인 창의 안내를 확인하고 계속을 클릭합니다. 취소를 클릭하면 스위치가 원래 상태로 돌아갑니다.
  • 활성화할 때는 Google에 감사 로그 알림을 등록한 뒤 저장하므로 몇 초 걸릴 수 있습니다.
  • 저장에 실패하면 스위치가 원래 상태로 돌아가고, 오류 코드가 담긴 안내 창이 표시됩니다.
  • Google Drive 이벤트 채널 역할 권한이 없는 관리자에게는 스위치가 비활성화되어 표시됩니다.
오류 코드원인조치
282연동용 Google 관리자 계정이 등록되지 않았거나, Google Workspace에 없는 계정입니다.고객사 설정의 연동용 관리자 계정을 확인한 뒤 다시 활성화합니다.
298도메인 전체 위임에 감사 로그 조회 범위가 없습니다.범위를 추가한 뒤 다시 활성화합니다.
286Google 호출이 일시적으로 실패했습니다.잠시 후 다시 시도합니다.
231설정 저장에 실패했습니다.잠시 후 다시 시도합니다.

알아 둘 점​

  • 새 사용자나 공유 드라이브가 생긴 뒤 채널이 설치되기까지 10분 정도 걸릴 수 있습니다. Google 감사 로그에 기록되기까지 몇 분이 걸리기 때문입니다.
  • 새로 생긴 대상에만 동작합니다. 활성화하기 전부터 목록에 있던 미설치 대상은 채널 설치 또는 전체 설치로 설치합니다.
  • 사용자 계정 연결(선행 조건 3)이 되지 않은 사용자의 내 드라이브에는 자동으로 설치되지 않습니다.
  • 비활성화하면 자동 설치가 중지됩니다. 이후 새로 생긴 대상은 동기화나 목록 자동 갱신으로 목록에 나타난 뒤 직접 설치해야 합니다.

제약 사항​

제품 구조상 지원하지 않거나 우회할 수 없는 항목입니다.

항목내용
사용자 계정 연결SHIELD ID 인사연동에 의존합니다. 자동 동기화가 설정되어 있지 않으면 계정이 양쪽에 모두 있어도 연결되지 않으며, 수동 동기화를 실행해야 합니다.
채널 미설치 드라이브문서 이벤트가 수신되지 않으며, 조건부 정책도 적용되지 않습니다.
신규 사용자·드라이브실시간 감지를 활성화하지 않은 탭에서는 실시간으로 감지되지 않습니다. 동기화를 실행하거나 1시간마다 동작하는 목록 자동 갱신을 기다려야 목록에 나타납니다.
자동 설치실시간 감지를 활성화한 탭에서 새로 생긴 대상에만 채널이 자동으로 설치됩니다. 그 밖의 대상은 관리자가 직접 설치해야 합니다.
채널 만료채널에는 만료 시각이 있으며, 주기적으로 자동 재등록됩니다.
처리 반영 시점설치·해제는 요청 접수 방식이라 즉시 반영되지 않을 수 있습니다.
공유 드라이브모두 설치 대상이므로 지원하지 않음 상태가 없습니다.
메뉴 표시 조건Google Workspace를 사용하는 고객사에게만 표시됩니다. Microsoft 365 환경에서는 이벤트 리시버 메뉴가 같은 역할을 합니다.
권한메뉴 이용에는 Google Drive 이벤트 채널 역할 권한이 필요합니다. 권한이 없는 관리자에게는 설치, 해제, 동기화 버튼과 실시간 감지 스위치가 비활성화됩니다.

주의사항​

  • 전체 설치는 현재 탭 목록의 모든 대상에 채널을 설치합니다. 내 드라이브 탭에서 실행하면 목록에 있는 모든 사용자의 내 드라이브가 대상이 되므로, 실행 전 대상 범위를 확인해 주세요.
  • 전체 삭제를 실행하면 해당 탭의 모든 드라이브에서 문서 이벤트 수신이 중단됩니다. 채널이 없는 드라이브의 문서에는 조건부 정책이 적용되지 않습니다.
  • 정책 적용 범위를 넓힐 때는 대상 드라이브의 채널 설치 상태를 먼저 확인해 주세요.
  • 조직에 새 구성원이 합류하면 SHIELD ID 인사연동 반영 확인 → 동기화 → 채널 설치 순으로 점검하는 것을 권장합니다.