zum Hauptinhalt springen
Dokumentation durchsuchen

Go

Verifizieren Sie Syncanix-Agent-Intents in Go — net/http, Gin, Echo und Fiber — mit einer lokalen HMAC-Prüfung bei jedem Tool-Aufruf.

Das Go-SDK liefert Middleware für net/http, Gin, Echo und Fiber sowie einen VerifyIntent-Kern, den Sie direkt aufrufen können. Registrieren Sie es auf Ihren Tool-Routen und lesen Sie die verifizierte Nutzlast aus dem Request-Kontext.

Installation

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

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

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.

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})
})
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