Skip to main content

Google Workspace Integration Setup Guide

info

**Google Workspace integration proceeds after obtaining approval from Google (domain-wide delegation), followed by installing event channels for each drive on the SHIELD DRM admin page.**The conditional policy operates from the drive where the channel is installed.

This document provides guidance on the steps to initially integrate SHIELD DRM in a Google Workspace environment from the perspective of the implementation manager. For detailed operations by screen, please refer to the administrator guide, and this document isOrder and confirmation methods for each step, response in case of failureFocus.

Relationship with Microsoft 365 Integration​

Microsoft 365 Environment of 「Migration Guide」and the structure is similar. Google Workspace has an event receiver that transitions from the Add-In.전환There is none, but the initial setup procedure corresponds as follows.

itemMicrosoft 365Google Workspace
Permission ApprovalMicrosoft app permission consent URLService Account Domain-Wide Delegation Approval
Event Receiver Installation UnitSite · OneDrive Unit Event ReceiverDrive Unit Change Notification Channel
Management Menu연동 관리 → 이벤트 리시버연동 관리 → Google Drive 이벤트 채널
Installation MaintenanceKeep after installationChannel validity period 7 days, automatic re-registration

Integration Order​

1. Pre-check preparation​

「Google Workspace Pre-GuideCheck if the preparation of __PH_0__ is complete.

Check ItemsHow to check
Google Workspace users are synchronized with SHIELD ID.Check if there are Google Workspace users in the SHIELD ID user list.
Admin account for integrationDrive 및 문서You have administrator privileges.Google Admin Console →계정 → 관리자 역할
Domain-wide delegation has been approved.Google Admin Console →보안 → API 관리 → 도메인 전체 위임 관리List of Client ID and Scopehttps://www.googleapis.com/auth/driveis displayed

Full domain delegation may take up to 24 hours to reflect after approval. If the next step fails immediately after approval, please wait for the reflection and try again.

2. Registration of Integration Administrator Account​

The email address of the integration administrator account will be provided to the SHIELD DRM operations manager. The operations manager will register it in the client company settings.

If this account is not registered, retrieving the shared drive list and installing the shared drive channel will fail.

3. Document Security Server Integration​

SHIELD DRM must be integrated with the customer's document security server to decrypt the encryption of the DRM document. The procedure is the same regardless of the cloud service. Administrator Guide 「Document Security ServerPlease follow the 」.

4. Event Channel Installation​

SHIELD DRM Admin Page →연동 관리 → Google Drive 이벤트 채널will proceed. Screen manipulation is in the administrator guide 「Google Drive Event ChannelPlease refer to 」.

  1. 내 드라이브in the tab동기화Execute to retrieve the user list of SHIELD ID. Before execution, the list is empty.
  2. 사용자 IDCheck if Google Workspace email is displayed in the column. Empty users need SHIELD ID synchronization.
  3. Select the user to protect채널 설치to execute,전체 설치executes.
  4. 공유 드라이브Change to tab동기화Install in the same way as after. At this time, SHIELD DRM has service accounts for each shared drive.참여자to add.
  5. In a moment새로 고침Press채널 설치 상태a설치Check if it has changed to.
  • Installation is a request reception method, so it may not be reflected immediately.
  • Google Drive 이벤트 채널The menu is only displayed to customers who have contracted Google Workspace. If the menu is not visible, please contact the SHIELD DRM operations manager.

5. Conditional Policy Registration​

조건부 정책 → Cloud Storage → Google WorkspaceRegistering policies. Administrator Guide 「Google Workspace Conditional PoliciesPlease refer to 」.

To re-protect a document downloaded on a PC조건부 정책 → Endpoint → Document SecurityYou also need to establish policies.

6. Operation Confirmation​

  1. Upload the policy-targeted DRM document to the drive where the channel is installed.
  2. document's버전 관리A new version is added, and check if the document opens in Google Drive.
  3. Admin Page로그 → 「Document Conversion LogCheck the processing results in ")".

Response to Failure​

SymptomsCauseResponse
Installation of the channel failed on all drives.Domain full delegation not approved, before reflection, or range input errorCheck the client ID and scope of the entire domain delegation list. If it is immediately after approval, wait up to 24 hours before reinstalling.
My drive list is empty동기화not executed, or there are no active users on the SHIELD ID내 드라이브in the tab동기화executes. If it is still empty, check the SHIELD ID user list.
The shared drive list is empty or the retrieval has failed.Unregistered integration administrator account,Drive 및 문서No administrator privileges, or the account domain is different from my drive user domain.Check the registered accounts and their domains with the operations manager, and verify the administrator role of the account.
Only specific shared drives fail to install.The drive does not allow access for external users, so a service account cannot be added.Check external access restrictions in shared drive settings.
My drive status is지원하지 않음User's SHIELD ID account is not linked to a Google Workspace account, or the account cannot use Drive.After SHIELD ID synchronization동기화 → 채널 설치re-execute
Channel is설치The shared drive document is not processed.Someone has removed the service account from the shared drive members or lowered its role.Unlink the channel of the shared drive and then reinstall. When reinstalling, the service account will be added again.
I'm worried that if I leave the channel unattended, it might expire.Channel validity period is up to 7 days.SHIELD DRM automatically re-registers before expiration, so the administrator does not need to reinstall it.

If the above method does not resolve the issue, please contact the SHIELD DRM operations team with the reason for failure from the document conversion log.

Reference Document​