Versão atual do XenMobile Server

Firebase Cloud Messaging

March 16, 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.
Clique na guia Cloud Messaging.
Se Cloud Messaging API (Legacy) estiver desativado, o Server key não será exibido.

Ative Cloud Messaging API (Legacy) da seguinte forma:
1. Clique no botão Reticências ao lado de Cloud Messaging API (Legacy) e, em seguida, clique em Manage API in Google Cloud Console.
2. Em Cloud Messaging, clique no botão Enable.
Copie os valores de Server key e Sender ID. No próximo procedimento, você cola esses valores no console XenMobile. A partir de outubro de 2016, você deve criar chaves de servidor no console do Firebase.

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.

Edite a chave de API e digite a chave do servidor do Firebase Cloud Messaging que você copiou na última etapa da configuração do Firebase Cloud Messaging.
Edite o ID do remetente e digite o valor de ID do remetente copiado no procedimento anterior.

A entrada de valor do ID do Remetente

Depois de concluir a configuração, você pode remover a política de dispositivo Agendamento ou alterar essa política para se conectar com menos frequência.

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

March 16, 2024

Contribuição de:

March 16, 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?