تصحيح الأخطاء وإصلاح مشكلات DiscourseConnect الشائعة

[Discourse]

بصفتك مديرًا لمنصة منتديات تستخدم DiscourseConnect، قد تتلقى أحيانًا تقارير من مستخدمين يحاولون تسجيل الدخول إلى المنتدى فيظهر لهم رسالة خطأ. على سبيل المثال: “هناك مشكلة في حسابك. يرجى التواصل مع مدير الموقع.”

تمكين سجلات Discourse Connect التفصيلية

لحل المشكلة، الخطوة الأولى هي تمكين إعداد الموقع المسمى “verbose discourse connect logging” في نظام Discourse. إذا كان هذا الإعداد مفعلًا مسبقًا، يمكنك الانتقال مباشرة إلى سجلات موقعك عبر Admin/Logs/Error Logs. أما إذا لم يكن الإعداد مفعلًا مسبقًا، فستحتاج إلى طلب من المستخدم محاولة تسجيل الدخول مرة أخرى لتوليد مدخل سجل لمحاولته الفاشلة في تسجيل الدخول.

قراءة مدخل السجل

انتقل إلى Admin/Logs/Error Logs وابحث عن مدخل سجل حديث يبدأ بـ Verbose SSO log: Record was invalid. إذا واجهت صعوبة في العثور على المدخل، أدخل عبارة ‘Record was invalid’ في مربع البحث الموجود في أسفل صفحة السجلات. انقر على مدخل السجل، ثم انقر على تبويب ‘info’ في شريط أدوات السجلات:

المعلومات التي ستحتاجها هي السبب (المذكور في مدخل السجل)، بالإضافة إلى email و external_id (الموجودة في قسم المعلومات).

حل مشكلات تسجيل الدخول عبر DiscourseConnect المتعلقة بـ require_activation

مشكلة شائعة في تسجيل الدخول عبر SSO هي: Record was invalid: User {:primary_email=\u003e\"has already been taken\"}.

قد يحدث هذا عندما يكون معامل require_activation في حمولة SSO مضبوطًا على true، ويوجد للمستخدم حساب موجود مسبقًا في Discourse إما لا يحتوي على single_sign_on_record مرتبط به بعد، أو يحتوي على single_sign_on_record لكن external_id للسجل لا يطابق external_id للمستخدم الذي يحاول تسجيل الدخول.

لتأكيد ذلك، افتح وحدة تحكم Rails الخاصة بمنتداك وابحث عن مستخدم يحمل عنوان البريد الإلكتروني المستخدم في محاولة تسجيل الدخول الفاشلة عبر SSO:

u = User.find_by_email('sally@example.com')

الآن، تحقق مما إذا كان هناك single_sign_on_record لهذا المستخدم:

sso_record = u.single_sign_on_record

إذا كان المستخدم موجودًا في منتداك لكنه لا يملك سجل SSO، فيمكنك إنشاء سجل له باستخدام القيم من سجل SSO:

SingleSignOnRecord.create!(user_id: 2, external_id: 2, external_email: 'sally@example.com', last_payload: '')

يجب أن يتمكن المستخدم الآن من تسجيل الدخول.

إذا كان هناك سجل SSO موجود مسبقًا للمستخدم، لكن external_id الخاص به لا يطابق external_id من محاولة تسجيل الدخول الفاشلة، فستحتاج إلى البحث في سبب حدوث ذلك. أحد الأسباب التي قد تؤدي إلى ذلك هو حذف حساب المستخدم ثم إعادة إنشائه في موقع مزود SSO. في هذه الحالة، يمكنك تحديث سجل SSO لاستخدام external_id الجديد:

sso_record.external_id = <failed-sso-login-record-external_id>
sso_record.save!

يجب أن يتمكن المستخدم الآن من تسجيل الدخول.

إذا كنت تستخدم إضافة WP Discourse وتواجه المشكلة المذكورة أعلاه، فراجع Validate Email Addresses with the WP Discourse plugin للحصول على تفاصيل حول كيفية حل المشكلة دون الحاجة إلى الوصول إلى وحدة تحكم Rails.

[jord8on (Jordan)]

@simon

enter your forum’s Rails console

I wasn’t sure how to enter the Rails console, but found the answer over here and thought I’d publish for anyone else who doesn’t know how to get into the Rails console.

1. SSH into your site
2. Login as root user then do the following:
3. sudo -s
4. cd /var/discourse/
5. ls
6. ./launcher enter app
7. rails c

That should get you into the Rails console!

[jord8on (Jordan)]

@simon

If there is an existing SSO record for the user, but its external_id doesn’t match the external_id from the failed login attempt, you will need to look into why this has happened. One way this can happen is if a user’s account has been deleted and then recreated on the SSO provider site. In this case, you can update the SSO record to use the new external_id :

sso_record.external_id = <failed-sso-login-record-external_id>
sso_record.save

I was doing this and it was not working, but I finally got it to work when I replaced this:

sso_record.external_id = <failed-sso-login-record-external_id>

with this:

sso_record.external_id = 91

Where “91” was the external_id of the user who was unable to login.

Thanks so much for this helpful discussion @simon!

[simon]

@jord8on

I was doing this and it was not working, but I finally got it to work when I replaced this:

sso_record.external_id = <failed-sso-login-record-external_id>

with this:

sso_record.external_id = 91

Yes, <failed-sso-login-record-external_id> is meant to be replaced with the external_id from the log entry.

[jord8on (Jordan)]

I was trying it with the " < > " and it wasn’t working, of course ツ

[dylanb (Dylan Burkhardt)]

Is there an easy way to reset the SSO ties for specific accounts with the Rails console? I have a couple admin accounts that are tied to different WP accounts than I would like because originally the email addresses didn’t match properly. Can I manually set them to be tied to a different WP account?

[simon]

You can find the user’s WordPress ID by going to their user page from the WordPress dashboard. The user’s ID will be displayed in the address bar of your browser as the value of the user_id query parameter.

Once you have the user’s WordPress ID, you can update their SSO record on Discourse following the steps outlined for updating the external_id at the end of the ‘Solving require_activation SSO login issues’ section of my original post. You need to be careful with this though - especially with admin accounts.

[peuplier (Marie)]

مرحباً، جربنا هذه الحلول لكن لم ينجح أي منها… كانت المعرفات الخارجية متطابقة ونظام الدخول الموحد (SSO) مفعل. هل لديك حل آخر من فضلك؟ أنا حائر :(.

[simon]

@peuplier

لقد جربنا هذه الحلول لكن لا شيء نجح.

هل المشكلة تتعلق بتسجيل الدخول عبر SSO لمستخدم معين، أم أن SSO لا يعمل على الإطلاق في موقعك؟

[peuplier (Marie)]

فقط لمستخدم معين

[simon]

تأكد من تفعيل إعداد الموقع verbose sso logging. إذا قمت بذلك، هل يمكنك العثور على الخطأ في سجلات موقعك عندما يحاول المستخدم تسجيل الدخول؟ إذا أمكنك مشاركة سجل الخطأ هنا، فقد نتمكن من المساعدة. إذا كانت هناك بيانات في السجل لا ترغب في جعلها عامة، فيمكنك إرسالها إليّ في رسالة خاصة.

[peuplier (Marie)]

هل يساعدك هذا؟ هل هو ما تحتاجه؟

هذا هو تفاصيل السجل (Log) الخاص بالعضو المتأثر بالمشكلة (أو على الأقل، العضو الوحيد الذي أبلغ عن هذه المشكلة)

شكرًا جزيلاً لك!

[simon]

شكرًا لك، هذا مفيد. يبدو أن موقع مزود SSO الخاص بك هو موقع WordPress. هل تستخدم إضافة WP Discourse لـ SSO؟ إذا كان الأمر كذلك، وتستخدم أحدث إصدار من الإضافة، فحاول الانتقال إلى صفحة ملف المستخدم وتحديد مربع اختيار ‘تم التحقق من عنوان البريد الإلكتروني’. ثم تأكد من النقر على زر حفظ. بعد القيام بذلك، اطلب من المستخدم محاولة تسجيل الدخول مرة أخرى.

إذا لم تكن تستخدم إضافة WP Discourse، فسنحتاج إلى تزويدك بتعليمات أكثر تفصيلاً لحل المشكلة.

[peuplier (Marie)]

أنت محق، أنا أستخدم WordPress وقمت بالتغيير، سأطلب من المستخدم المحاولة مرة أخرى، شكرًا جزيلاً!!

[peuplier (Marie)]

نجح الأمر! نعم! شكرًا لك!