Using RWHttpsSecureSocketClient to Retrieve a Document

SourcePro : Secure Communication Module User’s Guide : PART III HTTPS Package : Using HTTPS : Getting Started with HTTPS : Using RWHttpsSecureSocketClient to Retrieve a Document

This example uses the HTTPS client class. A client class allows low-level access to and encapsulates the details of the protocol.

This example uses utility functions provided in util.h.

Example 11 – Using a Secure Client

// File: examples\https\manual\RWHttpSecureClientExample.cpp

#include <rw/network/RWWinSockInfo.h>

#include <rw/network/RWInetAddr.h>

#include <rw/secsock/RWSecureSocketPackageInit.h>

#include <rw/secsock/RWSecureSocketContext.h>

#include <rw/http/RWHttpClient.h>

#include <rw/http/RWHttpRequest.h>

#include <rw/https/RWHttpsSecureSocketClient.h>

#include <rw/internet/RWURL.h>

#include <iostream>

using std::cout;

using std::cerr;

using std::endl;

#include "args.h"

// This data is used to seed the RNG

const unsigned char seed[] = "123456789012345678901234567890"

"123456789012345678901234567890"

"123456789012345678901234567890";

int main(int argc, char* argv[])

{

RWWinSockInfo info; //1

RWSecureSocketPackageInit secsockInit; //2

RWSecureSocketPackageInit::seedRNGFromMemory(SEED_DATA_FILE); //3

RWTValSlist<RWCString> args = processArgs(argc, argv);

if (args.entries() < 1)

{

cout << "Usage: " << argv[0] << " <url>" << endl;

return 1;

}

RWURL url(args[0]);

RWCString host = url.getHost();

RWCString portStr = url.getPort();

int port = atoi(portStr.data());

RWSecureSocketContext context; //4

// context.prepareToAuthenticate("<certificate file>"); //5

RWHttpClient client; //6

client = RWHttpsSecureSocketClient::make(context); //7

RWHttpRequest request(RWHttpRequest::Get, "/"); //8

try {

client.connect(host, port); //9

client.submit(request);

RWHttpReply reply = client.getReply(); //10

cout << reply.asString() << endl;

if(reply.is2XX()) {

cout << reply.getBody() << endl; //11

}

} catch(const RWxmsg& msg) {

cerr << "An unexpected exception occurred: "

<< msg.why() << endl;

return 1;

}

return 0;

}

//1 Initialize Windows Sockets (does nothing on UNIX).

//2 Initialize the Secure Sockets package.

//3 Seed the Random Number Generator in the Secure Sockets package (Note: Seedin the random number generator from a const string is not secure and not recommended in production applications, but is sufficient for this example).

//4 Create a RWSecureSocketContext instance.

//5 Initialize the context. This call instructs the context to prepare to authenticate the server we will connect to. The <certificate_file> is a text file that contains the root certificates of the certificate authorities we trust. (For example, we do not perform authentication in this example.)

//6 Create a HTTP client handle.

//7 Create an RWHttpsSecureSocketClient and associate the context with it. Connect this body with the handle created in //6.

//8 Create a request for the root document.

//9 Connect the client to the host and submit the request created in //8.

//10 Get the reply from the server. This function blocks until a reply is available.

//11 If the request was successful, write the body of the document to standard output.