Ruby

Verifizieren Sie Syncanix-Agent-Intents in Ruby — Rails und jede Rack-App — mit einer lokalen HMAC-Prüfung bei jedem Tool-Aufruf.

Das Ruby-SDK bietet ein Rails-Controller-Concern und Rack-Middleware über einem gemeinsamen VerifyIntent-Kern. Binden Sie das Concern in Ihren Tools-Controller ein und lesen Sie die verifizierte Nutzlast aus der Intent, die es bereitstellt.

Installation

Fügen Sie das Paket mit dem Paketmanager Ihrer Sprache zu Ihrem Projekt hinzu.

bundle add syncanix-sdk-rails

Verfügbar zum Launch — dieses Paket ist noch nicht in seiner öffentlichen Registry; der obige Befehl funktioniert ab dem Tag, an dem Syncanix öffnet.

Das Secret konfigurieren

Das SDK verifiziert Intents mit dem Intent-Signing-Secret Ihres Tenants. Hinterlegen Sie es als Umgebungsvariable — niemals in die Versionsverwaltung einchecken — und laden Sie es dort, wo Sie das SDK registrieren.

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

Intents verifizieren

Registrieren Sie das SDK auf den Routen, die Agent-Aktionen bereitstellen. Es verifiziert den X-Syncanix-Intent-Header, bevor Ihr Handler läuft, weist jeden ungültigen oder wiederholten Aufruf mit 403 ab und übergibt Ihrem Handler die verifizierte Nutzlast — einschließlich des handelnden Tenants und Nutzers.

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

Verifikation einer Intent auf einer Tool-Route. Bei Erfolg steht die verifizierte Nutzlast Ihrem Handler zur Verfügung; bei Fehlschlag gibt das SDK 403 zurück, bevor Ihr Code läuft.

Nächste Schritte

Laufzeit-API-ReferenzDer Intent-Envelope, die Verifikationsregeln und die Fehlergründe — identisch in jedem SDK.Schlüssel- & Token-FormateDie Secret-, Schlüssel- und ID-Formate, die überall in Syncanix verwendet werden.Alle SDKsVergleichen Sie jedes serverseitige SDK und seinen Installationsbefehl.