XenMobile Server

Firebase Cloud Messaging

Nota:

Firebase Cloud Messaging (FCM) era anteriormente conhecido como Google Cloud Messaging (GCM). Alguns rótulos e mensagens do console XenMobile usam a terminologia do GCM.

A Citrix recomenda que você use o Firebase Cloud Messaging (FCM) para controlar como e quando dispositivos Android se conectam ao XenMobile. O XenMobile, quando configurado para FCM, envia notificações de conexão para dispositivos Android habilitados para FCM. Qualquer ação de segurança ou comando de implantação dispara uma notificação por push para solicitar ao usuário que se reconecte ao XenMobile Server.

Depois de concluir as etapas de configuração deste artigo e um dispositivo fazer check-in, o dispositivo se registra no serviço FCM no XenMobile Server. Essa conexão permite a comunicação quase em tempo real do seu XenMobile Service com o seu dispositivo usando o FCM. O registro do FCM funciona para registros de novos dispositivos e dispositivos registrados anteriormente.

Quando o XenMobile precisa iniciar uma conexão com o dispositivo, ele se conecta ao serviço FCM. Em seguida, o serviço FCM notifica o dispositivo para se conectar. Esse tipo de conexão é semelhante ao que a Apple usa para seu Serviço de Notificação por Push.

Pré-requisitos

  • Secure Hub cliente mais recente
  • Credenciais de conta de desenvolvedor do Google
  • Serviços do Google Play instalados em dispositivos Android habilitados para FCM

Portas de firewall

  • Abra a porta 443 no XenMobile para fcm.googleapis.com e Google.com.
  • Abrir comunicação com a Internet de saída para dispositivo Wi-Fi nas portas 5228, 5229 e 5230.
  • Para permitir conexões de saída, o FCM recomenda a inclusão das portas de 5228 a 5230 na lista de permissão sem restrições de IP. No entanto, se você precisar de restrições de IP, o FCM recomenda colocar na lista de permissão todos os endereços IP nos blocos IPv4 e IPv6 Esses blocos estão listados no Google ASN de 15169. Atualize essa lista mensalmente. Para obter mais informações sobre portas FCM, consulte a documentação do Google sobre Portas FCM.

Para obter mais informações, consulte Requisitos de porta.

Arquitetura

Esse diagrama mostra o fluxo de comunicação do FCM nas redes externa e interna.

A arquitetura do FCM

Para configurar sua conta do Google para FCM

  1. Faça login na seguinte URL usando suas credenciais de conta de desenvolvedor do Google:

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

  2. Clique em Add project.

    A opção de criação de projeto

  3. Depois de criar o projeto, clique em Project settings.

    A opção de configurações do projeto

    Nota:

    O Google descontinuará as APIs legadas do FCM para HTTP, que atualmente são usadas em nossa implementação do FCM. O prazo de migração é 21 de junho de 2024. Precisamos migrar o FCM da API legada do FCM para a API HTTP v1. Para obter mais informações, consulte Migrar de APIs legadas do FCM para o HTTP v1.

  4. Clique na guia Cloud Messaging. Verifique se a API do Firebase Cloud Messaging está ativada e clique em Gerenciar contas de serviço.

    1. Antes da migração, você poderia usar a API legada. Garanta que a API do Cloud Messaging (legada) esteja ativada. Copie os valores dos campos Chave e ID de remetente.

      Ativar Cloud Messaging API

      Se você não tiver uma chave listada, clique nas reticências em Ações para adicionar uma chave.

      Ações

    2. Após a migração, a API legada foi descontinuada do Google. Você precisa ativar a API do Firebase Cloud Messaging (V1). Para obter mais informações, consulte Migrar de APIs legadas do FCM para o HTTP v1.

      Ativar FCI

      Baixe o arquivo JSON da conta de serviço de Contas de serviço em Configurações do projeto. Consulte a seção Fornecer credenciais manualmente para gerar um arquivo de chave privada para sua conta de serviço. Clique em Gerar nova chave privada para baixar o arquivo JSON da chave da conta de serviço.

      Configurações do projeto

Para obter as etapas para configurar um aplicativo cliente FCM no Android, consulte este artigo do Google Developers Cloud Messaging: https://firebase.google.com/docs/cloud-messaging/android/client.

Para configurar o XenMobile para FCM

No console XenMobile, acesse Configurações > Firebase Cloud Messaging.

Para API do Cloud Messaging (legada)

  1. Insira a chave do Firebase Cloud Messaging da última etapa da configuração do Firebase Cloud Messaging no campo Chave de API.

  2. Insira o valor da ID de remetente do procedimento anterior.

A entrada de valor do ID do Remetente

Para API do Firebase Cloud Messaging (V1)

Notas:

  • Para ativar a API do FCM V1 para o XenMobile Server versão 10.15 Patch contínuo 7 e posterior, consulte o artigo CTX677031 do Knowledge Center.
  • Se você for um novo usuário do FCM, pule a etapa 1 e continue com a etapa 2.
  1. Se você já estiver usando o FCM, notará que a ID de remetente é preenchida automaticamente com seu projeto atual do FCM e uma nova opção para carregar o Arquivo de chave da conta de serviço.

    FCM para usuários atuais

  2. Se você for um novo usuário do FCM, insira a ID de remetente e carregue o Arquivo de chave da conta de serviço do procedimento anterior.

    Novo usuário do FCM

  3. O arquivo carregado será analisado e os campos correspondentes serão gerados automaticamente.

    Conta de serviço analisada

  4. Verifique as informações e clique em Salvar.

Para testar sua configuração

  1. Registre um dispositivo Android.

  2. Deixe o dispositivo ocioso por algum tempo, para que ele seja desconectado do XenMobile.

  3. Faça login no console XenMobile, clique em Gerenciar, selecione o dispositivo Android e clique em Segurança.

    A opção de Segurança do dispositivo Android

  4. Em Ações do dispositivo, clique em Apagamento seletivo.

    A opção de Limpeza seletiva

    Em uma configuração bem-sucedida, o apagamento seletivo ocorre no dispositivo.

Firebase Cloud Messaging