Habilitando autenticação entre aplicativos com Apple Keychain compartilhado

Para compartilhar estados de autenticação entre vários apps ou extensões em plataformas Apple, armazene o estado de autenticação em uma chave compartilhada usando os Serviços de Chaves e configure seus aplicativos para usarem a chave compartilhada.

Isso permite que os usuários:

• Faça login uma vez e faça login em todos os aplicativos que pertencem ao mesmo grupo de acesso.
• Saia uma vez e saia de todos os aplicativos que pertencem ao mesmo grupo de acesso.

Observação: as chaves compartilhadas não atualizam automaticamente os usuários nos aplicativos em tempo real. Se você fizer uma alteração em um usuário em um aplicativo, o usuário deverá ser recarregado em qualquer outro aplicativo de chaves compartilhadas antes que as alterações fiquem visíveis.

Compartilhe o estado de autenticação entre aplicativos

Para compartilhar o estado de autenticação entre aplicativos:

1. Configure um grupo de acesso para seus aplicativos.

   Você pode usar um grupo de acesso de chaves ou um grupo de aplicativos. Consulte Compartilhando acesso a itens de chaveiro entre uma coleção de aplicativos para obter detalhes.

   Para configurar um grupo de acesso às chaves, faça o seguinte para cada aplicativo:

   1. No Xcode, vá para Configurações do projeto > Capacidades .
   2. Ative o compartilhamento de chaveiro.
   3. Adicione um identificador de grupo de chaves. Use o mesmo identificador para todos os aplicativos cujo estado você deseja compartilhar.

2. Em cada aplicativo, defina o grupo de acesso para o grupo de acesso de chaves ou grupo de aplicativos que você criou na etapa anterior.

   Rápido Objetivo-C

   do {
     try Auth.auth().useUserAccessGroup("TEAMID.com.example.group1")
   } catch let error as NSError {
     print("Error changing user access group: %@", error)
   }
   

   [FIRAuth.auth useUserAccessGroup:@"TEAMID.com.example.group1"
                                      error:nil];
   

3. Em pelo menos um aplicativo, faça login de um usuário com qualquer método de login.

   Rápido Objetivo-C

   Auth.auth().signInAnonymously { result, error in
     // User signed in
   }
   

   [FIRAuth signInAnonymouslyWithCompletion:^(FIRAuthDataResult *_Nullable result,
                                              NSError *_Nullable error) {
     // User signed in
   }];
   

   O mesmo usuário atual está disponível em todos os aplicativos do grupo de acesso.

   Rápido Objetivo-C

   var user = Auth.auth().currentUser
   

   FIRUser *user = FIRAuth.auth.currentUser;
   

Volte para um chaveiro não compartilhado

1. Defina o grupo de acesso como nil para interromper o compartilhamento do estado de autenticação.

   Rápido Objetivo-C

   do {
     try Auth.auth().useUserAccessGroup(nil)
   } catch let error as NSError {
     print("Error changing user access group: %@", error)
   }
   

   [FIRAuth.auth useUserAccessGroup:nil error:nil];
   

2. Faça login em um usuário com qualquer método de login. O estado do usuário não estará disponível para nenhum outro aplicativo.

   Rápido Objetivo-C

   Auth.auth().signInAnonymously { result, error in
     // User signed in
   }
   

   [FIRAuth signInAnonymouslyWithCompletion:^(FIRAuthDataResult *_Nullable result,
                                      NSError *_Nullable error) {
     // User signed in
   }];
   

Migrar um usuário conectado para uma chave compartilhada

Para migrar um usuário que já fez login para um estado compartilhado:

1. Faça uma referência ao usuário atual para uso futuro.

   Rápido Objetivo-C

   var user = Auth.auth().currentUser
   

   FIRUser *user = FIRAuth.auth.currentUser;
   

   Nota: Mudar de não compartilhamento para chaves compartilhadas resulta na limpeza do usuário conectado. Mudar de chaves compartilhadas para não compartilhadas não limpará o usuário conectado, mesmo quando nenhum aplicativo usar esse grupo de acesso.

2. (Opcional) Verifique o estado de autenticação do grupo de acesso que você deseja compartilhar.

   Rápido Objetivo-C

   let accessGroup = "TEAMID.com.example.group1"
   var tempUser: User?
   do {
     try tempUser = Auth.auth().getStoredUser(forAccessGroup: accessGroup)
   } catch let error as NSError {
     print("Error getting stored user: %@", error)
   }
   if tempUser != nil {
     // A user exists in the access group
   } else {
     // No user exists in the access group
   }
   

   NSString *accessGroup = @"TEAMID.com.example.group1";
   FIRUser *tempUser = [FIRAuth getStoredUserForAccessGroup:accessGroup
                                                      error:nil];
   if (tempUser) {
     // A user exists in the access group
     } else {
     // No user exists in the access group
   }
   

3. Use um grupo de acesso definido anteriormente nas configurações do projeto.

   Rápido Objetivo-C

   do {
     try Auth.auth().useUserAccessGroup(accessGroup)
   } catch let error as NSError {
     print("Error changing user access group: %@", error)
   }
   

   [FIRAuth.auth useUserAccessGroup:accessGroup error:nil];
   

4. Atualize o usuário atual.

   Rápido Objetivo-C

   Auth.auth().updateCurrentUser(user!) { error in
     // Error handling
   }
   

   [FIRAuth.auth updateCurrentUser:user completion:^(NSError * _Nullable error) {
     // Error handling
   }];
   

   Nota: Você receberá 2 notificações se estiver ouvindo alterações de estado de autenticação no FIRAuth: primeiro, ele é acionado com nil (ao mudar para um novo grupo de acesso) e depois acionado novamente com o usuário (quando updateCurrentUser é chamado). Você pode ignorar essas notificações.

5. O usuário agora pode ser acessado por outros apps que tenham acesso ao mesmo grupo de acesso.