Registrierung von iOS/tvOS-Anwendungen iostvos-application-registration
Einführung Intro
Ab Version 3.0 des iOS/tvOS AccessEnabler SDK ändern wir den Authentifizierungsmechanismus mit Adobe-Servern. Statt einen öffentlichen Schlüssel und ein geheimes System zum Signieren der Anforderer-ID zu verwenden, führen wir das Konzept einer Software-Anweisungszeichenfolge ein, mit der ein Zugriffstoken abgerufen werden kann, das später für alle Aufrufe verwendet wird, die das SDK an unsere Server sendet. Zusätzlich zu einer Softwareanweisung benötigen Sie auch ein benutzerdefiniertes URL-Schema für Ihre Anwendung.
Weitere Informationen finden Sie unter Dynamische Client-Registrierung
Was ist eine Software-Anweisung? Soft_state
Eine Software-Anweisung ist ein JWT-Token, das Informationen über Ihre Anwendung enthält. Jede Applikation sollte über eine eindeutige Softwareanweisung verfügen, die von unseren Servern verwendet wird, um die Applikation im Adobe-System zu identifizieren. Die Software-Anweisung muss übergeben werden, wenn Sie das AccessEnabler SDK initialisieren. Sie wird zur Registrierung der Anwendung bei Adobe verwendet. Nach der Registrierung erhält das SDK eine Client-ID und ein Client-Geheimnis, die zum Abrufen eines Zugriffstokens verwendet werden. Jeder Aufruf, den das SDK an unsere Server sendet, erfordert ein gültiges Zugriffstoken. Das SDK ist für die Registrierung der Anwendung, den Abruf und die Aktualisierung des Zugriffstokens zuständig.
Hinweis: Eine Software-Anweisung ist App-spezifisch und dieselbe Software-Anweisung kann nicht für mehrere Anwendungen verwendet werden. Bitte beachten Sie, dass Softwareanweisungen auf Programmebene ebenfalls dem gleichen folgen, d.h. sie können nur für einzelne Anwendungen verwendet werden - ob für einzelne Kanäle oder für mehrere Kanäle. Diese Einschränkung gilt auch für benutzerdefinierte Schemata.
Wie erhalte ich eine Software-Anweisung? obtain
Wenn Sie Zugriff auf das Adobe TVE-Dashboard haben:
- Öffnen Sie den Browser und navigieren Sie zu https://console.auth.adobe.com
- Navigieren Sie zum Abschnitt
Channels
und wählen Sie Ihren Kanal aus. - Navigieren Sie zur Registerkarte
Registered Applications
. - Klicken Sie auf
Add new application
. - Geben Sie einen Namen und eine Version für Ihre Anwendung an und wählen Sie die Plattformen, auf denen sie verfügbar sein wird. In unserem Fall iOS/tvOS.
- Übertragen Sie Ihre Änderungen auf den Server und navigieren Sie dann zurück zur Registerkarte Registrierte Anwendungen Ihres Kanals .
- Es sollte eine Liste mit allen registrierten Anwendungen angezeigt werden. Klicken Sie auf
Download
in der Anwendung, die Sie gerade erstellt haben. Möglicherweise müssen Sie einige Minuten warten, bis Ihre Software-Anweisung für den Download bereit ist. - Eine Textdatei wird heruntergeladen. Verwenden Sie die Inhalte als Ihre Software-Anweisung.
Weitere Informationen finden Sie unter Dynamisches Client-Registrierungs-Management.
Wenn Sie keinen Zugriff auf das Adobe TVE Dashboard haben:
Senden Sie ein Ticket an tve-support@adobe.com. Bitte fügen Sie alle notwendigen Informationen wie Kanal, Anwendungsname, Version und Plattformen hinzu und jemand aus unserem Supportteam wird eine Softwareanweisung für Sie erstellen.
Wie wird die Software-Anweisung verwendet? use
Nachdem Sie Ihre Software-Anweisung erhalten haben, müssen Sie sie als Paramenter im Access Enabler-Konstruktor übergeben. Wir empfehlen, die Software-Anweisung an einem Remote-Standort zu hosten. Auf diese Weise können Sie die Software-Anweisung einfach widerrufen und ändern, ohne eine neue Version Ihrer Anwendung veröffentlichen zu müssen.
Erstellen eines benutzerdefinierten URL-Schemas für Ihre Anwendung generating
Wenn Sie Zugriff auf das Adobe TVE-Dashboard haben:
- Öffnen Sie den Browser und navigieren Sie zu https://console.auth.adobe.com
- Navigieren Sie zum Abschnitt
Channels
und wählen Sie Ihren Kanal aus. - Navigieren Sie zur Registerkarte
Custom Schemes
. - Klicken Sie auf
Generate a new custom scheme
. - Für Ihre Anwendung wird ein neues benutzerdefiniertes Schema generiert. Beispiel:
adbe.1JqxQsYhQOCIrwPjaooY8w://
- Übertragen Sie Ihre Änderungen auf den Server.
Wenn Sie keinen Zugriff auf das Adobe TVE Dashboard haben:
Senden Sie ein Ticket an tve-support@adobe.com. Bitte geben Sie die Kanal-ID an und jemand aus unserem Support-Team wird ein benutzerdefiniertes Schema für Sie erstellen.
Verwendung des benutzerdefinierten Schemas use_custom
Fügen Sie in der Datei info.plist
Ihrer Anwendung den folgenden Code hinzu:
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleURLSchemes</key>
<array>
<string>adbe.u-XFXJeTSDuJiIQs0HVRAg</string> // replace this with your custom scheme
</array>
</dict>
</array>