Repository: dnauck/Portable.Licensing Branch: develop Commit: 6ec8ce3b20d0 Files: 71 Total size: 182.3 KB Directory structure: gitextract_zc1asx_w/ ├── .gitignore ├── .paket/ │ └── paket.targets ├── .travis.yml ├── Icons/ │ └── Portable.Licensing.icns ├── LICENSE.md ├── Portable.Licensing.nuspec ├── README.md ├── Samples/ │ ├── Android.Sample/ │ │ ├── Android.Sample/ │ │ │ ├── Android.Sample.csproj │ │ │ ├── Assets/ │ │ │ │ └── AboutAssets.txt │ │ │ ├── MainActivity.cs │ │ │ ├── Properties/ │ │ │ │ └── AssemblyInfo.cs │ │ │ └── Resources/ │ │ │ ├── AboutResources.txt │ │ │ ├── Layout/ │ │ │ │ └── Main.axml │ │ │ ├── Resource.Designer.cs │ │ │ └── Values/ │ │ │ └── Strings.xml │ │ ├── Android.Sample.sln │ │ └── Android.Sample.sln.DotSettings │ └── iOS.Sample/ │ ├── iOS.Sample/ │ │ ├── AppDelegate.cs │ │ ├── Info.plist │ │ ├── Main.cs │ │ ├── MyViewController.cs │ │ ├── Properties/ │ │ │ └── AssemblyInfo.cs │ │ └── iOS.Sample.csproj │ ├── iOS.Sample.sln │ └── iOS.Sample.sln.DotSettings ├── Tools/ │ └── xpkg/ │ └── xpkg ├── Xamarin/ │ ├── Details.md │ └── GettingStarted.md ├── appveyor.yml ├── build-runTests.bat ├── build.bat ├── build.fsx ├── build.sh ├── lib/ │ └── License.txt ├── paket.dependencies └── src/ ├── CommonAssemblyInfo.cs ├── Portable.Licensing/ │ ├── AssemblyBuildDateAttribute.cs │ ├── Customer.cs │ ├── IFluentInterface.cs │ ├── ILicenseBuilder.cs │ ├── License.cs │ ├── LicenseAttributes.cs │ ├── LicenseBuilder.cs │ ├── LicenseType.cs │ ├── Portable.Licensing.csproj │ ├── Properties/ │ │ └── AssemblyInfo.cs │ ├── Security/ │ │ └── Cryptography/ │ │ ├── KeyFactory.cs │ │ ├── KeyGenerator.cs │ │ └── KeyPair.cs │ └── Validation/ │ ├── GeneralValidationFailure.cs │ ├── IAddAdditionalValidationChain.cs │ ├── IAssertValidation.cs │ ├── ICompleteValidationChain.cs │ ├── ILicenseValidator.cs │ ├── IStartValidationChain.cs │ ├── IValidationChain.cs │ ├── IValidationChainCondition.cs │ ├── IValidationFailure.cs │ ├── InvalidSignatureValidationFailure.cs │ ├── LicenseExpiredValidationFailure.cs │ ├── LicenseValidationExtensions.cs │ ├── LicenseValidator.cs │ └── ValidationChainBuilder.cs ├── Portable.Licensing.Tests/ │ ├── KeyGeneratorTests.cs │ ├── LicenseSignatureTests.cs │ ├── LicenseValidationTests.cs │ ├── Portable.Licensing.Tests.csproj │ ├── Properties/ │ │ └── AssemblyInfo.cs │ └── paket.references ├── Portable.Licensing.sln └── Portable.Licensing.sln.DotSettings ================================================ FILE CONTENTS ================================================ ================================================ FILE: .gitignore ================================================ /Build /Publish /Distribution /nant-*.log* packages/ BuildMetrics/ #ignore thumbnails created by windows Thumbs.db #Ignore files build by Visual Studio *.obj *.exe *.pdb *.user *.aps *.pch *.vspscc *_i.c *_p.c *.ncb *.suo *.tlb *.tlh *.bak *.cache *.ilk *.log [Bb]in [Dd]ebug*/ *.lib *.sbr obj/ [Rr]elease*/ _ReSharper*/ [Tt]est[Rr]esult* *.userprefs ================================================ FILE: .paket/paket.targets ================================================ true true $(MSBuildThisFileDirectory) $(MSBuildThisFileDirectory)..\ $(PaketToolsPath)paket.exe $(PaketToolsPath)paket.bootstrapper.exe "$(PaketExePath)" mono --runtime=v4.0.30319 $(PaketExePath) "$(PaketBootStrapperExePath)" mono --runtime=v4.0.30319 $(PaketBootStrapperExePath) $(MSBuildProjectDirectory)\paket.references $(MSBuildProjectFullPath).paket.references $(PaketCommand) restore --references-files $(PaketReferences) $(PaketBootStrapperCommand) RestorePackages; $(BuildDependsOn); ================================================ FILE: .travis.yml ================================================ language: objective-c env: matrix: - MONO_VERSION="3.10.0" before_install: - wget "http://download.mono-project.com/archive/${MONO_VERSION}/macos-10-x86/MonoFramework-MDK-${MONO_VERSION}.macos10.xamarin.x86.pkg" - sudo installer -pkg "MonoFramework-MDK-${MONO_VERSION}.macos10.xamarin.x86.pkg" -target / - mozroots --import --sync --quiet script: - ./build.sh PackageNuGetDistribution ================================================ FILE: LICENSE.md ================================================ The MIT License Copyright (c) 2012 - 2014 Nauck IT KG http://www.nauck-it.de Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ================================================ FILE: Portable.Licensing.nuspec ================================================ Portable.Licensing $version$ Nauck IT KG Daniel Nauck http://opensource.org/licenses/MIT http://dev.nauck-it.de/projects/portable-licensing http://www.nauck-it.de/fileadmin/Portable.Licensing/Portable.Licensing.ico false Portable.Licensing is a cross platform software licensing framework which allows you to implement licensing into your application or library. It provides you all tools to create and validate licenses for your software. Portable.Licensing is using the latest military strength, state-of-the-art cryptographic algorithm to ensure that your software and thus your intellectual property is protected. It is targeting the Portable Class Library and thus runs on nearly every .NET/Mono profile including Silverlight, Windows Phone, Windows Store App, Xamarin.iOS, Xamarin.Android, Xamarin.Mac and XBox 360. Use it for your Desktop- (WinForms, WPF, etc.), Console-, Service-, Web- (ASP.NET, MVC, etc.), Mobile (Xamarin.iOS, Xamarin.Android) or even LightSwitch applications. FEATURES - runs on .NET >= 4.0.3, Silverlight 5, Windows Phone >= 8, Windows Store Apps, Mono, Xamarin.iOS, Xamarin.Android, Xamarin.Mac, XBox 360 - easy creation and validation of your licenses - trial, standard and subscription licenses - cryptographic signed licenses, no alteration possible - allows you to enable/disable program modules or product features - limit various parameters for your software, e.g. max transactions, etc. - add additional key/value pair attributes to your licenses - easily extend the fluent validation API with extension methods Copyright 2012-2014 Nauck IT KG Portable.Licensing PCL Portable Licensing License Key KeyGenerator Protection Signing Nauck ================================================ FILE: README.md ================================================ # Documentation # ---------- ## About Portable.Licensing ## Portable.Licensing is a cross platform software licensing framework which allows you to implement licensing into your application or library. It provides you all tools to create and validate licenses for your software. Portable.Licensing is using the latest military strength, state-of-the-art cryptographic algorithm to ensure that your software and thus your intellectual property is protected. It is targeting the *Portable Class Library* and thus runs on nearly every .NET/Mono profile including Silverlight, Windows Phone, Windows Store App, Xamarin.iOS, Xamarin.Android, Xamarin.Mac and XBox 360. Use it for your Desktop- (WinForms, WPF, etc.), Console-, Service-, Web- (ASP.NET, MVC, etc.), Mobile (Xamarin.iOS, Xamarin.Android) or even LightSwitch applications. ## Features ## - runs on .NET >= 4.0.3, Silverlight 5, Windows Phone >= 8, Windows Store Apps, Mono, Xamarin.iOS, Xamarin.Android, Xamarin.Mac, XBox 360 - easy creation and validation of your licenses - trial, standard and subscription licenses - cryptographic signed licenses, no alteration possible - allows you to enable/disable program modules or product features - limit various parameters for your software, e.g. max transactions, etc. - add additional key/value pair attributes to your licenses - easily extend the fluent validation API with extension methods ## Build status | Platform | Status of last build | | :------ | :------: | :------: | | **Mono** | [![Travis build status](https://travis-ci.org/dnauck/Portable.Licensing.svg)](https://travis-ci.org/dnauck/Portable.Licensing) | | **Windows** | [![AppVeyor Build status](https://ci.appveyor.com/api/projects/status/ybwy7l9ooue3apqc/branch/devel?svg=true)](https://ci.appveyor.com/project/dnauck/portable-licensing) | ---------- ## Getting started ## ### License.Manager light ### A reference implementation of a management application for products, customers and licenses is available here: [https://github.com/dnauck/License.Manager-Light](https://github.com/dnauck/License.Manager-Light) ### License.Manager ### License.Manager is a web-based management solution for Portable.Licensing developed using AngularJS and ServiceStack. It enables you to manage customers, products and licenses and provides a REST service backend for integration with payment providers and 3rd party tools. License.Manager is available here: [https://github.com/dnauck/License.Manager](https://github.com/dnauck/License.Manager) ### Download ### [Portable.Licensing](https://nuget.org/packages/Portable.Licensing) is distributed with the popular NuGet Packaging Manager. This will make it easier for developers to get the Portable.Licensing distribution into their project. Go to the NuGet website for more details: [http://nuget.org/](http://nuget.org/) NuGet provides several ways to get Portable.Licensing into your Project. The easiest way is to right click your project references in Visual Studio and choose the menu item "Manage NuGet Packages". Search in the "Online" tab for "Portable.Licensing" and click "Install" on your selected packages. It is also possible to install the Portable.Licensing packages via the "NuGet Package Manager Console". Type the following to install the Portable.Licensing library: PM> Install-Package Portable.Licensing Or use the following command to get a specific version: PM> Install-Package Portable.Licensing -Version 1.0.0 ### Create a private and public key for your product ### Portable.Licensing uses the Elliptic Curve Digital Signature Algorithmus (ECDSA) to ensure the license cannot be altered after creation. First you need to create a new public/private key pair for your product: var keyGenerator = Portable.Licensing.Security.Cryptography.KeyGenerator.Create(); var keyPair = keyGenerator.GenerateKeyPair(); var privateKey = keyPair.ToEncryptedPrivateKeyString(passPhrase); var publicKey = keyPair.ToPublicKeyString(); Store the private key securely and distribute the public key with your product. Normally you create one key pair for each product, otherwise it is possible to use a license with all products using the same key pair. If you want your customer to buy a new license on each major release you can create a key pair for each release and product. ### Create the license generator ### Now we need something to generate licenses. This could be easily done with the *LicenseFactory*: var license = License.New() .WithUniqueIdentifier(Guid.NewGuid()) .As(LicenseType.Trial) .ExpiresAt(DateTime.Now.AddDays(30)) .WithMaximumUtilization(5) .WithProductFeatures(new Dictionary { {"Sales Module", "yes"}, {"Purchase Module", "yes"}, {"Maximum Transactions", "10000"} }) .LicensedTo("John Doe", "john.doe@yourmail.here") .CreateAndSignWithPrivateKey(privateKey, passPhrase); Now you can take the license and save it to a file: File.WriteAllText("License.lic", license.ToString(), Encoding.UTF8); or license.Save(xmlWriter); ### Validate the license in your application ### The easiest way to assert the license is in the entry point of your application. First load the license from a file or resource: var license = License.Load(...); Then you can assert the license: using Portable.Licensing.Validation; var validationFailures = license.Validate() .ExpirationDate() .When(lic => lic.Type == LicenseType.Trial) .And() .Signature(publicKey) .AssertValidLicense(); Portable.Licesing will not throw any Exception and just return an enumeration of validation failures. Now you can iterate over possible validation failures: foreach (var failure in validationFailures) Console.WriteLine(failure.GetType().Name + ": " + failure.Message + " - " + failure.HowToResolve); Or simply check if there is any failure: if (validationFailures.Any()) // ... Make sure to call `validationFailures.ToList()` or `validationFailures.ToArray()` before using the result multiple times. ---------- ## License ## Portable.Licensing is distributed using the MIT/X11 License. ## Further Information ## The latest release and documentation can be found on the Portable.Licensing project website: [http://dev.nauck-it.de/projects/portable-licensing](http://dev.nauck-it.de/projects/portable-licensing) ================================================ FILE: Samples/Android.Sample/Android.Sample/Android.Sample.csproj ================================================  Debug AnyCPU 8.0.30703 2.0 {C1669549-42DA-49E5-B88B-A6D0AD0A545F} {EFBA0AD7-5A72-4C68-AF49-83D382785DCF};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC} Library Properties Android.Sample Android.Sample 512 true Resources\Resource.Designer.cs Off true full false bin\Debug\ DEBUG;TRACE prompt 4 True None pdbonly true bin\Release\ TRACE prompt 4 False SdkOnly ..\Components\Portable.Licensing-1.0.0.0\lib\mobile\Portable.Licensing.dll False 1.0.0.0 True 1.0.0.0 False ================================================ FILE: Samples/Android.Sample/Android.Sample/Assets/AboutAssets.txt ================================================ Any raw assets you want to be deployed with your application can be placed in this directory (and child directories) and given a Build Action of "AndroidAsset". These files will be deployed with you package and will be accessible using Android's AssetManager, like this: public class ReadAsset : Activity { protected override void OnCreate (Bundle bundle) { base.OnCreate (bundle); InputStream input = Assets.Open ("my_asset.txt"); } } Additionally, some Android functions will automatically load asset files: Typeface tf = Typeface.CreateFromAsset (Context.Assets, "fonts/samplefont.ttf"); ================================================ FILE: Samples/Android.Sample/Android.Sample/MainActivity.cs ================================================ using System; using System.Linq; using System.Text; using Android.App; using Android.Content; using Android.Runtime; using Android.Views; using Android.Widget; using Android.OS; using Portable.Licensing; using Portable.Licensing.Validation; namespace Android.Sample { [Activity(Label = "Android.Sample", MainLauncher = true, Icon = "@drawable/icon")] public class MainActivity : Activity { int count = 1; protected override void OnCreate(Bundle bundle) { base.OnCreate(bundle); var licenseContent = @" 77d4c193-6088-4c64-9663-ed7398ae8c1a Trial Thu, 31 Dec 2009 23:00:00 GMT 1 John Doe john@doe.tld MEUCIQDdDpq/Ddt4hZJlird/BcR6FVKLdWF/DENnd6r/0LuB3gIgVm7RSQx5mcjC32JjCoHNdoL8C+etXOtWKiYGLCT4q6w= "; var license = License.Load(licenseContent); var validationFailures = license.Validate() .ExpirationDate() .When(lic => lic.Type == LicenseType.Trial) .And() .Signature(Resources.GetString(Resource.String.LicensePublicKey)) .AssertValidLicense().ToList(); if (validationFailures.Any()) { var dialogBuilder = new AlertDialog.Builder(this); dialogBuilder.SetTitle("License validation failure!"); dialogBuilder.SetIcon(Android.Resource.Drawable.IcDialogAlert); var messageBuilder = new StringBuilder(); foreach (var validationFailure in validationFailures) { messageBuilder.AppendLine("Failure:"); messageBuilder.AppendLine(validationFailure.Message); messageBuilder.AppendLine(" "); messageBuilder.AppendLine("Resolve issue by:"); messageBuilder.AppendLine(validationFailure.HowToResolve); messageBuilder.AppendLine(" "); messageBuilder.AppendLine(" "); } dialogBuilder.SetMessage(messageBuilder.ToString()); dialogBuilder.SetNeutralButton("Cancel", (sender, args) => { /* close app */ }); dialogBuilder.Show(); } // Set our view from the "main" layout resource SetContentView(Resource.Layout.Main); // Get our button from the layout resource, // and attach an event to it Button button = FindViewById