הפעלת אימות בכל האפליקציות באמצעות 'צרור מפתחות משותף' של Apple

כדי לשתף את מצבי האימות בין כמה אפליקציות או תוספים בפלטפורמות של Apple, שומרים את מצב האימות באוסף מפתחות משותף באמצעות שירותי אוסף המפתחות ומגדירים את האפליקציות להשתמש באוסף המפתחות המשותף.

כך המשתמשים יכולים:

  • נכנסים פעם אחת ונכנסים לחשבון בכל האפליקציות שמשויכות לאותה גישה קבוצה.
  • יציאה אחת תגרום ליציאה מכל האפליקציות ששייכות לאותה קבוצת גישה.

שיתוף מצב האימות בין אפליקציות

כדי לשתף את מצב האימות בין אפליקציות:

  1. מגדירים קבוצת גישה לאפליקציות.

    אפשר להשתמש בקבוצת גישה ל-Keychain או בקבוצת אפליקציות. למידע נוסף, ראו שיתוף גישה לפריטי 'צרור מפתחות' בין אוסף של אפליקציות אפשר לקבל פרטים נוספים.

    כדי להגדיר קבוצת גישה אל 'צרור מפתחות', מבצעים את הפעולות הבאות בכל אפליקציה:

    1. ב-Xcode, עוברים אל Project settings > (הגדרות פרויקט >) יכולות.
    2. הפעלת שיתוף מפתחות (Keychain).
    3. מוסיפים מזהה קבוצה של מפתחות. צריך להשתמש באותו מזהה לכל הערכים אפליקציות שאתם רוצים לשתף.

  2. בכל אפליקציה, מגדירים את קבוצת הגישה כקבוצת הגישה מסוג 'צרור מפתחות' או כקבוצת האפליקציות שיצרתם בשלב הקודם.

    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. נכנסים משתמש לאפליקציה אחת לפחות באמצעות כל אחת משיטות הכניסה.

    Swift

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

    Objective-C

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

    אותו משתמש נוכחי זמין בכל האפליקציות בקבוצת הגישה.

    Swift

    var user = Auth.auth().currentUser

    Objective-C

    FIRUser *user = FIRAuth.auth.currentUser;

איך חוזרים לאוסף מפתחות שלא משותף

  1. כדי להפסיק את שיתוף מצב האימות צריך להגדיר את קבוצת הגישה לערך nil.

    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. נכנסים למשתמש באמצעות שיטת כניסה כלשהי. מצב המשתמש לא יהיה זמין לכל אפליקציה אחרת.

    Swift

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

    Objective-C

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

העברת משתמש מחובר ל-Keychain משותף

כדי להעביר משתמש שכבר מחובר למצב משותף:

  1. אפשר להפנות למשתמש הנוכחי לשימוש עתידי.

    Swift

    var user = Auth.auth().currentUser

    Objective-C

    FIRUser *user = FIRAuth.auth.currentUser;

  2. (אופציונלי) בודקים את סטטוס האימות של קבוצת הגישה שרוצים לשתף.

    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. משתמשים בקבוצת גישה שהגדרתם בעבר בהגדרות הפרויקט.

    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. מעדכנים את המשתמש הנוכחי.

    Swift

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

    Objective-C

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

  5. עכשיו אפליקציות אחרות שיש להן גישה לאותה קבוצת גישה יכולות לגשת למשתמש.