ورود با Google

۱راه‌اندازی در کنسول#

1. در Google Cloud Console › APIs & Services › Credentials، OAuth client IDهایی را که اپ‌هایتان با آن‌ها وارد می‌شوند پیدا کنید (یا بسازید). Android، iOS و وب هر کدام client ID خودشان را دارند.
2. در کنسول ابرووا، Abrova Auth › روش‌های ورود را باز کنید، Google را روشن کنید و همه‌ی client IDهایی را که اپ‌هایتان استفاده می‌کنند اضافه کنید.

Abrova Auth فقط ID tokenی از Google را می‌پذیرد که audience آن یکی از این client IDها باشد.

۲مقدار nonce#

با تابع کمکی SDK یک nonce خام تصادفی بسازید، SHA-256 آن را به‌صورت hex با حروف کوچک به Google بدهید و مقدار خام را به Abrova Auth. ابرووا بررسی می‌کند که این دو با هم جور باشند و هر nonce را فقط یک بار می‌پذیرد. ID token باید کمتر از ۱۰ دقیقه عمر داشته باشد.

۳ورود#

Android (Credential Manager)

androidx.credentials:credentials، androidx.credentials:credentials-play-services-auth و com.google.android.libraries.identity.googleid:googleid را به اپ اضافه کنید:

val rawNonce = AbrovaNonce.generate()
val option = GetGoogleIdOption.Builder()
    .setServerClientId(WEB_CLIENT_ID)
    .setFilterByAuthorizedAccounts(false)
    .setNonce(AbrovaNonce.sha256(rawNonce))
    .build()
val response = CredentialManager.create(context)
    .getCredential(context, GetCredentialRequest.Builder().addCredentialOption(option).build())
val idToken = GoogleIdTokenCredential.createFrom(response.credential.data).idToken

AbrovaAuth.shared.signInWithGoogle(idToken, rawNonce)

Flutter

با google_sign_in نسخه‌ی ۷:

final raw = AbrovaAuthNonce.generate();
await GoogleSignIn.instance.initialize(
  serverClientId: 'xxx.apps.googleusercontent.com',
  nonce: AbrovaAuthNonce.sha256Hex(raw),
);
final account = await GoogleSignIn.instance.authenticate();

await AbrovaAuth.instance.signInWithGoogle(
  idToken: account.authentication.idToken!,
  rawNonce: raw,
);

iOS

ID token مربوط به Google را با AbrovaNonce.sha256(rawNonce) به‌عنوان nonce درخواست کنید، سپس:

try await AbrovaAuth.shared.signInWithGoogle(idToken: idToken, rawNonce: rawNonce)

Web و React Native

hashedNonce را به‌عنوان nonce به Google Identity Services (وب) یا کتابخانه‌ی ورود با Google در React Native بدهید:

const { rawNonce, hashedNonce } = await auth.createNonce();
// ... run Google's sign-in with nonce: hashedNonce, then:
await auth.signInWithGoogle({ idToken, rawNonce });

ایمیل#

Abrova Auth از ایمیل Google فقط وقتی استفاده می‌کند که Google بگوید تأییدشده است، و آن را (رمزگذاری‌شده) فقط وقتی ذخیره می‌کند که ذخیره‌ی اطلاعات پروفایل در Abrova Auth › تنظیمات روشن باشد. یک حساب Google و یک حساب Apple یا رمز عبور با همان ایمیل، کاربران جداگانه می‌مانند مگر اینکه کاربر آن‌ها را به هم وصل کند.

وصل کردن Google به کاربرِ واردشده#

برای ارتقای کاربر ناشناس، linkGoogle(...) را با همان آرگومان‌ها صدا بزنید. شناسه‌ی کاربر همان می‌ماند. اگر این حساب Google از قبل متعلق به کاربر دیگری باشد، فراخوانی با PROVIDER_ALREADY_LINKED شکست می‌خورد.

خطاها#