Enregistrement de l’application iOS/tvOS (hérité) iostvos-application-registration
Introduction Intro
À compter de la version 3.0 du SDK AccessEnabler d’iOS/tvOS, nous modifions le mécanisme d’authentification avec les serveurs d’Adobe. Au lieu d’utiliser une clé publique et un système secret pour signer l’ID du demandeur, nous introduisons le concept d’une chaîne d’instruction logicielle qui peut être utilisée pour obtenir un jeton d’accès qui est ensuite utilisé pour tous les appels que le SDK effectue à nos serveurs. Outre une déclaration de logiciel, vous aurez également besoin d’un schéma d’URL personnalisé pour votre application.
Pour plus d’informations, voir Présentation de l’enregistrement client dynamique.
Qu’est-ce qu’une déclaration de logiciel ? Soft_state
Une instruction logicielle est un jeton JWT contenant des informations sur votre application. Chaque application doit avoir une déclaration logicielle unique qui est utilisée par nos serveurs pour identifier l'application dans le système d'Adobe. L’instruction logicielle doit être transmise lorsque vous initialisez le SDK AccessEnabler et elle sera utilisée pour enregistrer l’application avec Adobe. Lors de l’enregistrement, le SDK recevra un identifiant client et un secret client qui seront utilisés pour obtenir un jeton d’accès. Tout appel du SDK à nos serveurs nécessite un jeton d’accès valide. Le SDK est chargé d’enregistrer l’application, d’obtenir et d’actualiser le jeton d’accès.
Remarque : une instruction logicielle est spécifique à l'application et la même instruction logicielle ne peut pas être utilisée sur plusieurs applications. Notez que les instructions logicielles au niveau du programmeur suivent le même principe, c’est-à-dire qu’elles ne peuvent être utilisées que pour une seule application, à canal unique ou multicanal. Cette limitation s’applique également aux schémas personnalisés.
Comment obtenir une déclaration logicielle ? obtain
Si vous avez accès au tableau de bord TVE d’Adobe :
- Ouvrez votre navigateur et accédez à https://experience.adobe.com/#/pass/authentication
- Accédez à
Channels
section et sélectionnez votre canal. - Accédez à l’onglet
Registered Applications
. - Cliquez sur
Add new application
. - Attribuez un nom et une version à votre application, puis sélectionnez le les plateformes sur lesquelles il sera disponible. iOS/tvOS dans notre cas.
- Envoyez vos modifications au serveur, puis revenez à l’onglet Applications enregistrées de votre canal.
- Vous devriez voir une liste comportant toutes les applications enregistrées. Cliquez sur le lien
Download
bouton sur l'application que vous venez de créer. Vous devrez peut-être attendre quelques minutes avant que votre déclaration logicielle soit prête à être téléchargée. - Un fichier texte sera téléchargé. Utilisez son contenu comme déclaration logicielle.
Pour plus d'informations, voir Dynamic Client Registration Management.
Si vous n’avez pas accès au tableau de bord TVE d’Adobe :
Envoyez un ticket à tve-support@adobe.com. Veuillez indiquer toutes les informations nécessaires telles que le canal, le nom de l’application, la version et les plateformes. Un membre de notre équipe d’assistance créera alors une déclaration logicielle pour vous.
Comment utiliser la déclaration du logiciel ? use
Une fois que vous avez obtenu votre instruction logicielle, vous devez la transmettre en tant que paramètre dans le constructeur Access Enabler. Nous vous recommandons d’héberger la déclaration logicielle sur un emplacement distant. De cette façon, vous pouvez facilement révoquer et modifier la déclaration logicielle sans publier une nouvelle version de votre application.
Génération d’un schéma d’URL personnalisé pour votre application generating
Si vous avez accès au tableau de bord TVE d’Adobe :
- Ouvrez votre navigateur et accédez à https://experience.adobe.com/#/pass/authentication
- Accédez à
Channels
section et sélectionnez votre canal. - Accédez à l’onglet
Custom Schemes
. - Cliquez sur
Generate a new custom scheme
. - Un nouveau schéma personnalisé sera généré pour votre application. Ex :
adbe.1JqxQsYhQOCIrwPjaooY8w://
- Envoyez vos modifications au serveur.
Si vous n’avez pas accès au tableau de bord TVE d’Adobe :
Envoyez un ticket à tve-support@adobe.com. Veuillez indiquer l’ID du canal. Une personne de notre équipe d’assistance créera un schéma personnalisé pour vous.
Utilisation du schéma personnalisé use_custom
Dans le fichier info.plist
de votre application, ajoutez le code suivant :
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleURLSchemes</key>
<array>
<string>adbe.u-XFXJeTSDuJiIQs0HVRAg</string> // replace this with your custom scheme
</array>
</dict>
</array>