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 Platform 콘솔에서 직접 만듭니다.
b. Pub/Sub API 사용 (주제 메서드 만들기 참조).

주제를 만든 후에는 주제 이름을 기록해 둡니다.

3. 구독 만들기

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

a. Google Cloud Platform 콘솔에서 직접 만듭니다.
b. Pub/Sub API 사용 (구독 메서드 만들기 참고)

4. Android Device Policy에 주제에 게시할 권한을 부여합니다.

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

a. Google Cloud Platform 콘솔에서 직접 만들기

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

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

  • serviceAccount:android-cloud-policy@system.gserviceaccount.commembers에 추가합니다.
  • roleroles/pubsub.publisher로 설정합니다.

5. 알림을 지원하려면 엔터프라이즈를 업데이트하세요

기업에 대한 알림을 생성한 주제에 연결하려면 enterprises.patch를 호출하고 다음 매개변수를 지정합니다.

  • pubsubTopic: projects/{project}/topics/{topic} 형식으로 된 Pub/Sub 주제의 이름입니다.
  • enabledNotificationTypes: 수신하려는 모든 알림 유형을 포함합니다. ENROLLMENT, STATUS_REPORT, COMMAND 중에서 선택하세요.

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

구독은 메시지 전송을 위해 푸시 또는 풀 메커니즘을 사용할 수 있습니다. 이 두 메커니즘을 통해 알림을 수신하는 방법에 대한 가이드라인과 지침은 Pub/Sub 구독자 가이드에서 확인할 수 있습니다.

메시지 형식

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

  • COMMAND 알림은 리소스 유형 작업을 사용합니다.
  • USAGE_LOGS 알림은 리소스 유형 UsageLogEvent를 사용합니다.
  • ENROLLMENTSTATUS_REPORT 알림은 리소스 유형 기기를 사용합니다.

Enterprise에서 pubsubTopic를 설정하면 초기 메시지는 notificationTypetest로 설정된 상태로 게시됩니다. 이 메시지는 Android Device Policy에서 주제에 관한 게시 권한이 있으며 무시해야 하는지 확인하기 위해 전송됩니다.