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: 수신하려는 모든 알림 유형을 포함합니다. ENROLLMENT, STATUS_REPORT, COMMAND 중에서 선택합니다.

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

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

메시지 형식

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

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

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

예상 지연 시간

Enterprise 업그레이드 이벤트는 즉시 전송됩니다.

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

이벤트 유형 기기 내 이벤트와 상응하는 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. ↩