Pub/Sub 알림 설정

참고: 프로그래매틱 방식으로 생성된 ESA를 사용하는 기존 EMM 파트너는 Android Management API용 Pub/Sub 알림을 설정하기 전에 선호하는 Cloud 프로젝트를 Google에 등록해야 합니다. 자세한 내용은 기존 EMM 파트너를 위한 가이드를 참고하세요.

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에 주제에 게시할 권한을 부여합니다.

[e-mail]에 주제에 게시할 권한을 부여해야 합니다. 게시 권한을 부여하는 방법에는 두 가지가 있습니다.

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

• [e-mail]을 주제에 구성원으로 추가합니다.
• 역할 선택 > Pub/Sub > Pub/Sub 게시자를 클릭합니다.

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

• serviceAccount:[e-mail]를 members에 추가합니다.
• role을 roles/pubsub.publisher로 설정합니다.

5. 알림을 지원하려면 Enterprise를 업데이트하세요.

기업에 대한 알림을 생성한 주제에 연결하려면 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 알림은 리소스 유형 Operation을 사용합니다.
• USAGE_LOGS 알림은 리소스 유형 UsageLogEvent를 사용합니다.
• ENROLLMENT 및 STATUS_REPORT 알림은 리소스 유형 기기를 사용합니다.

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

참고: Pub/Sub REST API를 사용할 때 data 필드는 base64 문자열로 인코딩됩니다. 리소스 JSON을 가져오려면 먼저 data의 콘텐츠에 base64 디코딩을 수행한 후 결과 바이트를 UTF-8 문자열로 해석합니다.

예상 지연 시간

빠르게 연달아 발생하는 로컬 기기 이벤트는 일괄 처리되고 단일 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.↩