Description

Check whether username and password entered by the web client match a certain value.

Syntax

webserver.checkCredentials(authCredentials);

Parameters

authCredentials

Base64 encoded representation of valid <username>:<password>
The length of this parameter is currently limited to 44 characters in base64 encoded format, effectively limiting username and password combined to 32 characters, e.g. 16 characters username and 16 characters password. This should be practical.

Returns

Returns true if, otherwise returns false

Examples

#include "WebServer.h"

WebServer webserver; // defaults to no prefix, port 80

void privateCmd(WebServer &server, WebServer::ConnectionType type, char *, bool) {
  if (server.checkCredentials("dXNlcjp1c2Vy")) { // user:user in base64 is dXNlcjp1c2Vy
    server.httpSuccess();
    P(helloMsg) = "<h1>Hello User</h1>";
    server.printP(helloMsg);
  } else if (server.checkCredentials("YWRtaW46YWRtaW4=")) { // admin:admin in base64 is YWRtaW46YWRtaW4=
    server.httpSuccess();
    P(helloMsg) = "<h1>Hello Admin</h1>";
    server.printP(helloMsg);
  } else {
    server.httpUnauthorized();
  }
}

void setup() {
  // Ethernet stuff here, e.g. set MAC and IP address
  webserver.addCommand("private.html", &privateCmd);
  webserver.begin();
}

void loop() {
  webserver.processConnection();
}

« back to Webduino