Spring Boot

تهيّئ حزمة SDK لـ Spring Boot مرشِّح servlet تلقائيًا من إعدادات تطبيقك. وسِم نقاط نهاية الأدوات بـ ‎@SyncanixVerifyIntent‎ واقرأ الحمولة المتحقَّق منها من سمات الطلب.

التثبيت

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

implementation "ai.syncanix:syncanix-sdk-spring-boot"

ضبط السرّ

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

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

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

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

@RestController
@RequestMapping("/tools")
public class RefundController {

  @PostMapping("/refund")
  @SyncanixVerifyIntent
  public Map<String, String> refund(HttpServletRequest request) {
    IntentPayload intent =
        (IntentPayload) request.getAttribute(SyncanixIntentFilter.INTENT_ATTRIBUTE);
    return Map.of("tenantId", intent.getTenantId());
  }
}

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