Zugangsdaten

Das authentication-Modul kann den Zugriff auf das Webinterfaces und die HTTP-API durch die Prüfung von Zugangsdaten absichern. Wenn aktiviert verlangt das Modul eine Digest Access Authentication nach RFC 2617. Als Realm wird esp32-lib verwendet.

warp1

Wallboxen verwenden das mächtigere users-Modul.

warp2

Wallboxen verwenden das mächtigere users-Modul.

warp3

Wallboxen verwenden das mächtigere users-Modul.

wem

authentication/config

Zugangsdaten, die für die Verwendung von Webinterface und HTTP-API abgefragt werden sollen.

Beispiel

HTTP (curl)

# $HOST z.B. wem-AbCd

Lesen

curl http://$HOST/authentication/config

{
  "enable_auth": true,
  "username": "testuser",
  // Wird nicht zurückgegeben
  "digest_hash": null
}

Schreiben

curl http://$HOST/authentication/config -d '{
  "enable_auth": true,
  "username": "testuser",
  "digest_hash": "926011006c2686471698e86690b7e500"
}'

"digest_hash" = MD5("testuser:esp32-lib:testpass")

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. wem/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/authentication/config

{
  "enable_auth": true,
  "username": "testuser",
  // Wird nicht zurückgegeben
  "digest_hash": null
}

Schreiben

Mit MQTT auf $PREFIX/authentication/config_update

mosquitto_pub -h $BROKER -t $PREFIX/authentication/config_update -m '{
  "enable_auth": true,
  "username": "testuser",
  "digest_hash": "926011006c2686471698e86690b7e500"
}'

"digest_hash" = MD5("testuser:esp32-lib:testpass")

Name	Bedeutung
enable_auth bool	Gibt an, ob zur Verwendung von Webinterface und HTTP-API Zugangsdaten nötig sein sollen. true - Falls Zugangsdaten verlangt werden sollen. false - Wenn nicht.
username string	Der Benutzername, dem Zugriff auf Webinterface und HTTP-API gewährt werden.
digest_hash string	Der Digest Hash (HA1), dem Zugriff auf Webinterface und HTTP-API gewährt werden. Als realm wird esp32-lib verwendet.

any

authentication/config

Zugangsdaten, die für die Verwendung von Webinterface und HTTP-API abgefragt werden sollen.

Beispiel

HTTP (curl)

# $HOST z.B. warp-AbCd

Lesen

curl http://$HOST/authentication/config

{
  "enable_auth": true,
  "username": "testuser",
  // Wird nicht zurückgegeben
  "digest_hash": null
}

Schreiben

curl http://$HOST/authentication/config -d '{
  "enable_auth": true,
  "username": "testuser",
  "digest_hash": "926011006c2686471698e86690b7e500"
}'

"digest_hash" = MD5("testuser:esp32-lib:testpass")

MQTT (mosquitto)

# $BROKER z.B. my_mosquitto.localdomain
# $PREFIX z.B. warp/AbCd

Lesen

mosquitto_sub -v -C 1 -h $BROKER -t $PREFIX/authentication/config

{
  "enable_auth": true,
  "username": "testuser",
  // Wird nicht zurückgegeben
  "digest_hash": null
}

Schreiben

Mit MQTT auf $PREFIX/authentication/config_update

mosquitto_pub -h $BROKER -t $PREFIX/authentication/config_update -m '{
  "enable_auth": true,
  "username": "testuser",
  "digest_hash": "926011006c2686471698e86690b7e500"
}'

"digest_hash" = MD5("testuser:esp32-lib:testpass")

Name	Bedeutung
enable_auth bool	Gibt an, ob zur Verwendung von Webinterface und HTTP-API Zugangsdaten nötig sein sollen. true - Falls Zugangsdaten verlangt werden sollen. false - Wenn nicht.
username string	Der Benutzername, dem Zugriff auf Webinterface und HTTP-API gewährt werden.
digest_hash string	Der Digest Hash (HA1), dem Zugriff auf Webinterface und HTTP-API gewährt werden. Als realm wird esp32-lib verwendet.