source/carddav2/carddav2.h

   1 // CardDAV2.h - CardDAV v2 class header
   2 //
   3 // (c) 2012-2016 Xestia Software Development.
   4 //
   5 // This file is part of Xestia Address Book.
   6 //
   7 // Xestia Address Book is free software: you can redistribute it and/or modify
   8 // it under the terms of the GNU General Public License as published by the
   9 // Free Software Foundation, version 3 of the license.
  10 //
  11 // Xestia Address Book is distributed in the hope that it will be useful,
  12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14 // GNU General Public License for more details.
  15 //
  16 // You should have received a copy of the GNU General Public License along
  17 // with Xestia Address Book. If not, see <http://www.gnu.org/licenses/>
  18
  19 #ifndef __CARDDAV2_CARDDAV2_H__
  20 #define __CARDDAV2_CARDDAV2_H__
  21
  22 #include "../connobject/ConnectionObject.h"
  23 #include "../version.h"
  24 #include "../common/sslcertstructs.h"
  25 #include "../common/dirs.h"
  26
  27 #include <curl/curl.h>
  28 #include <wx/tokenzr.h>
  29 #include <wx/file.h>
  30 #include <libxml/parser.h>
  31 #include <libxml/tree.h>
  32
  33 #include <string>
  34 #include <vector>
  35
  36 class CardDAV2 : public ConnectionObject {
  37
  38         public:
  39
  40                 CardDAV2(std::string ServerAddress, int ServerPort, std::string ServerUser, std::string ServerPass, bool ServerSSL);
  41                 CardDAV2(std::string ServerAddress, int ServerPort, std::string ServerUser, std::string ServerPass, bool ServerSSL, std::string ServerPrefix, std::string ServerAccount);
  42
  43                 // Destructor.
  44
  45                 ~CardDAV2();
  46
  47                 // Functions from the ConnectionObject interface.
  48
  49                 void SetupConnectionObject();
  50
  51                 bool IsTaskCompleted();
  52
  53                 COConnectResult Connect(bool DoAuthentication);
  54
  55                 COServerResponse GetDefaultPrefix(std::string *ServerPrefix);
  56                 COServerResponse AddContact(std::string Location, std::string Data);
  57                 COServerResponse EditContact(std::string Location, std::string Data);
  58                 COServerResponse DeleteContact(std::string Location);
  59                 COServerResponse GetServerEntityTagValue(std::string Location);
  60                 COServerResponse GetContact(std::string Location, std::string *ContactData);
  61                 COContactList GetContactList(std::string SyncToken);
  62
  63                 bool CanDoProcessing();
  64                 bool CanDoSSL();
  65                 COSSLVerified SSLVerify();
  66                 bool AbleToLogin();
  67                 bool HasValidResponse();
  68                 bool IsSelfSigned();
  69                 std::string GetErrorMessage();
  70
  71 #if defined(__APPLE__)
  72 #elif defined(__WIN32__)
  73
  74                 PCCERT_CONTEXT BuildSSLCollection();
  75
  76 #else
  77                 SSLCertCollectionString BuildSSLCollection();
  78
  79 #endif
  80
  81                 void BypassSSLVerification(bool EnableBypass);
  82
  83                 struct CardDAV2PassObject {
  84                         CardDAV2 *CardDAV2Object = nullptr;
  85                         std::string *DataSetting = nullptr;
  86                         bool ServerUsingSSL = false;
  87                         CURL *ConnectionSessionObject = nullptr;
  88 #if defined(__APPLE__)
  89 #elif defined(__WIN32__)
  90                         PCCERT_CONTEXT SSLContext = nullptr;
  91 #endif
  92                 };
  93
  94         protected:
  95         private:
  96
  97                 // Variables to set for the CardDAV2 class.
  98
  99                 CURL *ConnectionSession = nullptr;
 100                 CURLcode SessionResult = CURLE_OK;
 101                 struct curl_slist *HeaderList = nullptr;
 102
 103                 void SetupDefaultParametersNonSSL(bool DoAuthentication);
 104                 void SetupDefaultParametersSSL(bool DoAuthentication);
 105
 106                 std::string PageData;
 107                 std::string PageHeader;
 108                 char SessionErrorBuffer[CURL_ERROR_SIZE];
 109
 110                 CardDAV2PassObject PageDataObject;
 111                 CardDAV2PassObject PageHeaderObject;
 112
 113                 static size_t WritebackFunc(char *ptr, size_t size, size_t nmemb, void *stream);
 114                 size_t WritebackFuncImplementation(char *ptr, size_t size, size_t nmemb, void *stream);
 115
 116                 std::string BuildURL(std::string URI);
 117                 void ResetResults();
 118                 std::vector<std::string> GetDAVHeader();
 119                 std::string GetETagHeader();
 120                 std::string GetETagValue();
 121
 122                 std::string GetUserPrincipalURI();
 123                 std::string GetAddressBookHomeURI();
 124                 std::string GetDefaultAddressBookURI();
 125                 void ProcessContactData(COContactList *ContactList);
 126
 127 #if defined(__APPLE__)
 128 #elif defined(__WIN32__)
 129
 130                 PCCERT_CONTEXT CertificateData = nullptr;
 131
 132 #else
 133 #endif
 134
 135                 void SetCertificateData();
 136
 137                 bool EnableSSLBypass = false;
 138
 139 };
 140
 141 #endif