Zum Inhalt
HALOWERK

Sicherwerk

jwt verify

Decodes a JWT and checks it in two layers. Structure and claims: expiry, not-before and issued-at against the current time with the clock skew you allow, issuer and audience against the values you expect, and the token lifetime. Signature: HMAC with a shared secret, or RSA, RSA-PSS and ECDSA against a PEM key or a JWKS you point at, with the kid matched to the right key.

POST https://sicher.halowerk.com/v1/jwt-verify

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
tokenstringJaThe JWT in compact form.
secretstringNeinShared secret for HS256/384/512.
public_key_pemstringNeinPEM public key for RS/PS/ES algorithms.
jwks_urlstringNeinJWKS endpoint; the key is picked by kid.
expected_issuerstringNeinIssuer the token must carry.
expected_audiencestringNeinAudience the token must name.
clock_skew_secondsintegerNeinTolerance for exp and nbf.
max_lifetime_secondsintegerNeinFlag tokens valid for longer than this.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "token"
  ],
  "additionalProperties": false,
  "properties": {
    "token": {
      "type": "string",
      "minLength": 10,
      "maxLength": 20000,
      "description": "The JWT in compact form."
    },
    "secret": {
      "type": "string",
      "maxLength": 2000,
      "description": "Shared secret for HS256/384/512."
    },
    "public_key_pem": {
      "type": "string",
      "maxLength": 8000,
      "description": "PEM public key for RS/PS/ES algorithms."
    },
    "jwks_url": {
      "type": "string",
      "maxLength": 2000,
      "description": "JWKS endpoint; the key is picked by kid."
    },
    "expected_issuer": {
      "type": "string",
      "maxLength": 500,
      "description": "Issuer the token must carry."
    },
    "expected_audience": {
      "type": "string",
      "maxLength": 500,
      "description": "Audience the token must name."
    },
    "clock_skew_seconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3600,
      "default": 60,
      "description": "Tolerance for exp and nbf."
    },
    "max_lifetime_seconds": {
      "type": "integer",
      "minimum": 1,
      "description": "Flag tokens valid for longer than this."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2V4YW1wbGUuaW52YWxpZC9oYWxvd2Vyay1zeW50aGV0aWMiLCJzdWIiOiJzeW50aGV0aWMtZXhhbXBsZSIsImF1ZCI6InN5bnRoZXRpYy1leGFtcGxlIiwiaWF0Ijo5NDY2ODQ4MDAsImV4cCI6OTQ2Njg4NDAwfQ.RyBcYWZR8Bd7xTj_QqASWo1SGVw16vZR2EhIG6tAjiw",
  "secret": "HALOWERK-public-synthetic-example-never-use-for-authentication",
  "expected_issuer": "https://example.invalid/halowerk-synthetic",
  "expected_audience": "synthetic-example"
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://sicher.halowerk.com/v1/jwt-verify/schema#/outputSchema"
}

Veröffentlichtes Ergebnisbeispiel öffnen

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →