Gerando Certificado APNS

Esta página descreve os passos necessários para gerar o certificado APNS, necessário para disparos de push na Dito.

Criando o certificado SSL

O primeiro passo é criar um App ID e o certificado SSL associado no site da Apple Developer Member Center. Este certificado irá permitir que o servidor envie push notifications para a aplicação identificado pelo App ID.

Pedido de Certificado

Para começar, vamos precisar de um arquivo de solicitação para a assinatura do certificado. Isto será utilizado para autenticar a criação do certificado SSL.

  1. Inicie a aplicação "Keychain Access" no Mac.

  2. Selecione o item do menu “Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority…”.

879

  1. Digite seu e-mail e nome.

  2. Selecione “Saved to disk” para realizar o download do arquivo .certSigningRequest.

617

Criando um App ID

Toda aplicação iOS instalado no dispositivo do desenvolvedor necessita de um App ID. Como convenção, são representados por endereços invertidos (ex.: com.example.MyPushApp).

  1. Navegue no site do Apple Developer Member Center e selecione Certificates, Identifiers & Profiles.
  2. Selecione Identifiers na seção iOS Apps.
  3. Você verá a lista de seus iOS App IDs. Selecione o botão + para registrar um novo App ID.

976

  1. Digite um nome para seu novo App ID e marque o checkbox para habilitar o serviço de Push Notifications, localizado abaixo de App Services.

674

672

  1. Abaixo de App ID Suffix selecione Explicit App ID. Digite o Bundle ID de seu ap iOS. Esta string deve ser igual ao Bundle Identifier no arquivo Info.plist em seu app iOS.

668

  1. Selecione “Continue” e depois “Submit” para finalizar o registro.

Configurando o App ID para Push Notification

Agora que você criou um App ID, é hora de configurar o App ID para Push Notifications.

  1. Selecione o novo App ID criado da lista de iOS App IDs, então selecione “Edit”.

723

  1. Desça até a seção de Push Notifications. Aqui você será capaz de criar tanto um Certificado SSL de desenvolvimento bem como uma de produção. Comece selecionando “Create Certificate” em “Development SSL Certificate”.

679

  1. A próxima tela mostrará instruções para criar um Certificate Signing Request (CSR). Isto é o mesmo arquivo .certSigningRequest criado anteriormente. Selecione “Continue”, então escolha “Choose File...” e coloque esse arquivo.
  2. Selecione “Generate”. Uma vez que o certificado estiver pronto, selecione “Done” e depois realize o download do certificado.

677

  1. Clique duas vezes no certificado SSL baixado para instalá-lo em seu Keychain.
  2. No Keychain Access, dentro de “My Certificates”, procure o certificado que você adicionou.

879

  1. Clique com o botão direito, selecione "Export Apple Development IOS Push Services:..." e salve como arquivo .p12. Você será solicitado para digitar uma senha que será usada para proteger o certificado exportado. Não digite uma senha de exportação quando solicitado!

Criando um Provisioning Profile

Um Provisioning Profile autentica seu dispositivo a rodar o app que você está desenvolvendo. Se você tiver criado um novo App ID ou alterado um existente você vai precisar gerar novamente o Provisioning Profile e instalá-lo. Se você tiver problemas ao usar um profiling existente, tente remover o App ID e configurá-lo novamente, Neste tutorial iremos criar um novo.

  1. Navegue no website Apple Developer Member Center e selecione Certifies, Identifiers & Profiles.

  2. Selecione Provisioning Profiles na seção iOS Apps.

  3. Selecione o botão + para criar um novo Provisioning Profile.

  4. Escolha “iOS App Development” como seu tipo de Provisioning Profile e clique em “Continue”.

  5. Escolha o App IS que foi criado no e clique em “Continue”.

  6. Selecione seu certificado de desenvolvedor iOS na próxima tela e clique em “Continue”.

  7. Você será solicitado para selecionar quais dispositivos srão incluídos no Provisioning Profile. Clique em “Continue” depois de selecionar quais dispositivos serão testados.

  8. Escolha um nome para esse Provisioning Profile e clique em “Generate”.

  9. Baixe o Provisioning Profile gerado clicando no botão “Download”.

  10. Instale o profile clicando duas vezes no arquivo baixado.

Desenvolvendo o código de Push Notification integrado com a Dito

Na plataforma da Dito será necessário adicionar o certificado no formato .pem, para isso será necessário converter o arquivo .p12 para .pem:

$ openssl pkcs12 -in cert.p12 -out apple_push_notification.pem -nodes -clcerts -legacy

Para instruções de como instalar e utilizar a nossa SDK IOS, consulte a documentação.