
BotAuth - حزمة تسمح لك بتسجيل الدخول باستخدام برنامج Vkontakte و FaceBook و Telegram.
الهدف الرئيسي من BotAuth هو تبسيط زوار مواقع الويب / تسجيل الدخول PWA عبر الشبكات الاجتماعية.
بينما الاجتماعية. لا تقدم الشبكات تعليقات من تطبيقات الأجهزة المحمولة المحلية إلى موقع ويب ، ويتعين على المطورين إرسال المستخدم إلى متصفح ، حيث يحتاجون مرة أخرى إلى إدخال اسم مستخدم وكلمة مرور.
باستخدام برامج الروبوت ، يمكنك الحصول على تعليقات (رد الاتصال) من التطبيق الأصلي ، وبالتالي لا تضطر إلى إدخال اسم المستخدم وكلمة المرور الاجتماعية. الشبكة في المتصفح.
عرض توضيحي - 
https://laravel.zetrider.ru/botauthجيثب - 
https://github.com/zetrider/BotAuthروابط النموذج:
https://vk.me/ https://t.me/ https://m.me/ 
افتح تطبيق المحمول لبدء حوار مع الروبوت. لن يضطر الزائر إلى إعادة إدخال اسم المستخدم وكلمة المرور في المتصفح.
يمكنك توصيل الروبوتات:
- فكونتاكتي
- برقية
- فيسبوك
- مزودك الخاص (مثال أدناه)
تركيب- الملحن تتطلب zetrider / botauth
- قم بتوصيل الحزمة في config / app.php
 مزود
  ZetRider\BotAuth\BotAuthServiceProvider::class,
 
 مظهر زائف
  'BotAuth' => ZetRider\BotAuth\Facades\BotAuth::class,
 
 
- نسخ التكوين. ملف
  php artisan vendor:publish --tag=botauth-config
 
 إذا لزم الأمر
  php artisan vendor:publish --tag=botauth-views
 
  php artisan vendor:publish --tag=botauth-migrations
 
 
- تشير إلى اللازمة الاجتماعية. ربط الشبكات في config / botauth.php في معلمة الارتباط.
- ملء ملف ENV مع مفاتيح الروبوت
  BOTAUTH_VKONTAKTE_API_SECRET BOTAUTH_VKONTAKTE_API_TOKEN BOTAUTH_VKONTAKTE_API_CONFIRM BOTAUTH_TELEGRAM_API_TOKEN BOTAUTH_TELEGRAM_PROXY BOTAUTH_FACEBOOK_API_SECRET BOTAUTH_FACEBOOK_API_TOKEN BOTAUTH_FACEBOOK_API_CONFIRM
 
 
- تشغيل الهجرات
  php artisan migrate
 
 
- في Middleware VerifyCsrfToken إضافة استثناء عنوان لإعادة الاتصال ، الافتراضي هو botauth / callback / * '
  protected $except = [ 'botauth/callback/*' 
 
 
- لطراز المستخدم الخاص بك ، أضف سمة:
  use ZetRider\BotAuth\Traits\BotAuthUserTrait;
 
 والتي سوف تضيف علاقة مع تسجيلات دخول المستخدم من الاجتماعية. الشبكات
 
 ربط السير:فكونتاكتي- افتح إعدادات المنتدى أو أنشئ vk.com/groups؟w=groups_create جديدًا
- في إعدادات المجتمع ، افتح قسم "الإعدادات" - "العمل مع واجهة برمجة التطبيقات"
- قم بإنشاء مفتاح مرور ، وحدد "السماح للتطبيق بالوصول إلى رسائل المجتمع" ، ثم اكتب المفتاح ، ويجب تحديده .env BOTAUTH_VKONTAKTE_API_TOKEN
- في نفس الصفحة ، حدد واجهة برمجة تطبيقات رد الاتصال ، وحدد "إصدار واجهة برمجة التطبيقات" 5.95 ، وحدد عنوان رد الاتصال لموقعك في حقل "العنوان" ، المثال الافتراضي https://DOMAIN/botauth/callback/vkontakte
 
- أدناه ، يرجى الإشارة إلى السطر الذي يجب أن يعود إليه الخادم .env BOTAUTH_VKONTAKTE_API_CONFIRM
- في حقل "المفتاح السري" ، أدخل أي مفتاح سري ، حدد في .env BOTAUTH_VKONTAKTE_API_SECRET
- بعد ملء جميع المفاتيح في .env ، انقر فوق الزر "تأكيد"
- في نفس الصفحة ، افتح علامة التبويب "أنواع الأحداث" ، حدد "صندوق الوارد"
- افتح إعدادات المجتمع ، العنصر "الرسائل" ، قم بتمكين "رسائل المجتمع"
- افتح إعدادات المجتمع ، العنصر "رسائل" - "إعدادات للبوت" ، قم بتشغيل "ميزات البوت"
الروبوت مستعد للذهاب.
مثال على ارتباط مباشر لحوار مع الروبوت
 https://vk.me/zetcode 
 برقية- قم بإنشاء الروبوت الخاص بك عبرBotFather
- تذكر المفتاح ، حدد في .env BOTAUTH_TELEGRAM_API_TOKEN
- إضافة ربط الويب عبر
  https://api.telegram.org/botYOUR_TOKEN/setWebhook?url=https://DOMAIN/botauth/callback/telegram
 
 استبدل YOUR_TOKEN برمزك ، DOMAIN بنطاقك
- إذا لزم الأمر ، حدد الخادم الوكيل في .env BOTAUTH_TELEGRAM_PROXY ، على سبيل المثال socks5h: //127.0.0.1: 1080
الروبوت مستعد للذهاب.
مثال على ارتباط مباشر لحوار مع الروبوت
 https://t.me/BotAuthBot 
 الفيسبوك- يجب أن تكون قد أنشأت صفحة ، إن لم تكن كذلك ، أضف www.facebook.com/pages/creation/؟ref_type=universal_creation_hub
- أضف التطبيق developers.facebook.com/apps الجديد
- في إعدادات التطبيق ، حدد "أساسي" ، وانسخ "سر التطبيق" إلى .env BOTAUTH_FACEBOOK_API_SECRET
- في إعدادات التطبيق تحتاج إلى إضافة المنتج "Messenger"
- في إعدادات المنتج "Messenger" ، قم بإنشاء رمز وصول ، حدده في .env BOTAUTH_FACEBOOK_API_TOKEN
- في إعدادات منتج Messenger ، قم بإنشاء ربط ويب ، حدد في URL رد الاتصال https://DOMAIN/botauth/callback/facebook
 استبدل DOMAIN بنطاقك
- في حقل "تأكيد العلامة" ، حدد أي نص ، واحفظه في .env BOTAUTH_FACEBOOK_API_CONFIRM
- في خيارات "حقول الاشتراك" ، حدد "رسائل"
- انقر فوق تأكيد
- بعد تأكيد الخادم في إعدادات ربط الويب ، حدد الصفحة ، وانقر فوق "اشتراك"
- في نافذة "التحقق من تطبيق Messenger" ، بجوار "pages_messaging" ، انقر على "Add to Request"
الروبوت جاهز للعمل بالفعل ، ولكنه متاح للمسؤولين فقط.
بعد تأكيد التطبيق ، سوف يصبح متاحًا لجميع الزوار. تقديم الطلب للاعتدال.
مثال على ارتباط مباشر لحوار مع الروبوت
 https://m.me/zetridercode 
 ومن المهم أن:- يجب أن يعمل الموقع على https
- يقوم برنامج bot الخاص بفيسبوك بإرجاع PSID لا يطابق معرف المستخدم العمومي.
- بشكل افتراضي ، تعمل وحدة التحكم bot مع طراز \ App \ User. إذا كانت لديك حالة مختلفة ، فقم فقط بإنشاء وحدة التحكم والنموذج استنادًا إلى أمثلة من المستودع. نموذج ، المراقب المالي
كيفية إضافة مزودك:قم بإنشاء فصلك الذي يرث فصلاً مجردة
 ZetRider\BotAuth\AbstractProvider 
مثال 
مثال / ExampleProvider.phpأضف موفرًا للخدمة ، على سبيل المثال ، AppServiceProvider في طريقة التمهيد
 
سيقوم الموفر بمعالجة الطلبات في رد اتصال على
 https://.../botauth/callback/example 
أحداثحدث على معالجة ناجحة لرسالة جديدة من الروبوت