Skip to main content

Enterprise Server 3.20 is currently available as a release candidate.

Enforcing dependency review across an organization

Dependency review lets you catch insecure dependencies before you introduce them to your environment. You can enforce the use of the dependency review action across your organization.

Who can use this feature?

Organization owners, security managers, and organization members with the admin role

You can enforce the use of the dependency review action in your organization by setting up a repository ruleset that will require a workflow that runs dependency review to pass before pull requests can be merged. For more information about the action, see About dependency review.

Prerequisites

You need to add the dependency review action to one of the repositories in your organization, and configure the action. For more information, see Configuring the dependency review action.

Enforcing dependency review for your organization

  1. In the upper-right corner of GitHub, click your profile picture, then click Organizations.

  2. Next to the organization, click Settings.

  3. In the left sidebar, in the "Code, planning, and automation" section, click Repository, then click Rulesets.

    Screenshot of an organization's settings page. In the sidebar, a link labeled "Rulesets" is outlined in orange.

  4. Click the New ruleset dropdown menu, and select New branch ruleset.

  5. To help identify your ruleset and clarify its purpose, give the ruleset a name in Ruleset Name.

  6. Set Enforcement status to Active.

  7. Optionally, you can target specific repositories in your organization. For more information, see Choosing which repositories to target in your organization.

  8. In the "Rules" section, select the "Require workflows to pass before merging" option.

  9. In "Workflow configurations", click Add workflow.

  10. In the dialog, select the repository that you added the dependency review action to. For more information, see Prerequisites.

  11. Select a branch and the workflow file for dependency review in the enhanced dialog.

    Screenshot of the Add required workflow dialog. You need to specify a repository, branch, and workflow.

  12. Click Create.