ورود با شبکه‌های اجتماعی
مسیر: تنظیمات ← ورود اجتماعی
ابتدا گزینهٔ فعال‌سازی ورود با شبکه‌های اجتماعی؟ را روشن کنید، سپس هر سرویس را جداگانه فعال کنید. سرویس‌های پشتیبانی‌شده:
- فیسبوک (شناسه App و کلید App Secret)
- گوگل
- گیت‌هاب
- لینکدین و LinkedIn OpenID Connect
- X (توییتر)
برای سرویس‌های غیر از فیسبوک، شناسه Client و کلید Client Secret را از پنل توسعه‌دهندگان همان سرویس دریافت کنید. سبک نمایش دکمه‌ها (پیش‌فرض، ساده یا مینیمال) نیز در همین صفحه قابل انتخاب است.
آدرس بازگشت (Redirect URI)
در پنل توسعه‌دهندگان هر سرویس، آدرس بازگشت را به این شکل ثبت کنید:
https://your-domain.com/auth/callback/googleبه‌جای google نام سرویس (facebook، github، linkedin، x و…) را بنویسید. ترتیب درست مسیر auth/callback/{سرویس} است.
رفع اشکال
اگر پس از بازگشت از سرویس با خطای InvalidStateException یا Missing required parameter: code مواجه شدید، معمولاً ModSecurity هاست پارامترهای بازگشت را حذف می‌کند؛ از پشتیبانی هاست بخواهید برای این مسیر استثنا تعریف کند.
نکات مهم
- آدرس بازگشت باید دقیقاً با مقدار ثبت‌شده در پنل سرویس یکسان باشد (همراه
https). - برخی سرویس‌ها از سرورهای داخل ایران در دسترس نیستند؛ پیش از فعال‌سازی، ورود را آزمایش کنید.
هشدارها
⚠️ کلیدهای Secret را در کد، مخزن گیت یا مکان عمومی قرار ندهید.