NPM

Manage NPM packages and team access permissions automatically as your team changes.

Setup

1. Create or sign into your NPM account

Sign in to NPM
or
Create a new NPM account

2. Generate Access Token

Follow the NPM documentation to create an access token

Make sure to grant the following permissions:

  • Read and write organization members
  • Read and write teams
  • Read and write packages

3. Connect NPM Organization

Enter your Access Token below to complete the integration.


Configuration

FieldTypeDescription
accessTokenstring (required)Secret NPM access token provided by the user. Encrypted and stored as encryptedToken.
organizationNamestring (required)NPM organization name provided by the user, used for reference in future requests.
secretsobjectBuilt during integration config setup containing:
  encryptedTokenstringEncrypted accessToken used to authenticate future requests.

Connections

Permission Group

Permission group connections can link to existing NPM Teams or create new ones if no connection input is provided.

When creating a new Team in NPM, the name will be the Hyphen Team name.

Configuration

FieldTypeDescription
teamIdstringUnique team ID in the NPM team.
teamNamestringTeam name in the NPM team, used for reference.

Connection Input

Provide the NPM team name to connect to an existing Team.

Access

A Member connection will be added as a member when added to the NPM team.


User

User connections can only connect to existing Users in NPM by providing input.

Configuration

FieldTypeDescription
userIdstringUnique username in NPM.
emailstringHyphen member email, used for display.

Connection Input

Provide the NPM username to connect to an existing User.


Code Registry

Code registry connections can only connect to existing NPM packages within the NPM organization using a provided input.

Configuration

FieldTypeDescription
packageIdstringUnique package name in the NPM organization.
packageNamestringUnique package name in the NPM organization, used for display.

Connection Input

Provide the NPM package name to connect to an existing Package.

Access

A Team connection will be added with ‘read-write’ permissions when added to the NPM package.