Neste artigo
Visão geral do NPS Authentication Proxy
dropdown icon
Pré-requisitos do proxy de autenticação NPS
    Versões mínimas e restrições de co-residência
    NPS compartilhado
    APNs HTTP/2
    Android FCMv1
Resumo da migração do proxy NPS
Migre os aplicativos iOS do BroadWorks Collaborate para HTTP/2
Migre os aplicativos BroadWorks UC-One Connect/SaaS Android para o FCMv1
Migre os aplicativos BroadWorks UC-One Connect/SaaS Android para o FCMv1 (no ADP)
Reativar o modo legado do FCM
dropdown icon
Instalar patches de proxy de autenticação NPS
    Patches R22
    Patches R23
Configurar o NPS para usar o proxy de autenticação
Reinicie o NPS e teste as notificações push
Atualize o Cisco BroadWorks NPS para usar o proxy NPS: guia de configuração
list-menuNeste artigo
list-menuComentários?

Aprenda a atualizar o Cisco BroadWorks NPS para utilizar o NPS Proxy com este guia de configuração. Descubra instruções passo a passo, considerações e melhores práticas para uma integração perfeita e um desempenho de rede aprimorado.

Visão geral do NPS Authentication Proxy

Este artigo descreve como configurar um NPS compartilhado para usar o proxy de autenticação NPS, para que ele também possa ser usado para enviar notificações de chamadas para aplicativos Webex. Se o seu NPS não oferecer suporte a outros aplicativos, você poderá seguir o procedimento simplificado no Guia de soluções Webex for BroadWorks.

Visão geral do proxy NPS

Para compatibilidade com o Webex for BroadWorks, seu NPS deve ser corrigido para oferecer suporte ao recurso NPS Proxy, Push Server for VoIP em UCaaS.

O recurso implementa um novo design no Notification Push Server para resolver a vulnerabilidade de segurança do compartilhamento de chaves privadas de certificados de notificação push com provedores de serviços para clientes móveis. Em vez de compartilhar certificados e chaves de notificação push com o provedor de serviços, o NPS usa uma nova API para obter um token de notificação push de curta duração do back-end do UCaaS e usa esse token para autenticação com os APNs da Apple e os serviços do Google FCM.

O recurso também aprimora a capacidade do Notification Push Server de enviar notificações para dispositivos Android por meio da nova API HTTPv1 do Google Firebase Cloud Messaging (FCM).

Pré-requisitos do proxy de autenticação NPS

O XSP (ou Application Delivery Platform ADP) que hospeda o NPS deve atender aos seguintes requisitos:

Versões mínimas e restrições de co-residência

  • O NPS deve ser ativado em um XSP/ADP dedicado e o NPS deve ser o único aplicativo hospedado no servidor. Isso é para eliminar a interferência na entrega de notificações push.

  • Só deve haver um aplicativo NPS em uma implantação. Se você estiver usando UC-One Collaborate/Connect e/ou UC-One SaaS móvel e estiver implementando o Webex for BroadWorks, você deve compartilhar esse único NPS para todos os aplicativos.

  • O NPS deve estar na versão R22 ou posterior, XSP ou ADP.

    O R22/R23 XSP é compatível com uma pilha R21 se o XSP executar somente NPS e o AS for R21.SP1. Consulte a Matriz de Compatibilidade do BroadWorks para obter mais informações.

  • Mais informações sobre o servidor ADP podem ser encontradas na Cisco BroadWorks Application Delivery Platform.

NPS compartilhado

Leia estas notas antes de configurar seu NPS compartilhado para usar o proxy NPS:

  • Se seu NPS for usado com outros aplicativos (não apenas com o aplicativo Webex): primeiro configure o proxy NPS e altere o NPS de usar a API legada do FCM para usar a API HTTP v1 do FCM.

  • Depois de verificar se as notificações estão funcionando corretamente para aplicativos mais antigos com o proxy NPS, remova a chave da API do FCM para o aplicativo Android e a chave de autenticação do APNs para o aplicativo iOS.

APNs HTTP/2

  • Se você implantou algum aplicativo iOS que não seja da Cisco/Broadsoft, configure esses aplicativos para usar o protocolo APNS HTTP/2 antes de configurar o NPS para usar o proxy NPS.

  • Os XSP/ADPs que já oferecem suporte ao aplicativo Collaborate ou SaaS BroadWorks precisam ser migrados para HTTP/2. Para obter informações detalhadas sobre a configuração do HTTP/2, consulte Suporte HTTP/2 ao Notification Push Server for APNS (a migração do NPS para dar suporte a esses aplicativos iOS está resumida neste artigo).

Android FCMv1

  • Se você implantou algum aplicativo Android que não seja da Cisco/Broadsoft, configure esses aplicativos para usar as chaves FCMv1 antes de configurar o NPS para usar o proxy NPS.

  • Se o XSP/ADP atualmente oferecer suporte ao aplicativo Connect ou UC-One SaaS, ative as chaves FCMv1 depois de configurar o proxy NPS. Recomendamos que você migre todos os aplicativos adicionais para as chaves FCMv1, ative e teste e, em seguida, desative até que esteja pronto para concluir as instruções de configuração (o fluxo de migração está documentado neste artigo).

Resumo da migração do proxy NPS

Resumo visual da migração para o proxy de autenticação NPS
Tabela 1. Resumo das tarefas a serem migradas para o proxy NPS

Sequência

Título da tarefa

Quando/Por que a tarefa é necessária?

1

Migre o NPS para HTTP/2 para aplicativos iOS UC-One SaaS (ou Connect).

Se o NPS oferecer suporte a esses aplicativos e eles ainda não estiverem configurados para HTTP/2.

2

Migre o NPS para o FCMv1 para aplicativos Android UC-One SaaS (ou Connect).

Se o NPS oferecer suporte a esses aplicativos e eles ainda não estiverem configurados para o FCMv1.

3

Ative o modo FCMv1 e teste as notificações push.

Se o NPS oferecer suporte ao UC-One Connect e/ou a outros aplicativos Android (que não sejam da Cisco).

4

Reative o modo legado do FCM.

Se o NPS estiver oferecendo suporte ao UC-One SaaS. Se você deixar o FCMv1 ativado antes de configurar o proxy NPS, as notificações push para o UC-One SaaS começarão a falhar.

5

Instale os patches do proxy de autenticação do NPS.

Se o NPS estiver no XSP R22 ou no XSP R23.

6

Configure o NPS para usar o proxy de autenticação NPS:

  • Conecte o suporte técnico do NPS

  • Solicitar conta CI OAuth

  • Crie uma conta CI no NPS e configure o tempo limite do token de atualização

  • Adicionar IDs de aplicativos Android

  • Adicionar IDs de aplicativos iOS

  • Verificar/definir URLs e tempos limite de conexão

  • Adicionar aplicativos à lista de permissões do AS

  • (Re-) Ativar o FCMv1

  • Reinicie o XSP/ADP

  • Teste PNs para aplicativos iOS e Android

Sempre necessário.

7

Remova as chaves do modo legado do FCM.

Para aplicativos que são suportados com êxito pelo NPS no FCMv1.

Migre os aplicativos iOS do BroadWorks Collaborate para HTTP/2

Essa tarefa é obrigatória para notificações push para aplicativos UC-One SaaS e Webex em plataformas iOS.

Antes de começar

Se seu XSP estiver executando o R22, você precisará aplicar ap354313 antes de configurar o aplicativo NPS para usar HTTP/2 para APNS.

1

Defina o URL de produção e os parâmetros de conexão em XSP_CLI/applications/notificationpushserver/APNS/Production>

defina o url https://api.push.apple.com/3/device

defina ConnectionPoolSize 2

definir ConnectionTimeout 3000

defina o tempo limite de inatividade da conexão em segundos 600

Nota: Não defina o tempo limite de conexão abaixo de 1000.

2

Adicione os IDs do aplicativo ao contexto dos aplicativos do APNS, certificando-se de omitir a chave de autenticação — defina-a como vazia.

Para UC-One SaaS: XSP_CLI/applications/notificationpushserver/APNS/production/tokens> adicione com.broadsoft.uc-one

Para o aplicativo Webex: XSP_CLI/applications/notificationpushserver/apns/production/tokens> adicione com.cisco.squared

3

Verifique as chaves de autenticação com XSP_CLI/applications/notificationpushserver/apns/production/tokens> get

4

Se a chave de autenticação não estiver vazia para com.broadsoft.uc-one, você pode limpá-la com xsp_cli/applications/notificationpushserver/apns/production/tokens> clear the-authkey

5

Habilitar HTTP/2:

xsp_cli/applications/notificationpushserver/apns/generalSettings> defina como verdadeiro o Http2Enabled

6

Somente para aplicativos SaaS UC-One: Entre no portal do revendedor e vá para Configuração > BroadWorks >.

7

Role para baixo até a seção Notification Push Server, selecione sua versão (por exemplo, Release 22) e siga as instruções fornecidas no portal.

Migre os aplicativos BroadWorks UC-One Connect/SaaS Android para o FCMv1

  • Essa tarefa se aplica ao NPS no XSP. Ignore-o se seu NPS estiver no ADP.

  • Você pode usar esse procedimento para migrar para notificações FCMv1 para aplicativos Android UC-One Connect ou UC-One SaaS.

  • Você deve usar o FCMv1 se quiser usar o proxy NPS para autenticar notificações push no UC-One ou nos aplicativos Webex Android.

  • Essa tarefa prepara o NPS para o FCMv1 para que você possa habilitá-lo como parte da configuração do proxy de autenticação do NPS. Não habilite o FCMv1 até que você esteja pronto para configurar o proxy de autenticação NPS, ou as notificações para clientes SaaS falharão.

1

Obtenha o ID do projeto no Firebase console:

  1. Faça login em console.firebase.google.com.

  2. Selecione o projeto do aplicativo UC-One (Connect ou SaaS) e abra as configurações do projeto.

  3. Abra a guia Geral e registre o ID do projeto.

2

Obtenha a chave privada da sua conta de serviço no Firebase:

  1. Navegue até a guia Contas de serviço nas configurações do projeto.

  2. Crie uma nova conta de serviço e obtenha sua chave privada.

  3. Ou abra uma conta de serviço existente e gere uma nova chave privada para ela.

    Observação: a conta de serviço precisa ter a permissão firebaseadmin-sdk.

  4. Baixe a chave para um local seguro.

3

Copie a chave para o XSP que hospeda seu NPS.

4

Adicione o ID do projeto e a chave privada associada ao contexto dos projetos do FCM:

XSP_CLI/applications/NotificationPushServer/FCM/projects> adicionar caminho/para/arquivo-chave do ID do projeto

5

Adicione o aplicativo UC-One (Connect ou SaaS) e o ID do projeto associado ao contexto dos aplicativos do FCM:

xsp_cli/applications/notificationpushserver/FCM/applications> adicionar applicationID com.broadsoft.connect projectID project-id

6

Compare a configuração do FCM com os atributos e valores recomendados mostrados aqui. Use a versão definida do comando para alterar os valores, se necessário:

Execute xsp_cli/applications/notificationpushserver/fcm> get

Parâmetro

Valor recomendado

URL de autenticação

https://www.googleapis.com/oauth2/v4/token

Enviar URL

https://fcm.googleapis.com/v1/projects/ PROJECT-ID /mensages:enviar

escopo

https://www.googleapis.com/auth/firebase.messaging

Tomou um tempo para viver em segundos

3600

Tamanho do pool de conexão

10

Tempo limite de conexão em milissegundos

3000

Tempo limite de inatividade da conexão em segundos

600

Migre os aplicativos BroadWorks UC-One Connect/SaaS Android para o FCMv1 (no ADP)

  • Essa tarefa se aplica ao NPS no ADP. Ignore-o se seu NPS estiver no XSP.

  • Você pode usar esse procedimento para migrar para notificações FCMv1 para aplicativos Android UC-One Connect ou UC-One SaaS.

  • Você deve usar o FCMv1 se quiser usar o proxy NPS para autenticar notificações push no UC-One ou nos aplicativos Webex Android.

  • Essa tarefa prepara o NPS para o FCMv1 para que você possa habilitá-lo como parte da configuração do proxy de autenticação do NPS. Não habilite o FCMv1 até que você esteja pronto para configurar o proxy de autenticação NPS, ou as notificações para clientes SaaS falharão.

1

Obtenha o ID do projeto no Firebase console:

  1. Faça login em console.firebase.google.com.

  2. Selecione o projeto do aplicativo UC-One (Connect ou SaaS) e abra as configurações do projeto.

  3. Abra a guia Geral e registre o ID do projeto.

2

Obtenha a chave privada da sua conta de serviço no Firebase:

  1. Navegue até a guia Contas de serviço nas configurações do projeto.

  2. Crie uma nova conta de serviço e obtenha sua chave privada.

  3. Ou abra uma conta de serviço existente e gere uma nova chave privada para ela.

    Observação: a conta de serviço precisa ter a permissão firebaseadmin-sdk.

  4. Faça o download da chave (arquivo.json) em um local seguro.

3

Importe o arquivo.json para o servidor ADP /bw/install.

4

Faça login na CLI do ADP e adicione o projeto e a chave da API ao contexto dos projetos do FCM:

adp_cli/applications/notificationpushserver/FCM/projects> adicionar connect-ucaas /bw/install/ filename.json

5

Adicione o ID do aplicativo e do projeto ao contexto dos aplicativos do FCM:

adp_cli/applications/notificationpushserver/FCM/applications> adicionar applicationID com.broadsoft.ucaas.connect projectID project-id

6

Verifique sua configuração:

ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get
Project ID Accountkey
========================
connect-ucaas ********
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas

Reativar o modo legado do FCM

Você só precisa fazer isso (como parte da migração) se:

  • Seu NPS é usado para aplicativos Android UC-One SaaS ou BroadWorks Connect.

  • Você já testou que as notificações push de chamadas para outros aplicativos estão funcionando com a API FCMv1.

Você está desativando temporariamente o FCMv1 porque as chaves FCMv1 desses aplicativos só devem ser habilitadas durante o processo de configuração do proxy de autenticação NPS.

1

Faça login no XSP que hospeda seu NPS compartilhado.

2

Navegue até o contexto do FCM e desative o FCM v1: xsp_cli/applications/notificationpushserver/fcm> set v1Enabled false para voltar a usar a chave de API legada do FCM.

Configurar o NPS para usar o proxy de autenticação

1

Crie uma solicitação de serviço com seu contato de integração ou com o TAC para provisionar sua conta de cliente OAuth (Webex Common Identity). Dê um título à sua solicitação de serviço Configuração NPS para Configuração do Proxy de Autenticação.

Fornecemos a você um ID de cliente OAuth, um segredo de cliente e um token de atualização válido por 60 dias. Se o token expirar antes de você usá-lo com seu NPS, você poderá fazer outra solicitação.
2

Crie a conta do cliente no NPS:

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> defina o ID do cliente do ClientID a partir da etapa 1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Execute o comando para verificar se os valores inseridos correspondem aos fornecidos a você. xsp_cli/Aplicativos/NotificationPushServer/Ciscoci/Client> get

3

Insira a URL do proxy NPS e defina o intervalo de atualização do token (recomenda-se 30 minutos):

FQDNs baseados na região:

Leste dos EUA:

xsp_cli/applications/notificationpushserver/cloudnpsservice> defina o url https://broadworks-idp-proxy-a.wbx2.com/nps/

Oeste dos EUA:

xsp_cli/applications/notificationpushserver/cloudnpsservice> defina o url https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

xsp_cli/applications/notificationpushserver/cloudnpsservice> defina o url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Aplicativos/NotificationPushServer/CloudNPSService> defina o intervalo de atualização de VoipToken 1800

Arábia Saudita:

xsp_cli/applications/notificationpushserver/cloudnpsservice> defina o url https://broadworks-idp-proxy-d.wbx2.com/nps/

Austrália:

xsp_cli/applications/notificationpushserver/cloudnpsservice> defina o url https://broadworks-idp-proxy-m.wbx2.com/nps/

Se as notificações push expirarem devido a um atraso na resolução do DNS, aumente o valor do tempo limite no arquivo “/etc/resolv.conf” no servidor BroadWorks.

4

(Para notificações do Android) Adicione os IDs dos aplicativos Android ao contexto dos aplicativos do FCM no NPS.

Para o aplicativo Webex no Android: xsp_cli/applications/notificationpushserver/FCM/applications> adicione com.cisco.wx2.android

Para o aplicativo UC-One no Android: XSP_CLI/applications/notificationpushserver/FCM/applications> adicione com.broadsoft.connect

5

(Para Apple iOS notificações) Adicione o ID do aplicativo ao contexto dos aplicativos do APNS, certificando-se de omitir a chave Auth — defina-a como vazia.

Para o aplicativo Webex no iOS: xsp_cli/applications/notificationpushserver/apns/production/tokens> adicione com.cisco.squared

Para o aplicativo UC-One no iOS: xsp_cli/applications/notificationpushserver/apns/production/tokens> adicione com.cisco.squared

6

Configure os seguintes URLs do NPS:

Contexto da CLI do XSP

Parâmetro

Valor

XSP_CLI/Aplicativos/Servidor push de notificação/FCM>

URL de autenticação

https://www.googleapis.com/oauth2/v4/token

Enviar URL

https://fcm.googleapis.com/v1/projects//messages:send

escopo

https://www.googleapis.com/auth/firebase.messaging

XSP_CLI/Aplicativos/Servidor push de notificação/APNS/Produção >

url

https://api.push.apple.com/3/device

7

Configure os seguintes parâmetros de conexão NPS de acordo com os valores recomendados mostrados:

Contexto da CLI do XSP

Parâmetro

Valor

XSP_CLI/Aplicativos/Servidor push de notificação/FCM>

Tomou um tempo para viver em segundos

3600

Tamanho do pool de conexão

10

Tempo limite de conexão em milissegundos

3000

Tempo limite de inatividade da conexão em segundos

600

XSP_CLI/Aplicativos/Servidor push de notificação/APNS/Produção >

Tempo limite de conexão

3000

Tamanho do pool de conexão

2

Tempo limite de inatividade da conexão em segundos

600

8

Verifique se o servidor do aplicativo está examinando os IDs dos aplicativos, pois talvez seja necessário adicionar os aplicativos Webex à lista de permissões:

  1. Execute as_CLI/System/PushNotification> get e verifique o valor de enforceAllowedApplicationList. Se for verdade, você precisa concluir essa subtarefa. Caso contrário, ignore o restante da subtarefa.

  2. as_cli/System/PushNotification/AllowApplications> adicione com.cisco.wx2.android “Webex Android”

  3. as_cli/System/PushNotification/AllowApplications> adicione com.cisco.squared “Webex iOS”

Reinicie o NPS e teste as notificações push

1

Reinicie o XSP:

bwrestart
2

Teste as notificações de chamadas para Android fazendo chamadas de um assinante da BroadWorks para o cliente de chamadas no Android. Verifique se a notificação de chamada aparece no dispositivo Android.

Nota: Se as notificações push começarem a falhar para o aplicativo Android UC-One, é possível que haja uma configuração incorreta. Se essa for sua situação, você pode reverter para o FCM legado da seguinte forma:

  1. Desative o FCMv1: xsp_cli/applications/notificationpushserver/fcm> defina V1Enabled false

  2. Reinicie o XSP: bwrestart

  3. Verifique sua configuração.

  4. Reative o FCMv1 e reinicie o XSP.

  5. Repita o teste.

3

Teste as notificações de chamadas para iOS fazendo chamadas de um assinante da BroadWorks para o cliente de chamadas no iOS. Verifique se a notificação de chamada aparece no dispositivo iOS.

Nota: Se as notificações push começarem a falhar para o aplicativo iOS UC-One, é possível que haja uma configuração incorreta. Se essa for sua situação, você pode reverter para a interface binária legada com set http2Enabled false

Este artigo foi útil?
Este artigo foi útil?