cmdamt/Include/httpDigest.h

   1 //----------------------------------------------------------------------------
   2 //
   3 //  Copyright (C) Intel Corporation, 2003 - 2005.
   4 //
   5 //  File:       httpDigest.h
   6 //
   7 //  Contents:   Sample code for a gSOAP plugin to implement HTTP Digest
   8 //              authentication.
   9 //
  10 //  Limitations:
  11 //          - MIME, DIME and HTTP chunks (SOAP_IO_CHUNK) are not supported.
  12 //          - This implementationn will internally buffer the entire outgoing
  13 //            message before sending
  14 //          - This implementation will fail if challenge isn't received within
  15 //            SOAP_BUFLEN bytes read.
  16 //          - This implementation will fail if challenge or response are larger
  17 //            than the constants we used.
  18 //          - This implementation calculates the digest response for each call
  19 //            and doesn't save information.
  20 //          - This implementation assumes that the algorithm is MD5 and that
  21 //            qop="auth".
  22 //
  23 // Usage:   Add the httpDigest.h and httpDigest.cpp files to your project
  24 //
  25 //          In your source, just after calling soap_init(), register this
  26 //          plugin with soap_register_plugin( soap, http_digest ).
  27 //          Use soap.userid and soap.passwd for the username and password.
  28 //          As in gSOAP, username and password have to be provided for each call.
  29 //
  30 //          e.g.
  31 //              struct soap soap;
  32 //              soap_init( &soap );
  33 //              soap_register_plugin( &soap, http_digest );
  34 //              soap.userid = "admin";
  35 //              soap.passwd = "admin";
  36 //              ...
  37 //              soap_done(&soap);
  38 //
  39 //----------------------------------------------------------------------------
  40
  41 #ifndef HTTP_DIGEST_H
  42 #define HTTP_DIGEST_H
  43
  44 #include "stdsoap2.h"
  45
  46 int http_digest(struct soap *soap, struct soap_plugin *p, void *arg);
  47
  48 #endif