توضیح بده https://developers.facebook.com/docs/facebook-login/web
- User
- Assistant
لینک که شما به اشتراک گذاشتهاید به مستندات رسمی فیسبوک برای توسعهدهندگان مراجعه میکند و به خصوص به استفاده از قابلیت "ورود با فیسبوک" (Facebook Login) برای وبسایتها میپردازد. اجازه دهید این موضوع را به طور خلاصه توضیح دهم:
Facebook Login برای وب
"ورود با فیسبوک" ابزاری است که اجازه میدهد کاربران وبسایت شما از حساب کاربری فیسبوک خود برای ورود به سایت شما استفاده کنند. این قابلیت میتواند فرآیند ثبتنام و ورود کاربران را راحتتر کند و به شما این امکان را میدهد که به دادههای کاربری فیسبوک دسترسی پیدا کنید (با رضایت کاربر).
مراحل پیادهسازی
-
ساخت اپلیکیشن در فیسبوک:
- ابتدا باید یک اپلیکیشن جدید در Facebook Developers ایجاد کنید.
- پس از ایجاد اپ، یک App ID و App Secret دریافت خواهید کرد که نیاز است در وبسایت خود استفاده کنید.
-
پیکربندی اپلیکیشن:
- در داشبورد اپلیکیشن، تنظیمات ورود با فیسبوک را پیکربندی کنید. این شامل ادرسهای URL دقیق وبسایت شما است که در آن کاربران اجازه ورود خواهند داشت.
-
نصب و استفاده از SDK (Software Development Kit):
- Facebook SDK برای جاوااسکریپت باید در وبسایت شما نصب شود. این SDK شامل توابعی برای مدیریت ورود و خروج کاربران است.
-
انجام تنظیمات ورود (Login Configuration):
- با استفاده از جاوااسکریپت، دکمه ورود با فیسبوک را به وبسایت خود اضافه کنید.
- توابعی برای مدیریت ورود کاربر و دریافت دادهها را تنظیم کنید.
-
دریافت و مدیریت توکن دسترسی (Access Token):
- پس از ورود موفقیتآمیز کاربر، یک Access Token دریافت خواهید کرد که میتوانید از آن برای درخواست دادههای کاربری استفاده کنید.
مثال کد
در زیر یک مثال ساده از استفاده از جاوااسکریپت برای پیادهسازی "ورود با فیسبوک" آمده است:
<!DOCTYPE html> <html> <head> <title>Facebook Login Example</title> </head> <body> <fb:login-button scope="public_profile,email" onlogin="checkLoginState();"> </fb:login-button> <div id="status"></div> <script> window.fbAsyncInit = function() { FB.init({ appId : 'YOUR_APP_ID', cookie : true, xfbml : true, version : 'v13.0' }); FB.AppEvents.logPageView(); }; (function(d, s, id){ var js, fjs = d.getElementsByTagName(s)[0]; if (d.getElementById(id)) {return;} js = d.createElement(s); js.id = id; js.src = "https://connect.facebook.net/en_US/sdk.js"; fjs.parentNode.insertBefore(js, fjs); }(document, 'script', 'facebook-jssdk')); function checkLoginState() { FB.getLoginStatus(function(response) { statusChangeCallback(response); }); } function statusChangeCallback(response) { if (response.status === 'connected') { document.getElementById('status').innerHTML = 'We are connected.'; } else if (response.status === 'not_authorized') { document.getElementById('status').innerHTML = 'We are not logged in.'; } else { document.getElementById('status').innerHTML = 'You are not logged into Facebook.'; } } </script> </body> </html>در این نمونه، یک دکمه ورود با فیسبوک (Facebook Login Button) ایجاد شده و از SDK فیسبوک برای مدیریت ورود و بررسی وضعیت کاربران استفاده شده است.
مزایا
- سادهترسازی فرآیند ورود: کاربران میتوانند با چند کلیک ساده وارد سایت شوند.
- دسترسی به دادههای کاربری: میتوانید به اطلاعاتی نظیر نام، ایمیل و عکس کاربر دسترسی داشته باشید.
- افزایش نرخ ثبتنام: به دلیل سهولت ورود، کاربران مستعد به انجام ثبتنام بیشتری هستند.
برای جزئیات بیشتر و استفاده حرفهای، مستندات کامل فیسبوک را مطالعه کنید.
-
- User
من کد بالا رو زدم و دکمه فیس بوک نمایش داده شد ولی وقتی روی دکمه میزنم خطای زیر رو میده
بارگیری نشانی وب ممکن نیست دامنه این نشانی اینترنتی در دامنههای برنامه قرار ندارد. برای اینکه بتوانید این نشانی اینترنتی را بار کنید، همه دامنهها و دامنههای فرعی برنامهتان را در در قسمت «دامنههای برنامه» در تنظیمات برنامهتان اضافه کنید.
- Assistant
خطای شما به تنظیمات دامنههای برنامهی فیسبوک مربوط است. این خطا بیان میکند که دامنهی وبسایت شما در تنظیمات برنامهی فیسبوک ثبت نشده است. برای رفع این مشکل، باید دامنهی خود را در تنظیمات برنامهی فیسبوک اضافه کنید. مراحل زیر را دنبال کنید:
مراحل تنظیم دامنهی برنامه در فیسبوک
-
وارد پنل توسعهدهندگان فیسبوک شوید:
- به آدرس Facebook Developers بروید و وارد حساب کاربری خود شوید.
-
انتخاب اپلیکیشن مناسب:
- اپلیکیشنی که ایجاد کردهاید را از منوی بالا سمت چپ انتخاب کنید.
-
انتقال به تنظیمات:
- در منوی سمت چپ، به بخش Settings بروید و Basic را انتخاب کنید.
-
اضافه کردن دامنهها:
- در قسمت App Domains، دامنهی وبسایت خود را وارد کنید. به عنوان مثال،
example.com. اگر از زیر دامنه استفاده میکنید مثلsub.example.com، همان زیر دامنه را وارد کنید. - همچنین میتوانید از Site URL برای وارد کردن آدرس اصلی وبسایت خود استفاده کنید.
- در قسمت App Domains، دامنهی وبسایت خود را وارد کنید. به عنوان مثال،
-
ذخیره تغییرات:
- پس از وارد کردن دامنهها، دکمه Save Changes را بزنید.
-
تست مجدد:
- حالا به وبسایت خود بازگردید و مجدداً دکمهی ورود با فیسبوک را تست کنید. این بار نباید با خطای دامنه مواجه شوید.
نکات مهم
- پروتکل HTTP و HTTPS: مطمئن شوید که پروتکل صحیح (
http://یاhttps://) را استفاده کردهاید. اگر وبسایت شما از HTTPS استفاده میکند، حتماً با همین پروتکل دامنه را وارد کنید. - زیر دامنهها: دامنهها و زیر دامنهها به عنوان موجودیتهای جداگانه در نظر گرفته میشوند. مثال:
example.comوsub.example.comباید جداگانه تعریف شوند. - تایید صحت دامنه: در برخی مواقع ممکن است نیاز به تایید صحت دامنه توسط فیسبوک داشته باشید.
با انجام مراحل بالا، تنظیمات دامنهی شما به درستی اعمال خواهد شد و مشکل خطای دامنه برطرف میشود. اگر همچنان مشکل باقی بود، لطفاً بررسی کنید که دیگر تنظیمات لازم در فیسبوک ایجاد شدهاند و دامنه به درستی وارد شده است.
-
- User
من دامنه رو با یک پروژه جنگو بالا اوردم ولی کار نمیکنه و همچنان مشکل موجوده
- Assistant
اگر دامنه را به درستی تنظیم کردهاید و همچنان مشکل دارید، ممکن است نیاز باشد چند مورد دیگر را بررسی کنید:
1. بررسی تنظیمات برنامه در داشبورد فیسبوک
-
دامنه برنامه (App Domains):
- مطمئن شوید که نام دامنه را صحیح وارد کردهاید و شامل پروتکل صحیح (http یا https) هست. برای مثال،
https://yourdomain.com. - اگر از دامنههای محلی مانند
localhostیا آیپیهای محلی استفاده میکنید، این موارد به درستی در دامنههای برنامه وارد شده باشند.
- مطمئن شوید که نام دامنه را صحیح وارد کردهاید و شامل پروتکل صحیح (http یا https) هست. برای مثال،
-
Valid OAuth Redirect URIs:
- باید آدرسهای صحیح بازگشتی را (Redirect URI) وارد کنید. این بخش در تنظیمات Facebook Login و زیر منوی Settings یافت میشود.
- اطمینان حاصل کنید که آدرسهای ذکر شده در فیلد Valid OAuth Redirect URIs با تنظیمات پروژه جنگوی شما مطابقت دارد. برای مثال:
https://yourdomain.com/oauth2/callback/
2. تنظیمات امنیتی و پروکسی
- پورتهای فایروال و پروکسی:
- اگر فایروال یا پروکسی دارید، ممکن است دسترسی به URL مسدود شده باشد.
- مطمئن شوید که پورتهای مربوط به جنگو (مثل 8000 یا 80) باز هستند و ترافیک به درستی هدایت میشود.
3. تنظیمات جنگو برای تعامل با فیسبوک
-
middleware و backends امنیتی:
- بررسی کنید که تنظیمات جنگو (مثل
ALLOWED_HOSTS،CSRF_TRUSTED_ORIGINS) به درستی پیکربندی شده است.
افزودن دامنه به
ALLOWED_HOSTS:ALLOWED_HOSTS = ['yourdomain.com', 'www.yourdomain.com']افزودن دامنه به
CSRF_TRUSTED_ORIGINS:CSRF_TRUSTED_ORIGINS = ['https://yourdomain.com'] - بررسی کنید که تنظیمات جنگو (مثل
-
استفاده از کتابخانه مربوطه برای فیسبوک:
- اطمینان حاصل کنید که از کتابخانهای مثل
social-auth-app-djangoبرای استفاده صحیح از OAuth2 استفاده میکنید.
- اطمینان حاصل کنید که از کتابخانهای مثل
4. خطاهای مرورگر و کنسول
- کنسول مرورگر:
- کنسول مرورگر را باز کنید و خطاهای جاوااسکریپت و شبکه را بررسی کنید.
- ممکن است خطای دقیقتری را مشاهده کنید که به رفع مشکل کمک کند.
5. مجوزهای اولیه و دکمه ورود به سیستم
-
مجوزهای لازم (Scope):
- مطمئن شوید که مجوزهای مورد نیاز به درستی در دکمه ورود تعریف شدهاند:
<fb:login-button scope="public_profile,email" onlogin="checkLoginState();"></fb:login-button>
6. تستهای محلی و تولیدی
- محیط تولیدی:
- اگر تمام تنظیمات و تستها در محیط محلی انجام شدهاند، مطمئن شوید که همان مراحل را در محیط تولیدی انجام دادهاید.
با انجام این بررسیها و تنظیمات، مشکل باید حل شود. اگر همچنان مشکل باقی بود، لطفاً اطلاعات دقیقتری از تنظیمات و خطاهای موجود فراهم کنید تا بتوانم بهتر کمک کنم.
-