فعال کردن اصالت‌سنجی بین‌برنامه‌ای با «کلیددان Apple» هم‌رسانی‌شده

برای هم‌رسانی وضعیت‌های اصالت‌سنجی در چندین برنامه یا افزونه در پلاتفرم‌های Apple، وضعیت اصالت‌سنجی را بااستفاده از Keychain Services در یک keychain هم‌رسانی‌شده ذخیره کنید و برنامه‌هایتان را برای استفاده از keychain هم‌رسانی‌شده پیکربندی کنید.

این کار به کاربران اجازه می‌دهد:

  • یک‌بار به سیستم وارد شوید و در همه برنامه‌هایی که به همان گروه دسترسی تعلق دارند به سیستم وارد شوید.
  • یک‌بار از سیستم خارج شوید و از سیستم همه برنامه‌هایی که به همان گروه دسترسی تعلق دارند خارج شوید.

هم‌رسانی وضعیت احراز هویت بین برنامه‌ها

برای هم‌رسانی وضعیت احراز هویت بین برنامه‌ها:

  1. گروه دسترسی برای برنامه‌هایتان راه‌اندازی کنید.

    می‌توانید از گروه دسترسی keychain یا گروه برنامه استفاده کنید. برای جزئیات، به هم‌رسانی دسترسی به موارد Keychain در میان مجموعه‌ای از برنامه‌ها مراجعه کنید.

    برای راه‌اندازی گروه دسترسی به دسته کلید، برای هر برنامه کارهای زیر را انجام دهید:

    1. در Xcode، به تنظیمات پروژه > قابلیت‌ها بروید.
    2. Keychain Sharing (هم‌رسانی 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
    }];
    

انتقال کاربر واردشده به سیستم به دسته کلید مشترک

برای انتقال کاربری که قبلاً به سیستم وارد شده است به وضعیت مشترک:

  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. اکنون برنامه‌های دیگری که به همان گروه دسترسی دارند می‌توانند به کاربر دسترسی داشته باشند.