lluserauth.h

Go to the documentation of this file.

#ifndef LLUSERAUTH_H
#define LLUSERAUTH_H

#include <string>
#include <vector>
#include <map>

class LLXMLRPCTransaction;

//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// Class LLUserAuth
//
// This class encapsulates the authentication and initialization from
// the login server. Construct an instance of this object, and call
// the authenticate() method, and call authResponse() until it returns
// a non-negative value. If that method returns E_OK, you can start
// asking for responses via the getResponse() method. Here is some
// sample code that gets the session id if login was successful:
//
//  auth.authenticate(...);
//  while((auth.authResponse() < 0)) {sleep(1);}
//  LLUUID session_id;
//  if(0 == strcmp(auth.getResponse("login"), "true"))
//  {
//    const char* session_id_str = auth.getResponse("session-id");
//    if(session_id_str) session_id.set(session_id_str);
//  }
//
// Format for responses as maintained in login.cgi:
// login = 'true' | 'false'
// reason = [ 'data'  |    -- insufficient or poorly formatted data
//            'ban' |      -- user is banned
//            'update' |   -- viewer requires update
//            'optional' | -- optional viewer update
//            'key' |      -- mismatched first/last/passwd
// message = human readable message for client
// session-id = auth key
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

class LLUserAuth
{
public:
        LLUserAuth();
        ~LLUserAuth();

        // These codes map to the curl return codes...
        typedef enum {
                E_NO_RESPONSE_YET = -2,
                E_DOWNLOADING = -1,
                E_OK = 0,
                E_COULDNT_RESOLVE_HOST,
                E_SSL_PEER_CERTIFICATE,
                E_SSL_CACERT,
                E_SSL_CONNECT_ERROR,
                E_UNHANDLED_ERROR,
                E_LAST                                          // never use!
        } UserAuthcode;

        // used for holding options
        typedef std::map<std::string, std::string> response_t;
        typedef std::vector<response_t> options_t;

        void authenticate(
                const char* auth_uri,
                const char* auth_method,
                const char* firstname,
                const char* lastname,
                const char* passwd,
                const char* start,
                BOOL skip_optional_update,
                BOOL accept_tos,
                BOOL accept_critical_message,
                const LLUUID& viewer_digest,
                BOOL last_exec_froze, 
                const std::vector<const char*>& requested_options,
                const std::string& hashed_mac,
                const std::string& hashed_volume_serial);

        UserAuthcode authResponse();
        
        std::string errorMessage() const { return mErrorMessage; }

        // function to get a direct reponse from the login api by
        // name. returns NULL if the named response was not found.
        const char* getResponse(const char* name) const;
        BOOL getOptions(const char* name, options_t& options) const;

        F64 getLastTransferRateBPS() const { return mLastTransferRateBPS; }

private:
        LLXMLRPCTransaction* mTransaction;

        UserAuthcode mAuthResponse;
        std::string mErrorMessage;
        
        // dealing with the XML
        typedef std::map<std::string, options_t> all_options_t;
        response_t mResponses;
        all_options_t mOptions;
        
        UserAuthcode parseResponse();

        F64 mLastTransferRateBPS;       // bits per second, only valid after a big transfer like inventory
};

extern LLUserAuth *gUserAuthp;

#endif /* LLUSERAUTH_H */

---