Moved and renamed tunnel notification sample and added a secure tunne… (#350)

* Added a secure_tunnel sample that connects through the AWS secure tunnel endpoint as well as through an optional proxy server.
* Added the secure_tunnel sample and the tunnel_notification samples to build_samples.py

Author: sbSteveK

.builder/actions/build_samples.py

@@ -17,6 +17,8 @@ def run(self, env):
             'samples/greengrass/basic_discovery',
             'samples/identity/fleet_provisioning',
             'samples/jobs/describe_job_execution',
+            'samples/secure_tunneling/secure_tunnel',
+            'samples/secure_tunneling/tunnel_notification',
         ]
         for sample_path in samples:
             build_path = os.path.join('build', sample_path)

samples/README.md

@@ -443,15 +443,31 @@ using a permanent certificate set, replace the paths specified in the `--cert` a
         --csr /tmp/deviceCert.csr
 ```
 
-## Secure Tunneling
+## Secure Tunnel
+
+This sample uses AWS IoT [Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) Service to connect a destination and a source with each other through the AWS Secure Tunnel endpoint using access tokens.
+
+Create a new secure tunnel in the AWS IoT console (https://console.aws.amazon.com/iot/) (AWS IoT/Manage/Tunnels/Create tunnel) and retrieve the destination and source access tokens. (https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling-tutorial-open-tunnel.html)
+
+Provide the necessary arguments along with the destination access token and start the sample in destination mode (default).
+
+Provide the necessary arguments along with the source access token and start a second sample in source mode by using the flag --localProxyModeSource.
+
+The two samples will then connect to each other through the AWS Secure Tunnel endpoint and establish a stream through which data can be trasmitted in either direction.
+
+A proxy server may be used by providing the --proxy_host and --proxy_port arguments. If the proxy server requires a user name and password the --proxy_user_name and --proxy_password arguments should be used.
+
+Source: `samples/secure_tunneling/secure_tunnel`
+
+## Secure Tunnel Notification
 
 This sample uses the AWS IoT [Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) Service to receive a tunnel notification.
 
 This sample requires you to create a tunnel for your thing. See [instructions here](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling-tutorial.html).
 
 On startup, the sample will wait until it receives, and then displays the tunnel notification.
 
-Source: `samples/secure_tunneling`
+Source: `samples/secure_tunneling/tunnel_notification`
 
 ## Greengrass discovery
 

samples/secure_tunneling/secure_tunnel/CMakeLists.txt

@@ -0,0 +1,27 @@
+cmake_minimum_required(VERSION 3.1)
+# note: cxx-17 requires cmake 3.8, cxx-20 requires cmake 3.12
+project(secure-tunnel CXX)
+
+file(GLOB SRC_FILES
+       "*.cpp"
+)
+
+add_executable(${PROJECT_NAME} ${SRC_FILES})
+
+set_target_properties(${PROJECT_NAME} PROPERTIES
+    CXX_STANDARD 14)
+
+#set warnings
+if (MSVC)
+    target_compile_options(${PROJECT_NAME} PRIVATE /W4 /WX)
+else ()
+    target_compile_options(${PROJECT_NAME} PRIVATE -Wall -Wno-long-long -pedantic -Werror)
+endif ()
+
+find_package(aws-crt-cpp REQUIRED)
+find_package(IotDeviceCommon-cpp REQUIRED)
+find_package(IotSecureTunneling-cpp REQUIRED)
+
+install(TARGETS ${PROJECT_NAME} DESTINATION bin)
+
+target_link_libraries(${PROJECT_NAME} AWS::aws-crt-cpp AWS::IotDeviceCommon-cpp AWS::IotSecureTunneling-cpp)