/**********
|
This library is free software; you can redistribute it and/or modify it under
|
the terms of the GNU Lesser General Public License as published by the
|
Free Software Foundation; either version 3 of the License, or (at your
|
option) any later version. (See <http://www.gnu.org/copyleft/lesser.html>.)
|
|
This library is distributed in the hope that it will be useful, but WITHOUT
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for
|
more details.
|
|
You should have received a copy of the GNU Lesser General Public License
|
along with this library; if not, write to the Free Software Foundation, Inc.,
|
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
**********/
|
// "liveMedia"
|
// Copyright (c) 1996-2017 Live Networks, Inc. All rights reserved.
|
// A class used for digest authentication.
|
// C++ header
|
|
#ifndef _DIGEST_AUTHENTICATION_HH
|
#define _DIGEST_AUTHENTICATION_HH
|
|
#ifndef _BOOLEAN_HH
|
#include <Boolean.hh>
|
#endif
|
|
// A class used for digest authentication.
|
// The "realm", and "nonce" fields are supplied by the server
|
// (in a "401 Unauthorized" response).
|
// The "username" and "password" fields are supplied by the client.
|
class Authenticator {
|
public:
|
Authenticator();
|
Authenticator(char const* username, char const* password, Boolean passwordIsMD5 = False);
|
// If "passwordIsMD5" is True, then "password" is actually the value computed
|
// by md5(<username>:<realm>:<actual-password>)
|
Authenticator(const Authenticator& orig);
|
Authenticator& operator=(const Authenticator& rightSide);
|
Boolean operator<(const Authenticator* rightSide);
|
virtual ~Authenticator();
|
|
void reset();
|
void setRealmAndNonce(char const* realm, char const* nonce);
|
void setRealmAndRandomNonce(char const* realm);
|
// as above, except that the nonce is created randomly.
|
// (This is used by servers.)
|
void setUsernameAndPassword(char const* username, char const* password, Boolean passwordIsMD5 = False);
|
// If "passwordIsMD5" is True, then "password" is actually the value computed
|
// by md5(<username>:<realm>:<actual-password>)
|
|
char const* realm() const { return fRealm; }
|
char const* nonce() const { return fNonce; }
|
char const* username() const { return fUsername; }
|
char const* password() const { return fPassword; }
|
|
char const* computeDigestResponse(char const* cmd, char const* url) const;
|
// The returned string from this function must later be freed by calling:
|
void reclaimDigestResponse(char const* responseStr) const;
|
|
private:
|
void resetRealmAndNonce();
|
void resetUsernameAndPassword();
|
void assignRealmAndNonce(char const* realm, char const* nonce);
|
void assignUsernameAndPassword(char const* username, char const* password, Boolean passwordIsMD5);
|
void assign(char const* realm, char const* nonce,
|
char const* username, char const* password, Boolean passwordIsMD5);
|
|
private:
|
char* fRealm; char* fNonce;
|
char* fUsername; char* fPassword;
|
Boolean fPasswordIsMD5;
|
};
|
|
#endif
|
