7.1 Getting Started with HTTPS

The following examples show how to retrieve documents using HTTPS.

---

NOTE -- This chapter describes only new information about the use of HTTP over a secure channel. It assumes that you understand the HTTP package (Rogue Wave Internet Protocols Module) and the Secure Sockets package.

---

This example uses the HTTP agent class on https:// URIs. An agent class uses its respective client class to perform common protocol requests.

This example uses utility functions provided in util.h.

Example 10: Using a Secure Agent

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

#include <rw/itc/RWTIOUResult.h>
#include <rw/internet/RWURL.h>
#include <rw/network/RWWinSockInfo.h>
#include <rw/secsock/RWSecureSocketPackageInit.h>
#include <rw/secsock/RWSecureSocketContext.h>
#include <rw/http/RWHttpAgent.h>
#include <rw/http/RWHttpReply.h>
#include <rw/https/RWHttpsSecurityManager.h>

#if defined(RW_NO_IOSTD)
#  include <iostream.h>
#else
#  include <iostream>
   using std::cout;
   using std::cerr;
   using std::endl;
   using std::flush;
#endif

#include "args.h"

// This data is used to seed the RNG
   const unsigned char seed[] = "123456789012345678901234567890"
                                "123456789012345678901234567890"
                                "123456789012345678901234567890"
                                "123456789012345678901234567890"
                                "123456789012345678901234567890";

int main(int argc, char** argv) 
{
  RWWinSockInfo info;                                          //1
  RWSecureSocketPackageInit secsockInit;                       //2

  RWSecureSocketPackageInit::seedRNGFromMemory(seed, 
                                           sizeof(seed))       //3

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

if (args.entries() < 1)
{
  cout << "Usage: " << argv[0] << " <URL>" << endl;
  return 1;
}

RWURL (url(args[0]);                                           //4

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

RWHttpsSecurityManager::setAgentContext(context);              //7

RWHttpAgent agent;                                             //8

RWTIOUResult<RWHttpReply> replyIOU;                            //9

try {
    replyIOU = agent.executeGet(url);                          //10

    RWHttpReply reply = replyIOU.redeem();                     //11

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

    if(reply.is2XX()) { 
      cout << reply.getBody() << endl;                         //12
    }
  } catch(const RWxmsg& msg) { 
    cerr << "An unexpected exception occurred: " 
         << msg.why() << endl;
    return 1;
  }

  return 0;
}

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>

#if defined(RW_NO_IOSTD)
#  include <iostream.h>
#else
#  include <iostream>
   using std::cout;
   using std::cerr;
   using std::endl;
#endif

#include "args.h"

// This data is used to seed the RNG
const unsigned char seed[] = "123456789012345678901234567890"
                             "123456789012345678901234567890"    
                             "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;
}

© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.