Zum Inhalt
HALOWERK

Iotwerk

device auth

Canonicalizes device_id, nonce and message, computes an HMAC-SHA256 tag with caller-supplied ephemeral key material, and optionally compares a claimed tag in constant time. It does not provision devices, store keys or replace asymmetric device identity; do not submit long-lived production secrets.

POST https://iot.halowerk.com/v1/device-auth

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
device_idstringJaStable device identifier.
noncestringJaFresh caller-generated challenge nonce.
messagestringJaChallenge payload.
ephemeral_keystringJaEphemeral HMAC key; long-lived production keys must not be sent.
claimed_tag_hexstringNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "device_id",
    "nonce",
    "message",
    "ephemeral_key"
  ],
  "additionalProperties": false,
  "properties": {
    "device_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Stable device identifier."
    },
    "nonce": {
      "type": "string",
      "minLength": 8,
      "maxLength": 256,
      "description": "Fresh caller-generated challenge nonce."
    },
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Challenge payload."
    },
    "ephemeral_key": {
      "type": "string",
      "minLength": 16,
      "maxLength": 512,
      "description": "Ephemeral HMAC key; long-lived production keys must not be sent."
    },
    "claimed_tag_hex": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{64}$"
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "device_id": "sensor-berlin-17",
  "nonce": "20260831-0001",
  "message": "boot:4.2.1",
  "ephemeral_key": "example-ephemeral-key-2026"
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://iot.halowerk.com/v1/device-auth/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 →