اصالت‌سنجی با Firebase بااستفاده از سیستم اصالت‌سنجی سفارشی و Unity

می‌توانید Firebase Authentication را با سیستم اصالت‌سنجی سفارشی ادغام کنید. برای این کار، سرور اصالت‌سنجی‌تان را به‌گونه‌ای اصلاح کنید که وقتی کاربر با موفقیت به سیستم وارد می‌شود، کدهای امضاشده سفارشی تولید کند. برنامه شما این توکن را دریافت می‌کند و از آن برای اصالت‌سنجی با Firebase استفاده می‌کند.

قبل از شروع

  1. قبل‌از اینکه بتوانید از Firebase Authentication استفاده کنید، باید:

    دستورالعمل‌های دقیق برای این مراحل راه‌اندازی اولیه را در افزودن Firebase به پروژه Unity پیدا کنید.

  2. کلیدهای سرور پروژه‌تان را دریافت کنید:
    1. در کنسول Firebase، به تنظیمات > حساب‌های سرویس بروید.
    2. در پایین بخش Firebase Admin SDK، روی تولید کلید خصوصی جدید کلیک کنید.
    3. جفت کلید عمومی/خصوصی حساب سرویس جدید به‌طور خودکار در رایانه‌تان ذخیره می‌شود. این فایل را در سرور اصالت‌سنجی‌تان کپی کنید.

اصالت‌سنجی با Firebase

کلاس FirebaseAuth دروازه همه فراخوانی‌های میانای برنامه‌سازی کاربردی است. ازطریق FirebaseAuth.DefaultInstance قابل‌دسترسی است.
Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;

بااستفاده از توکن سرور اصالت‌سنجی‌تان، با Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync تماس بگیرید.

  1. وقتی کاربران به سیستم برنامه شما وارد می‌شوند، اطلاعات اعتباری ورود به سیستم آن‌ها (برای مثال، نام کاربری و گذرواژه آن‌ها) را به سرور اصالت‌سنجی‌تان ارسال کنید. سرور شما اطلاعات اعتباری را بررسی می‌کند و اگر معتبر باشند، یک کد سفارشی برمی‌گرداند.
  2. پس‌از دریافت کردن کد سفارشی از سرور اصالت‌سنجی، آن را به Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync ارسال کنید تا کاربر به سیستم وارد شود:
    auth.SignInWithCustomTokenAsync(custom_token).ContinueWith(task => {
      if (task.IsCanceled) {
        Debug.LogError("SignInWithCustomTokenAsync was canceled.");
        return;
      }
      if (task.IsFaulted) {
        Debug.LogError("SignInWithCustomTokenAsync encountered an error: " + task.Exception);
        return;
      }
    
      Firebase.Auth.AuthResult result = task.Result;
      Debug.LogFormat("User signed in successfully: {0} ({1})",
          result.User.DisplayName, result.User.UserId);
    });

مراحل بعدی

پس‌از اینکه کاربر برای اولین‌بار به سیستم وارد شد، حساب کاربری جدیدی ایجاد می‌شود و به اطلاعات اعتباری (یعنی نام کاربری و گذرواژه، شماره تلفن، یا اطلاعات ارائه‌دهنده احراز هویت) که کاربر با آن به سیستم وارد شده است پیوند داده می‌شود. این حساب جدید به‌عنوان بخشی از پروژه Firebase شما ذخیره می‌شود و می‌توان از آن برای شناسایی کاربر در هر برنامه در پروژه شما، صرف‌نظر از نحوه ورود کاربر به سیستم، استفاده کرد.

  • در برنامه‌هایتان، می‌توانید اطلاعات نمایه پایه کاربر را از شیء Firebase.Auth.FirebaseUser دریافت کنید:

    Firebase.Auth.FirebaseUser user = auth.CurrentUser;
    if (user != null) {
      string name = user.DisplayName;
      string email = user.Email;
      System.Uri photo_url = user.PhotoUrl;
      // The user's Id, unique to the Firebase project.
      // Do NOT use this value to authenticate with your backend server, if you
      // have one; use User.TokenAsync() instead.
      string uid = user.UserId;
    }
  • در Firebase Realtime Database و Cloud Storage قوانین امنیتی، می‌توانید شناسه کاربر منحصربه‌فرد کاربر واردشده به سیستم را از متغیر auth دریافت کنید، و از آن برای کنترل داده‌هایی که کاربر می‌تواند به آن‌ها دسترسی داشته باشد استفاده کنید.

می‌توانید به کاربران اجازه دهید بااستفاده از چند ارائه‌دهنده اصالت‌سنجی به سیستم برنامه‌تان وارد شوند. برای این کار، اعتبارنامه‌های ارائه‌دهنده اصالت‌سنجی را به حساب کاربری موجود پیوند دهید.

برای خارج کردن کاربر از سیستم، SignOut() را فراخوانی کنید:

auth.SignOut();