saltar al contenido principal
Explorar la documentación

Go

Verifica las intenciones del agente de Syncanix en Go —net/http, Gin, Echo y Fiber— con una comprobación HMAC local en cada llamada a herramienta.

El SDK de Go incluye middleware para net/http, Gin, Echo y Fiber, además de un núcleo VerifyIntent que puedes llamar directamente. Regístralo en tus rutas de herramientas y lee el payload verificado desde el contexto de la solicitud.

Instalación

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

go get github.com/syncanix-ai/syncanix-sdk-go

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.

r := gin.Default()
r.Use(syncanix.GinMiddleware(os.Getenv("SYNCANIX_INTENT_SECRET"), nil))

r.POST("/tools/refund", func(c *gin.Context) {
    payload, _ := c.MustGet(syncanix.GinIntentKey).(*syncanix.IntentPayload)
    c.JSON(200, gin.H{"tenantId": payload.TenantID})
})
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