Configurar recursos

Comunicar-se com APNs usando um certificado TLS

O servidor de notificação pode se comunicar com o Apple Push Notification Service (APNs) usando um certificado TLS.

Primeiro, ative as notificações por push na conta de desenvolvedor. Em seguida, gere um certificado TLS de cliente para o APNs, que funcionará tanto em ambientes de desenvolvimento quanto de produção. Depois, exporte a identidade TLS de cliente do seu Mac e a instale no servidor de notificação. Mais tarde, quando você distribuir o app, o Xcode vai alterar automaticamente a configuração do app do ambiente de desenvolvimento para o de produção.

Outra opção é ativar as notificações por push no projeto do Xcode para realizar etapas adicionais no app.

Função necessária: titular da conta ou administrador.

Gerar um certificado TLS de cliente para o APNs

Gere um certificado TLS de cliente separado para cada app distribuído que usa notificações por push. Gerar o certificado habilita por completo as notificações por push para o App ID associado. Na conta de desenvolvedor, o APNs do App ID muda de Configurable (Configurável) para Enabled (Ativado).

  1. Em Certificates, Identifiers & Profiles (Certificados, Identificadores e Perfis), clique em Identifiers (Identificadores) na barra lateral e selecione o ID de pacote que você deseja atualizar.

  2. Em Capabilities (Recursos), marque a caixa de seleção Push Notifications (Notificações por push) e clique em Configure (Configurar).

  3. No modal, em Production SSL Certificate (Certificado SSL de produção), selecione Create Certificate (Criar certificado).

  4. Crie uma solicitação de assinatura de certificado no Mac e clique em Continue (Continuar).

  5. Clique em Choose File (Escolher arquivo).

  6. Essa ação abrirá uma caixa de diálogo. Selecione o arquivo de solicitação de certificado (um arquivo com a extensão .certSigningRequest) e clique em Choose (Escolher).

  7. Clique em Continue (Continuar).

  8. Clique em Download (Baixar).

  9. O arquivo de certificado (um arquivo com a extensão .cer) aparecerá na pasta Downloads.

Na conta de desenvolvedor, verifique se o APNs do App ID está Enabled (Ativado). Em Identifiers (Identificadores), selecione App IDs e depois selecione o App ID que você quer ver. Um certificado associado aparecerá na linha Push Notifications (Notificações por push).

Para instalar o certificado nas chaves, clique duas vezes no arquivo de certificado baixado no seu Mac. O certificado aparecerá na categoria Meus Certificados em Acesso às Chaves.

Exportar a identidade TLS de cliente do Mac

Exporte a identidade a partir de Acesso às Chaves no Mac em que ela foi criada. Em seguida, copie-a para o local correto no servidor que executa o código do provedor e se conecta à versão de desenvolvimento ou produção do APNs.

  1. Abra Acesso às Chaves.

  2. Na seção Categoria, selecione Meus Certificados.

  3. Encontre o certificado que você quer exportar e exiba seu conteúdo.

    Você verá um certificado e uma chave privada.

  4. Selecione o certificado e a chave. Depois, escolha Arquivo > Exportar Itens.

  5. No menu pop-up Formato do Arquivo, escolha um formato compatível com o seu servidor.

  6. Digite um nome de arquivo no campo Salvar Como e clique em Salvar.

    O certificado e a chave serão salvos no local especificado como um arquivo de texto no formato Personal Information Exchange (um arquivo com a extensão .p12).

Para saber mais sobre as notificações por push, acesse o Guia de programação para notificações locais e remotas.