Come posso creare un'applicazione della piattaforma APNs per l'invio di notifiche push in Amazon SNS utilizzando l'AWS CLI?

Breve descrizione

Per creare un'applicazione della piattaforma APNs in Amazon SNS utilizzando l'AWS CLI, esegui il comando create-platform-application.

Per ulteriori informazioni, consulta CreatePlatformApplication nel Riferimento d'API Amazon SNS.

Nota: puoi anche creare un'applicazione della piattaforma nella console Amazon SNS.

Soluzione

Nota: le notifiche push di Amazon SNS non sono disponibili in tutte le Regioni AWS. Per ulteriori informazioni, consulta Regioni supportate per applicazioni mobili. Se ricevi un messaggio di errore durante l’esecuzione dei comandi dell'AWS CLI, assicurati di usare la versione più recente di AWS CLI.

Prerequisiti

È necessario disporre di un'applicazione valida per iOS, VoIP o MacOS. È inoltre necessario disporre delle seguenti risorse dal proprio account Apple Developer, in base al metodo di autenticazione dell'applicazione:

Per l'autenticazione basata su certificati

• Un certificato TLS valido

Per l'autenticazione basata su token

• Una chiave di firma del token valida
• Un ID Apple Team valido
• Un ID Apple Bundle valido

Per ulteriori informazioni, consulta le sezioni Prerequisiti per le notifiche degli utenti Amazon SNS e Metodi di autenticazione Apple nella Guida per gli sviluppatori Amazon SNS.

Per creare un'applicazione della piattaforma APNs in Amazon SNS utilizzando l'AWS CLI

Per l'autenticazione basata su certificati

1.    Esegui il seguente comando:

Importante: sostituisciYour_Application_Name con il nome della tua applicazione. Sostituisci Certificates.p12 con il tuo file PKCS#12. Sostituisci il valore della piattaforma con APNS_SANDBOX o APNS, in base al tuo caso d'uso. Assicurati di eseguire il comando nella stessa directory in cui si trova il file 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: per i servizi Apple che utilizzano le credenziali di certificato, PlatformCredential è una chiave privata. PlatformPrincipal è il certificato SSL. Il comando pkcs12 di OpenSSL analizza un file PKCS#12 in un formato leggibile per l'autenticazione basata su certificati. Per ulteriori informazioni, consulta pkcs12 sul sito web di OpenSSL.

Viene visualizzata una richiesta di inserire un valore per la password di importazione.

2.    Per la password di importazione, inserisci la password che è stata creata quando hai esportato il file PKCS#12 dall'app Keychain Access.

Per l'autenticazione basata su token

Esegui il seguente comando:

Importante: sostituisci PlatformCredential con la chiave di firma del token. Sostituisci PlatformPrincipal con l'ID della chiave di firma del token. Sostituisci ApplePlatformTeamID con il tuo ID Apple Team. Sostituisci ApplePlatformBundleID con il tuo ID Apple Bundle. Sostituisci il valore della piattaforma con APNS_SANDBOX o APNS, in base al tuo caso d'uso. Sostituisci Token.p8 con il tuo file PKCS#8. Assicurati di eseguire il comando nella stessa directory in cui si trova il file 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: per i servizi Apple che utilizzano le credenziali token, PlatformCredential è una chiave di firma del token. PlatformPrincipal è l'ID della chiave di firma del token. Il comando pkcs8 di OpenSSL elabora le chiavi private in formato PKCS#8 e le analizza in un formato leggibile per l'autenticazione basata su token. Per ulteriori informazioni, vedi pkcs8 sul sito web di OpenSSL.

Per ulteriori informazioni sugli attributi della piattaforma, consulta SeePlatformApplicationAttributes nel Riferimento d'API Amazon SNS.

Informazioni correlate

Errori delle API push mobili

Configurazione di un'applicazione per dispositivi mobili

Operazioni API push mobili