تخطَّ إلى المحتوى الرئيسي
تصفّح التوثيق

Ruby

تحقّق من نيّات وكيل Syncanix في Ruby — Rails وأي تطبيق Rack — بفحص HMAC محلي على كل استدعاء أداة.

تقدّم حزمة SDK للغة Ruby خاصية concern لمتحكّمات Rails وبرمجية وسيطة لـ Rack فوق نواة VerifyIntent مشتركة. ضمِّن الخاصية في متحكّم أدواتك واقرأ الحمولة المتحقَّق منها من النيّة التي تكشفها.

التثبيت

أضف الحزمة إلى مشروعك بمدير الحزم الخاص بلغتك.

bundle add syncanix-sdk-rails
متاح عند الإطلاق — هذه الحزمة ليست بعد على سجلّها العام، لذا سيعمل الأمر أعلاه يوم افتتاح Syncanix.

ضبط السرّ

تتحقق حزمة SDK من النيّات بسرّ توقيع النيّة الخاص بمستأجرك. خزّنه كمتغيّر بيئة — ولا تودعه في نظام إدارة الشيفرة أبدًا — وحمِّله حيث تسجّل حزمة SDK.

export SYNCANIX_INTENT_SECRET="your-intent-signing-secret"

التحقق من النيّات

سجِّل حزمة SDK على المسارات التي تعرض إجراءات الوكيل. فهي تتحقق من ترويسة X-Syncanix-Intent قبل تشغيل معالِجك، وترفض أي استدعاء غير صالح أو مُعاد إرساله بالرمز 403، وتسلّم معالِجك الحمولة المتحقَّق منها — بما فيها المستأجر والمستخدم الفاعلان.

class ToolsController < ApplicationController
  include SyncanixSdk::Rails::VerifyIntentConcern
  syncanix_verify_intent secret: ENV['SYNCANIX_INTENT_SECRET']

  def refund
    render json: { tenantId: @syncanix_intent.tenant_id }
  end
end
التحقق من نيّة على مسار أداة. عند النجاح تكون الحمولة المتحقَّق منها متاحة لمعالِجك؛ وعند الفشل تعيد حزمة SDK الرمز 403 قبل أن تعمل شيفرتك.

الخطوات التالية

مرجع واجهة برمجة التطبيقات في وقت التشغيلمغلَّف النيّة وقواعد التحقق وأسباب الفشل — متطابقة عبر كل حزم SDK.صيغ المفاتيح والرموزصيغ الأسرار والمفاتيح والمعرّفات المستخدمة عبر Syncanix.كل حزم SDKقارن بين كل حزم SDK لجانب الخادم وأوامر تثبيتها.