1. IronOCR
  2. Troubleshooting
  3. Setting License Key in Web.config

Setting License Key in Web.config

This problem has been solved since IronOCR version 2024.3.4.

Exception: Unhandled exception. IronSoftware.Exceptions.LicensingException: IronOCR must be licensed for development.

For older IronOcr versions, specifically those between versions 2023.4.13 and 2024.3.4, there is a known licensing issue in:

  • ASP.NET projects
  • .NET Framework version >= 4.6.2

The key stored in a Web.config file will NOT be picked up and used by the product.

Workaround

To address this issue, it is recommended to retrieve the license key from the Web.config file using ConfigurationManager in the code, and then apply it to the License.LicenseKey property.

Example:

<configuration>
...
  <appSettings>
    <add key="IronOcr.LicenseKey" value="IRONOCR-MYLICENSE-KEY-1EF01"/>
  </appSettings>
...
</configuration>
XML

With the XML file provided above, we can use ConfigurationManager to retrieve the license key value and pass it to the IronOcr.License.LicenseKey property.


using System.Configuration;

string licenseKey = ConfigurationManager.AppSettings ["IronOcr.LicenseKey"];

IronOcr.License.LicenseKey = licenseKey;

using System.Configuration;

string licenseKey = ConfigurationManager.AppSettings ["IronOcr.LicenseKey"];

IronOcr.License.LicenseKey = licenseKey;
Imports System.Configuration

Private licenseKey As String = ConfigurationManager.AppSettings ("IronOcr.LicenseKey")

IronOcr.License.LicenseKey = licenseKey
VB   C#