Cette page a été traduite par l'API Cloud Translation.

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:

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.

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.

SwiftObjective-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];

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

SwiftObjective-C

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

[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.

SwiftObjective-C

var user = Auth.auth().currentUser

FIRUser *user = FIRAuth.auth.currentUser;

Revenir à un trousseau non partagé

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

SwiftObjective-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];

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

SwiftObjective-C

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

[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é :

Faire référence à l'utilisateur actuel pour une utilisation ultérieure
SwiftObjective-C
```
var user = Auth.auth().currentUser
```
```
FIRUser *user = FIRAuth.auth.currentUser;
```
Remarque : Si vous passez du non-partage à un trousseau partagé, l'utilisateur connecté est effacé. Le passage d'un trousseau partagé à un trousseau non partagé ne sera pas effacé l'utilisateur connecté, même si aucune application n'utilise ce groupe d'accès.

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

SwiftObjective-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
}

Utilisez un groupe d'accès que vous avez défini précédemment dans les paramètres du projet.

SwiftObjective-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];

Mettez à jour l'utilisateur actuel.
SwiftObjective-C
```
Auth.auth().updateCurrentUser(user!) { error in
  // Error handling
}
```
```
[FIRAuth.auth updateCurrentUser:user completion:^(NSError * _Nullable error) {
  // Error handling
}];
```
Remarque : Vous recevrez deux notifications si vous écoutez les modifications d'état d'authentification sur FIRAuth : d'abord, elle est déclenchée avec "nil" (lorsque vous passez à un nouveau groupe d'accès), puis déclenchée à nouveau avec "user" (lorsque updateCurrentUser est appelé). Vous pouvez ignorer ces notifications.
L'utilisateur peut désormais être consulté par d'autres applications ayant accès au même groupe d'accès.