Merge pull request #1 from CyberSource/main

First Release (.NET Standard Authentication SDK)

Author: gnongsie

.gitignore

@@ -348,3 +348,10 @@ MigrationBackup/
 
 # Ionide (cross platform F# VS Code tools) working folder
 .ionide/
+.swagger-codegen
+/cybersource-rest-client-netstandard/cybersource-rest-client-netstandard/.swagger-codegen-ignore
+/cybersource-rest-client-netstandard/cybersource-rest-client-netstandard/.travis.yml
+/cybersource-rest-client-netstandard/cybersource-rest-client-netstandard/build.bat
+/cybersource-rest-client-netstandard/cybersource-rest-client-netstandard/build.sh
+/cybersource-rest-client-netstandard/cybersource-rest-client-netstandard/git_push.sh
+/cybersource-rest-client-netstandard/cybersource-rest-client-netstandard/mono_nunit_test.sh

README.md

@@ -1,2 +1,15 @@
 # .NET Standard Client SDK for the CyberSource REST API
-.NET Standard client library for the CyberSource REST API
+
+The CyberSource .NET Standard client provides convenient access to the [CyberSource REST API](https://developer.cybersource.com/api/reference/api-reference.html) from your .NET application.
+
+This repository also contains the code for the Authentication SDK written in .NET Standard.
+
+For a more detailed explanation of these libraries, refer to
+
+* [CyberSource REST Client SDK README.md](./cybersource-rest-client-netstandard/README.md)
+
+* [CyberSource Authentication SDK README.md](./cybersource-rest-auth-netstandard/README.md)
+
+## License
+
+This repository is distributed under a proprietary license.

cybersource-rest-auth-netstandard/ApiSdk/ApiSdk.sln

@@ -0,0 +1,31 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 16
+VisualStudioVersion = 16.0.30517.126
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ApiSdk", "ApiSdk\ApiSdk.csproj", "{23C047B9-8597-4A5F-82B7-A2F97555AD9F}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ApiSdkTests.NetCore", "ApiSdkTests.NetCore\ApiSdkTests.NetCore.csproj", "{B3F426A5-7324-4147-8992-7C50B1902C73}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{23C047B9-8597-4A5F-82B7-A2F97555AD9F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{23C047B9-8597-4A5F-82B7-A2F97555AD9F}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{23C047B9-8597-4A5F-82B7-A2F97555AD9F}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{23C047B9-8597-4A5F-82B7-A2F97555AD9F}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B3F426A5-7324-4147-8992-7C50B1902C73}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B3F426A5-7324-4147-8992-7C50B1902C73}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B3F426A5-7324-4147-8992-7C50B1902C73}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B3F426A5-7324-4147-8992-7C50B1902C73}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {A4D25916-F2C3-471F-8B4B-86CD58B767D7}
+	EndGlobalSection
+EndGlobal

cybersource-rest-auth-netstandard/ApiSdk/ApiSdk/ApiSdk.csproj

@@ -0,0 +1,31 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>netstandard2.1</TargetFramework>
+  </PropertyGroup>
+
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
+    <DebugType>full</DebugType>
+    <DebugSymbols>true</DebugSymbols>
+    <OutputPath>bin\Debug</OutputPath>
+    <DefineConstants>DEBUG;TRACE</DefineConstants>
+  </PropertyGroup>
+
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
+    <DebugType>pdbonly</DebugType>
+    <DebugSymbols>true</DebugSymbols>
+    <OutputPath>bin\Release</OutputPath>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Newtonsoft.Json" Version="12.0.3" />
+    <PackageReference Include="NLog" Version="4.7.4" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Reference Include="Cybersource.Authentication.NetStandard">
+      <HintPath>..\..\AuthenticationSdk\AuthenticationSdk\bin\Debug\netstandard2.1\Cybersource.Authentication.NetStandard.dll</HintPath>
+    </Reference>
+  </ItemGroup>
+
+</Project>

cybersource-rest-auth-netstandard/ApiSdk/ApiSdk/connection/HTTPConnection.cs

@@ -0,0 +1,90 @@
+using System.Net.Http;
+using System.Net.Http.Headers;
+using ApiSdk.util;
+using AuthenticationSdk.core;
+
+namespace ApiSdk.connection
+{
+    public class HTTPConnection : IConnection
+    {
+        public HttpClient GetConnectionForGet(MerchantConfig merchantConfig)
+        {
+            var signature = AuthenticationHelper.GetSignature(merchantConfig);
+            var httpConnUtility = new HttpConnUtility(merchantConfig.ProxyAddress, merchantConfig.ProxyPort, merchantConfig.TimeOut);
+            var client = httpConnUtility.GetHttpClient();
+
+            client.DefaultRequestHeaders
+                        .Accept
+                        .Add(new MediaTypeWithQualityHeaderValue(Constants.MediaTypeHalAndJson));
+
+            client.DefaultRequestHeaders.Add("v-c-merchant-id", signature.MerchantId);
+
+            client.DefaultRequestHeaders.Add("Date", signature.GmtDateTime);
+
+            client.DefaultRequestHeaders.Add("Host", signature.HostName);
+
+            client.DefaultRequestHeaders.Add("Signature", signature.SignatureParam);
+
+            return client;
+        }
+
+        public HttpClient GetConnectionForPost(MerchantConfig merchantConfig)
+        {
+            var signature = AuthenticationHelper.GetSignature(merchantConfig);
+            var httpConnUtility = new HttpConnUtility(merchantConfig.ProxyAddress, merchantConfig.ProxyPort, merchantConfig.TimeOut);
+            var client = httpConnUtility.GetHttpClient();
+
+            client.DefaultRequestHeaders.Add("v-c-merchant-id", signature.MerchantId);
+
+            client.DefaultRequestHeaders.Add("Date", signature.GmtDateTime);
+
+            client.DefaultRequestHeaders.Add("Host", signature.HostName);
+
+            client.DefaultRequestHeaders.Add("Digest", signature.Digest);
+
+            client.DefaultRequestHeaders.Add("Signature", signature.SignatureParam);
+
+            return client;
+        }
+
+        public HttpClient GetConnectionForPut(MerchantConfig merchantConfig)
+        {
+            var signature = AuthenticationHelper.GetSignature(merchantConfig);
+            var httpConnUtility = new HttpConnUtility(merchantConfig.ProxyAddress, merchantConfig.ProxyPort, merchantConfig.TimeOut);
+            var client = httpConnUtility.GetHttpClient();
+
+            client.DefaultRequestHeaders.Add("v-c-merchant-id", signature.MerchantId);
+
+            client.DefaultRequestHeaders.Add("Date", signature.GmtDateTime);
+
+            client.DefaultRequestHeaders.Add("Host", signature.HostName);
+
+            client.DefaultRequestHeaders.Add("Digest", signature.Digest);
+
+            client.DefaultRequestHeaders.Add("Signature", signature.SignatureParam);
+
+            return client;
+        }
+
+        public HttpClient GetConnectionForDelete(MerchantConfig merchantConfig)
+        {
+            var signature = AuthenticationHelper.GetSignature(merchantConfig);
+            var httpConnUtility = new HttpConnUtility(merchantConfig.ProxyAddress, merchantConfig.ProxyPort, merchantConfig.TimeOut);
+            var client = httpConnUtility.GetHttpClient();
+
+            client.DefaultRequestHeaders
+                        .Accept
+                        .Add(new MediaTypeWithQualityHeaderValue(Constants.MediaTypeHalAndJson));
+
+            client.DefaultRequestHeaders.Add("v-c-merchant-id", signature.MerchantId);
+
+            client.DefaultRequestHeaders.Add("Date", signature.GmtDateTime);
+
+            client.DefaultRequestHeaders.Add("Host", signature.HostName);
+
+            client.DefaultRequestHeaders.Add("Signature", signature.SignatureParam);
+
+            return client;
+        }
+    }
+}

cybersource-rest-auth-netstandard/ApiSdk/ApiSdk/connection/IConnection.cs

@@ -0,0 +1,16 @@
+using System.Net.Http;
+using AuthenticationSdk.core;
+
+namespace ApiSdk.connection
+{
+    public interface IConnection
+    {
+        HttpClient GetConnectionForGet(MerchantConfig merchantConfig);
+
+        HttpClient GetConnectionForPost(MerchantConfig merchantConfig);
+
+        HttpClient GetConnectionForPut(MerchantConfig merchantConfig);
+
+        HttpClient GetConnectionForDelete(MerchantConfig merchantConfig);
+    }
+}

cybersource-rest-auth-netstandard/ApiSdk/ApiSdk/connection/JWTConnection.cs

@@ -0,0 +1,68 @@
+using System.Net.Http;
+using System.Net.Http.Headers;
+using ApiSdk.util;
+using AuthenticationSdk.core;
+
+namespace ApiSdk.connection
+{
+    public class JWTConnection : IConnection
+    {
+        public HttpClient GetConnectionForGet(MerchantConfig merchantConfig)
+        {
+            var token = AuthenticationHelper.GetToken(merchantConfig);
+            var httpConnUtility = new HttpConnUtility(merchantConfig.ProxyAddress, merchantConfig.ProxyPort, merchantConfig.TimeOut);
+            var client = httpConnUtility.GetHttpClient();
+
+            client.DefaultRequestHeaders
+                .Accept
+                .Add(new MediaTypeWithQualityHeaderValue(Constants.MediaTypeHalAndJson));
+
+            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(Constants.Bearer, token.BearerToken);
+
+            return client;
+        }
+
+        public HttpClient GetConnectionForPost(MerchantConfig merchantConfig)
+        {
+            var token = AuthenticationHelper.GetToken(merchantConfig);
+            var httpConnUtility = new HttpConnUtility(merchantConfig.ProxyAddress, merchantConfig.ProxyPort, merchantConfig.TimeOut);
+            var client = httpConnUtility.GetHttpClient();
+
+            var content = new StringContent(merchantConfig.RequestJsonData);
+            content.Headers.ContentType = new MediaTypeHeaderValue(Constants.MediaTypeJson);
+
+            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(Constants.Bearer, token.BearerToken);
+
+            return client;
+        }
+
+        public HttpClient GetConnectionForPut(MerchantConfig merchantConfig)
+        {
+            var token = AuthenticationHelper.GetToken(merchantConfig);
+            var httpConnUtility = new HttpConnUtility(merchantConfig.ProxyAddress, merchantConfig.ProxyPort, merchantConfig.TimeOut);
+            var client = httpConnUtility.GetHttpClient();
+
+            var content = new StringContent(merchantConfig.RequestJsonData);
+            content.Headers.ContentType = new MediaTypeHeaderValue(Constants.MediaTypeJson);
+
+            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(Constants.Bearer, token.BearerToken);
+
+            return client;
+        }
+
+        public HttpClient GetConnectionForDelete(MerchantConfig merchantConfig)
+        {
+            var token = AuthenticationHelper.GetToken(merchantConfig);
+            var httpConnUtility = new HttpConnUtility(merchantConfig.ProxyAddress, merchantConfig.ProxyPort, merchantConfig.TimeOut);
+            var client = httpConnUtility.GetHttpClient();
+
+            client.DefaultRequestHeaders
+                .Accept
+                .Add(new MediaTypeWithQualityHeaderValue(Constants.MediaTypeHalAndJson));
+
+            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(Constants.Bearer, token.BearerToken);
+
+            return client;
+        }
+    }
+}

cybersource-rest-auth-netstandard/ApiSdk/ApiSdk/controller/APIController.cs

@@ -0,0 +1,118 @@
+using System;
+using ApiSdk.model;
+using ApiSdk.service;
+using AuthenticationSdk.core;
+using AuthenticationSdk.util;
+using NLog;
+
+namespace ApiSdk.controller
+{
+    /*================================================================================
+    * Provides Methods to Make HTTP Requests (GET/POST/PUT/DELETE) to CYBS REST API's
+    *===============================================================================*/
+    public class APIController
+    {
+        private readonly Logger _logger;
+        private readonly PaymentRequestService _paymentRequestService;
+
+        public APIController(MerchantConfig merchantConfig)
+        {
+            _logger = LogManager.GetCurrentClassLogger();
+            Enumerations.ValidateRequestType(merchantConfig.RequestType);
+            Enumerations.SetRequestType(merchantConfig);
+            _paymentRequestService = new PaymentRequestService(merchantConfig);
+        }
+
+        /**
+         * @return a Response object (HTTP Response) for the HTTP GET Request
+         * based on the Merchant Configuration passed to the Constructor of ApiController Class
+         */
+        public Response GetPayment()
+        {
+            try
+            {
+                // Call the Service to Get the Response Object
+                var response = _paymentRequestService.GetResponse();
+                LogResponseDetails(response);
+
+                return response;
+            }
+            catch (Exception e)
+            {
+                ExceptionUtility.Exception(e.Message, e.StackTrace);
+                return null;
+            }
+        }
+
+        /**
+         * @return a Response object (HTTP Response) for the HTTP POST Request
+         * based on the Merchant Configuration passed to the Constructor of ApiController Class
+         */
+        public Response PostPayment()
+        {
+            try
+            {
+                // Call the Service to Get the Response Object
+                var response = _paymentRequestService.PostResponse();
+                LogResponseDetails(response);
+
+                return response;
+            }
+            catch (Exception e)
+            {
+                ExceptionUtility.Exception(e.Message, e.StackTrace);
+                return null;
+            }
+        }
+
+        /**
+         * @return a Response object (HTTP Response) for the HTTP PUT Request
+         * based on the Merchant Configuration passed to the Constructor of ApiController Class
+         */
+        public Response PutPayment()
+        {
+            try
+            {
+                // Call the Service to Get the Response Object
+                var response = _paymentRequestService.PutResponse();
+                LogResponseDetails(response);
+
+                return response;
+            }
+            catch (Exception e)
+            {
+                ExceptionUtility.Exception(e.Message, e.StackTrace);
+                return null;
+            }
+        }
+
+        /**
+         * @return a Response object (HTTP Response) for the HTTP DELETE Request
+         * based on the Merchant Configuration passed to the Constructor of ApiController Class
+         */
+        public Response DeletePayment()
+        {
+            try
+            {
+                // Call the Service to Get the Response Object
+                var response = _paymentRequestService.DeleteResponse();
+                LogResponseDetails(response);
+
+                return response;
+            }
+            catch (Exception e)
+            {
+                ExceptionUtility.Exception(e.Message, e.StackTrace);
+                return null;
+            }
+        }
+
+        private void LogResponseDetails(Response response)
+        {
+            _logger.Info("v-c-correlation-id:{0}", response.GetResponseHeaderValue(response.Headers, "v-c-correlation-id"));
+            _logger.Info("Response Code:{0}", response.StatusCode);
+            _logger.Info("Response Message:{0}", response.Data);
+            _logger.Info("Status Information:{0}", response.StatusInfo);
+        }
+    }
+}