├── SpGatewayHelper
    ├── packages.config
    ├── Properties
    │   └── AssemblyInfo.cs
    ├── Helper
    │   ├── MyHelper.cs
    │   └── CryptoHelper.cs
    ├── SpGatewayResponse.cs
    ├── Models
    │   ├── TradeInfoModel.cs
    │   └── TradeInfo.cs
    └── SpGatewayHelper.csproj
├── SpGatewayHelperTests
    ├── packages.config
    ├── Properties
    │   └── AssemblyInfo.cs
    ├── Helper
    │   ├── MyHelperTests.cs
    │   └── CryptoHelperTests.cs
    ├── SpGatewayResponseTests.cs
    └── SpGatewayHelperTests.csproj
├── spgatewayTest.sln
├── README.md
├── .gitignore
└── LICENSE


/SpGatewayHelper/packages.config:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <packages>
3 |   <package id="Newtonsoft.Json" version="10.0.2" targetFramework="net46" />
4 | </packages>


--------------------------------------------------------------------------------
/SpGatewayHelperTests/packages.config:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <packages>
3 |   <package id="FluentAssertions" version="4.19.2" targetFramework="net46" />
4 |   <package id="MSTest.TestAdapter" version="1.1.18" targetFramework="net46" />
5 |   <package id="MSTest.TestFramework" version="1.1.18" targetFramework="net46" />
6 | </packages>


--------------------------------------------------------------------------------
/SpGatewayHelper/Properties/AssemblyInfo.cs:
--------------------------------------------------------------------------------
 1 | using System.Reflection;
 2 | using System.Runtime.CompilerServices;
 3 | using System.Runtime.InteropServices;
 4 | 
 5 | // 組件的一般資訊是由下列的屬性集控制。
 6 | // 變更這些屬性的值即可修改組件的相關
 7 | // 資訊。
 8 | [assembly: AssemblyTitle("SpGatewayHelper")]
 9 | [assembly: AssemblyDescription("")]
10 | [assembly: AssemblyConfiguration("")]
11 | [assembly: AssemblyCompany("")]
12 | [assembly: AssemblyProduct("SpGatewayHelper")]
13 | [assembly: AssemblyCopyright("Copyright ©  2017")]
14 | [assembly: AssemblyTrademark("")]
15 | [assembly: AssemblyCulture("")]
16 | 
17 | // 將 ComVisible 設為 false 可對 COM 元件隱藏
18 | // 組件中的類型。若必須從 COM 存取此組件中的類型，
19 | // 的類型，請在該類型上將 ComVisible 屬性設定為 true。
20 | [assembly: ComVisible(false)]
21 | 
22 | // 下列 GUID 為專案公開 (Expose) 至 COM 時所要使用的 typelib ID
23 | [assembly: Guid("da4a63a4-105d-40a4-9f4a-4cf81fac0db9")]
24 | 
25 | // 組件的版本資訊由下列四個值所組成: 
26 | //
27 | //      主要版本
28 | //      次要版本
29 | //      組建編號
30 | //      修訂編號
31 | //
32 | // 您可以指定所有的值，或將組建編號或修訂編號設為預設值
33 | //方法是使用 '*'，如下所示:
34 | // [assembly: AssemblyVersion("1.0.*")]
35 | [assembly: AssemblyVersion("1.0.0.0")]
36 | [assembly: AssemblyFileVersion("1.0.0.0")]
37 | 


--------------------------------------------------------------------------------
/SpGatewayHelperTests/Properties/AssemblyInfo.cs:
--------------------------------------------------------------------------------
 1 | using System.Reflection;
 2 | using System.Runtime.CompilerServices;
 3 | using System.Runtime.InteropServices;
 4 | 
 5 | // 組件的一般資訊是由下列的屬性集控制。
 6 | // 變更這些屬性的值即可修改組件的相關
 7 | // 資訊。
 8 | [assembly: AssemblyTitle("SpGatewayHelperTests")]
 9 | [assembly: AssemblyDescription("")]
10 | [assembly: AssemblyConfiguration("")]
11 | [assembly: AssemblyCompany("")]
12 | [assembly: AssemblyProduct("SpGatewayHelperTests")]
13 | [assembly: AssemblyCopyright("Copyright ©  2017")]
14 | [assembly: AssemblyTrademark("")]
15 | [assembly: AssemblyCulture("")]
16 | 
17 | // 將 ComVisible 設定為 false 會使得這個組件中的類型 
18 | // 對 COM 元件而言為不可見。如果您需要從 COM 存取這個組件中 
19 | // 的類型，請在該類型上將 ComVisible 屬性設定為 true。
20 | [assembly: ComVisible(false)]
21 | 
22 | // 下列 GUID 為專案公開 (Expose) 至 COM 時所要使用的 typelib ID
23 | [assembly: Guid("a37f4dc6-c959-4f55-a621-c4396e0611fe")]
24 | 
25 | // 組件的版本資訊由下列四個值所組成: 
26 | //
27 | //      主要版本
28 | //      次要版本 
29 | //      組建編號
30 | //      修訂編號
31 | //
32 | // 您可以指定所有的值，也可以依照以下的方式，使用 '*' 將組建和修訂編號 
33 | // 指定為預設值: 
34 | // [assembly: AssemblyVersion("1.0.*")]
35 | [assembly: AssemblyVersion("1.0.0.0")]
36 | [assembly: AssemblyFileVersion("1.0.0.0")]
37 | 


--------------------------------------------------------------------------------
/SpGatewayHelper/Helper/MyHelper.cs:
--------------------------------------------------------------------------------
 1 | using System;
 2 | using System.Collections.Generic;
 3 | using System.Linq;
 4 | using System.Reflection;
 5 | using System.Web;
 6 | using SpGatewayHelper.Models;
 7 | 
 8 | namespace SpGatewayHelper.Helper
 9 | {
10 |     public static class MyHelper
11 |     {
12 |         /// <summary>
13 |         /// To the unix time stamp.
14 |         /// </summary>
15 |         /// <param name="x">The x.</param>
16 |         /// <returns></returns>
17 |         public static string ToUnixTimeStamp(this DateTime x)
18 |         {
19 |             return ((int)x.Subtract(new DateTime(1970, 1, 1)).TotalSeconds).ToString();
20 |         }
21 | 
22 |         /// <summary>
23 |         /// To the dictionary.
24 |         /// </summary>
25 |         /// <param name="obj">The object.</param>
26 |         /// <returns></returns>
27 |         public static Dictionary<string, object> ToDictionary(this TradeInfo obj)
28 |         {
29 |             return obj.GetType()
30 |                 .GetProperties(BindingFlags.Instance | BindingFlags.Public)
31 |                 .Select(d => new {Name = d.Name, Value = d.GetValue(obj, null)})
32 |                 .Where(d => d.Value != null && string.IsNullOrWhiteSpace(d.Value.ToString()) == false)
33 |                 .ToDictionary(d => d.Name, d => d.Value);
34 |         }
35 |     }
36 | }


--------------------------------------------------------------------------------
/SpGatewayHelper/SpGatewayResponse.cs:
--------------------------------------------------------------------------------
 1 | using System;
 2 | using System.Collections.Generic;
 3 | using System.Linq;
 4 | using System.Web;
 5 | using Newtonsoft.Json;
 6 | using SpGatewayHelper.Helper;
 7 | 
 8 | namespace SpGatewayHelper
 9 | {
10 |     public class SpGatewayResponse
11 |     {
12 |         public string Status { get; set; }
13 |         public string MerchantId { get; set; }
14 |         public string TradeInfo { get; set; }
15 |         public string TradeSha { get; set; }
16 |         public string Version { get; set; }
17 |         public string Key { get; set; }
18 |         public string Vi { get; set; }
19 |         /// <summary>
20 |         /// 驗證資料正確性
21 |         /// </summary>
22 |         /// <param name="merchantId">The merchant identifier.</param>
23 |         /// <returns></returns>
24 |         public bool Validate(string merchantId)
25 |         {
26 |             if (merchantId != MerchantId)
27 |             {
28 |                 return false;
29 |             }
30 |             var cryptoHelper = new CryptoHelper(Key, Vi);
31 |             var sha = cryptoHelper.GetSha256String(TradeInfo);
32 |             return sha == TradeSha;
33 |         }
34 | 
35 |         /// <summary>
36 |         /// Gets the response model.
37 |         /// </summary>
38 |         /// <typeparam name="T"></typeparam>
39 |         /// <returns></returns>
40 |         public T GetResponseModel<T>()
41 |         {
42 |             var cryptoHelper = new CryptoHelper(Key, Vi);
43 |             var jsonString = cryptoHelper.DecryptAesString(TradeInfo);
44 |             return JsonConvert.DeserializeObject<T>(jsonString);
45 |         }
46 | 
47 |     }
48 | }


--------------------------------------------------------------------------------
/SpGatewayHelper/Models/TradeInfoModel.cs:
--------------------------------------------------------------------------------
 1 | using System;
 2 | using System.Collections.Generic;
 3 | using System.Linq;
 4 | using System.Text;
 5 | using System.Threading.Tasks;
 6 | 
 7 | namespace SpGatewayHelper.Models
 8 | {
 9 | 
10 |     public class TradeInfoModel
11 |     {
12 |         public string Status { get; set; }
13 |         public string Message { get; set; }
14 |         public Result Result { get; set; }
15 |     }
16 | 
17 |     public class Result
18 |     {
19 |         public string MerchantID { get; set; }
20 |         public int Amt { get; set; }
21 |         public string TradeNo { get; set; }
22 |         public string MerchantOrderNo { get; set; }
23 |         public string RespondType { get; set; }
24 |         public string IP { get; set; }
25 |         public string EscrowBank { get; set; }
26 |         public string PaymentType { get; set; }
27 |         public string PayTime { get; set; }
28 |         public string PayerAccount5Code { get; set; }
29 |         public string PayBankCode { get; set; }
30 |         public string RespondCode { get; set; }
31 |         public string Auth { get; set; }
32 |         public string Card6No { get; set; }
33 |         public string Card4No { get; set; }
34 |         public int Inst { get; set; }
35 |         public int RedAmt { get; set; }
36 |         public string CodeNo { get; set; }
37 |         public string Barcode_1 { get; set; }
38 |         public string Barcode_2 { get; set; }
39 |         public string Barcode_3 { get; set; }
40 |         public string PayStore { get; set; }
41 |         public string ExpireDate { get; set; }
42 |         public string ExpireTime { get; set; }
43 |         public string BankCode { get; set; }
44 | 
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/spgatewayTest.sln:
--------------------------------------------------------------------------------
 1 | 
 2 | Microsoft Visual Studio Solution File, Format Version 12.00
 3 | # Visual Studio 15
 4 | VisualStudioVersion = 15.0.26430.6
 5 | MinimumVisualStudioVersion = 10.0.40219.1
 6 | Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SpGatewayHelper", "SpGatewayHelper\SpGatewayHelper.csproj", "{DA4A63A4-105D-40A4-9F4A-4CF81FAC0DB9}"
 7 | EndProject
 8 | Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SpGatewayHelperTests", "SpGatewayHelperTests\SpGatewayHelperTests.csproj", "{A37F4DC6-C959-4F55-A621-C4396E0611FE}"
 9 | EndProject
10 | Global
11 | 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
12 | 		Debug|Any CPU = Debug|Any CPU
13 | 		Release|Any CPU = Release|Any CPU
14 | 	EndGlobalSection
15 | 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
16 | 		{DA4A63A4-105D-40A4-9F4A-4CF81FAC0DB9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
17 | 		{DA4A63A4-105D-40A4-9F4A-4CF81FAC0DB9}.Debug|Any CPU.Build.0 = Debug|Any CPU
18 | 		{DA4A63A4-105D-40A4-9F4A-4CF81FAC0DB9}.Release|Any CPU.ActiveCfg = Release|Any CPU
19 | 		{DA4A63A4-105D-40A4-9F4A-4CF81FAC0DB9}.Release|Any CPU.Build.0 = Release|Any CPU
20 | 		{A37F4DC6-C959-4F55-A621-C4396E0611FE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
21 | 		{A37F4DC6-C959-4F55-A621-C4396E0611FE}.Debug|Any CPU.Build.0 = Debug|Any CPU
22 | 		{A37F4DC6-C959-4F55-A621-C4396E0611FE}.Release|Any CPU.ActiveCfg = Release|Any CPU
23 | 		{A37F4DC6-C959-4F55-A621-C4396E0611FE}.Release|Any CPU.Build.0 = Release|Any CPU
24 | 	EndGlobalSection
25 | 	GlobalSection(SolutionProperties) = preSolution
26 | 		HideSolutionNode = FALSE
27 | 	EndGlobalSection
28 | 	GlobalSection(CodealikeProperties) = postSolution
29 | 		SolutionGuid = 3b3336f6-b0f1-4ba7-8680-885f42a3f90b
30 | 	EndGlobalSection
31 | EndGlobal
32 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # SPGateway
 2 | 台灣第三方金流服務智付通API串接小幫手
 3 | 
 4 | * 智付通第三方金流網址：[https://www.spgateway.com](https://www.spgateway.com)
 5 | * 智付通 API 位置：[https://web.spgateway.com/api/download_api](https://web.spgateway.com/api/download_api)
 6 |  
 7 | 此小幫手只處理 智付通 交易所需的 AES 加解密與 雜湊(SHA)字串檢查
 8 | 
 9 | 
10 | ```cs
11 | public class HomeController : Controller
12 | {
13 |     private readonly string _key;
14 |     private readonly string _Vi;
15 | 
16 |     public HomeController()
17 |     {
18 |         _key = "xbEznJ0PExvWzd5ct72dLPCMPIBUw8K3";
19 |         _Vi = "kpDI8DxNb2JKgOXK";
20 |     }
21 | 
22 |     public ActionResult Index()
23 |     {
24 |         var tradeInfo = new TradeInfo()
25 |         {
26 |             MerchantID = "MS12345678",
27 |             RespondType = "JSON",
28 |             TimeStamp = DateTime.Now.ToUnixTimeStamp(),
29 |             Version = "1.4",
30 |             Amt = 100,
31 |             ItemDesc = "TTEESSTT",
32 |             //InstFlag="3,6",
33 |             //CreditRed = 0,
34 |             Email = "demo@demo.demo",
35 |             EmailModify = 0,
36 |             LoginType = 0,
37 |             MerchantOrderNo = DateTime.Now.Ticks.ToString(),
38 |             TradeLimit = 180,
39 |             //CVS=1,
40 |             //ExpireDate=DateTime.Now.ToString("yyyyMMdd"),
41 |             ReturnURL = "http://localhost:51639/home/index",
42 |         };
43 |         var postData = tradeInfo.ToDictionary();
44 |         var cryptoHelper = new CryptoHelper(_key, _Vi);
45 |         var aesString = cryptoHelper.GetAesString(postData);
46 |         ViewData["TradeInfo"] = aesString;
47 |         ViewData["TradeSha"] = cryptoHelper.GetSha256String(aesString);
48 |         return PartialView();
49 |     }
50 | 
51 |     [HttpPost]
52 |     public ActionResult Index(SpGatewayResponse response)
53 |     {
54 |         response.Key = _key;
55 |         response.Vi = _Vi;
56 |         var success = response.Validate("MS12345678");
57 |         if (success)
58 |         {
59 |             var tradInfoModel=response.GetResponseModel<TradeInfoModel>();
60 |         }
61 |         return View();
62 |     }
63 | }
64 | ```
65 | 
66 | 


--------------------------------------------------------------------------------
/SpGatewayHelperTests/Helper/MyHelperTests.cs:
--------------------------------------------------------------------------------
 1 | using Microsoft.VisualStudio.TestTools.UnitTesting;
 2 | using SpGatewayHelper.Helper;
 3 | using System;
 4 | using System.Collections.Generic;
 5 | using System.Linq;
 6 | using System.Text;
 7 | using System.Threading.Tasks;
 8 | using SpGatewayHelper.Models;
 9 | 
10 | namespace SpGatewayHelper.Helper.Tests
11 | {
12 |     [TestClass()]
13 |     public class MyHelperTests
14 |     {
15 |         [TestMethod()]
16 |         public void ToTimeStampTest()
17 |         {
18 |             var testDateTime = new DateTime(2014, 5, 15, 15, 0, 0);
19 |             //-8 是以 UTC 來算
20 |             var actual = testDateTime.AddHours(-8).ToUnixTimeStamp();
21 | 
22 |             var expected = "1400137200";
23 |             Assert.AreEqual(expected, actual);
24 |         }
25 | 
26 |         [TestMethod()]
27 |         public void ToDictionaryTest()
28 |         {
29 |             var unitTime = DateTime.Now.ToUnixTimeStamp();
30 |             var target = new TradeInfo()
31 |             {
32 |                 MerchantID = "MS111",
33 |                 RespondType = "JSON",
34 |                 TimeStamp = unitTime,
35 |                 Version = "1.4",
36 |                 Amt = 900,
37 |                 ItemDesc = "TTEESSTT",
38 |                 ClientBackURL = "",
39 |                 CREDIT = 1,
40 |                 CreditRed = 1,
41 |                 CustomerURL = "",
42 |                 Email = "demo@demoshop.tw",
43 |                 EmailModify = 1,
44 |                 LoginType = 0,
45 |                 MerchantOrderNo = "9487",
46 |                 NotifyURL = "",
47 |                 ReturnURL = "",
48 |                 TradeLimit = 180
49 |             };
50 |             var actual = string.Join("", target.ToDictionary().OrderBy(d => d.Key).Select(d => d.Key + d.Value));
51 | 
52 |             var expectedDictionary = new Dictionary<string, object>
53 |             {
54 |                 {"MerchantID", "MS111"},
55 |                 {"RespondType", "JSON"},
56 |                 {"TimeStamp", unitTime},
57 |                 {"Version", "1.4"},
58 |                 {"Amt", 900},
59 |                 {"ItemDesc", "TTEESSTT"},
60 |                 {"CREDIT", 1},
61 |                 {"CreditRed", 1},
62 |                 {"Email", "demo@demoshop.tw"},
63 |                 {"EmailModify", 1},
64 |                 {"LoginType", 0},
65 |                 {"MerchantOrderNo", "9487"},
66 |                 {"TradeLimit", 180},
67 |             };
68 |             var expected = string.Join("", expectedDictionary.OrderBy(d => d.Key).Select(d => d.Key + d.Value));
69 |             Assert.AreEqual(expected, actual);
70 |         }
71 |     }
72 | }


--------------------------------------------------------------------------------
/SpGatewayHelper/SpGatewayHelper.csproj:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
 3 |   <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
 4 |   <PropertyGroup>
 5 |     <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
 6 |     <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
 7 |     <ProjectGuid>{DA4A63A4-105D-40A4-9F4A-4CF81FAC0DB9}</ProjectGuid>
 8 |     <OutputType>Library</OutputType>
 9 |     <AppDesignerFolder>Properties</AppDesignerFolder>
10 |     <RootNamespace>SpGatewayHelper</RootNamespace>
11 |     <AssemblyName>SpGatewayHelper</AssemblyName>
12 |     <TargetFrameworkVersion>v4.6</TargetFrameworkVersion>
13 |     <FileAlignment>512</FileAlignment>
14 |   </PropertyGroup>
15 |   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
16 |     <DebugSymbols>true</DebugSymbols>
17 |     <DebugType>full</DebugType>
18 |     <Optimize>false</Optimize>
19 |     <OutputPath>bin\Debug\</OutputPath>
20 |     <DefineConstants>DEBUG;TRACE</DefineConstants>
21 |     <ErrorReport>prompt</ErrorReport>
22 |     <WarningLevel>4</WarningLevel>
23 |   </PropertyGroup>
24 |   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
25 |     <DebugType>pdbonly</DebugType>
26 |     <Optimize>true</Optimize>
27 |     <OutputPath>bin\Release\</OutputPath>
28 |     <DefineConstants>TRACE</DefineConstants>
29 |     <ErrorReport>prompt</ErrorReport>
30 |     <WarningLevel>4</WarningLevel>
31 |   </PropertyGroup>
32 |   <ItemGroup>
33 |     <Reference Include="Newtonsoft.Json, Version=10.0.0.0, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed, processorArchitecture=MSIL">
34 |       <HintPath>..\packages\Newtonsoft.Json.10.0.2\lib\net45\Newtonsoft.Json.dll</HintPath>
35 |     </Reference>
36 |     <Reference Include="System" />
37 |     <Reference Include="System.Core" />
38 |     <Reference Include="System.Xml.Linq" />
39 |     <Reference Include="System.Data.DataSetExtensions" />
40 |     <Reference Include="Microsoft.CSharp" />
41 |     <Reference Include="System.Data" />
42 |     <Reference Include="System.Net.Http" />
43 |     <Reference Include="System.Xml" />
44 |   </ItemGroup>
45 |   <ItemGroup>
46 |     <Compile Include="Helper\CryptoHelper.cs" />
47 |     <Compile Include="Helper\MyHelper.cs" />
48 |     <Compile Include="Models\TradeInfoModel.cs" />
49 |     <Compile Include="SpGatewayResponse.cs" />
50 |     <Compile Include="Models\TradeInfo.cs" />
51 |     <Compile Include="Properties\AssemblyInfo.cs" />
52 |   </ItemGroup>
53 |   <ItemGroup>
54 |     <None Include="packages.config" />
55 |   </ItemGroup>
56 |   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
57 | </Project>


--------------------------------------------------------------------------------
/SpGatewayHelperTests/Helper/CryptoHelperTests.cs:
--------------------------------------------------------------------------------
 1 | using Microsoft.VisualStudio.TestTools.UnitTesting;
 2 | using SpGatewayHelper.Helper;
 3 | using System;
 4 | using System.Collections.Generic;
 5 | using System.Linq;
 6 | using System.Text;
 7 | using System.Threading.Tasks;
 8 | 
 9 | namespace SpGatewayHelper.Helper.Tests
10 | {
11 |     [TestClass()]
12 |     public class CryptoHelperTests
13 |     {
14 |         private const string Key = "12345678901234567890123456789012";
15 |         private const string Vi = "1234567890123456";
16 | 
17 |         [TestMethod()]
18 |         public void GetAesStringTest()
19 |         {
20 |             var target = new CryptoHelper(Key, Vi);
21 | 
22 |             var postData = new Dictionary<string, object>
23 |             {
24 |                 { "MerchantID", "3430112" },
25 |                 { "RespondType", "JSON" },
26 |                 { "TimeStamp", "1485232229" },
27 |                 { "Version", "1.4" },
28 |                 { "MerchantOrderNo", "S_1485232229" },
29 |                 { "Amt", "40" },
30 |                 { "ItemDesc", "UnitTest" }
31 |             };
32 | 
33 |             var actual = target.GetAesString(postData);
34 | 
35 |             var expected =
36 |                 "ff91c8aa01379e4de621a44e5f11f72e4d25bdb1a18242db6cef9ef07d80b0165e476fd1d9acaa53170272c82d122961e1a0700a7427cfa1cf90db7f6d6593bbc93102a4d4b9b66d9974c13c31a7ab4bba1d4e0790f0cbbbd7ad64c6d3c8012a601ceaa808bff70f94a8efa5a4f984b9d41304ffd879612177c622f75f4214fa";
37 |             Assert.AreEqual(expected, actual);
38 |         }
39 |         [TestMethod()]
40 |         public void GetSha256StringTest()
41 |         {
42 |             var target = new CryptoHelper(Key, Vi);
43 |             var aesString = "ff91c8aa01379e4de621a44e5f11f72e4d25bdb1a18242db6cef9ef07d80b0165e476fd1d9acaa53170272c82d122961e1a0700a7427cfa1cf90db7f6d6593bbc93102a4d4b9b66d9974c13c31a7ab4bba1d4e0790f0cbbbd7ad64c6d3c8012a601ceaa808bff70f94a8efa5a4f984b9d41304ffd879612177c622f75f4214fa";
44 | 
45 |             var actual = target.GetSha256String(aesString);
46 | 
47 |             var expected = "EA0A6CC37F40C1EA5692E7CBB8AE097653DF3E91365E6A9CD7E91312413C7BB8";
48 | 
49 |             Assert.AreEqual(expected, actual);
50 | 
51 |         }
52 | 
53 |         [TestMethod()]
54 |         [ExpectedException(typeof(NullReferenceException), "Key or Iv is required")]
55 |         public void CryptoHelperTest()
56 |         {
57 |             new CryptoHelper(null, null);
58 |         }
59 | 
60 |         [TestMethod()]
61 |         public void DecryptAesStringTest()
62 |         {
63 |             var aesString =
64 |                 "ff91c8aa01379e4de621a44e5f11f72e4d25bdb1a18242db6cef9ef07d80b0165e476fd1d9acaa53170272c82d122961e1a0700a7427cfa1cf90db7f6d6593bbc93102a4d4b9b66d9974c13c31a7ab4bba1d4e0790f0cbbbd7ad64c6d3c8012a601ceaa808bff70f94a8efa5a4f984b9d41304ffd879612177c622f75f4214fa";
65 |             var target = new CryptoHelper(Key, Vi);
66 |             var actual = target.DecryptAesString(aesString);
67 |             var expected = "MerchantID=3430112&RespondType=JSON&TimeStamp=1485232229&Version=1.4&MerchantOrderNo=S_1485232229&Amt=40&ItemDesc=UnitTest";
68 |             Assert.AreEqual(expected, actual);
69 | 
70 |         }
71 |     }
72 | }


--------------------------------------------------------------------------------
/SpGatewayHelperTests/SpGatewayResponseTests.cs:
--------------------------------------------------------------------------------
 1 | using Microsoft.VisualStudio.TestTools.UnitTesting;
 2 | using System;
 3 | using System.Collections.Generic;
 4 | using System.Linq;
 5 | using System.Text;
 6 | using System.Threading.Tasks;
 7 | using FluentAssertions;
 8 | using SpGatewayHelper;
 9 | using SpGatewayHelper.Models;
10 | 
11 | namespace SpGatewayHelperTests
12 | {
13 |     [TestClass()]
14 |     public class SpGatewayResponseTests
15 |     {
16 |         [TestMethod()]
17 |         public void ValidateTest()
18 |         {
19 |             var target = new SpGatewayResponse()
20 |             {
21 |                 MerchantId = "AAA",
22 |                 Status = "SUCCESS",
23 |                 Version = "1.4",
24 |                 TradeInfo = "ff91c8aa01379e4de621a44e5f11f72e4d25bdb1a18242db6cef9ef07d80b0165e476fd1d9acaa53170272c82d122961e1a0700a7427cfa1cf90db7f6d6593bbc93102a4d4b9b66d9974c13c31a7ab4bba1d4e0790f0cbbbd7ad64c6d3c8012a601ceaa808bff70f94a8efa5a4f984b9d41304ffd879612177c622f75f4214fa",
25 |                 TradeSha = "EA0A6CC37F40C1EA5692E7CBB8AE097653DF3E91365E6A9CD7E91312413C7BB8",
26 |                 Key = "12345678901234567890123456789012",
27 |                 Vi = "1234567890123456"
28 |             };
29 | 
30 |             Assert.AreEqual(false, target.Validate("asb"));
31 |             Assert.AreEqual(true, target.Validate("AAA"));
32 |         }
33 | 
34 |         [TestMethod()]
35 |         public void GetResponseModelTest()
36 |         {
37 |             var target = new SpGatewayResponse()
38 |             {
39 |                 MerchantId = "MS31756909",
40 |                 Status = "SUCCESS",
41 |                 Version = "1.4",
42 |                 TradeInfo = "9d9d94de7cdaa5c73ba288bb9fafac953691b4e72d865e4e098d7e96eded1122d4accc05946ccec051dd621b070cad3a7ff98656178bcfebbbd76b6fe11684476a0d4815c67195694106b33f6a922398047291f5775c2202553896d4b6abbdf5df5e0e86af72ae9b41329657b4e23dd9ec287464186928f30ee0fd859ed96c6982ccae7836102e97402699a2c780a08fa564a04bda3e7ca305efba44f535f0dbb4f54bea55fc56512a97910fd13712ea046d7c411ce2385fba959241899dbc60eeb4ebe54fe76a14087e3e979217ecfb111406b1c64c6f4a66186fab9eb0c4566909a128d6743e2bf560ce699eaa97a01b983be4b09dc706e69927d271443a3d3bb23789991893043c5c929d6f2586d82f920eb7c6075efa4d3019b13daca3f456448b4d8da93d6243962a062c70c603dea5c1ef60df97b3185302a83bc512bf43462321eeae92f064b2d33c8d2c434e3fbc83b3cad22f6b48f2b690395a0f08",
43 |                 TradeSha = "0F271B65D055B3264D6C6C00FD6FDCC6BC7F653F8DAC38399C158F54AB2375B6",
44 |                 Key = "xbEznJ0PExvWzd5ct72dLPCMPIBUw8K3",
45 |                 Vi = "kpDI8DxNb2JKgOXK"
46 |             };
47 |             var actual = target.GetResponseModel<TradeInfoModel>();
48 | 
49 |             var expected = new TradeInfoModel
50 |             {
51 |                 Status = "SUCCESS",
52 |                 Message = "\u4ed8\u6b3e\u6210\u529f",
53 |                 Result = new Result
54 |                 {
55 |                     MerchantID = "MS31756909",
56 |                     Amt = 900,
57 |                     TradeNo = "17060802213088297",
58 |                     MerchantOrderNo = "636324851460397211",
59 |                     RespondType = "JSON",
60 |                     IP = "180.217.182.136",
61 |                     EscrowBank = "Esun",
62 |                     PaymentType = "WEBATM",
63 |                     PayTime = "2017-06-08 02:21:30",
64 |                     PayerAccount5Code = "12345",
65 |                     PayBankCode = "808"
66 |                 }
67 |             };
68 |             expected.ShouldBeEquivalentTo(actual);
69 |         }
70 |     }
71 | }


--------------------------------------------------------------------------------
/SpGatewayHelper/Helper/CryptoHelper.cs:
--------------------------------------------------------------------------------
  1 | using System;
  2 | using System.Collections.Generic;
  3 | using System.IO;
  4 | using System.Linq;
  5 | using System.Security.Cryptography;
  6 | using System.Text;
  7 | using System.Text.RegularExpressions;
  8 | 
  9 | namespace SpGatewayHelper.Helper
 10 | {
 11 |     public class CryptoHelper
 12 |     {
 13 |         private string Key { get; }
 14 |         private string Iv { get; }
 15 | 
 16 |         public CryptoHelper(string key, string iv)
 17 |         {
 18 |             if (string.IsNullOrWhiteSpace(key) || string.IsNullOrWhiteSpace(iv))
 19 |             {
 20 |                 throw new NullReferenceException("Key or Iv is required");
 21 |             }
 22 |             Key = key;
 23 |             Iv = iv;
 24 |         }
 25 |         /// <summary>
 26 |         /// 將資料使用 AES 128 雜湊後傳回
 27 |         /// </summary>
 28 |         /// <param name="dataDictionary">The data dictionary.</param>
 29 |         /// <returns></returns>
 30 |         public string GetAesString(Dictionary<string, object> dataDictionary)
 31 |         {
 32 |             var aesCryptoServiceProvider = new AesCryptoServiceProvider
 33 |             {
 34 |                 Key = Encoding.ASCII.GetBytes(Key),
 35 |                 IV = Encoding.ASCII.GetBytes(Iv)
 36 |             };
 37 |             var source = string.Join("&", dataDictionary.Select(d => d.Key + "=" + d.Value));
 38 |             var dataByteArray = Encoding.UTF8.GetBytes(source);
 39 | 
 40 |             string encrypt;
 41 |             var sb = new StringBuilder();
 42 |             using (var ms = new MemoryStream())
 43 |             using (var cryptoStream = new CryptoStream(ms, aesCryptoServiceProvider.CreateEncryptor(), CryptoStreamMode.Write))
 44 |             {
 45 |                 cryptoStream.Write(dataByteArray, 0, dataByteArray.Length);
 46 |                 cryptoStream.FlushFinalBlock();
 47 |                 foreach (var d in ms.ToArray())
 48 |                 {
 49 |                     sb.AppendFormat("{0:x2}", d);
 50 |                 }
 51 |                 encrypt = sb.ToString();
 52 |             }
 53 |             return encrypt;
 54 |         }
 55 | 
 56 |         /// <summary>
 57 |         /// Decrypts the aes string.
 58 |         /// </summary>
 59 |         /// <param name="aesString">The aes string.</param>
 60 |         /// <returns></returns>
 61 |         public string DecryptAesString(string aesString)
 62 |         {
 63 |             var dataByteArray = Enumerable.Range(0, aesString.Length / 2)
 64 |                  .Select(d => Convert.ToByte(aesString.Substring(d * 2, 2), 16))
 65 |                  .ToArray();
 66 | 
 67 |             using (var aesAlg = Aes.Create())
 68 |             {
 69 |                 aesAlg.Key = Encoding.UTF8.GetBytes(Key);
 70 |                 aesAlg.IV = Encoding.UTF8.GetBytes(Iv);
 71 |                 aesAlg.FeedbackSize = 128;
 72 |                 aesAlg.Mode = CipherMode.CBC;
 73 |                 aesAlg.Padding = PaddingMode.None;
 74 | 
 75 |                 var decryptor = aesAlg.CreateDecryptor(aesAlg.Key, aesAlg.IV);
 76 |                 using (var msDecrypt = new MemoryStream(dataByteArray))
 77 |                 using (var csDecrypt = new CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read))
 78 |                 using (var srDecrypt = new StreamReader(csDecrypt, Encoding.ASCII))
 79 |                 {
 80 |                     return Regex.Replace(srDecrypt.ReadToEnd(), "[^\x0d\x0a\x20-\x7e\t]", "");
 81 |                 }
 82 |             }
 83 |         }
 84 | 
 85 |         /// <summary>
 86 |         /// 取得 Sha256 字串
 87 |         /// </summary>
 88 |         /// <param name="aesString">The aes string.</param>
 89 |         /// <returns></returns>
 90 |         public string GetSha256String(string aesString)
 91 |         {
 92 |             var source = $"HashKey={Key}&{aesString}&HashIV={Iv}";
 93 |             var bytes = Encoding.UTF8.GetBytes(source);
 94 |             var hashstring = new SHA256Managed();
 95 |             var hash = hashstring.ComputeHash(bytes);
 96 |             var sb = new StringBuilder();
 97 |             foreach (var d in hash)
 98 |             {
 99 |                 sb.AppendFormat("{0:X2}", d);
100 |             }
101 |             return sb.ToString();
102 |         }
103 |     }
104 | }


--------------------------------------------------------------------------------
/SpGatewayHelper/Models/TradeInfo.cs:
--------------------------------------------------------------------------------
  1 | using System;
  2 | using System.Collections.Generic;
  3 | using System.Linq;
  4 | using System.Web;
  5 | 
  6 | namespace SpGatewayHelper.Models
  7 | {
  8 |     public class TradeInfo
  9 |     {
 10 |         /// <summary>
 11 |         /// 商店代號 
 12 |         /// </summary>
 13 |         /// <value>
 14 |         /// The merchant identifier.
 15 |         /// </value>
 16 |         public string MerchantID { get; set; }
 17 |         /// <summary>
 18 |         /// 回傳格式 
 19 |         /// <para>JSON 或是 String</para>
 20 |         /// </summary>
 21 |         /// <value>
 22 |         /// The type of the respond.
 23 |         /// </value>
 24 |         public string RespondType { get; set; }
 25 |         /// <summary>
 26 |         /// TimeStamp
 27 |         /// <para>自從 Unix 纪元（格林威治時間 1970 年 1 月 1 日 00:00:00）到當前時間的秒數。</para>
 28 |         /// </summary>
 29 |         /// <value>
 30 |         /// The time stamp.
 31 |         /// </value>
 32 |         public string TimeStamp { get; set; }
 33 |         /// <summary>
 34 |         /// 串接程式版本 
 35 |         /// </summary>
 36 |         /// <value>
 37 |         /// The version.
 38 |         /// </value>
 39 |         public string Version { get; set; }
 40 |         /// <summary>
 41 |         /// 商店訂單編號 
 42 |         /// <para>限英、數字、_ 格式</para>
 43 |         /// </summary>
 44 |         /// <value>
 45 |         /// The merchant order no.
 46 |         /// </value>
 47 |         public string MerchantOrderNo { get; set; }
 48 |         /// <summary>
 49 |         /// 訂單金額 
 50 |         /// </summary>
 51 |         /// <value>
 52 |         /// The amt.
 53 |         /// </value>
 54 |         public int Amt { get; set; }
 55 |         /// <summary>
 56 |         /// 商店備註 
 57 |         /// </summary>
 58 |         /// <value>
 59 |         /// The order comment.
 60 |         /// </value>
 61 |         public string OrderComment { get; set; }
 62 |         /// <summary>
 63 |         /// 商品資訊 
 64 |         /// </summary>
 65 |         /// <value>
 66 |         /// The item desc.
 67 |         /// </value>
 68 |         public string ItemDesc { get; set; }
 69 |         /// <summary>
 70 |         /// 交易限制秒數 
 71 |         /// </summary>
 72 |         /// <value>
 73 |         /// The trade limit.
 74 |         /// </value>
 75 |         public int TradeLimit { get; set; }
 76 |         /// <summary>
 77 |         /// 支付完成 返回商店網址 
 78 |         /// </summary>
 79 |         /// <value>
 80 |         /// The return URL.
 81 |         /// </value>
 82 |         public string ReturnURL { get; set; }
 83 |         /// <summary>
 84 |         /// 支付通知網址 
 85 |         /// </summary>
 86 |         /// <value>
 87 |         /// The notify URL.
 88 |         /// </value>
 89 |         public string NotifyURL { get; set; }
 90 |         /// <summary>
 91 |         /// 商店取號網址 
 92 |         /// </summary>
 93 |         /// <value>
 94 |         /// The customer URL.
 95 |         /// </value>
 96 |         public string CustomerURL { get; set; }
 97 |         /// <summary>
 98 |         /// 支付取消 返回商店網址 
 99 |         /// </summary>
100 |         /// <value>
101 |         /// The client back URL.
102 |         /// </value>
103 |         public string ClientBackURL { get; set; }
104 |         /// <summary>
105 |         /// 付款人電子信箱 
106 |         /// </summary>
107 |         /// <value>
108 |         /// The email.
109 |         /// </value>
110 |         public string Email { get; set; }
111 |         /// <summary>
112 |         /// 付款人電子信箱 是否開放修改 
113 |         /// <para>1=可修改 0=不可修改 </para>
114 |         /// </summary>
115 |         /// <value>
116 |         /// The email modify.
117 |         /// </value>
118 |         public int EmailModify { get; set; }
119 |         /// <summary>
120 |         /// 智付通會員 
121 |         /// <para>0=不須登入智付通會員</para>
122 |         /// <para>1=須要登入智付通會員</para>
123 |         /// </summary>
124 |         /// <value>
125 |         /// The type of the login.
126 |         /// </value>
127 |         public int LoginType { get; set; }
128 |         /// <summary>
129 |         /// ATM 轉帳啟用
130 |         /// </summary>
131 |         /// <value>
132 |         /// The webatm.
133 |         /// </value>
134 |         public int? VACC { get; set; }
135 |         /// <summary>
136 |         /// 超商條碼繳費啟用 
137 |         /// </summary>
138 |         /// <value>
139 |         /// The webatm.
140 |         /// </value>
141 |         public int? BARCODE { get; set; }
142 |         /// <summary>
143 |         /// 超商代碼繳費 啟用
144 |         /// </summary>
145 |         /// <value>
146 |         /// The webatm.
147 |         /// </value>
148 |         public int? CVS { get; set; }
149 |         /// <summary>
150 |         /// 繳費有效期限 
151 |         /// <para>格式為 date('Ymd') ，例：20140620</para> 
152 |         /// </summary>
153 |         /// <value>
154 |         /// The credit red.
155 |         /// </value>
156 |         public string ExpireDate { get; set; }
157 |         /// <summary>
158 |         /// 信用卡 一次付清啟用 
159 |         /// </summary>
160 |         /// <value>
161 |         /// The credit.
162 |         /// </value>
163 |         public int? CREDIT { get; set; }
164 |         /// <summary>
165 |         /// 信用卡 紅利啟用 
166 |         /// <para>1=啟用</para> 
167 |         /// </summary>
168 |         /// <value>
169 |         /// The credit red.
170 |         /// </value>
171 |         public int? CreditRed { get; set; }
172 |         /// <summary>
173 |         /// 信用卡 分期付款啟用 
174 |         /// <para>3=分3期功能</para>
175 |         /// <para>6=分6期功能</para>
176 |         /// <para>12=分12期功能</para>  
177 |         /// <para>18=分18期功能</para>  
178 |         /// <para>24=分24期功能</para>   
179 |         /// <para>30=分30期功能</para> 
180 |         /// </summary>
181 |         /// <value>
182 |         /// 
183 |         /// </value>
184 |         public string InstFlag { get; set; }
185 |        
186 | 
187 |     }
188 | }


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
  1 | ## Ignore Visual Studio temporary files, build results, and
  2 | ## files generated by popular Visual Studio add-ons.
  3 | ##
  4 | ## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
  5 | 
  6 | # User-specific files
  7 | *.suo
  8 | *.user
  9 | *.userosscache
 10 | *.sln.docstates
 11 | 
 12 | # User-specific files (MonoDevelop/Xamarin Studio)
 13 | *.userprefs
 14 | 
 15 | # Build results
 16 | [Dd]ebug/
 17 | [Dd]ebugPublic/
 18 | [Rr]elease/
 19 | [Rr]eleases/
 20 | x64/
 21 | x86/
 22 | bld/
 23 | [Bb]in/
 24 | [Oo]bj/
 25 | [Ll]og/
 26 | 
 27 | # Visual Studio 2015 cache/options directory
 28 | .vs/
 29 | # Uncomment if you have tasks that create the project's static files in wwwroot
 30 | #wwwroot/
 31 | 
 32 | # MSTest test Results
 33 | [Tt]est[Rr]esult*/
 34 | [Bb]uild[Ll]og.*
 35 | 
 36 | # NUNIT
 37 | *.VisualState.xml
 38 | TestResult.xml
 39 | 
 40 | # Build Results of an ATL Project
 41 | [Dd]ebugPS/
 42 | [Rr]eleasePS/
 43 | dlldata.c
 44 | 
 45 | # .NET Core
 46 | project.lock.json
 47 | project.fragment.lock.json
 48 | artifacts/
 49 | **/Properties/launchSettings.json
 50 | 
 51 | *_i.c
 52 | *_p.c
 53 | *_i.h
 54 | *.ilk
 55 | *.meta
 56 | *.obj
 57 | *.pch
 58 | *.pdb
 59 | *.pgc
 60 | *.pgd
 61 | *.rsp
 62 | *.sbr
 63 | *.tlb
 64 | *.tli
 65 | *.tlh
 66 | *.tmp
 67 | *.tmp_proj
 68 | *.log
 69 | *.vspscc
 70 | *.vssscc
 71 | .builds
 72 | *.pidb
 73 | *.svclog
 74 | *.scc
 75 | 
 76 | # Chutzpah Test files
 77 | _Chutzpah*
 78 | 
 79 | # Visual C++ cache files
 80 | ipch/
 81 | *.aps
 82 | *.ncb
 83 | *.opendb
 84 | *.opensdf
 85 | *.sdf
 86 | *.cachefile
 87 | *.VC.db
 88 | *.VC.VC.opendb
 89 | 
 90 | # Visual Studio profiler
 91 | *.psess
 92 | *.vsp
 93 | *.vspx
 94 | *.sap
 95 | 
 96 | # TFS 2012 Local Workspace
 97 | $tf/
 98 | 
 99 | # Guidance Automation Toolkit
100 | *.gpState
101 | 
102 | # ReSharper is a .NET coding add-in
103 | _ReSharper*/
104 | *.[Rr]e[Ss]harper
105 | *.DotSettings.user
106 | 
107 | # JustCode is a .NET coding add-in
108 | .JustCode
109 | 
110 | # TeamCity is a build add-in
111 | _TeamCity*
112 | 
113 | # DotCover is a Code Coverage Tool
114 | *.dotCover
115 | 
116 | # Visual Studio code coverage results
117 | *.coverage
118 | *.coveragexml
119 | 
120 | # NCrunch
121 | _NCrunch_*
122 | .*crunch*.local.xml
123 | nCrunchTemp_*
124 | 
125 | # MightyMoose
126 | *.mm.*
127 | AutoTest.Net/
128 | 
129 | # Web workbench (sass)
130 | .sass-cache/
131 | 
132 | # Installshield output folder
133 | [Ee]xpress/
134 | 
135 | # DocProject is a documentation generator add-in
136 | DocProject/buildhelp/
137 | DocProject/Help/*.HxT
138 | DocProject/Help/*.HxC
139 | DocProject/Help/*.hhc
140 | DocProject/Help/*.hhk
141 | DocProject/Help/*.hhp
142 | DocProject/Help/Html2
143 | DocProject/Help/html
144 | 
145 | # Click-Once directory
146 | publish/
147 | 
148 | # Publish Web Output
149 | *.[Pp]ublish.xml
150 | *.azurePubxml
151 | # TODO: Comment the next line if you want to checkin your web deploy settings
152 | # but database connection strings (with potential passwords) will be unencrypted
153 | *.pubxml
154 | *.publishproj
155 | 
156 | # Microsoft Azure Web App publish settings. Comment the next line if you want to
157 | # checkin your Azure Web App publish settings, but sensitive information contained
158 | # in these scripts will be unencrypted
159 | PublishScripts/
160 | 
161 | # NuGet Packages
162 | *.nupkg
163 | # The packages folder can be ignored because of Package Restore
164 | **/packages/*
165 | # except build/, which is used as an MSBuild target.
166 | !**/packages/build/
167 | # Uncomment if necessary however generally it will be regenerated when needed
168 | #!**/packages/repositories.config
169 | # NuGet v3's project.json files produces more ignorable files
170 | *.nuget.props
171 | *.nuget.targets
172 | 
173 | # Microsoft Azure Build Output
174 | csx/
175 | *.build.csdef
176 | 
177 | # Microsoft Azure Emulator
178 | ecf/
179 | rcf/
180 | 
181 | # Windows Store app package directories and files
182 | AppPackages/
183 | BundleArtifacts/
184 | Package.StoreAssociation.xml
185 | _pkginfo.txt
186 | 
187 | # Visual Studio cache files
188 | # files ending in .cache can be ignored
189 | *.[Cc]ache
190 | # but keep track of directories ending in .cache
191 | !*.[Cc]ache/
192 | 
193 | # Others
194 | ClientBin/
195 | ~$*
196 | *~
197 | *.dbmdl
198 | *.dbproj.schemaview
199 | *.jfm
200 | *.pfx
201 | *.publishsettings
202 | orleans.codegen.cs
203 | 
204 | # Since there are multiple workflows, uncomment next line to ignore bower_components
205 | # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
206 | #bower_components/
207 | 
208 | # RIA/Silverlight projects
209 | Generated_Code/
210 | 
211 | # Backup & report files from converting an old project file
212 | # to a newer Visual Studio version. Backup files are not needed,
213 | # because we have git ;-)
214 | _UpgradeReport_Files/
215 | Backup*/
216 | UpgradeLog*.XML
217 | UpgradeLog*.htm
218 | 
219 | # SQL Server files
220 | *.mdf
221 | *.ldf
222 | *.ndf
223 | 
224 | # Business Intelligence projects
225 | *.rdl.data
226 | *.bim.layout
227 | *.bim_*.settings
228 | 
229 | # Microsoft Fakes
230 | FakesAssemblies/
231 | 
232 | # GhostDoc plugin setting file
233 | *.GhostDoc.xml
234 | 
235 | # Node.js Tools for Visual Studio
236 | .ntvs_analysis.dat
237 | node_modules/
238 | 
239 | # Typescript v1 declaration files
240 | typings/
241 | 
242 | # Visual Studio 6 build log
243 | *.plg
244 | 
245 | # Visual Studio 6 workspace options file
246 | *.opt
247 | 
248 | # Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
249 | *.vbw
250 | 
251 | # Visual Studio LightSwitch build output
252 | **/*.HTMLClient/GeneratedArtifacts
253 | **/*.DesktopClient/GeneratedArtifacts
254 | **/*.DesktopClient/ModelManifest.xml
255 | **/*.Server/GeneratedArtifacts
256 | **/*.Server/ModelManifest.xml
257 | _Pvt_Extensions
258 | 
259 | # Paket dependency manager
260 | .paket/paket.exe
261 | paket-files/
262 | 
263 | # FAKE - F# Make
264 | .fake/
265 | 
266 | # JetBrains Rider
267 | .idea/
268 | *.sln.iml
269 | 
270 | # CodeRush
271 | .cr/
272 | 
273 | # Python Tools for Visual Studio (PTVS)
274 | __pycache__/
275 | *.pyc
276 | 
277 | # Cake - Uncomment if you are using it
278 | # tools/**
279 | # !tools/packages.config
280 | 
281 | # Telerik's JustMock configuration file
282 | *.jmconfig
283 | 
284 | # BizTalk build output
285 | *.btp.cs
286 | *.btm.cs
287 | *.odx.cs
288 | *.xsd.cs
289 | 


--------------------------------------------------------------------------------
/SpGatewayHelperTests/SpGatewayHelperTests.csproj:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="utf-8"?>
  2 | <Project ToolsVersion="15.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  3 |   <Import Project="..\packages\MSTest.TestAdapter.1.1.18\build\net45\MSTest.TestAdapter.props" Condition="Exists('..\packages\MSTest.TestAdapter.1.1.18\build\net45\MSTest.TestAdapter.props')" />
  4 |   <PropertyGroup>
  5 |     <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
  6 |     <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
  7 |     <ProjectGuid>{A37F4DC6-C959-4F55-A621-C4396E0611FE}</ProjectGuid>
  8 |     <OutputType>Library</OutputType>
  9 |     <AppDesignerFolder>Properties</AppDesignerFolder>
 10 |     <RootNamespace>SpGatewayHelperTests</RootNamespace>
 11 |     <AssemblyName>SpGatewayHelperTests</AssemblyName>
 12 |     <TargetFrameworkVersion>v4.6</TargetFrameworkVersion>
 13 |     <FileAlignment>512</FileAlignment>
 14 |     <ProjectTypeGuids>{3AC096D0-A1C2-E12C-1390-A8335801FDAB};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}</ProjectTypeGuids>
 15 |     <VisualStudioVersion Condition="'$(VisualStudioVersion)' == ''">10.0</VisualStudioVersion>
 16 |     <VSToolsPath Condition="'$(VSToolsPath)' == ''">$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)</VSToolsPath>
 17 |     <ReferencePath>$(ProgramFiles)\Common Files\microsoft shared\VSTT\$(VisualStudioVersion)\UITestExtensionPackages</ReferencePath>
 18 |     <IsCodedUITest>False</IsCodedUITest>
 19 |     <TestProjectType>UnitTest</TestProjectType>
 20 |     <TargetFrameworkProfile />
 21 |     <NuGetPackageImportStamp>
 22 |     </NuGetPackageImportStamp>
 23 |   </PropertyGroup>
 24 |   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
 25 |     <DebugSymbols>true</DebugSymbols>
 26 |     <DebugType>full</DebugType>
 27 |     <Optimize>false</Optimize>
 28 |     <OutputPath>bin\Debug\</OutputPath>
 29 |     <DefineConstants>DEBUG;TRACE</DefineConstants>
 30 |     <ErrorReport>prompt</ErrorReport>
 31 |     <WarningLevel>4</WarningLevel>
 32 |   </PropertyGroup>
 33 |   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
 34 |     <DebugType>pdbonly</DebugType>
 35 |     <Optimize>true</Optimize>
 36 |     <OutputPath>bin\Release\</OutputPath>
 37 |     <DefineConstants>TRACE</DefineConstants>
 38 |     <ErrorReport>prompt</ErrorReport>
 39 |     <WarningLevel>4</WarningLevel>
 40 |   </PropertyGroup>
 41 |   <ItemGroup>
 42 |     <Reference Include="FluentAssertions, Version=4.19.2.0, Culture=neutral, PublicKeyToken=33f2691a05b67b6a, processorArchitecture=MSIL">
 43 |       <HintPath>..\packages\FluentAssertions.4.19.2\lib\net45\FluentAssertions.dll</HintPath>
 44 |     </Reference>
 45 |     <Reference Include="FluentAssertions.Core, Version=4.19.2.0, Culture=neutral, PublicKeyToken=33f2691a05b67b6a, processorArchitecture=MSIL">
 46 |       <HintPath>..\packages\FluentAssertions.4.19.2\lib\net45\FluentAssertions.Core.dll</HintPath>
 47 |     </Reference>
 48 |     <Reference Include="Microsoft.VisualStudio.TestPlatform.TestFramework, Version=14.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
 49 |       <HintPath>..\packages\MSTest.TestFramework.1.1.18\lib\net45\Microsoft.VisualStudio.TestPlatform.TestFramework.dll</HintPath>
 50 |     </Reference>
 51 |     <Reference Include="Microsoft.VisualStudio.TestPlatform.TestFramework.Extensions, Version=14.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
 52 |       <HintPath>..\packages\MSTest.TestFramework.1.1.18\lib\net45\Microsoft.VisualStudio.TestPlatform.TestFramework.Extensions.dll</HintPath>
 53 |     </Reference>
 54 |     <Reference Include="System" />
 55 |     <Reference Include="System.Xml" />
 56 |     <Reference Include="System.Xml.Linq" />
 57 |   </ItemGroup>
 58 |   <Choose>
 59 |     <When Condition="('$(VisualStudioVersion)' == '10.0' or '$(VisualStudioVersion)' == '') and '$(TargetFrameworkVersion)' == 'v3.5'">
 60 |       <ItemGroup>
 61 |         <Reference Include="Microsoft.VisualStudio.QualityTools.UnitTestFramework, Version=10.1.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL" />
 62 |       </ItemGroup>
 63 |     </When>
 64 |     <Otherwise />
 65 |   </Choose>
 66 |   <ItemGroup>
 67 |     <Compile Include="Helper\CryptoHelperTests.cs" />
 68 |     <Compile Include="Helper\MyHelperTests.cs" />
 69 |     <Compile Include="Properties\AssemblyInfo.cs" />
 70 |     <Compile Include="SpGatewayResponseTests.cs" />
 71 |   </ItemGroup>
 72 |   <ItemGroup>
 73 |     <None Include="packages.config" />
 74 |   </ItemGroup>
 75 |   <ItemGroup>
 76 |     <ProjectReference Include="..\SpGatewayHelper\SpGatewayHelper.csproj">
 77 |       <Project>{DA4A63A4-105D-40A4-9F4A-4CF81FAC0DB9}</Project>
 78 |       <Name>SpGatewayHelper</Name>
 79 |     </ProjectReference>
 80 |   </ItemGroup>
 81 |   <Choose>
 82 |     <When Condition="'$(VisualStudioVersion)' == '10.0' And '$(IsCodedUITest)' == 'True'">
 83 |       <ItemGroup>
 84 |         <Reference Include="Microsoft.VisualStudio.QualityTools.CodedUITestFramework, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
 85 |           <Private>False</Private>
 86 |         </Reference>
 87 |         <Reference Include="Microsoft.VisualStudio.TestTools.UITest.Common, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
 88 |           <Private>False</Private>
 89 |         </Reference>
 90 |         <Reference Include="Microsoft.VisualStudio.TestTools.UITest.Extension, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
 91 |           <Private>False</Private>
 92 |         </Reference>
 93 |         <Reference Include="Microsoft.VisualStudio.TestTools.UITesting, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
 94 |           <Private>False</Private>
 95 |         </Reference>
 96 |       </ItemGroup>
 97 |     </When>
 98 |   </Choose>
 99 |   <Import Project="$(VSToolsPath)\TeamTest\Microsoft.TestTools.targets" Condition="Exists('$(VSToolsPath)\TeamTest\Microsoft.TestTools.targets')" />
100 |   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
101 |   <Target Name="EnsureNuGetPackageBuildImports" BeforeTargets="PrepareForBuild">
102 |     <PropertyGroup>
103 |       <ErrorText>此專案參考這部電腦上所缺少的 NuGet 封裝。請啟用 NuGet 封裝還原，以下載該封裝。如需詳細資訊，請參閱 http://go.microsoft.com/fwlink/?LinkID=322105。缺少的檔案是 {0}。</ErrorText>
104 |     </PropertyGroup>
105 |     <Error Condition="!Exists('..\packages\MSTest.TestAdapter.1.1.18\build\net45\MSTest.TestAdapter.props')" Text="$([System.String]::Format('$(ErrorText)', '..\packages\MSTest.TestAdapter.1.1.18\build\net45\MSTest.TestAdapter.props'))" />
106 |     <Error Condition="!Exists('..\packages\MSTest.TestAdapter.1.1.18\build\net45\MSTest.TestAdapter.targets')" Text="$([System.String]::Format('$(ErrorText)', '..\packages\MSTest.TestAdapter.1.1.18\build\net45\MSTest.TestAdapter.targets'))" />
107 |   </Target>
108 |   <Import Project="..\packages\MSTest.TestAdapter.1.1.18\build\net45\MSTest.TestAdapter.targets" Condition="Exists('..\packages\MSTest.TestAdapter.1.1.18\build\net45\MSTest.TestAdapter.targets')" />
109 |   <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
110 |        Other similar extension points exist, see Microsoft.Common.targets.
111 |   <Target Name="BeforeBuild">
112 |   </Target>
113 |   <Target Name="AfterBuild">
114 |   </Target>
115 |   -->
116 | </Project>


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                     GNU GENERAL PUBLIC LICENSE
  2 |                        Version 3, 29 June 2007
  3 | 
  4 |  Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
  5 |  Everyone is permitted to copy and distribute verbatim copies
  6 |  of this license document, but changing it is not allowed.
  7 | 
  8 |                             Preamble
  9 | 
 10 |   The GNU General Public License is a free, copyleft license for
 11 | software and other kinds of works.
 12 | 
 13 |   The licenses for most software and other practical works are designed
 14 | to take away your freedom to share and change the works.  By contrast,
 15 | the GNU General Public License is intended to guarantee your freedom to
 16 | share and change all versions of a program--to make sure it remains free
 17 | software for all its users.  We, the Free Software Foundation, use the
 18 | GNU General Public License for most of our software; it applies also to
 19 | any other work released this way by its authors.  You can apply it to
 20 | your programs, too.
 21 | 
 22 |   When we speak of free software, we are referring to freedom, not
 23 | price.  Our General Public Licenses are designed to make sure that you
 24 | have the freedom to distribute copies of free software (and charge for
 25 | them if you wish), that you receive source code or can get it if you
 26 | want it, that you can change the software or use pieces of it in new
 27 | free programs, and that you know you can do these things.
 28 | 
 29 |   To protect your rights, we need to prevent others from denying you
 30 | these rights or asking you to surrender the rights.  Therefore, you have
 31 | certain responsibilities if you distribute copies of the software, or if
 32 | you modify it: responsibilities to respect the freedom of others.
 33 | 
 34 |   For example, if you distribute copies of such a program, whether
 35 | gratis or for a fee, you must pass on to the recipients the same
 36 | freedoms that you received.  You must make sure that they, too, receive
 37 | or can get the source code.  And you must show them these terms so they
 38 | know their rights.
 39 | 
 40 |   Developers that use the GNU GPL protect your rights with two steps:
 41 | (1) assert copyright on the software, and (2) offer you this License
 42 | giving you legal permission to copy, distribute and/or modify it.
 43 | 
 44 |   For the developers' and authors' protection, the GPL clearly explains
 45 | that there is no warranty for this free software.  For both users' and
 46 | authors' sake, the GPL requires that modified versions be marked as
 47 | changed, so that their problems will not be attributed erroneously to
 48 | authors of previous versions.
 49 | 
 50 |   Some devices are designed to deny users access to install or run
 51 | modified versions of the software inside them, although the manufacturer
 52 | can do so.  This is fundamentally incompatible with the aim of
 53 | protecting users' freedom to change the software.  The systematic
 54 | pattern of such abuse occurs in the area of products for individuals to
 55 | use, which is precisely where it is most unacceptable.  Therefore, we
 56 | have designed this version of the GPL to prohibit the practice for those
 57 | products.  If such problems arise substantially in other domains, we
 58 | stand ready to extend this provision to those domains in future versions
 59 | of the GPL, as needed to protect the freedom of users.
 60 | 
 61 |   Finally, every program is threatened constantly by software patents.
 62 | States should not allow patents to restrict development and use of
 63 | software on general-purpose computers, but in those that do, we wish to
 64 | avoid the special danger that patents applied to a free program could
 65 | make it effectively proprietary.  To prevent this, the GPL assures that
 66 | patents cannot be used to render the program non-free.
 67 | 
 68 |   The precise terms and conditions for copying, distribution and
 69 | modification follow.
 70 | 
 71 |                        TERMS AND CONDITIONS
 72 | 
 73 |   0. Definitions.
 74 | 
 75 |   "This License" refers to version 3 of the GNU General Public License.
 76 | 
 77 |   "Copyright" also means copyright-like laws that apply to other kinds of
 78 | works, such as semiconductor masks.
 79 | 
 80 |   "The Program" refers to any copyrightable work licensed under this
 81 | License.  Each licensee is addressed as "you".  "Licensees" and
 82 | "recipients" may be individuals or organizations.
 83 | 
 84 |   To "modify" a work means to copy from or adapt all or part of the work
 85 | in a fashion requiring copyright permission, other than the making of an
 86 | exact copy.  The resulting work is called a "modified version" of the
 87 | earlier work or a work "based on" the earlier work.
 88 | 
 89 |   A "covered work" means either the unmodified Program or a work based
 90 | on the Program.
 91 | 
 92 |   To "propagate" a work means to do anything with it that, without
 93 | permission, would make you directly or secondarily liable for
 94 | infringement under applicable copyright law, except executing it on a
 95 | computer or modifying a private copy.  Propagation includes copying,
 96 | distribution (with or without modification), making available to the
 97 | public, and in some countries other activities as well.
 98 | 
 99 |   To "convey" a work means any kind of propagation that enables other
100 | parties to make or receive copies.  Mere interaction with a user through
101 | a computer network, with no transfer of a copy, is not conveying.
102 | 
103 |   An interactive user interface displays "Appropriate Legal Notices"
104 | to the extent that it includes a convenient and prominently visible
105 | feature that (1) displays an appropriate copyright notice, and (2)
106 | tells the user that there is no warranty for the work (except to the
107 | extent that warranties are provided), that licensees may convey the
108 | work under this License, and how to view a copy of this License.  If
109 | the interface presents a list of user commands or options, such as a
110 | menu, a prominent item in the list meets this criterion.
111 | 
112 |   1. Source Code.
113 | 
114 |   The "source code" for a work means the preferred form of the work
115 | for making modifications to it.  "Object code" means any non-source
116 | form of a work.
117 | 
118 |   A "Standard Interface" means an interface that either is an official
119 | standard defined by a recognized standards body, or, in the case of
120 | interfaces specified for a particular programming language, one that
121 | is widely used among developers working in that language.
122 | 
123 |   The "System Libraries" of an executable work include anything, other
124 | than the work as a whole, that (a) is included in the normal form of
125 | packaging a Major Component, but which is not part of that Major
126 | Component, and (b) serves only to enable use of the work with that
127 | Major Component, or to implement a Standard Interface for which an
128 | implementation is available to the public in source code form.  A
129 | "Major Component", in this context, means a major essential component
130 | (kernel, window system, and so on) of the specific operating system
131 | (if any) on which the executable work runs, or a compiler used to
132 | produce the work, or an object code interpreter used to run it.
133 | 
134 |   The "Corresponding Source" for a work in object code form means all
135 | the source code needed to generate, install, and (for an executable
136 | work) run the object code and to modify the work, including scripts to
137 | control those activities.  However, it does not include the work's
138 | System Libraries, or general-purpose tools or generally available free
139 | programs which are used unmodified in performing those activities but
140 | which are not part of the work.  For example, Corresponding Source
141 | includes interface definition files associated with source files for
142 | the work, and the source code for shared libraries and dynamically
143 | linked subprograms that the work is specifically designed to require,
144 | such as by intimate data communication or control flow between those
145 | subprograms and other parts of the work.
146 | 
147 |   The Corresponding Source need not include anything that users
148 | can regenerate automatically from other parts of the Corresponding
149 | Source.
150 | 
151 |   The Corresponding Source for a work in source code form is that
152 | same work.
153 | 
154 |   2. Basic Permissions.
155 | 
156 |   All rights granted under this License are granted for the term of
157 | copyright on the Program, and are irrevocable provided the stated
158 | conditions are met.  This License explicitly affirms your unlimited
159 | permission to run the unmodified Program.  The output from running a
160 | covered work is covered by this License only if the output, given its
161 | content, constitutes a covered work.  This License acknowledges your
162 | rights of fair use or other equivalent, as provided by copyright law.
163 | 
164 |   You may make, run and propagate covered works that you do not
165 | convey, without conditions so long as your license otherwise remains
166 | in force.  You may convey covered works to others for the sole purpose
167 | of having them make modifications exclusively for you, or provide you
168 | with facilities for running those works, provided that you comply with
169 | the terms of this License in conveying all material for which you do
170 | not control copyright.  Those thus making or running the covered works
171 | for you must do so exclusively on your behalf, under your direction
172 | and control, on terms that prohibit them from making any copies of
173 | your copyrighted material outside their relationship with you.
174 | 
175 |   Conveying under any other circumstances is permitted solely under
176 | the conditions stated below.  Sublicensing is not allowed; section 10
177 | makes it unnecessary.
178 | 
179 |   3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180 | 
181 |   No covered work shall be deemed part of an effective technological
182 | measure under any applicable law fulfilling obligations under article
183 | 11 of the WIPO copyright treaty adopted on 20 December 1996, or
184 | similar laws prohibiting or restricting circumvention of such
185 | measures.
186 | 
187 |   When you convey a covered work, you waive any legal power to forbid
188 | circumvention of technological measures to the extent such circumvention
189 | is effected by exercising rights under this License with respect to
190 | the covered work, and you disclaim any intention to limit operation or
191 | modification of the work as a means of enforcing, against the work's
192 | users, your or third parties' legal rights to forbid circumvention of
193 | technological measures.
194 | 
195 |   4. Conveying Verbatim Copies.
196 | 
197 |   You may convey verbatim copies of the Program's source code as you
198 | receive it, in any medium, provided that you conspicuously and
199 | appropriately publish on each copy an appropriate copyright notice;
200 | keep intact all notices stating that this License and any
201 | non-permissive terms added in accord with section 7 apply to the code;
202 | keep intact all notices of the absence of any warranty; and give all
203 | recipients a copy of this License along with the Program.
204 | 
205 |   You may charge any price or no price for each copy that you convey,
206 | and you may offer support or warranty protection for a fee.
207 | 
208 |   5. Conveying Modified Source Versions.
209 | 
210 |   You may convey a work based on the Program, or the modifications to
211 | produce it from the Program, in the form of source code under the
212 | terms of section 4, provided that you also meet all of these conditions:
213 | 
214 |     a) The work must carry prominent notices stating that you modified
215 |     it, and giving a relevant date.
216 | 
217 |     b) The work must carry prominent notices stating that it is
218 |     released under this License and any conditions added under section
219 |     7.  This requirement modifies the requirement in section 4 to
220 |     "keep intact all notices".
221 | 
222 |     c) You must license the entire work, as a whole, under this
223 |     License to anyone who comes into possession of a copy.  This
224 |     License will therefore apply, along with any applicable section 7
225 |     additional terms, to the whole of the work, and all its parts,
226 |     regardless of how they are packaged.  This License gives no
227 |     permission to license the work in any other way, but it does not
228 |     invalidate such permission if you have separately received it.
229 | 
230 |     d) If the work has interactive user interfaces, each must display
231 |     Appropriate Legal Notices; however, if the Program has interactive
232 |     interfaces that do not display Appropriate Legal Notices, your
233 |     work need not make them do so.
234 | 
235 |   A compilation of a covered work with other separate and independent
236 | works, which are not by their nature extensions of the covered work,
237 | and which are not combined with it such as to form a larger program,
238 | in or on a volume of a storage or distribution medium, is called an
239 | "aggregate" if the compilation and its resulting copyright are not
240 | used to limit the access or legal rights of the compilation's users
241 | beyond what the individual works permit.  Inclusion of a covered work
242 | in an aggregate does not cause this License to apply to the other
243 | parts of the aggregate.
244 | 
245 |   6. Conveying Non-Source Forms.
246 | 
247 |   You may convey a covered work in object code form under the terms
248 | of sections 4 and 5, provided that you also convey the
249 | machine-readable Corresponding Source under the terms of this License,
250 | in one of these ways:
251 | 
252 |     a) Convey the object code in, or embodied in, a physical product
253 |     (including a physical distribution medium), accompanied by the
254 |     Corresponding Source fixed on a durable physical medium
255 |     customarily used for software interchange.
256 | 
257 |     b) Convey the object code in, or embodied in, a physical product
258 |     (including a physical distribution medium), accompanied by a
259 |     written offer, valid for at least three years and valid for as
260 |     long as you offer spare parts or customer support for that product
261 |     model, to give anyone who possesses the object code either (1) a
262 |     copy of the Corresponding Source for all the software in the
263 |     product that is covered by this License, on a durable physical
264 |     medium customarily used for software interchange, for a price no
265 |     more than your reasonable cost of physically performing this
266 |     conveying of source, or (2) access to copy the
267 |     Corresponding Source from a network server at no charge.
268 | 
269 |     c) Convey individual copies of the object code with a copy of the
270 |     written offer to provide the Corresponding Source.  This
271 |     alternative is allowed only occasionally and noncommercially, and
272 |     only if you received the object code with such an offer, in accord
273 |     with subsection 6b.
274 | 
275 |     d) Convey the object code by offering access from a designated
276 |     place (gratis or for a charge), and offer equivalent access to the
277 |     Corresponding Source in the same way through the same place at no
278 |     further charge.  You need not require recipients to copy the
279 |     Corresponding Source along with the object code.  If the place to
280 |     copy the object code is a network server, the Corresponding Source
281 |     may be on a different server (operated by you or a third party)
282 |     that supports equivalent copying facilities, provided you maintain
283 |     clear directions next to the object code saying where to find the
284 |     Corresponding Source.  Regardless of what server hosts the
285 |     Corresponding Source, you remain obligated to ensure that it is
286 |     available for as long as needed to satisfy these requirements.
287 | 
288 |     e) Convey the object code using peer-to-peer transmission, provided
289 |     you inform other peers where the object code and Corresponding
290 |     Source of the work are being offered to the general public at no
291 |     charge under subsection 6d.
292 | 
293 |   A separable portion of the object code, whose source code is excluded
294 | from the Corresponding Source as a System Library, need not be
295 | included in conveying the object code work.
296 | 
297 |   A "User Product" is either (1) a "consumer product", which means any
298 | tangible personal property which is normally used for personal, family,
299 | or household purposes, or (2) anything designed or sold for incorporation
300 | into a dwelling.  In determining whether a product is a consumer product,
301 | doubtful cases shall be resolved in favor of coverage.  For a particular
302 | product received by a particular user, "normally used" refers to a
303 | typical or common use of that class of product, regardless of the status
304 | of the particular user or of the way in which the particular user
305 | actually uses, or expects or is expected to use, the product.  A product
306 | is a consumer product regardless of whether the product has substantial
307 | commercial, industrial or non-consumer uses, unless such uses represent
308 | the only significant mode of use of the product.
309 | 
310 |   "Installation Information" for a User Product means any methods,
311 | procedures, authorization keys, or other information required to install
312 | and execute modified versions of a covered work in that User Product from
313 | a modified version of its Corresponding Source.  The information must
314 | suffice to ensure that the continued functioning of the modified object
315 | code is in no case prevented or interfered with solely because
316 | modification has been made.
317 | 
318 |   If you convey an object code work under this section in, or with, or
319 | specifically for use in, a User Product, and the conveying occurs as
320 | part of a transaction in which the right of possession and use of the
321 | User Product is transferred to the recipient in perpetuity or for a
322 | fixed term (regardless of how the transaction is characterized), the
323 | Corresponding Source conveyed under this section must be accompanied
324 | by the Installation Information.  But this requirement does not apply
325 | if neither you nor any third party retains the ability to install
326 | modified object code on the User Product (for example, the work has
327 | been installed in ROM).
328 | 
329 |   The requirement to provide Installation Information does not include a
330 | requirement to continue to provide support service, warranty, or updates
331 | for a work that has been modified or installed by the recipient, or for
332 | the User Product in which it has been modified or installed.  Access to a
333 | network may be denied when the modification itself materially and
334 | adversely affects the operation of the network or violates the rules and
335 | protocols for communication across the network.
336 | 
337 |   Corresponding Source conveyed, and Installation Information provided,
338 | in accord with this section must be in a format that is publicly
339 | documented (and with an implementation available to the public in
340 | source code form), and must require no special password or key for
341 | unpacking, reading or copying.
342 | 
343 |   7. Additional Terms.
344 | 
345 |   "Additional permissions" are terms that supplement the terms of this
346 | License by making exceptions from one or more of its conditions.
347 | Additional permissions that are applicable to the entire Program shall
348 | be treated as though they were included in this License, to the extent
349 | that they are valid under applicable law.  If additional permissions
350 | apply only to part of the Program, that part may be used separately
351 | under those permissions, but the entire Program remains governed by
352 | this License without regard to the additional permissions.
353 | 
354 |   When you convey a copy of a covered work, you may at your option
355 | remove any additional permissions from that copy, or from any part of
356 | it.  (Additional permissions may be written to require their own
357 | removal in certain cases when you modify the work.)  You may place
358 | additional permissions on material, added by you to a covered work,
359 | for which you have or can give appropriate copyright permission.
360 | 
361 |   Notwithstanding any other provision of this License, for material you
362 | add to a covered work, you may (if authorized by the copyright holders of
363 | that material) supplement the terms of this License with terms:
364 | 
365 |     a) Disclaiming warranty or limiting liability differently from the
366 |     terms of sections 15 and 16 of this License; or
367 | 
368 |     b) Requiring preservation of specified reasonable legal notices or
369 |     author attributions in that material or in the Appropriate Legal
370 |     Notices displayed by works containing it; or
371 | 
372 |     c) Prohibiting misrepresentation of the origin of that material, or
373 |     requiring that modified versions of such material be marked in
374 |     reasonable ways as different from the original version; or
375 | 
376 |     d) Limiting the use for publicity purposes of names of licensors or
377 |     authors of the material; or
378 | 
379 |     e) Declining to grant rights under trademark law for use of some
380 |     trade names, trademarks, or service marks; or
381 | 
382 |     f) Requiring indemnification of licensors and authors of that
383 |     material by anyone who conveys the material (or modified versions of
384 |     it) with contractual assumptions of liability to the recipient, for
385 |     any liability that these contractual assumptions directly impose on
386 |     those licensors and authors.
387 | 
388 |   All other non-permissive additional terms are considered "further
389 | restrictions" within the meaning of section 10.  If the Program as you
390 | received it, or any part of it, contains a notice stating that it is
391 | governed by this License along with a term that is a further
392 | restriction, you may remove that term.  If a license document contains
393 | a further restriction but permits relicensing or conveying under this
394 | License, you may add to a covered work material governed by the terms
395 | of that license document, provided that the further restriction does
396 | not survive such relicensing or conveying.
397 | 
398 |   If you add terms to a covered work in accord with this section, you
399 | must place, in the relevant source files, a statement of the
400 | additional terms that apply to those files, or a notice indicating
401 | where to find the applicable terms.
402 | 
403 |   Additional terms, permissive or non-permissive, may be stated in the
404 | form of a separately written license, or stated as exceptions;
405 | the above requirements apply either way.
406 | 
407 |   8. Termination.
408 | 
409 |   You may not propagate or modify a covered work except as expressly
410 | provided under this License.  Any attempt otherwise to propagate or
411 | modify it is void, and will automatically terminate your rights under
412 | this License (including any patent licenses granted under the third
413 | paragraph of section 11).
414 | 
415 |   However, if you cease all violation of this License, then your
416 | license from a particular copyright holder is reinstated (a)
417 | provisionally, unless and until the copyright holder explicitly and
418 | finally terminates your license, and (b) permanently, if the copyright
419 | holder fails to notify you of the violation by some reasonable means
420 | prior to 60 days after the cessation.
421 | 
422 |   Moreover, your license from a particular copyright holder is
423 | reinstated permanently if the copyright holder notifies you of the
424 | violation by some reasonable means, this is the first time you have
425 | received notice of violation of this License (for any work) from that
426 | copyright holder, and you cure the violation prior to 30 days after
427 | your receipt of the notice.
428 | 
429 |   Termination of your rights under this section does not terminate the
430 | licenses of parties who have received copies or rights from you under
431 | this License.  If your rights have been terminated and not permanently
432 | reinstated, you do not qualify to receive new licenses for the same
433 | material under section 10.
434 | 
435 |   9. Acceptance Not Required for Having Copies.
436 | 
437 |   You are not required to accept this License in order to receive or
438 | run a copy of the Program.  Ancillary propagation of a covered work
439 | occurring solely as a consequence of using peer-to-peer transmission
440 | to receive a copy likewise does not require acceptance.  However,
441 | nothing other than this License grants you permission to propagate or
442 | modify any covered work.  These actions infringe copyright if you do
443 | not accept this License.  Therefore, by modifying or propagating a
444 | covered work, you indicate your acceptance of this License to do so.
445 | 
446 |   10. Automatic Licensing of Downstream Recipients.
447 | 
448 |   Each time you convey a covered work, the recipient automatically
449 | receives a license from the original licensors, to run, modify and
450 | propagate that work, subject to this License.  You are not responsible
451 | for enforcing compliance by third parties with this License.
452 | 
453 |   An "entity transaction" is a transaction transferring control of an
454 | organization, or substantially all assets of one, or subdividing an
455 | organization, or merging organizations.  If propagation of a covered
456 | work results from an entity transaction, each party to that
457 | transaction who receives a copy of the work also receives whatever
458 | licenses to the work the party's predecessor in interest had or could
459 | give under the previous paragraph, plus a right to possession of the
460 | Corresponding Source of the work from the predecessor in interest, if
461 | the predecessor has it or can get it with reasonable efforts.
462 | 
463 |   You may not impose any further restrictions on the exercise of the
464 | rights granted or affirmed under this License.  For example, you may
465 | not impose a license fee, royalty, or other charge for exercise of
466 | rights granted under this License, and you may not initiate litigation
467 | (including a cross-claim or counterclaim in a lawsuit) alleging that
468 | any patent claim is infringed by making, using, selling, offering for
469 | sale, or importing the Program or any portion of it.
470 | 
471 |   11. Patents.
472 | 
473 |   A "contributor" is a copyright holder who authorizes use under this
474 | License of the Program or a work on which the Program is based.  The
475 | work thus licensed is called the contributor's "contributor version".
476 | 
477 |   A contributor's "essential patent claims" are all patent claims
478 | owned or controlled by the contributor, whether already acquired or
479 | hereafter acquired, that would be infringed by some manner, permitted
480 | by this License, of making, using, or selling its contributor version,
481 | but do not include claims that would be infringed only as a
482 | consequence of further modification of the contributor version.  For
483 | purposes of this definition, "control" includes the right to grant
484 | patent sublicenses in a manner consistent with the requirements of
485 | this License.
486 | 
487 |   Each contributor grants you a non-exclusive, worldwide, royalty-free
488 | patent license under the contributor's essential patent claims, to
489 | make, use, sell, offer for sale, import and otherwise run, modify and
490 | propagate the contents of its contributor version.
491 | 
492 |   In the following three paragraphs, a "patent license" is any express
493 | agreement or commitment, however denominated, not to enforce a patent
494 | (such as an express permission to practice a patent or covenant not to
495 | sue for patent infringement).  To "grant" such a patent license to a
496 | party means to make such an agreement or commitment not to enforce a
497 | patent against the party.
498 | 
499 |   If you convey a covered work, knowingly relying on a patent license,
500 | and the Corresponding Source of the work is not available for anyone
501 | to copy, free of charge and under the terms of this License, through a
502 | publicly available network server or other readily accessible means,
503 | then you must either (1) cause the Corresponding Source to be so
504 | available, or (2) arrange to deprive yourself of the benefit of the
505 | patent license for this particular work, or (3) arrange, in a manner
506 | consistent with the requirements of this License, to extend the patent
507 | license to downstream recipients.  "Knowingly relying" means you have
508 | actual knowledge that, but for the patent license, your conveying the
509 | covered work in a country, or your recipient's use of the covered work
510 | in a country, would infringe one or more identifiable patents in that
511 | country that you have reason to believe are valid.
512 | 
513 |   If, pursuant to or in connection with a single transaction or
514 | arrangement, you convey, or propagate by procuring conveyance of, a
515 | covered work, and grant a patent license to some of the parties
516 | receiving the covered work authorizing them to use, propagate, modify
517 | or convey a specific copy of the covered work, then the patent license
518 | you grant is automatically extended to all recipients of the covered
519 | work and works based on it.
520 | 
521 |   A patent license is "discriminatory" if it does not include within
522 | the scope of its coverage, prohibits the exercise of, or is
523 | conditioned on the non-exercise of one or more of the rights that are
524 | specifically granted under this License.  You may not convey a covered
525 | work if you are a party to an arrangement with a third party that is
526 | in the business of distributing software, under which you make payment
527 | to the third party based on the extent of your activity of conveying
528 | the work, and under which the third party grants, to any of the
529 | parties who would receive the covered work from you, a discriminatory
530 | patent license (a) in connection with copies of the covered work
531 | conveyed by you (or copies made from those copies), or (b) primarily
532 | for and in connection with specific products or compilations that
533 | contain the covered work, unless you entered into that arrangement,
534 | or that patent license was granted, prior to 28 March 2007.
535 | 
536 |   Nothing in this License shall be construed as excluding or limiting
537 | any implied license or other defenses to infringement that may
538 | otherwise be available to you under applicable patent law.
539 | 
540 |   12. No Surrender of Others' Freedom.
541 | 
542 |   If conditions are imposed on you (whether by court order, agreement or
543 | otherwise) that contradict the conditions of this License, they do not
544 | excuse you from the conditions of this License.  If you cannot convey a
545 | covered work so as to satisfy simultaneously your obligations under this
546 | License and any other pertinent obligations, then as a consequence you may
547 | not convey it at all.  For example, if you agree to terms that obligate you
548 | to collect a royalty for further conveying from those to whom you convey
549 | the Program, the only way you could satisfy both those terms and this
550 | License would be to refrain entirely from conveying the Program.
551 | 
552 |   13. Use with the GNU Affero General Public License.
553 | 
554 |   Notwithstanding any other provision of this License, you have
555 | permission to link or combine any covered work with a work licensed
556 | under version 3 of the GNU Affero General Public License into a single
557 | combined work, and to convey the resulting work.  The terms of this
558 | License will continue to apply to the part which is the covered work,
559 | but the special requirements of the GNU Affero General Public License,
560 | section 13, concerning interaction through a network will apply to the
561 | combination as such.
562 | 
563 |   14. Revised Versions of this License.
564 | 
565 |   The Free Software Foundation may publish revised and/or new versions of
566 | the GNU General Public License from time to time.  Such new versions will
567 | be similar in spirit to the present version, but may differ in detail to
568 | address new problems or concerns.
569 | 
570 |   Each version is given a distinguishing version number.  If the
571 | Program specifies that a certain numbered version of the GNU General
572 | Public License "or any later version" applies to it, you have the
573 | option of following the terms and conditions either of that numbered
574 | version or of any later version published by the Free Software
575 | Foundation.  If the Program does not specify a version number of the
576 | GNU General Public License, you may choose any version ever published
577 | by the Free Software Foundation.
578 | 
579 |   If the Program specifies that a proxy can decide which future
580 | versions of the GNU General Public License can be used, that proxy's
581 | public statement of acceptance of a version permanently authorizes you
582 | to choose that version for the Program.
583 | 
584 |   Later license versions may give you additional or different
585 | permissions.  However, no additional obligations are imposed on any
586 | author or copyright holder as a result of your choosing to follow a
587 | later version.
588 | 
589 |   15. Disclaimer of Warranty.
590 | 
591 |   THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592 | APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593 | HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594 | OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595 | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596 | PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597 | IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598 | ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599 | 
600 |   16. Limitation of Liability.
601 | 
602 |   IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604 | THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605 | GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606 | USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607 | DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608 | PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609 | EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610 | SUCH DAMAGES.
611 | 
612 |   17. Interpretation of Sections 15 and 16.
613 | 
614 |   If the disclaimer of warranty and limitation of liability provided
615 | above cannot be given local legal effect according to their terms,
616 | reviewing courts shall apply local law that most closely approximates
617 | an absolute waiver of all civil liability in connection with the
618 | Program, unless a warranty or assumption of liability accompanies a
619 | copy of the Program in return for a fee.
620 | 
621 |                      END OF TERMS AND CONDITIONS
622 | 
623 |             How to Apply These Terms to Your New Programs
624 | 
625 |   If you develop a new program, and you want it to be of the greatest
626 | possible use to the public, the best way to achieve this is to make it
627 | free software which everyone can redistribute and change under these terms.
628 | 
629 |   To do so, attach the following notices to the program.  It is safest
630 | to attach them to the start of each source file to most effectively
631 | state the exclusion of warranty; and each file should have at least
632 | the "copyright" line and a pointer to where the full notice is found.
633 | 
634 |     {one line to give the program's name and a brief idea of what it does.}
635 |     Copyright (C) {year}  {name of author}
636 | 
637 |     This program is free software: you can redistribute it and/or modify
638 |     it under the terms of the GNU General Public License as published by
639 |     the Free Software Foundation, either version 3 of the License, or
640 |     (at your option) any later version.
641 | 
642 |     This program is distributed in the hope that it will be useful,
643 |     but WITHOUT ANY WARRANTY; without even the implied warranty of
644 |     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
645 |     GNU General Public License for more details.
646 | 
647 |     You should have received a copy of the GNU General Public License
648 |     along with this program.  If not, see <http://www.gnu.org/licenses/>.
649 | 
650 | Also add information on how to contact you by electronic and paper mail.
651 | 
652 |   If the program does terminal interaction, make it output a short
653 | notice like this when it starts in an interactive mode:
654 | 
655 |     {project}  Copyright (C) {year}  {fullname}
656 |     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657 |     This is free software, and you are welcome to redistribute it
658 |     under certain conditions; type `show c' for details.
659 | 
660 | The hypothetical commands `show w' and `show c' should show the appropriate
661 | parts of the General Public License.  Of course, your program's commands
662 | might be different; for a GUI interface, you would use an "about box".
663 | 
664 |   You should also get your employer (if you work as a programmer) or school,
665 | if any, to sign a "copyright disclaimer" for the program, if necessary.
666 | For more information on this, and how to apply and follow the GNU GPL, see
667 | <http://www.gnu.org/licenses/>.
668 | 
669 |   The GNU General Public License does not permit incorporating your program
670 | into proprietary programs.  If your program is a subroutine library, you
671 | may consider it more useful to permit linking proprietary applications with
672 | the library.  If this is what you want to do, use the GNU Lesser General
673 | Public License instead of this License.  But first, please read
674 | <http://www.gnu.org/philosophy/why-not-lgpl.html>.
675 | 


--------------------------------------------------------------------------------