Activer l'authentification multi-application avec le trousseau Apple partagé

Pour partager des états d'authentification entre plusieurs applications ou extensions sur les plates-formes Apple, stockez l'état d'authentification dans un trousseau partagé à l'aide des services Keychain et configurez vos applications pour qu'elles utilisent le trousseau partagé.

Cela permet aux utilisateurs d'effectuer les opérations suivantes :

  • Il doit se connecter une seule fois pour être connecté à toutes les applications associées au même accès. groupe.
  • Déconnectez-vous une fois pour toutes les applications associées au même accès. groupe.

Partager l'état d'authentification entre les applis

Pour partager l'état d'authentification entre les applications:

  1. Configurez un groupe d'accès pour vos applications.

    Vous pouvez utiliser un groupe d'accès à un trousseau d'accès ou un groupe d'applications. Pour en savoir plus, consultez la section Partager l'accès aux éléments du trousseau entre une collection d'applications.

    Pour configurer un groupe d'accès au trousseau, procédez comme suit pour chaque application :

    1. Dans Xcode, accédez à Project settings > Capabilities (Paramètres du projet > Fonctionnalités).
    2. Activez le partage du trousseau.
    3. Ajoutez un identifiant de groupe de trousseau de clés. Utilisez le même identifiant pour tous les les applications avec lesquelles vous souhaitez partager l'état.

  2. Dans chaque application, définissez le groupe d'accès sur le groupe d'accès du trousseau ou le groupe d'applications que vous avez créé à l'étape précédente.

    Swift

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

    Objective-C

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

  3. Dans au moins une application, connectez un utilisateur avec n'importe quelle méthode de connexion.

    Swift

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

    Objective-C

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

    Le même utilisateur actuel est disponible dans toutes les applications du groupe d'accès.

    Swift

    var user = Auth.auth().currentUser

    Objective-C

    FIRUser *user = FIRAuth.auth.currentUser;

Revenir à un trousseau non partagé

  1. Définissez le groupe d'accès sur nil pour arrêter de partager l'état d'authentification.

    Swift

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

    Objective-C

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

  2. Connectez un utilisateur avec n'importe quelle méthode de connexion. L'état de l'utilisateur ne sera pas disponible à d'autres applications.

    Swift

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

    Objective-C

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

Migrer un utilisateur connecté vers un trousseau partagé

Pour migrer un utilisateur déjà connecté vers un état partagé :

  1. Faire référence à l'utilisateur actuel pour une utilisation ultérieure

    Swift

    var user = Auth.auth().currentUser

    Objective-C

    FIRUser *user = FIRAuth.auth.currentUser;

  2. (Facultatif) Vérifiez l'état d'authentification du groupe d'accès que vous souhaitez partager.

    Swift

    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
}

    Objective-C

    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. Utilisez un groupe d'accès que vous avez défini précédemment dans les paramètres du projet.

    Swift

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

    Objective-C

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

  4. Mettez à jour l'utilisateur actuel.

    Swift

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

    Objective-C

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

  5. L'utilisateur peut désormais être consulté par d'autres applications ayant accès au même groupe d'accès.