Configurar a experiência otimizada de autenticação de código QR no aplicativo iOS/macOS

O método de autenticação de código QR permite que os trabalhadores da linha de frente entrem de forma rápida e fácil em aplicativos em dispositivos compartilhados. Os usuários podem usar o código QR exclusivo fornecido por seus administradores e inserir seu PIN para entrar, eliminando a necessidade de inserir nomes de usuário e senhas.

Pode usar a experiência de login web com código QR disponível em login.microsoft.com. Esse ponto de entrada do usuário não requer nenhuma alteração do desenvolvedor. Os utilizadores selecionam Opções de início de sessão>Iniciar sessão numa organização>Iniciar sessão com um código QR. Pode otimizar a experiência de início de sessão com código QR fornecendo o ponto de entrada na sua página de início de sessão, eliminando dois cliques do utilizador. Para tirar proveito do método de autenticação de código QR, os desenvolvedores de aplicativos e o Administrador de Política de Autenticação trabalham juntos:

  • Os desenvolvedores de aplicativos integram o ponto de entrada otimizado da autenticação de código QR em seu aplicativo usando a Biblioteca de Autenticação da Microsoft (MSAL) para iOS e macOS.
  • O Administrador da Política de Autenticação configura o método de autenticação no Microsoft Entra ID.

Configure seu aplicativo para usar a autenticação de código QR

Para configurar seu aplicativo para usar a autenticação de código QR, você pode chamar a getDeviceInformationWithParameters API no MSAL para receber o MSALDeviceInformation objeto. Neste objeto, um novo sinalizador está disponível para refletir a autenticação de código QR configurada pelo administrador na configuração da extensão de logon único (SSO). O trecho de código a seguir mostra como recuperar o método de autenticação preferencial:


@property (nonatomic, readonly) MSALPreferredAuthMethod configuredPreferredAuthMethod;

MSALPreferredAuthMethod é uma enumeração que descreve os diferentes métodos de autenticação disponíveis. A configuredPreferredAuthMethod propriedade permite que você recupere o método de autenticação preferido para o aplicativo. Atualmente, o código QR tem o valor de enum privado de 1. Quando liberado MSALPreferredAuthMethodQRPINpara disponibilidade geral (GA), é .

MSALInteractiveTokenParameters Defina também um novo parâmetro opcional do tipo MSALPreferredAuthMethod: preferredAuthMethod. Quando esse parâmetro é definido para autenticação de código QR, a interface do usuário de entrada interativa resultante leva o usuário diretamente para a página de entrada de autenticação de código QR. O trecho de código a seguir mostra como configurar seu aplicativo para usar a autenticação de código QR:

MSALWebviewParameters *webParameters = [[MSALWebviewParameters alloc] initWithAuthPresentationViewController:viewController]; 

     

MSALInteractiveTokenParameters *interactiveParams = [[MSALInteractiveTokenParameters alloc] initWithScopes:scopes webviewParameters:webParameters]; 

 

interactiveParams.preferredAuthMethod = 1; //Currently need to use the private enum value 

 

[application acquireTokenWithParameters:interactiveParams completionBlock:^(MSALResult *result, NSError *error) { 

    // When token acquisition completes 

}];

Este trecho de código configura e adquire um token usando o MSAL em um aplicativo iOS, com foco na autenticação de código QR. Ele inicializa MSALWebviewParameters com um controlador de vista para a vista web de autenticação e cria MSALInteractiveTokenParameters com os âmbitos e parâmetros web necessários. O método de autenticação preferido é definido como autenticação por código QR.

Finalmente, ela chama acquireTokenWithParameters na instância MultipleAccountPublicClientApplication, usando os parâmetros configurados e um bloco de conclusão para gerir o resultado. Essa configuração garante que o fluxo de autenticação use o método de autenticação de código QR para autenticação de usuário segura e conveniente.

É aconselhável ligar para a getDeviceInformationWithParameters API no MSAL para descobrir se o administrador configurou o método de autenticação de código QR. Se tiver, um aplicativo pode atualizar sua interface do usuário para indicar que o método de autenticação de código QR está disponível como uma opção de entrada.

Por padrão, a autenticação de código QR solicita aos usuários permissão da câmera toda vez que eles precisam usar a câmera para digitalizar um código QR.

Captura de tela de como permitir o acesso à câmera no iOS.

Os administradores podem suprimir esse comportamento e ignorar a solicitação de permissão da câmera. Para configurar a solicitação, defina a seguinte configuração de extensão SSO:

  • Chave: suppress_camera_consent
  • Tipo: Integer
  • Valor: 1 ou 0. Esse valor é definido como 0 por padrão.

O local é o mesmo onde você pode configurar preferred_auth_method. Para obter mais informações sobre a configuração da extensão SSO, consulte Mais opções de configuração para o plug-in Microsoft Enterprise SSO para dispositivos Apple.

Note

O prompt de consentimento da câmera é exibido uma vez devido aos requisitos do sistema operacional.

Conteúdo relacionado

  • Last updated on