Saltar al contenido principal
Para enviar notificaciones push a aplicaciones iOS, se requiere una conexión autenticada a Apple Push Notification Services (APNs). Puedes autenticarte usando un método basado en token (clave .p8) o un método basado en certificado (archivo .p12), pero solo uno es necesario. Esta guía te guiará a través de la configuración de una clave .p8 basada en token, el enfoque recomendado.

​
Requisitos

Asegúrate de tener lo siguiente antes de comenzar:

​
Configurar la autenticación de APNs

​
Generar tu clave .p8 en la cuenta de Apple Developer

Para las instrucciones completas de Apple, consulta Crear una clave privada para acceder a un servicio.
  1. Inicia sesión en tu cuenta de Apple Developer.
  2. Ve a Certificates, Identifiers & Profiles > Keys.
  3. Haz clic en el icono azul más (+).
    • Si no lo ves, contacta a tu administrador para obtener acceso.
Página de claves de Apple Developer mostrando el ícono azul de más para crear una nueva clave
  1. Selecciona Apple Push Notifications service (APNs).
  2. Al configurar la clave, asegúrate de que Sandbox & Production esté seleccionado:
Configuración de clave de Apple Developer con Sandbox y Production seleccionados
  1. Ingresa un nombre para la clave y haz clic en Continuar, luego en Registrar.
Página de registro de clave de Apple Developer con los botones Continue y Register
  1. Descarga tu clave .p8 y guárdala de forma segura. No podrás descargarla nuevamente.
Si necesitas crear una nueva .p8 y ya tienes dos, primero debes revocar una de las claves existentes, y ya no será utilizable.

​
Cargar la clave .p8 a OneSignal

  1. Navega a Settings > Push & In-App > Apple iOS (APNs) Settings en tu panel de OneSignal.
Página de configuración de OneSignal mostrando la sección Push e In-App con la configuración APNs de Apple iOS
  1. Elige .p8 Auth Key (Recomendado) como método de autenticación.
Selección de método de autenticación APNs de OneSignal mostrando la opción recomendada de clave Auth p8
Proporciona lo siguiente:
  • Archivo .p8 – El archivo de clave privada que descargaste de tu cuenta de Apple Developer.
  • Key ID – Una cadena alfanumérica de 10 caracteres (ej.: ABC123DEFG) que se encuentra junto al nombre de tu clave en la sección de Keys de tu cuenta de Apple Developer. Asegúrate de que coincida con el archivo .p8 descargado.
  • Team ID – Una cadena alfanumérica de 10 caracteres (ej.: 9A1B2C3D4E) que aparece junto al nombre de tu equipo en la esquina superior derecha de tu cuenta de Apple Developer. Este no es el mismo que el Key ID.
  • App Bundle ID – Una cadena de dominio inverso (ej.: com.example.app) que se encuentra en:
El Key ID y el Team ID son cadenas de 10 caracteres que se encuentran en tu cuenta de Apple Developer, pero en ubicaciones diferentes. Verifica que no los hayas intercambiado — esta es la configuración incorrecta más común.
Cuenta de Apple Developer mostrando las ubicaciones del Key ID y Team ID
Pestaña de Firma y Capacidades de Xcode mostrando el campo Identificador del Bundle
Haz clic en Guardar y continuar cuando termines.
Has configurado correctamente la autenticación de APNs usando una clave .p8 en OneSignal.¡Tu aplicación iOS ahora está lista para enviar y recibir notificaciones push! 🎉

​
Solución de problemas de .p8

1

Verificar formato del archivo .p8

  • Abre el archivo .p8 en un editor de texto.
  • Debería verse así: 
    -----BEGIN PRIVATE KEY-----
64 character line
64 character line
64 character line
8 character line
-----END PRIVATE KEY-----
2

Asegurarte de no haber cargado un .p12 por error

  • Las claves .p8 provienen de la sección Keys de tu cuenta de Apple Developer.
  • Los certificados .p12 son de la sección Certificates. Estos no son compatibles con la autenticación .p8.
3

Confirmar que tienes el key id correcto

  • Ve a tu Apple Developer > sección de Keys.
  • El Key ID es la cadena de 10 caracteres que aparece junto al nombre de tu clave (ej.: ABC123DEFG).
  • Compara el Key ID que ingresaste en OneSignal con el que aparece para la clave .p8 descargada.
  • No lo confundas con el Team ID — ambos son cadenas de 10 caracteres, pero se encuentran en diferentes ubicaciones.
4

Verificar el team id

  • Tu Team ID aparece en la esquina superior derecha de tu cuenta de Apple Developer.
  • Asegúrate de que se copió exactamente y coincida con la cuenta donde se generó la clave.
  • No lo confundas con el Key ID — el Team ID identifica tu cuenta de desarrollador, no una clave específica.
5

Asegurarte de que la clave tenga capacidad apns

  • Al ver tu clave en Apple Developer, debería aparecer la capacidad Apple Push Notifications service (APNs).
  • Si no es así, revoca la clave y crea una nueva.
6

Espera unos minutos

  • Las claves recién creadas pueden tardar 10-15 minutos en propagarse antes de que Apple permita la autenticación externa.
  • Si obtienes errores de validación inmediatamente después de la creación, espera e intenta nuevamente.

​
¿Necesitas ayuda?

  • Revoca la clave .p8 actual y crea una nueva desde cero.
  • Verifica dos veces que estás usando un Bundle ID válido de la misma cuenta bajo la cual se creó la clave.
  • Contacta a support@onesignal.com con el Key ID, Team ID, Bundle ID y una captura de pantalla redactada de tu configuración de clave de Apple Developer.

​
Próximos pasos

Configuración del iOS SDK

Instala el SDK de OneSignal, inicialízalo en tu app y envía una notificación de prueba.

Configuración del SDK móvil

Elige tu plataforma y sigue la guía completa de integración del SDK para Android, iOS o frameworks multiplataforma.

​
Preguntas frecuentes

​
¿Cuál es la diferencia entre .p8 y .p12?

Una clave .p8 es una clave de autenticación basada en token que no expira y funciona para todas las apps bajo tu cuenta de Apple Developer. Un certificado .p12 es específico de la app y expira después de un año, requiriendo renovación anual. OneSignal recomienda .p8 por su simplicidad y menor mantenimiento. Consulta la guía de certificados .p12 para el método alternativo.

​
¿Mi clave .p8 expira?

No. A diferencia de los certificados .p12, las claves .p8 no expiran. Una vez creada, una clave .p8 permanece válida hasta que la revoques en tu cuenta de Apple Developer.

​
¿Puedo usar una sola clave .p8 para múltiples apps?

Sí. Una sola clave .p8 funciona para todas las apps bajo la misma cuenta de Apple Developer. Puedes subir el mismo archivo .p8 a múltiples apps de OneSignal — cada app solo necesita su propio Bundle ID único.

​
¿Necesito un perfil de aprovisionamiento y cómo crearlo?

Sí, Apple requiere diferentes tipos de perfiles para desarrollo, pruebas (Ad Hoc) y distribución en la App Store. En Xcode, deberías poder seleccionar Gestionar firma automáticamente para crear uno automáticamente.
Pestaña de Firma y Capacidades de Xcode con la gestión automática de firma habilitada
De lo contrario, consulta la documentación de Apple sobre perfiles de aprovisionamiento para obtener detalles.