Pular para o conteúdo principal
Para enviar notificações push para aplicativos iOS, é necessária uma conexão autenticada ao Apple Push Notification Services (APNs). Você pode autenticar usando um método baseado em token (chave .p8) ou um método baseado em certificado (arquivo .p12) — mas apenas um é necessário. Este guia irá orientá-lo na configuração de uma chave .p8 baseada em token, a abordagem recomendada.

​
Requisitos

Certifique-se de ter o seguinte antes de começar:

​
Configurar a autenticação APNs

​
Gerar sua chave .p8 na conta Apple Developer

Para as instruções completas da Apple, consulte Criar uma chave privada para acessar um serviço.
  1. Faça login na sua conta Apple Developer.
  2. Vá para Certificates, Identifiers & Profiles > Keys.
  3. Clique no ícone plus (+) azul.
    • Se você não o vê, entre em contato com seu Admin para obter acesso.
Página de chaves do Apple Developer mostrando o ícone azul de mais para criar uma nova chave
  1. Selecione Apple Push Notifications service (APNs).
  2. Ao configurar a chave, certifique-se de que Sandbox & Production está selecionado:
Configuração de chave do Apple Developer com Sandbox e Production selecionados
  1. Insira um nome para a chave e clique em Continue, depois em Register.
Página de registro de chave do Apple Developer com os botões Continue e Register
  1. Baixe sua chave .p8 e armazene-a com segurança. Você não poderá baixá-la novamente.
Se você precisar criar um novo .p8 e já tiver dois, você deve primeiro revogar uma das chaves existentes — e ela não será mais utilizável.

​
Fazer upload da chave .p8 para o OneSignal

  1. Navegue até Settings > Push & In-App > Apple iOS (APNs) Settings no seu painel do OneSignal.
Página de configurações do OneSignal mostrando a seção Push e In-App com as configurações APNs do Apple iOS
  1. Escolha .p8 Auth Key (Recommended) como o método de autenticação.
Seleção de método de autenticação APNs do OneSignal mostrando a opção recomendada de chave Auth p8
Forneça o seguinte:
  • .p8 File – O arquivo de chave privada que você baixou da sua conta Apple Developer.
  • Key ID – Uma string alfanumérica de 10 caracteres (ex.: ABC123DEFG) encontrada ao lado do nome da sua chave na seção Keys da sua conta Apple Developer. Certifique-se de que corresponde ao arquivo .p8 baixado.
  • Team ID – Uma string alfanumérica de 10 caracteres (ex.: 9A1B2C3D4E) exibida ao lado do nome da sua equipe no canto superior direito da sua conta Apple Developer. Este não é o mesmo que o Key ID.
  • App Bundle ID – Uma string de domínio reverso (ex.: com.example.app) encontrada em:
    • A seção Identifiers da sua conta Apple Developer, ou
    • Xcode > Main App Target > Signing & Capabilities
Key ID e Team ID são ambas strings de 10 caracteres encontradas na sua conta Apple Developer, mas em locais diferentes. Verifique se não os trocou — esta é a configuração incorreta mais comum.
Conta do Apple Developer mostrando os locais do Key ID e Team ID
Aba de Assinatura e Capacidades do Xcode mostrando o campo de Identificador do Bundle
Clique em Save & Continue quando terminar.
Você configurou com sucesso a autenticação APNs usando uma chave .p8 no OneSignal.Seu aplicativo iOS agora está pronto para enviar e receber notificações push! 🎉

​
Solução de problemas do .p8

1

Verificar formato do arquivo .p8

  • Abra o arquivo .p8 em um editor de texto.
  • Ele deve ter esta aparência: 
    -----BEGIN PRIVATE KEY-----
64 character line
64 character line
64 character line
8 character line
-----END PRIVATE KEY-----
2

Certifique-se de que não enviou um .p12 por engano

  • Chaves .p8 vêm da seção Keys da sua conta Apple Developer.
  • Certificados .p12 são da seção Certificates. Estes não são compatíveis com autenticação .p8.
3

Confirme que você tem o key id correto

  • O Key ID é a string de 10 caracteres exibida ao lado do nome da sua chave (ex.: ABC123DEFG).
  • Vá para sua Apple Developer > seção Keys.
  • Compare o Key ID que você inseriu no OneSignal com o listado para a chave .p8 baixada.
  • Não confunda com o Team ID — ambos são strings de 10 caracteres, mas encontrados em locais diferentes.
4

Verifique o team id

  • Seu Team ID aparece no canto superior direito da sua conta Apple Developer.
  • Certifique-se de que está copiado exatamente e corresponde à conta onde a chave foi gerada.
  • Não confunda com o Key ID — o Team ID identifica sua conta de desenvolvedor, não uma chave específica.
5

Certifique-se de que a chave tem capability apns

  • Ao visualizar sua chave no Apple Developer, a capability Apple Push Notifications service (APNs) deve estar listada.
  • Caso contrário, revogue a chave e crie uma nova.
6

Aguarde alguns minutos

  • Chaves recém-criadas podem levar 10–15 minutos para propagar antes que a Apple permita autenticação externa.
  • Se você receber erros de validação imediatamente após a criação, aguarde e tente novamente.

​
Precisa de ajuda?

  • Revogue a chave .p8 atual e crie uma nova do zero.
  • Verifique novamente se você está usando um Bundle ID válido da mesma conta em que a chave foi criada.
  • Entre em contato com support@onesignal.com com o Key ID, Team ID, Bundle ID e uma captura de tela editada da sua configuração de chave Apple Developer.

​
Próximos passos

Configuração do iOS SDK

Instale o SDK do OneSignal, inicialize-o no seu app e envie uma notificação de teste.

Configuração do SDK móvel

Escolha sua plataforma e siga o guia completo de integração do SDK para Android, iOS ou frameworks multiplataforma.

​
Perguntas frequentes

​
Qual é a diferença entre .p8 e .p12?

Uma chave .p8 é uma chave de autenticação baseada em token que não expira e funciona para todos os apps na sua conta Apple Developer. Um certificado .p12 é específico do app e expira após um ano, exigindo renovação anual. O OneSignal recomenda o .p8 por sua simplicidade e menor manutenção. Consulte o guia de certificado .p12 para o método alternativo.

​
Minha chave .p8 expira?

Não. Ao contrário dos certificados .p12, as chaves .p8 não expiram. Uma vez criada, uma chave .p8 permanece válida até você revogá-la na sua conta Apple Developer.

​
Posso usar uma chave .p8 para vários apps?

Sim. Uma única chave .p8 funciona para todos os apps na mesma conta Apple Developer. Você pode fazer upload do mesmo arquivo .p8 para vários apps do OneSignal — cada app só precisa do seu próprio Bundle ID exclusivo.

​
Preciso de um provisioning profile e como criá-lo?

Sim, a Apple requer diferentes tipos de profiles para desenvolvimento, testes (Ad Hoc) e distribuição para a App Store. No Xcode, você deve ser capaz de selecionar Automatically manage signing para criar um automaticamente.
Aba de Assinatura e Capacidades do Xcode com gerenciamento automático de assinatura ativado
Caso contrário, consulte a documentação da Apple sobre provisioning profiles para detalhes.