SOOS

The SOOS SCM Audit script should be used to determine the number of contributing developers in your organization.

SOOS Badge Status

Requirements

• npm

Installation

run npm install --prefix ./soos @soos-io/soos-scm-audit

Configure and Run the Script

NOTE: you can find values for the --apiKey and --clientId at app.soos.io.

For GitHub

1. Generate a GitHub Public Access Token (PAT) for your organization and ensure that it has the full repo permission set.

2. Plug in the values for --apiKey, --clientId, --secret, and --organizationName and run the script.

3. Run node ./soos/node_modules/@soos-io/soos-scm-audit/bin/index.js --apiKey=<API_KEY> --clientId=<CLIENT_ID> --scmType=GitHub --secret=<GITHUB_PAT> --organizationName="<GITHUB_ORG_NAME>"

For Bitbucket Cloud

1. Generate an App Password for your organization and ensure that it has the Read Repositories permission set.

2. Plug in the values for --apiKey, --clientId, --secret, and --workspace, and --username and run the script.

3. Run node ./soos/node_modules/@soos-io/soos-scm-audit/bin/index.js --apiKey=<API_KEY> --clientId=<CLIENT_ID> --scmType=BitbucketCloud --secret=<APP_PASSWORD> --workspace="<BITBUCKET_WORKSPACE>" --username="<BITBUCKET_USERNAME>"

Parameters

General Parameters	Default	Description
--apiKey		SOOS API Key - get yours from SOOS Integration.
--clientId		SOOS Client ID - get yours from SOOS Integration.
--logLevel		Minimum level to show logs: DEBUG, INFO, WARN, FAIL, ERROR.
--resultsFormat		Results format: TXT or JSON
--scmType		Scm Type to use for the audit. Options: GitHub, BitBucketCloud

BitBucket Cloud Parameters	Default	Description
--username		Username where the App password was generated for BitBucketCloud.
--secret		Secret to use for API calls. It should be a App Password
--workspace		Workspace name to run audit for BitBucketCloud.

GitHub Parameters	Default	Description
--organizationName		Organization name to run audit for GitHub.
--secret		Secret to use for API calls. It should be a classic GPAT that has access to all repositories for the organization