¿Cómo creo una aplicación de plataforma APN para enviar notificaciones push en Amazon SNS mediante la AWS CLI?

Descripción corta

Para crear una aplicación de plataforma APN en Amazon SNS mediante la AWS CLI, ejecute el comando create-platform-application.

Para obtener más información, consulte CreatePlatformApplication en la referencia de la API de Amazon SNS.

Nota: También puede crear una aplicación de plataforma en la consola de Amazon SNS.

Resolución

Nota: Las notificaciones push de Amazon SNS no están disponibles en todas las regiones de AWS. Para obtener más información, consulte Regiones compatibles para aplicaciones móviles. Si recibe errores al ejecutar comandos de AWS CLI, asegúrese de que utiliza la versión más reciente de AWS CLI.

Requisitos previos

Debe tener una aplicación válida para iOS, VoIP o MacOS. También debe tener los siguientes recursos de su cuenta de desarrollador de Apple, según el método de autenticación de su aplicación:

Para la autenticación basada en certificados

• Un certificado TLS válido

Para la autenticación basada en tokens

• Una clave de firma de tokens válida
• Un ID de equipo de Apple válido
• Un ID de paquete de Apple válido

Para obtener más información, consulte Requisitos previos para las notificaciones de usuarios de Amazon SNS y Métodos de autenticación de Apple en la Guía para desarrolladores de Amazon SNS.

Para crear una aplicación de plataforma APN en Amazon SNS mediante la AWS CLI

Para la autenticación basada en certificados

1.    Ejecute el siguiente comando:

Importante: Reemplace Your_Application_Name por el nombre de su aplicación. Reemplace Certificates.p12 por el archivo PKCS#12. Reemplace el valor de la plataforma por APNS_SANDBOX o APNS, según su caso de uso. Asegúrese de ejecutar el comando en el mismo directorio en el que se encuentra el archivo PKCS#12.

aws sns create-platform-application --name Your_Application_Name --platform APNS_SANDBOX --attributes PlatformCredential="\"$(openssl pkcs12 -in Certificates.p12 -nodes -nocerts)\"",PlatformPrincipal="\"$(openssl pkcs12 -in Certificates.p12 -nodes -nokeys)\""

Nota: Para los servicios de Apple que usan credenciales de certificado, PlatformCredential es una clave privada. PlatformPrincipal es el certificado SSL. El comando pkcs12 de OpenSSL procesa un archivo PKCS#12 en un formato legible para la autenticación basada en certificados. Para obtener más información, consulte pkcs12 en el sitio web de OpenSSL.

Aparecerá un mensaje para introducir un valor de contraseña de importación.

2.    Para la contraseña de importación, ingrese la contraseña que se creó cuando exportó el archivo PKCS#12 desde la aplicación Keychain Access.

Para la autenticación basada en tokens

Ejecute el siguiente comando:

Importante: Reemplace PlatformCredential por su clave de firma de tokens. Reemplace PlatformPrincipal por su ID de clave de firma de tokens. Reemplace ApplePlatformTeamID por su ID de equipo de Apple. Reemplace ApplePlatformBundleID por su ID de paquete de Apple. Reemplace el valor de la plataforma por APNS_SANDBOX o APNS, según su caso de uso. Reemplace Token.p8 por su archivo PKCS#8. Asegúrese de ejecutar el comando en el mismo directorio en el que se encuentra el archivo PKCS#8.

aws sns create-platform-application --name token --platform APNS_SANDBOX --attributes ApplePlatformTeamID=XXXXXXX,ApplePlatformBundleID=com.XXXXX,PlatformPrincipal=XXXXXXX,PlatformCredential="\"$(openssl pkcs8 -in Token.p8 -nocrypt)\""

Nota: Para los servicios de Apple que usan credenciales de token, PlatformCredential es una clave de firma de tokens. PlatformPrincipal es el identificador de clave de firma de tokens. El comando pkcs8 de OpenSSL procesa las claves privadas en formato PKCS#8 y las analiza en un formato legible para la autenticación basada en tokens. Para obtener más información, consulte pkcs8 en el sitio web de OpenSSL.

Para obtener más información sobre los atributos de la plataforma, consulte PlatformApplicationAttributes en la referencia de la API de Amazon SNS.

Información relacionada

Errores de API push móvil

Configuración de una aplicación móvil

Acciones de API push móvil