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
Feedback