XenMobile Server

Firebase Cloud Messaging

July 4, 2024

Contribuição de:

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

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

https://console.firebase.google.com/
Clique em Add project.
Depois de criar o projeto, clique em Project settings.

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.
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.
  
  Se você não tiver uma chave listada, clique nas reticências em Ações para adicionar uma chave.
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.
  
  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.

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)

Insira a chave do Firebase Cloud Messaging da última etapa da configuração do Firebase Cloud Messaging no campo Chave de API.
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.

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.
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.
O arquivo carregado será analisado e os campos correspondentes serão gerados automaticamente.
Verifique as informações e clique em Salvar.

Para testar sua configuração

Registre um dispositivo Android.
Deixe o dispositivo ocioso por algum tempo, para que ele seja desconectado do XenMobile.
Faça login no console XenMobile, clique em Gerenciar, selecione o dispositivo Android e clique em Segurança.
Em Ações do dispositivo, clique em Apagamento seletivo.

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

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Firebase Cloud Messaging

July 4, 2024

Contribuição de:

July 4, 2024

Contribuição de:

Neste artigo

Pré-requisitos
Arquitetura
Para configurar sua conta do Google para FCM
Para configurar o XenMobile para FCM
Para testar sua configuração

Isso foi útil?