Help Center

Configuring Private NPM Packages

Rosie Watson

You may require help from a more technical team member if you are not familiar with private registries.

If you wish to import NPM packages hosted on a private registry, you can do so by adding authentication details to zeroheight. Note : We proxy registries through zeroheight.com, so we don’t currently support adding private registries behind VPNs.

1. Navigate to ‘ Your organization ‘ settings page and click ‘ Developers ‘ on the sidebar
2. You’ll see an NPM Registry section; click the Add registry button to bring up the creation modal
3. Fill out each of the fields in the modal and click save :

• Registry name : a label used only within zeroheight
• URL : The URL of the registry, e.g. for a private package on NPM, you would use “ https://registry.npmjs.org “
• Scopes : A comma separated list of scopes that will be associated with the registry (these should begin with an “ @ “)
• Authentication method :
  • Token : This provides a single authentication token field, which allows accessing private registries using bearer authentication
  • Username & password : This provides a username and password field, which allows accessing private registries using basic authentication
• Skip credentials check : This stops zeroheight from verifying credentials before saving. Certain registries, including Azure Artifacts and GitLab, don’t support our method of credentials verification, so this option to bypass our checks on save.

4. Once completed, click Add registry

You will then need to add any packages that use the private NPM registry in the styleguide settings . Note: you will need to import any dependancies required for private packages to compile

After configuration, any matching scoped packages added to code blocks will refer to the created registry.

Adding an Artifactory private NPM registry

To add a JFrog Artifactory registry to zeroheight, you must add either an Identity token or a Scoped token .

To add an identity token :

1. Go to “Edit profile” in your JFrog account and click “Generate an Identity token”
2. Add the token to the registry in zeroheight with the authentication method set to Token

More information available in their help article

To add a scoped token :

1. Go to “Configuration > User Management > Access Tokens” in your JFrog account
2. Create a new scoped token
   • Check the ‘create reference token’ checkbox and use the returned reference token
   • Ensure you have the correct permissions in Artifactory

More information available in their help article