Referência da API do Aplicativo Móvel de Amostra

O aplicativo móvel de amostra usa as classes Login View Controller, User Dashboard View Controller, e Network Manager no Swift.

Controladora de Exibição de Log-in

Toda a interação entre o aplicativo de amostra e o SDK para Aplicativos iOS do Oracle Identity Cloud Service acontece por meio da classe LoginViewController.swift.

  • O método setupMSS() cria um dicionário de parâmetros de inicialização a serem usados pelo SDK e inicializa o objeto OMMobileSecurityService usando esses parâmetros. O aplicativo de amostra pode usar diferentes modos de browser para interagir com o Oracle Identity Cloud Service. No método setupMSS(), você precisa especificar qual modo de browser deseja usar.

  • A classe LoginViewController.swift interage com a instância do Oracle Identity Cloud Service usando o protocolo OMMobileSecurityServiceDelegate. Essa classe interna contém métodos de callback para cada ação que o SDK executa.

  • O método completedSetupWithConfiguration() é chamado no evento de conclusão da configuração que é acionado como resultado do método OMMobileSecurityService.setup().

  • O método didReceiveAuthenticationChallenge() é chamado no desafio do evento de autenticação que é acionado como resultado do método OMMobileSecurityService.authenticate().

  • O método didFinishAuthentication() é chamado no evento de conclusão de autenticação que é acionado como resultado da validação e redirecionamento de credenciais.

  • O método didReceiveLogoutAuthenticationChallenge() é chamado no desafio do evento de autenticação que é acionado como resultado do método OMMobileSecurityService.logout().

  • O método didFinishLogout() é chamado no evento de conclusão de log-out que é acionado como resultado da validação e redirecionamento de log-out.

  • O LoginViewController.swift implementa o método didReceiveLogoutAuthenticationChallenge. Esse método chama o URL de log-out do Oracle Identity Cloud Service usando o tipo de browser definido anteriormente.

Controlador de Exibição do Painel do Usuário

Após o acesso bem-sucedido, o aplicativo de amostra exibe a tela do usuário, representada pela classe UserDashboardViewController.swift.

Gerenciador de Rede

Todas as chamadas de rede para o Oracle Identity Cloud Service são feitas usando a classe de rede singleton NetworkManager.swift e callbacks usando o handler de conclusão.

A classe NetworkManager.swift implementa funções para solicitar as seguintes informações do Oracle Identity Cloud Service:

  • Lista de aplicativos designados ao usuário: chamada HTTP para o ponto final admin/v1/MyApps

  • Lista de grupos designados ao usuário: chamada HTTP para o ponto final admin/v1/MyGroups

  • Informações do usuário conectado: chamada HTTP para o ponto final admin/v1/Me