۱. تنظیم کردن
دریافت کد منبع
در این codelab، با نسخهای از برنامه نمونه Friendly Chat شروع میکنید که تقریباً کامل است، بنابراین اولین کاری که باید انجام دهید این است که کد منبع را شبیهسازی کنید:
$ git clone https://github.com/firebase/codelab-friendlychat-web --branch security
سپس، به دایرکتوری security-start بروید، جایی که برای باقیمانده این codelab کار خواهید کرد:
$ cd codelab-friendlychat-web/security-start
اکنون وابستگیها را نصب کنید تا بتوانید کد را اجرا کنید. اگر اتصال اینترنت شما کندتر است، ممکن است یک یا دو دقیقه طول بکشد:
$ npm install && (cd functions && npm install)
با این مخزن آشنا شوید
دایرکتوری security-solution/ حاوی کد کامل برنامه نمونه است. دایرکتوری security-start جایی است که شما در codelab کار خواهید کرد و چند بخش مهم از پیادهسازی اصالتسنجی را ندارد. فایلها و ویژگیهای کلیدی در security-start/ و security-solution/ عبارتاند از:
functions/index.jsحاوی کد Cloud Functions است و جایی است که توابع مسدود کردن اصالتسنجی را خواهید نوشت.public/- حاوی فایلهای ایستا برای برنامه گپ شما استpublic/scripts/main.js- جایی که کد JS برنامه گپ شما (src/index.js) در آن کامپایل میشودsrc/firebase-config.js- حاوی شیء پیکربندی Firebase است که برای مقداردهی اولیه برنامه گپ شما استفاده میشودsrc/index.js- کد JS برنامه گپ شما
دریافت واسط خط فرمان Firebase
«مجموعه شبیهساز» بخشی از «واسط خط فرمان Firebase» است که میتوان آن را با فرمان زیر در دستگاهتان نصب کرد:
$ npm install -g firebase-tools@latest
جاوا اسکریپت را با webpack بسازید، که main.js را در دایرکتوری public/scripts/ ایجاد میکند.
webpack build
سپس، مطمئن شوید که جدیدترین نسخه CLI را دارید. این codelab با نسخه ۱۱.۱۴ یا بالاتر کار میکند.
$ firebase --version 11.14.2
به پروژه Firebase خود متصل شوید
ایجاد پروژه Firebase جدید
- بااستفاده از «حساب Google» خود به سیستم کنسول Firebase وارد شوید.
- برای ایجاد پروژه جدید، روی دکمه کلیک کنید و سپس نام پروژه را وارد کنید (برای مثال،
Authentication MFA Codelab).
- روی ادامه کلیک کنید.
- اگر درخواست شد، شرایط Firebase را مرور و قبول کنید، سپس روی ادامه کلیک کنید.
- (اختیاری) «کمک هوش مصنوعی» را در کنسول Firebase (بهنام «Gemini در Firebase») فعال کنید.
- برای این codelab، به Google Analytics نیاز ندارید، بنابراین گزینه Google Analytics را خاموش کنید.
- روی ایجاد پروژه کلیک کنید، منتظر بمانید تا پروژهتان آماده شود، سپس روی ادامه دادن کلیک کنید.
متصل کردن کد به پروژه Firebase
اکنون باید این کد را به پروژه Firebase خود متصل کنید. ابتدا فرمان زیر را اجرا کنید تا به سیستم Firebase CLI وارد شوید:
$ firebase login
سپس فرمان زیر را برای ایجاد نام مستعار پروژه اجرا کنید. $YOUR_PROJECT_ID را با شناسه پروژه Firebase خودتان جایگزین کنید.
$ firebase use $YOUR_PROJECT_ID
اکنون آماده اجرای برنامه هستید!
۲. اجرای شبیهسازها
در این بخش، برنامه را بهصورت محلی اجرا خواهید کرد. این یعنی زمان راهاندازی «مجموعه شبیهساز» است.
شروع کردن شبیهسازها
از داخل فهرست راهنمای منبع codelab، فرمان زیر را برای راهاندازی شبیهسازها اجرا کنید:
$ firebase emulators:start
با این کار، برنامهتان در http://127.0.0.1:5170 ارائه میشود و کد منبع شما بهطور مداوم با اعمال تغییرات بازسازی میشود. برای دیدن تغییرات، فقط باید بهصورت محلی در مرورگرتان بازآوری سخت (ctrl-shift-r) انجام دهید.
باید خروجیای شبیه به این ببینید:
i emulators: Starting emulators: auth, functions, firestore, hosting, storage ✔ functions: Using node@16 from host. i firestore: Firestore Emulator logging to firestore-debug.log ✔ firestore: Firestore Emulator UI websocket is running on 9150. i hosting[demo-example]: Serving hosting files from: ./public ✔ hosting[demo-example]: Local server: http://127.0.0.1:5170 i ui: Emulator UI logging to ui-debug.log i functions: Watching "[...]" for Cloud Functions... ✔ functions: Loaded functions definitions from source: beforecreated. ✔ functions[us-central1-beforecreated]: providers/cloud.auth/eventTypes/user.beforeCreate function initialized (http://127.0.0.1:5011/[...]/us-central1/beforecreated). i Running script: npm start > security@1.0.0 start > webpack --watch --progress [...] webpack 5.50.0 compiled with 1 warning in 990 ms
وقتی پیام همه شبیهسازها آمادهاند را دیدید، برنامه آماده استفاده است.
۳. پیادهسازی اصالتسنجی چندعاملی
احراز هویت چندعاملی تاحدی در این مخزن پیادهسازی شده است. کد را اضافه خواهید کرد تا ابتدا کاربر را در MFA ثبتنام کنید و سپس از کاربران ثبتنامشده در MFA بخواهید عامل دوم را ارائه دهند.
در ویرایشگرتان، فایل src/index.js را باز کنید و روش startEnrollMultiFactor() را پیدا کنید. کد زیر را برای راهاندازی درستیسنج reCAPTCHA اضافه کنید تا از سوءاستفاده از تلفن جلوگیری شود (درستیسنج reCAPTCHA روی نامرئی تنظیم شده است و برای کاربران قابلمشاهده نخواهد بود):
async function startEnrollMultiFactor(phoneNumber) {
const recaptchaVerifier = new RecaptchaVerifier(
"recaptcha",
{ size: "invisible" },
getAuth()
);
سپس، روش finishEnrollMultiFactor() را پیدا کنید و موارد زیر را برای ثبتنام عامل دوم اضافه کنید:
// Completes MFA enrollment once a verification code is obtained.
async function finishEnrollMultiFactor(verificationCode) {
// Ask user for the verification code. Then:
const cred = PhoneAuthProvider.credential(verificationId, verificationCode);
const multiFactorAssertion = PhoneMultiFactorGenerator.assertion(cred);
// Complete enrollment.
await multiFactor(getAuth().currentUser)
.enroll(multiFactorAssertion)
.catch(function (error) {
alert(`Error finishing second factor enrollment. ${error}`);
throw error;
});
verificationId = null;
}
سپس، تابع signIn را پیدا کنید و جریان کنترل زیر را اضافه کنید که از کاربران ثبتنامشده در MFA میخواهد عامل دوم خود را وارد کنند:
async function signIn() {
// Sign in Firebase using popup auth and Google as the identity provider.
var provider = new GoogleAuthProvider();
await signInWithPopup(getAuth(), provider)
.then(function (userCredential) {
// User successfully signed in and is not enrolled with a second factor.
})
.catch(function (error) {
if (error.code == "auth/multi-factor-auth-required") {
multiFactorResolver = getMultiFactorResolver(getAuth(), error);
displaySecondFactor(multiFactorResolver.hints);
} else {
alert(`Error signing in user. ${error}`);
}
});
}
بقیه پیادهسازی، ازجمله توابع فراخوانیشده در اینجا، قبلاً تکمیل شده است. برای دیدن نحوه عملکرد آنها، بقیه فایل را مرور کنید.
۴. ورود به سیستم با MFA را در شبیهسازها امتحان کنید
اکنون پیادهسازی MFA را امتحان کنید! مطمئن شوید شبیهسازهایتان همچنان درحال اجرا هستند و از برنامه میزبانیشده محلی در localhost:5170 بازدید کنید. به سیستم وارد شوید و وقتی از شما خواسته شد کد MFA را ارائه دهید، کد MFA را در پنجره ترمینال خواهید دید.
ازآنجاییکه شبیهسازها بهطور کامل از «احراز هویت چندعاملی» پشتیبانی میکنند، محیط توسعه شما میتواند کاملاً مستقل باشد.
برای کسب اطلاعات بیشتر درباره پیادهسازی MFA، اسناد مرجع ما را ببینید.
۵. ایجاد تابع مسدودسازی
برخیاز برنامهها فقط برای استفاده گروه خاصی از کاربران درنظر گرفته شدهاند. در این موارد، میخواهید بتوانید الزامات سفارشی برای ثبتنام یا ورود به سیستم کاربر در برنامهتان ایجاد کنید.
این همان چیزی است که توابع مسدودسازی ارائه میدهند: روشی برای ایجاد الزامات اصالتسنجی سفارشی. اینها Cloud Functions هستند، اما برخلاف اکثر توابع، وقتی کاربر تلاش میکند ثبتنام کند یا به سیستم وارد شود، بهصورت همزمان اجرا میشوند.
برای ایجاد تابع مسدودسازی، functions/index.js را در ویرایشگرتان باز کنید و تابع beforecreated را که بهصورت نظر درآمده است پیدا کنید.
آن را با این کد جایگزین کنید که فقط به کاربران دارای دامنه example.com اجازه میدهد حساب ایجاد کنند:
exports.beforecreated = beforeUserCreated((event) => {
const user = event.data;
// Only users of a specific domain can sign up.
if (!user.email || !user.email.endsWith("@example.com")) {
throw new HttpsError("invalid-argument", "Unauthorized email");
}
});
۶. امتحان کردن عملکرد مسدودسازی در شبیهسازها
برای امتحان کردن عملکرد مسدودسازی، مطمئن شوید شبیهسازهایتان درحال اجرا هستند و در برنامه وب در localhost:5170، از سیستم خارج شوید.
سپس، با نشانی ایمیلی که به example.com ختم نمیشود حساب ایجاد کنید. تابع مسدودکننده مانع از موفقیت عملیات خواهد شد.
اکنون، دوباره با نشانی ایمیلی که به example.com ختم میشود امتحان کنید. حساب با موفقیت ایجاد خواهد شد.
با عملکردهای مسدودسازی، میتوانید هر محدودیتی را که لازم دارید برای اصالتسنجی ایجاد کنید. برای کسب اطلاعات بیشتر، اسناد مرجع را ببینید.
خلاصه
عالی است! برای کمک به کاربران در حفظ امنیت حسابشان، «اصالتسنجی چندعاملی» را به برنامه وب اضافه کردید و سپس الزامات سفارشی برای ثبتنام کاربران بااستفاده از عملکردهای مسدودسازی ایجاد کردید. قطعاً یک گیف کسب کردهاید!
