Area: Episerver B2B Commerce

Third-party library policy in Classic

Recommended reading 

Epi B2B Commerce Cloud supports a standard set of third-party libraries that fulfill common requirements such as SFTP and XML parsing. By standardizing on a finite set of libraries, Episerver mitigates the risk of binary incompatibility from conflicting libraries and reduces the security risk of unsupported libraries. With that in mind, packages outside the "allowedLibraries.txt" whitelist should not be referenced by or included in any deployments to Epi B2B Commerce Cloud.

In order to meet new requirements, periodic additions to this list are expected, and Episerver welcomes suggestions on what new libraries to include. The following is the process for requesting that a package be added to the list:

  1. Review the allowedLibraries.json file from the insite-commerce-cloud Git repository. (At the time of writing, the file is saved to /src/tools/PowerShellScripts.)
  2. Confirm that the desired package is not in the whitelist, and that no other libraries listed there are a good substitute.
  3. Submit a support ticket requesting that the desired package be added to the whitelist, identifying the name and source of the package as well as the reasons for wanting to add the package. Please be aware that this review process takes about four weeks.
  4. Episerver will evaluate the request based a few criteria, such as,
    • The desired package is important to the success of the project
    • None of the existing allowed packages meet the needed requirements
    • The package appears to have sufficient backing as to be maintained and secure going forward
    • The requirement is best met by a third party library rather than a base code change
  5. If approved, the change to the whitelist will be scheduled for release

Note: The simplest way to include a new JavaScript (JS) library is to use a CDN, if available. You can include a JS library in the theme, but if there are dependencies, those also need to be included in the theme.

Do you find this information helpful? Please log in to provide feedback.

Last updated: Dec 11, 2020

Recommended reading