// SPDX-License-Identifier: LGPL-3.0-or-later // Copyright 2016-2025 Hristo Gochkov, Mathieu Carbou, Emil Muratov // // Show how to manipulate headers in the request / response // #include #ifdef ESP32 #include #include #elif defined(ESP8266) #include #include #elif defined(TARGET_RP2040) || defined(TARGET_RP2350) || defined(PICO_RP2040) || defined(PICO_RP2350) #include #include #endif #include static AsyncWebServer server(80); // request logger static AsyncLoggingMiddleware requestLogger; // filter out specific headers from the incoming request static AsyncHeaderFilterMiddleware headerFilter; // remove all headers from the incoming request except the ones provided in the constructor AsyncHeaderFreeMiddleware headerFree; void setup() { Serial.begin(115200); #ifndef CONFIG_IDF_TARGET_ESP32H2 WiFi.mode(WIFI_AP); WiFi.softAP("esp-captive"); #endif requestLogger.setEnabled(true); requestLogger.setOutput(Serial); headerFilter.filter("X-Remove-Me"); headerFree.keep("X-Keep-Me"); headerFree.keep("host"); server.addMiddlewares({&requestLogger, &headerFilter}); // x-remove-me header will be removed // // curl -v -H "X-Header: Foo" -H "x-remove-me: value" http://192.168.4.1/remove // server.on("/remove", HTTP_GET, [](AsyncWebServerRequest *request) { // print all headers for (size_t i = 0; i < request->headers(); i++) { const AsyncWebHeader *h = request->getHeader(i); Serial.printf("Header[%s]: %s\n", h->name().c_str(), h->value().c_str()); } request->send(200, "text/plain", "Hello, world!"); }); // Only headers x-keep-me and host will be kept // // curl -v -H "x-keep-me: value" -H "x-remove-me: value" http://192.168.4.1/keep // server .on( "/keep", HTTP_GET, [](AsyncWebServerRequest *request) { // print all headers for (size_t i = 0; i < request->headers(); i++) { const AsyncWebHeader *h = request->getHeader(i); Serial.printf("Header[%s]: %s\n", h->name().c_str(), h->value().c_str()); } request->send(200, "text/plain", "Hello, world!"); } ) .addMiddleware(&headerFree); server.begin(); } // not needed void loop() { delay(100); }