docs: describe how to disable ssl verification in readme

Author: dpopp07

README.md

@@ -222,6 +222,21 @@ var myInstance = new watson.WhateverServiceV1({
 });
 ```
 
+### Configuring the HTTP client
+
+The HTTP client can be configured to disable SSL verification. Note that this has serious security implications - only do this if you really mean to! ⚠️
+
+To do this, set `disable_ssl` to `true` in the service constructor, like below:
+
+```
+const discovery = new DiscoveryV1({
+  url: '<service_url>',
+  version: '<version-date>',
+  iam_apikey: '<iam_api_key>',
+  disable_ssl: true, // this will disable SSL verification for any request made with this object
+});
+```
+
 ## Documentation
 
 You can find links to the documentation at https://console.bluemix.net/developer/watson/documentation. Find the service that you're interested in, click **API reference**, and then select the **Node** tab.

lib/base_service.ts

@@ -43,7 +43,7 @@ export interface UserOptions {
   iam_access_token?: string;
   iam_apikey?: string;
   iam_url?: string;
-  allow_unauthorized?: boolean;
+  disable_ssl?: boolean;
 }
 
 export interface BaseServiceOptions extends UserOptions {
@@ -151,9 +151,9 @@ export class BaseService {
     } else {
       this.tokenManager = null;
     }
-    // rejectUnauthorized should only be false if allow_unauthorized is true
+    // rejectUnauthorized should only be false if disable_ssl is true
     // used to disable ssl checking for icp
-    this._options.rejectUnauthorized = !options.allow_unauthorized;
+    this._options.rejectUnauthorized = !options.disable_ssl;
   }
 
   /**

test/unit/test.base_service.js

@@ -265,25 +265,25 @@ describe('BaseService', function() {
     assert(authHeader.startsWith('Basic'));
   });
 
-  it('should set rejectUnauthorized to `false` if allow_unauthorized is `true`', function() {
+  it('should set rejectUnauthorized to `false` if `disable_ssl` is `true`', function() {
     const instance = new TestService({
       username: 'apikey',
       password: 'icp-1234',
-      allow_unauthorized: true,
+      disable_ssl: true,
     });
     assert.equal(instance._options.rejectUnauthorized, false);
   });
 
-  it('should set rejectUnauthorized to `true` if allow_unauthorized is `false`', function() {
+  it('should set rejectUnauthorized to `true` if `disable_ssl` is `false`', function() {
     const instance = new TestService({
       username: 'apikey',
       password: 'icp-1234',
-      allow_unauthorized: false,
+      disable_ssl: false,
     });
     assert(instance._options.rejectUnauthorized);
   });
 
-  it('should set rejectUnauthorized to `true` if allow_unauthorized is not set', function() {
+  it('should set rejectUnauthorized to `true` if `disable_ssl` is not set', function() {
     const instance = new TestService({
       username: 'apikey',
       password: 'icp-1234',