Installation

The product is supplied as a ZIP file. This includes the NuGet packages, documentation and example projects. Simply unzip to a convenient location on your file system (e.g. C:\SAML for ASP.NET).

NuGet Packages

The recommended way to retrieve the SAML for ASP.NET packages and stay up to date is via nuget.org.

The following packages are available:

Package	Purpose	Notes
ComponentSpace.Saml2.Net	SAML functionality	Required
ComponentSpace.Saml2.Net.Extension.AesGcm	AES-GCM encryption	Optional
ComponentSpace.Saml2.Net.Extension.RsaOaep	RSA-OAEP encryption of symmetric keys	Optional

Trial Version

The product includes a free 30-day trial period.

Note

Production use requires a commercial license.

Installing the License Key

After purchasing a license, the supplied license key must be installed in the application before deploying to production. It's delivered as a ComponentSpace.lic file.

The installation options are:

Copy the ComponentSpace.lic file to the application's root folder. The license key will be loaded automatically.
Copy the ComponentSpace.lic file to a different folder and specify its location at application startup by setting SAMLController.LicenseKeyFileName.

For example:
```
SAMLController.LicenseKeyFileName = @"Licenses\ComponentSpace.lic";
```
Copy the license key string from the ComponentSpace.lic file and set it at application startup by setting SAMLController.LicenseKey

For example:
```
SAMLController.LicenseKey = "license key string goes here...";
```
Store the license key string elsewhere (e.g. in an environment variable , retrieve it and set it at application startup by setting SAMLController.LicenseKey.

Note

The license key is safe to store and distribute as required. It's specific to your organization but doesn't contain any sensitive or personally identifiable information.

Uninstallation

Uninstall the ComponentSpace.Saml2.Net packages from any ASP.NET web application projects.
Delete the unzipped product folder from your file system.