/usr/include/root/TS3HTTPRequest.h is in libroot-net-dev 5.34.19+dfsg-1.2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 | // @(#)root/net:$Id$
// Author: Fabio Hernandez 30/01/2013
// based on an initial version by Marcelo Sousa (class THTTPMessage)
/*************************************************************************
* Copyright (C) 1995-2011, Rene Brun and Fons Rademakers. *
* All rights reserved. *
* *
* For the licensing terms see $ROOTSYS/LICENSE. *
* For the list of contributors see $ROOTSYS/README/CREDITS. *
*************************************************************************/
#ifndef ROOT_TS3HTTPRequest
#define ROOT_TS3HTTPRequest
//////////////////////////////////////////////////////////////////////////
// //
// TS3HTTPRequest //
// //
// An object of this class represents an HTTP request extended to be //
// compatible with Amazon's S3 protocol. //
// Specifically, such a request contains an 'Authorization' header with //
// information used by the S3 server for authenticating this request. //
// The authentication information is computed based on a pair of access //
// key and secret key which are both provided to the user by the S3 //
// service provider (e.g. Amazon, Google, etc.). //
// The secret key is used to compute a signature of selected fields in //
// the request. The algorithm for computing the signature is documented //
// in: //
// //
// Google storage: //
// http://code.google.com/apis/storage/docs/reference/v1/developer-guidev1.html#authentication
// //
// Amazon: //
// http://docs.aws.amazon.com/AmazonS3/latest/dev/S3_Authentication2.html
// //
//////////////////////////////////////////////////////////////////////////
#ifndef ROOT_TObject
#include "TObject.h"
#endif
#ifndef ROOT_TString
#include "TString.h"
#endif
class TS3HTTPRequest : public TObject {
public:
enum EHTTPVerb { kGET, kPOST, kPUT, kDELETE, kHEAD, kCOPY };
enum EAuthType { kNoAuth, kAmazon, kGoogle };
private:
EHTTPVerb fVerb; // HTTP Verb
EAuthType fAuthType; // Authentication type
TString fHost; // Host name
TString fBucket; // Bucket name
TString fObjectKey; // Object key
TString fTimeStamp; // Request time stamp
TString fAccessKey; // Access key (for authentication)
TString fSecretKey; // Secret key (for authentication)
protected:
TString HTTPVerbToTString(EHTTPVerb httpVerb) const;
TString MakeRequestLine(TS3HTTPRequest::EHTTPVerb httpVerb) const;
TString MakeAuthHeader(TS3HTTPRequest::EHTTPVerb httpVerb) const;
TString ComputeSignature(TS3HTTPRequest::EHTTPVerb httpVerb) const;
TString MakeAuthPrefix() const;
TString MakeHostHeader() const;
TString MakeDateHeader() const;
TS3HTTPRequest& SetTimeStamp();
public:
TS3HTTPRequest();
TS3HTTPRequest(EHTTPVerb httpVerb, const TString& host,
const TString& bucket, const TString& objectKey,
EAuthType authType, const TString& accessKey,
const TString& secretKey);
TS3HTTPRequest(const TS3HTTPRequest& m);
virtual ~TS3HTTPRequest() { }
EHTTPVerb GetHTTPVerb() const { return fVerb; }
const TString& GetHost() const { return fHost; }
const TString& GetBucket() const { return fBucket; }
const TString& GetObjectKey() const { return fObjectKey; }
const TString& GetTimeStamp() const { return fTimeStamp; }
const TString& GetAccessKey() const { return fAccessKey; }
const TString& GetSecretKey() const { return fSecretKey; }
TString GetAuthType() const { return fAuthType; }
TString GetRequest(TS3HTTPRequest::EHTTPVerb httpVerb, Bool_t appendCRLF=kTRUE);
TS3HTTPRequest& SetHost(const TString& host);
TS3HTTPRequest& SetBucket(const TString& bucket);
TS3HTTPRequest& SetObjectKey(const TString& objectKey);
TS3HTTPRequest& SetAccessKey(const TString& accessKey);
TS3HTTPRequest& SetSecretKey(const TString& secretKey);
TS3HTTPRequest& SetAuthKeys(const TString& accessKey, const TString& secretKey);
TS3HTTPRequest& SetAuthType(TS3HTTPRequest::EAuthType authType);
ClassDef(TS3HTTPRequest, 0) // Create generic HTTP request for Amazon S3 and Google Storage services
};
//////////////////////////////////////////////////////////////////////////
// //
// Inlines //
// //
//////////////////////////////////////////////////////////////////////////
inline TS3HTTPRequest& TS3HTTPRequest::SetHost(const TString& host)
{
fHost = host;
return *this;
}
inline TS3HTTPRequest& TS3HTTPRequest::SetBucket(const TString& bucket)
{
fBucket = bucket;
return *this;
}
inline TS3HTTPRequest& TS3HTTPRequest::SetObjectKey(const TString& objectKey)
{
fObjectKey = objectKey;
return *this;
}
inline TS3HTTPRequest& TS3HTTPRequest::SetAuthKeys(const TString& accessKey, const TString& secretKey)
{
fAccessKey = accessKey;
fSecretKey = secretKey;
return *this;
}
inline TS3HTTPRequest& TS3HTTPRequest::SetAuthType(TS3HTTPRequest::EAuthType authType)
{
fAuthType = authType;
return *this;
}
inline TS3HTTPRequest& TS3HTTPRequest::SetAccessKey(const TString& accessKey)
{
fAccessKey = accessKey;
return *this;
}
inline TS3HTTPRequest& TS3HTTPRequest::SetSecretKey(const TString& secretKey)
{
fSecretKey = secretKey;
return *this;
}
#endif
|