XenMobile® Server

Firebase 클라우드 메시징

참고:

Firebase 클라우드 메시징(FCM)은 이전에는 Google 클라우드 메시징(GCM)으로 알려져 있었습니다. 일부 XenMobile® 콘솔 레이블 및 메시지에서는 GCM 용어를 사용합니다.

Citrix®는 Android 장치가 XenMobile에 연결하는 방법과 시기를 제어하기 위해 Firebase 클라우드 메시징(FCM)을 사용할 것을 권장합니다. FCM용으로 구성된 경우 XenMobile은 FCM이 활성화된 Android 장치에 연결 알림을 보냅니다. 모든 보안 작업 또는 배포 명령은 푸시 알림을 트리거하여 사용자에게 XenMobile Server에 다시 연결하도록 요청합니다.

이 문서의 구성 단계를 완료하고 장치가 체크인하면 장치는 XenMobile Server의 FCM 서비스에 등록됩니다. 이 연결을 통해 XenMobile 서비스에서 FCM을 사용하여 장치로 거의 실시간 통신이 가능해집니다. FCM 등록은 새 장치 등록 및 이전에 등록된 장치 모두에 적용됩니다.

XenMobile이 장치에 대한 연결을 시작해야 할 때 FCM 서비스에 연결합니다. 그러면 FCM 서비스가 장치에 연결하도록 알립니다. 이러한 유형의 연결은 Apple이 푸시 알림 서비스에 사용하는 방식과 유사합니다.

필수 구성 요소

  • 최신 Secure Hub 클라이언트
  • Google 개발자 계정 자격 증명
  • FCM이 활성화된 Android 장치에 Google Play 서비스 설치

방화벽 포트

  • XenMobile에서 fcm.googleapis.comGoogle.com으로 포트 443을 엽니다.
  • 장치 Wi-Fi에 대해 포트 5228, 5229, 5230에서 아웃바운드 인터넷 통신을 엽니다.
  • 아웃바운드 연결을 허용하려면 FCM은 IP 제한 없이 포트 5228에서 5230까지 허용할 것을 권장합니다. 그러나 IP 제한이 필요한 경우 FCM은 IPv4 및 IPv6 블록의 모든 IP 주소를 허용할 것을 권장합니다. 이러한 블록은 Google ASN 15169에 나열되어 있습니다. 이 목록을 매월 업데이트하십시오. FCM 포트에 대한 자세한 내용은 Google 문서의 FCM 포트를 참조하십시오.

자세한 내용은 포트 요구 사항을 참조하십시오.

아키텍처

이 다이어그램은 외부 및 내부 네트워크에서 FCM의 통신 흐름을 보여줍니다.

FCM 아키텍처

FCM용 Google 계정 구성

  1. Google 개발자 계정 자격 증명을 사용하여 다음 URL에 로그인합니다.

    https://console.firebase.google.com/

  2. 프로젝트 추가를 클릭합니다.

    프로젝트 생성 옵션

  3. 프로젝트를 생성한 후 프로젝트 설정을 클릭합니다.

    프로젝트 설정 옵션

    참고:

    Google은 현재 FCM 구현에 사용되는 HTTP용 FCM 레거시 API를 더 이상 사용하지 않을 예정입니다. 마이그레이션 기한은 2024년 6월 21일입니다. FCM을 레거시 FCM API에서 HTTP v1 API로 마이그레이션해야 합니다. 자세한 내용은 레거시 FCM API에서 HTTP v1으로 마이그레이션을 참조하십시오.

  4. 클라우드 메시징 탭을 클릭합니다. Firebase 클라우드 메시징 API가 활성화되어 있는지 확인하고 서비스 계정 관리를 클릭합니다.

    1. 마이그레이션 전에 레거시 API를 사용할 수 있었으므로 클라우드 메시징 API(레거시)가 활성화되어 있는지 확인하십시오. 보낸 사람 ID 필드의 값을 복사합니다.

      클라우드 메시징 API 활성화

      나열된 키가 없으면 작업 아래의 줄임표를 클릭하여 키를 추가합니다.

      작업

    2. 마이그레이션 후 Google에서 레거시 API가 더 이상 사용되지 않습니다. Firebase 클라우드 메시징 API(V1)를 활성화해야 합니다. 자세한 내용은 레거시 FCM API에서 HTTP v1으로 마이그레이션을 참조하십시오.

      FCM V1 활성화

      프로젝트 설정 아래의 서비스 계정에서 서비스 계정 JSON 파일을 다운로드합니다. 서비스 계정의 개인 키 파일을 생성하려면 수동으로 자격 증명 제공 섹션을 참조하십시오. 새 개인 키 생성을 클릭하여 서비스 계정 키 JSON 파일을 다운로드합니다.

      프로젝트 설정

Android에서 FCM 클라이언트 앱을 설정하는 단계는 다음 Google 개발자 클라우드 메시징 문서를 참조하십시오. https://firebase.google.com/docs/cloud-messaging/android/client.

FCM용 XenMobile 구성

XenMobile 콘솔에서 설정 > Firebase 클라우드 메시징으로 이동합니다.

클라우드 메시징 API(레거시)의 경우

  1. Firebase 클라우드 메시징 구성의 마지막 단계에서 얻은 Firebase 클라우드 메시징 API 키 필드에 입력합니다.

  2. 이전 절차에서 얻은 보낸 사람 ID 값을 입력합니다.

보낸 사람 ID 값 입력

Firebase 클라우드 메시징 API(V1)의 경우

참고:

  • XenMobile Server 버전 10.15 롤링 패치 7 이상에서 FCM API V1을 활성화하려면 기술 자료 문서 CTX677031을 참조하십시오.
  • 새 FCM 사용자인 경우 1단계를 건너뛰고 2단계부터 진행하십시오.
  1. 이미 FCM을 사용 중인 경우 보낸 사람 ID가 현재 FCM 프로젝트로 자동 채워지고 서비스 계정 키 파일을 업로드하는 새 옵션이 표시됩니다.

    현재 사용자를 위한 FCM

  2. 새 FCM 사용자인 경우 이전 절차에서 얻은 보낸 사람 ID를 입력하고 서비스 계정 키 파일을 업로드합니다.

    새 FCM 사용자

  3. 업로드된 파일이 구문 분석되고 해당 필드가 자동으로 생성됩니다.

    구문 분석된 서비스 계정

  4. 정보를 확인하고 저장을 클릭합니다.

구성 테스트

  1. Android 장치를 등록합니다.

  2. 장치가 XenMobile에서 연결 해제되도록 잠시 유휴 상태로 둡니다.

  3. XenMobile 콘솔에 로그인하고 관리를 클릭하고 Android 장치를 선택한 다음 보안을 클릭합니다.

    Android 장치 보안 옵션

  4. 장치 작업에서 선택적 초기화를 클릭합니다.

    보안 작업 - 선택적 초기화

    성공적으로 구성되면 장치에서 선택적 초기화가 수행됩니다.

Firebase 클라우드 메시징