Registrazione applicazione iOS/tvOS iostvos-application-registration
Introduzione Intro
A partire dalla versione 3.0 dell’SDK iOS/tvOS AccessEnabler, stiamo modificando il meccanismo di autenticazione con i server di Adobe. Invece di utilizzare una chiave pubblica e un sistema segreto per firmare l’ID richiedente, introduciamo il concetto di una stringa di istruzione software che può essere utilizzata per ottenere un token di accesso che viene successivamente utilizzato per tutte le chiamate dell’SDK ai nostri server. Oltre a un'informativa sul software, è necessario anche uno schema URL personalizzato per l'applicazione.
Per ulteriori informazioni, vedere Panoramica sulla registrazione client dinamica.
Che cos'è una dichiarazione software? Soft_state
Un rendiconto software è un token JWT che contiene informazioni sull’applicazione. Ogni applicazione deve disporre di una dichiarazione software univoca utilizzata dai nostri server per identificare l'applicazione nel sistema Adobe. L'istruzione software deve essere passata quando si inizializza l'SDK di AccessEnabler e verrà utilizzata per registrare l'applicazione con Adobe. Al momento della registrazione, l’SDK riceverà un ID client e un segreto client che verranno utilizzati per ottenere un token di accesso. Qualsiasi chiamata effettuata dall'SDK ai nostri server richiederà un token di accesso valido. L’SDK è responsabile della registrazione dell’applicazione, del recupero e dell’aggiornamento del token di accesso.
Nota: un'istruzione software è specifica dell'app e non può essere utilizzata in più applicazioni. Si noti che anche le istruzioni software a livello di programmatore seguono la stessa procedura, ovvero possono essere utilizzate solo per una singola applicazione, sia che si tratti di un singolo canale che di più canali. Questa limitazione si applica anche allo schema personalizzato.
Come si ottiene una dichiarazione software? obtain
Se hai accesso al dashboard TVE di Adobe:
- Apri il browser e passa a https://experience.adobe.com/#/pass/authentication
- Passa alla sezione
Channels
e seleziona il tuo canale. - Passa alla scheda
Registered Applications
. - Fai clic su
Add new application
. - Specifica un nome e una versione per l’applicazione e seleziona la piattaforme su cui sarà disponibile. iOS/tvOS nel nostro caso.
- Invia le modifiche al server e quindi torna alla scheda Applicazioni registrate del tuo canale.
- Dovresti visualizzare un elenco con tutte le applicazioni registrate. Fai clic su Pulsante
Download
dell'applicazione appena creata. Potrebbe essere necessario attendere alcuni minuti prima che il Software Statement sia pronto per il download. - Verrà scaricato un file di testo. Utilizza il contenuto come informativa sul software.
Per ulteriori informazioni, vedere Dynamic Client Registration Management.
Se non hai accesso al dashboard TVE di Adobe:
Invia un ticket a tve-support@adobe.com. Includi tutte le informazioni necessarie come il canale, il nome dell’applicazione, la versione e le piattaforme e qualcuno del nostro team di supporto creerà un rendiconto software per te.
Come utilizzare la dichiarazione software? use
Dopo aver ottenuto l'Informativa sul software, è necessario trasmetterla come parametro nel costruttore di Access Enabler. Si consiglia di ospitare l'Informativa sul software in una posizione remota. In questo modo, è possibile revocare e modificare facilmente l'informativa sul software senza rilasciare una nuova versione dell'applicazione.
Generazione di uno schema URL personalizzato per l’applicazione generating
Se hai accesso al dashboard TVE di Adobe:
- Apri il browser e passa a https://experience.adobe.com/#/pass/authentication
- Passa alla sezione
Channels
e seleziona il tuo canale. - Passa alla scheda
Custom Schemes
. - Fai clic su
Generate a new custom scheme
. - Verrà generato un nuovo schema personalizzato per l'applicazione. Esempio:
adbe.1JqxQsYhQOCIrwPjaooY8w://
- Invia le modifiche al server.
Se non hai accesso al dashboard TVE di Adobe:
Invia un ticket a tve-support@adobe.com. Includi l’ID canale: verrà creato uno schema personalizzato dal nostro team di supporto.
Come utilizzare lo schema personalizzato use_custom
Nel file info.plist
dell'applicazione aggiungere il codice seguente:
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleURLSchemes</key>
<array>
<string>adbe.u-XFXJeTSDuJiIQs0HVRAg</string> // replace this with your custom scheme
</array>
</dict>
</array>