Contents

Requirements

Configuração

Definir a URL para HTTP/2

Configurar as chaves de autenticação

Adicionar tokens para ambientes de produção e desenvolvimento

Habilitar HTTP/2 se estiver usando XSP 22.0

Reiniciar BroadWorks

Troubleshooting

Referência

Conectar cliente de avaliação

Após 31 de março de 2021, o Servidor de Push de Notificação (NPS) deve usar uma interface HTTP/2 para se comunicar com o Serviço de Notificação por Push da Apple (APNS). A interface HTTP/2 está disponível no BroadWorks Release 22.0 através do patch ap354313 e a versão 23.0 suporta somente HTTP/2.

Se estiver executando o BroadWorks Versão 22.0, o HTTP/2 pode ser configurado usando as seguintes instruções após aplicar o ap354313. Se estiver atualizando para 23.0 ou posterior, serão necessárias as seguintes etapas para configurar HTTP/2 para APNS.

Requirements

Você deve estar em 22.0+ ou 23.0 XSP. Um XSP 22.0/23.0 é compatível para ser executado em paralelo com uma pilha 21.sp1 se o XSP SOMENTE executar NPS e o AS for 21.sp1. Consulte a Matriz de compatibilidade do BroadWorks para obter mais informações.

Você precisará saber quais clientes estão atualmente em uso, pois a ID da chave de autenticação, a ID da equipe e a chave de autenticação serão necessárias para configurar o HTTP/2. Os aplicativos configurados em 21.sp1 podem ser encontrados aqui:

XSP_CLI/Applications/NotificationPushServer/APNS/Production/Certificate> get

- Quaisquer aplicativos iOS que não sejam da Cisco/BroadSoft devem ser configurados para usar o protocolo APNS HTTP/2.

- Os aplicativos Collaborate ou SaaS BroadWorks precisam ser migrados para HTTP/2.

- Adicionar suporte HTTP/2 ao Servidor de envio de notificações para APNs

- Para clientes SaaS, faça login no portal BAM → Configuração → BroadWorks, vá até a seção: Servidor de envio de notificações, selecione a versão adequada na lista suspensa e siga as instruções.

- Para Clientes de avaliação de conexão, abra um tíquete com TAC para solicitar as chaves de autenticação, a ID da chave de autenticação e a ID da equipe. Observe que a ID do aplicativo, a ID da chave de autenticação e a ID da equipe listadas abaixo são para o cliente sem marca, se estiver usando um cliente com marca, essas informações precisarão ser obtidas para seus clientes da Apple.

Os tokens necessários para outros clientes podem ser obtidos no portal do Apple Developer. Consulte a documentação da Apple aqui:

https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/...

Se a atualização para ou a implantação de um novo 22.0, 23.0 ou ADP for necessária, a licença necessária será necessária.

Consulte também as notas de versão relevantes disponíveis no Xchange para SO e requisitos de atualização.

Configuração

Verifique se a URL na CLI do Servidor de Push de Notificação está correta para HTTP/2 para Produção e Desenvolvimento.

Definir a URL para HTTP/2

_CLI/Applications/NotificationPushServer/APNS/Production> get

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

connectionPoolSize = 5

connectionTimeout = 1000

connectionIdleTimeoutInSeconds = 600

_CLI/Applications/NotificationPushServer/APNS/Development> get

url = https://api.development.push.apple.com/3/device

connectionPoolSize = 5

connectionTimeout = 1000

connectionIdleTimeoutInSeconds = 600

As configurações acima podem precisar ser ajustadas para seu sistema específico. O exemplo acima e as recomendações a seguir podem fornecer um ponto de partida.

- O 'ConnectionPoolSize' é o número de conexões simultâneas que o NPS pode fazer com servidores APNS. Isso ajudará na produtividade do NPS e pode não ajudar diretamente a solucionar problemas de tempo limite. O ConnectionPoolSize deve ser aumentado acima de 2, observe que sem o ap377409 o NPS pode não registrar corretamente um valor acima de 2.

- Recomenda-se definir connectionTimeout para um valor acima de 1000.

Configurar auth Keys

_CLI/Applications/NotificationPushServer/APNS/AuthKey> add UTHPSAD667 Y2V5KSH586 /export/home/bwadmin/EVAL_Team-Y2V5KSH586-APNsAuthKey_ID-UTHPSAD667.p8

...Done

_CLI/Applications/NotificationPushServer/APNS/AuthKey> get

Auth Key Id    Team Id     Auth Key

===================================

64D9E5NY4S     D775LZJG9V  ********       <- SaaS

L44B3C998K     698ZB8543V  ********       <- Connect Dev

UTHPSAD667     Y2V5KSH586  ********       <- Connect Eval

3 entry found.

Adicionar tokens para o sistemaAmbientes de ação e desenvolvimento

_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.broadsoft.connect.eval authKeyId UTHPSAD667

...Done

_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> get

App Id   Auth Key Id

===================================================

com.broadsoft.uc-one   64D9E5NY4S       <- SaaS

com.broadsoft.connect.eval   UTHPSAD667       <- Connect Eval

2 entries found.

Habilitar HTTP/2 se usando o XSP 22.0

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true

Note: Se em 23.0 ou ADP esta etapa não é necessária, pois HTTP/2 não pode ser desabilitado.

Reiniciar BroadWorks

restartbw

Troubleshooting

A resposta ao POST HTTP/2 é processada pelo Servidor de Push de Notificação. Um código de resposta "200" dos APNs significa que a notificação foi recebida com êxito pelos APNs e tentará enviar a notificação para o dispositivo. Mensagens de erro detalhadas são capturadas nos registros do Servidor de envio de notificações.

Se a Apple retornar um código de erro, os códigos de erro da Apple podem ser encontrados na documentação da Apple aqui:

https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotifi...

Se estiver usando o ADP, o AS deve ser definido para usar TLSv1.2. Para definir isso, adicione a seguinte opção de contêiner no AS:

AS_CLI/Maintenance/ContainerOptions> add platform bw.apache.sslenabledprotocols "-ALL +TLSv1.2"

Depois que o AS tiver sido definido para usar TLSv1.2, pare o BroadWorks, reinicie o BroadWorks e inicie o BroadWorks novamente no AS.

stopbw

configdctl restart

startbw

Referência

Documentação do BroadWorks HTTP/2: https://xchange.broadsoft.com/node/498995

Alerta sobre o Xchange no que diz respeito à substituição da interface APNS binária anterior: https://xchange.broadsoft.com/node/1053230

Guia de soluções UC-One: https://xchange.broadsoft.com/node/1049202

Consulte as notas de patch no ap354313 para 22.0: https://xchange.broadsoft.com/node/496044

Observe que o ap354313 existe para a plataforma e para o AS, EMS, HZS, PS, NS, NFM, UMS e XSP para atualizar o Java para 8.0_102b, este é um requisito para o XSP em 22.0 trabalhar com HTTP/2, não significa que o UMS também deva estar em 22.0 .

Conectar cliente de avaliação

https://apps.apple.com/in/app/uc-one-connect-evaluation/id1114743230