Pub/Sub 알림 설정

Pub/Sub 알림을 사용하면 새로 등록된 기기, 기기 보고서, 최근에 실행된 명령어에 관한 알림을 받을 수 있습니다.

Pub/Sub 알림을 설정하려면 Pub/Sub API를 사용 설정하고 주제를 만들어야 합니다. 주제에 게시된 메시지를 받으려면 해당 주제에 대한 구독을 생성해야 합니다. 구독은 주제에 게시된 메시지를 수신하고 처리하는 구독자 애플리케이션과 주제를 연결합니다. 정기 결제를 만든 후에는 Android Device Policy에 주제에 게시할 수 있는 권한을 부여해야 합니다.

1. 프로젝트에서 Pub/Sub API 사용 설정

Pub/Sub API를 사용 설정하는 방법은 콘솔 빠른 시작 가이드를 참고하세요. Android Management API가 사용 설정된 동일한 프로젝트를 선택해야 합니다.

2. 주제 만들기

API를 사용 설정한 후 Android Device Policy에서 알림을 게시할 수 있는 주제를 만들어야 합니다. 주제를 만드는 방법에는 두 가지가 있습니다.

a. Google Cloud 콘솔에서 수동으로
b. Pub/Sub API 사용 (주제 만들기 메서드 참고)

주제를 만든 후 주제 이름을 적어둡니다.

3. 구독 만들기

구독은 특정 주제에 게시된 메시지의 스트림을 캡처합니다. 정기 결제를 만드는 방법에는 두 가지가 있습니다.

a. Google Cloud 콘솔에서 수동으로
b. Pub/Sub API 사용 (구독 만들기 메서드 참고)

4. Android Device Policy에 주제에 게시할 권한 부여

android-cloud-policy@system.gserviceaccount.com에 주제에 게시할 권한을 부여해야 합니다. 게시 권한을 부여하는 방법에는 두 가지가 있습니다.

a. Google Cloud 콘솔에서 수동으로

  • android-cloud-policy@system.gserviceaccount.com을 주제의 구성원으로 추가합니다.
  • 역할 선택 > Pub/Sub > Pub/Sub 게시자를 클릭합니다.

b. Pub/Sub API 사용 (IAM API를 통한 액세스 제어 참고)

  • members에 serviceAccount:android-cloud-policy@system.gserviceaccount.com을 추가합니다.
  • role를 roles/pubsub.publisher로 설정합니다.

5. 알림을 지원하도록 엔터프라이즈 업데이트

지원하려는 알림이 항상 지원되는 ENTERPRISE_UPGRADE인 경우 이 단계를 건너뛰세요.

엔터프라이즈에 관한 알림을 만든 주제에 연결하려면 enterprises.patch를 호출하고 다음 매개변수를 지정합니다.

  • pubsubTopic: projects/{project}/topics/{topic} 형식의 Pub/Sub 주제 이름입니다.
  • enabledNotificationTypes: 수신하려는 모든 알림 유형을 포함합니다.

6. Pub/Sub API를 사용하여 알림 받기

구독은 메시지 전달을 위해 push 또는 pull 방법을 사용합니다. 이 두 메커니즘을 통해 알림을 수신하는 방법에 관한 가이드라인과 안내는 Pub/Sub 구독자 가이드에서 확인할 수 있습니다.

메시지 형식

메시지는 PubsubMessage 형식을 사용합니다. 메시지의 attributes 필드에는 키가 notificationType이고 값이 메시지를 트리거한 알림 유형 (예: ENROLLMENT)으로 설정된 속성이 포함됩니다. 메시지의 data 필드에는 업데이트된 리소스의 JSON 표현이 UTF-8 문자열로 인코딩되어 포함됩니다. 알림과 해당 리소스 유형은 다음과 같습니다.

  • COMMAND 알림은 리소스 유형 Operation을 사용합니다.
  • USAGE_LOGS 알림은 UsageLogEvent 리소스 유형을 사용합니다.
  • ENROLLMENT 및 STATUS_REPORT 알림은 기기 리소스 유형을 사용합니다.
  • ENTERPRISE_UPGRADE 알림은 EnterpriseUpgradeEvent 리소스 유형을 사용합니다.

엔터프라이즈에서 pubsubTopic를 설정하면 notificationType이 test로 설정된 초기 메시지가 게시됩니다. 이 메시지는 Android Device Policy에 주제에 대한 게시 권한이 있는지 확인하기 위해 전송되며 무시해야 합니다.

예상 지연 시간

엔터프라이즈 업그레이드 이벤트는 즉시 전송되어야 합니다.

빠르게 연속으로 발생하는 로컬 기기 이벤트는 일괄 처리되어 단일 Pub/Sub 메시지로 EMM에 보고됩니다.

이벤트 유형 온디바이스 이벤트와 해당 EMM 알림 간의 예상 지연 시간1
우선순위가 높은 키가 지정된 앱 상태 즉시, 분당 최대 1개 보고서
표준 우선순위 키가 지정된 앱 상태 1분 이내
IT 관리자가 정의한 설치 상태가 있는 앱의 프로비저닝 중 애플리케이션 관련 이벤트2 다른 관련 프로비저닝 이벤트에 더해 1분 이내
IT 관리자가 정의한 설치 상태가 있는 앱의 프로비저닝 후 애플리케이션 관련 이벤트입니다. 5분 이내
프로비저닝 중 및 프로비저닝 후의 애플리케이션 관련 이벤트(직원이 정의한 설치 상태가 있는 앱의 경우)3 60분 이내
기타 온디바이스 앱 이벤트 60분 이내

  1. 통제된 상황을 기반으로 한 최선을 다한 타겟입니다. 실제 지연 시간은 다양한 기기 및 환경 요인에 따라 달라질 수 있습니다. ↩

  2. 정책에서 시행되는 앱의 InstallType: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED, KIOSK ↩

  3. 사용 가능한 앱의 InstallType: AVAILABLE, INSTALL_TYPE_UNSPECIFIED ↩