saltar al contenido principal
Explorar la documentación

Ruby

Verifica las intenciones del agente de Syncanix en Ruby —Rails y cualquier aplicación Rack— con una comprobación HMAC local en cada llamada a herramienta.

El SDK de Ruby ofrece un concern de controlador para Rails y middleware Rack sobre un núcleo VerifyIntent compartido. Incluye el concern en tu controlador de herramientas y lee el payload verificado desde la intención que expone.

Instalación

Añade el paquete a tu proyecto con el gestor de paquetes de tu lenguaje.

bundle add syncanix-sdk-rails

Configura el secreto

El SDK verifica las intenciones con el secreto de firma de intenciones de tu inquilino. Guárdalo como variable de entorno —nunca lo subas al control de versiones— y cárgalo donde registres el SDK.

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

Verifica las intenciones

Registra el SDK en las rutas que exponen acciones del agente. Verifica la cabecera X-Syncanix-Intent antes de que se ejecute tu handler, rechaza con un 403 cualquier llamada inválida o repetida y entrega a tu handler el payload verificado, incluidos el inquilino y el usuario que actúan.

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
Verificación de una intención en una ruta de herramienta. Si tiene éxito, el payload verificado queda disponible para tu handler; si falla, el SDK devuelve 403 antes de que tu código se ejecute.

Próximos pasos