Beispiel-API-Referenz für mobile Anwendungen

Die mobile Beispielanwendung verwendet die Klassen Login View Controller, User Dashboard View Controller, und Network Manager in Swift.

Anmeldeansicht - Controller

Die gesamte Interaktion zwischen der Beispielanwendung und dem Oracle Identity Cloud Service-SDK für iOS-Anwendungen erfolgt über die Klasse LoginViewController.swift.

  • Die Methode setupMSS() erstellt ein Dictionary mit Initialisierungsparametern, die vom SDK verwendet werden sollen, und initialisiert das Objekt OMMobileSecurityService mit diesen Parametern. Die Beispielanwendung kann verschiedene Browsermodi für die Interaktion mit Oracle Identity Cloud Service verwenden. In der Methode setupMSS() müssen Sie angeben, welchen Browsermodus Sie verwenden möchten.

  • Die Klasse LoginViewController.swift interagiert mit der Oracle Identity Cloud Service-Instanz mit dem OMMobileSecurityServiceDelegate-Protokoll. Diese innere Klasse enthält Callback-Methoden für jede Aktion, die das SDK ausführt.

  • Die Methode completedSetupWithConfiguration() wird für das Abschlussereignis des Setups aufgerufen, das als Ergebnis der Methode OMMobileSecurityService.setup() ausgelöst wird.

  • Die Methode didReceiveAuthenticationChallenge() wird für die Challenge für Authentifizierungsereignis aufgerufen, das als Ergebnis der Methode OMMobileSecurityService.authenticate() ausgelöst wird.

  • Die Methode didFinishAuthentication() wird für das Authentifizierungsabschlussereignis aufgerufen, das aufgrund der Zugangsdatenvalidierung und -umleitung ausgelöst wird.

  • Die Methode didReceiveLogoutAuthenticationChallenge() wird für die Challenge für Authentifizierungsereignis aufgerufen, das als Ergebnis der Methode OMMobileSecurityService.logout() ausgelöst wird.

  • Die Methode didFinishLogout() wird für das Abschlussereignis der Abmeldung aufgerufen, das als Ergebnis der Abmeldevalidierung und -umleitung ausgelöst wird.

  • Die LoginViewController.swift implementiert die Methode didReceiveLogoutAuthenticationChallenge. Diese Methode ruft die Oracle Identity Cloud Service-Abmelde-URL mit dem zuvor definierten Browsertyp auf.

Benutzer-Dashboard - Ansichts-Controller

Nach erfolgreicher Anmeldung zeigt die Beispielanwendung den Benutzerbildschirm an, der durch die Klasse UserDashboardViewController.swift dargestellt wird.

Netzwerkmanager

Alle Netzwerkaufrufe an Oracle Identity Cloud Service werden mit der Singleton-Netzwerkklasse NetworkManager.swift und Callbacks mit dem Completion Handler durchgeführt.

Die Klasse NetworkManager.swift implementiert Funktionen, um die folgenden Informationen von Oracle Identity Cloud Service anzufordern:

  • Liste der dem Benutzer zugewiesenen Anwendungen: HTTP-Aufruf an den admin/v1/MyApps-Endpunkt

  • Liste der Gruppen, die dem Benutzer zugewiesen sind: HTTP-Aufruf an den admin/v1/MyGroups-Endpunkt

  • Informationen des angemeldeten Benutzers: HTTP-Aufruf an den Endpunkt admin/v1/Me