summaryrefslogtreecommitdiff
path: root/libraries/ESP_Async_WebServer/examples/SkipServerMiddleware
diff options
context:
space:
mode:
authorschererleander <leander@schererleander.de>2026-01-20 08:34:54 +0100
committerschererleander <leander@schererleander.de>2026-01-20 08:34:54 +0100
commit85ea4e995a75abe061f6fc375ea0481084dddd43 (patch)
tree7eb5d57653ecd8f041aeac4e68d7d554c1168681 /libraries/ESP_Async_WebServer/examples/SkipServerMiddleware
initial commitHEADmain
Diffstat (limited to 'libraries/ESP_Async_WebServer/examples/SkipServerMiddleware')
-rw-r--r--libraries/ESP_Async_WebServer/examples/SkipServerMiddleware/SkipServerMiddleware.ino73
1 files changed, 73 insertions, 0 deletions
diff --git a/libraries/ESP_Async_WebServer/examples/SkipServerMiddleware/SkipServerMiddleware.ino b/libraries/ESP_Async_WebServer/examples/SkipServerMiddleware/SkipServerMiddleware.ino
new file mode 100644
index 0000000..d232c71
--- /dev/null
+++ b/libraries/ESP_Async_WebServer/examples/SkipServerMiddleware/SkipServerMiddleware.ino
@@ -0,0 +1,73 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Copyright 2016-2025 Hristo Gochkov, Mathieu Carbou, Emil Muratov
+
+//
+// Authentication and authorization middlewares
+//
+
+#include <Arduino.h>
+#ifdef ESP32
+#include <AsyncTCP.h>
+#include <WiFi.h>
+#elif defined(ESP8266)
+#include <ESP8266WiFi.h>
+#include <ESPAsyncTCP.h>
+#elif defined(TARGET_RP2040) || defined(TARGET_RP2350) || defined(PICO_RP2040) || defined(PICO_RP2350)
+#include <RPAsyncTCP.h>
+#include <WiFi.h>
+#endif
+
+#include <ESPAsyncWebServer.h>
+
+static AsyncWebServer server(80);
+
+static AsyncAuthenticationMiddleware basicAuth;
+static AsyncLoggingMiddleware logging;
+
+void setup() {
+ Serial.begin(115200);
+
+#ifndef CONFIG_IDF_TARGET_ESP32H2
+ WiFi.mode(WIFI_AP);
+ WiFi.softAP("esp-captive");
+#endif
+
+ // basic authentication
+ basicAuth.setUsername("admin");
+ basicAuth.setPassword("admin");
+ basicAuth.setRealm("MyApp");
+ basicAuth.setAuthFailureMessage("Authentication failed");
+ basicAuth.setAuthType(AsyncAuthType::AUTH_BASIC);
+ basicAuth.generateHash(); // precompute hash (optional but recommended)
+
+ // logging middleware
+ logging.setEnabled(true);
+ logging.setOutput(Serial);
+
+ // we apply auth middleware to the server globally
+ server.addMiddleware(&basicAuth);
+
+ // protected endpoint: requires basic authentication
+ // curl -v -u admin:admin http://192.168.4.1/
+ server.on("/", HTTP_GET, [](AsyncWebServerRequest *request) {
+ request->send(200, "text/plain", "Hello, world!");
+ });
+
+ // we skip all global middleware from the catchall handler
+ server.catchAllHandler().skipServerMiddlewares();
+ // we apply a specific middleware to the catchall handler only to log requests without a handler defined
+ server.catchAllHandler().addMiddleware(&logging);
+
+ // standard 404 handler: will display the request in the console i na curl-like style
+ // curl -v -H "Foo: Bar" http://192.168.4.1/foo
+ server.onNotFound([](AsyncWebServerRequest *request) {
+ request->send(404, "text/plain", "Not found");
+ });
+
+ server.begin();
+}
+
+// not needed
+void loop() {
+ delay(100);
+}