Exemple de référence d'API d'application mobile

L'exemple d'application mobile utilise les classes Login View Controller, User Dashboard View Controller, et Network Manager dans Swift.

Contrôleur de vue de connexion

Toutes les interactions entre l'exemple d'application et la trousse SDK Oracle Identity Cloud Service pour les applications iOS se font au moyen de la classe LoginViewController.swift.

  • La méthode setupMSS() crée un dictionnaire de paramètres d'initialisation à utiliser par la trousse SDK et initialise l'objet OMMobileSecurityService à l'aide de ces paramètres. L'exemple d'application peut utiliser différents modes de navigateur pour interagir avec Oracle Identity Cloud Service. Dans la méthode setupMSS(), vous devez spécifier le mode de navigateur à utiliser.

  • La classe LoginViewController.swift interagit avec l'instance Oracle Identity Cloud Service à l'aide du protocole OMMobileSecurityServiceDelegate. Cette classe interne contient des méthodes de rappel pour chaque action effectuée par la trousse SDK.

  • La méthode completedSetupWithConfiguration() est appelée pour l'événement d'achèvement de la configuration qui est déclenché à la suite de la méthode OMMobileSecurityService.setup().

  • La méthode didReceiveAuthenticationChallenge() est appelée sur l'identification pour l'événement d'authentification qui est déclenché à la suite de la méthode OMMobileSecurityService.authenticate().

  • La méthode didFinishAuthentication() est appelée pour l'événement d'achèvement de l'authentification qui est déclenché à la suite de la validation et de la redirection des données d'identification.

  • La méthode didReceiveLogoutAuthenticationChallenge() est appelée sur l'identification pour l'événement d'authentification qui est déclenché à la suite de la méthode OMMobileSecurityService.logout().

  • La méthode didFinishLogout() est appelée pour l'événement d'achèvement de déconnexion qui est déclenché à la suite de la validation et de la redirection de la déconnexion.

  • LoginViewController.swift met en oeuvre la méthode didReceiveLogoutAuthenticationChallenge. Cette méthode appelle l'URL de déconnexion d'Oracle Identity Cloud Service à l'aide du type de navigateur défini précédemment.

Contrôleur de vue de tableau de bord d'utilisateur

Après la connexion réussie, l'exemple d'application affiche l'écran de l'utilisateur, représenté par la classe UserDashboardViewController.swift.

Gestionnaire de réseau

Tous les appels réseau à Oracle Identity Cloud Service sont effectués à l'aide de la classe de réseau singleton NetworkManager.swift et des rappels à l'aide du programme de traitement d'achèvement.

La classe NetworkManager.swift met en oeuvre des fonctions pour demander les informations suivantes à Oracle Identity Cloud Service :

  • Liste des applications affectées à l'utilisateur : Appel HTTP au point d'extrémité admin/v1/MyApps

  • Liste des groupes affectés à l'utilisateur : Appel HTTP au point d'extrémité admin/v1/MyGroups

  • Informations de l'utilisateur connecté : Appel HTTP au point d'extrémité admin/v1/Me