Study guide

8.1 Enterprise & Organization Action Policies

GitHub Actions Certification GH-200

Track your progress as you read

Finished sections get a check mark.

1 Chapter 1: Introduction & Exam Overview

1.1 Exam Structure, Format & Scoring 1.2 GitHub Actions Architecture & Core Mental Model 1.3 Hands-On Preparation & Exam Day Strategy

2 Chapter 2: Workflow Triggers & Event Architecture

2.1 Webhook & Code Events: push, pull_request, and pull_request_target 2.2 Scheduled & Manual Triggers: schedule, workflow_dispatch, and repository_dispatch 2.3 Release, Issue, and Dynamic Lifecycle Events 2.4 Branch, Tag, and Path Filtering Patterns

3 Chapter 3: Jobs, Matrix Strategies & Execution Control

3.1 Job Anatomy, Step Execution & Job Dependencies (needs) 3.2 Contexts, Expressions & Functions 3.3 Environment Variables & Workflow Commands 3.4 Matrix Strategies & Multi-Platform Builds 3.5 YAML Anchors, Aliases & Merge Keys

4 Chapter 4: Reusable Workflows & Troubleshooting

4.1 Authoring & Calling Reusable Workflows (workflow_call) 4.2 Comparing Reusable Workflows, Composite Actions & Starter Workflows 4.3 Troubleshooting Workflow Runs & Debug Logging 4.4 Concurrency Controls & Status Check Functions

5 Chapter 5: Authoring Custom Actions

5.1 Action Architecture & action.yml Specification 5.2 Authoring Composite Actions 5.3 Building JavaScript Actions 5.4 Building Docker Container Actions

6 Chapter 6: Action Distribution, Marketplace & Advanced Action Types

6.1 Action Versioning, Semantic Releases & Tagging 6.2 Publishing Actions to GitHub Marketplace 6.3 Service Containers & Network Topology 6.4 actions/github-script & Workflow Tooling

7 Chapter 7: Runner Infrastructure & Self-Hosted Runners

7.1 GitHub-Hosted Runners & Larger Runners 7.2 Self-Hosted Runner Setup, Architecture & Communication 7.3 Self-Hosted Runner Security & Ephemeral Runners 7.4 Runner Groups, Labels & Organization Routing

8 Chapter 8: Enterprise Governance, Policies & Environments

8.1 Enterprise & Organization Action Policies 8.2 Environments, Protection Rules & Deployment Approvals 8.3 Repository Rulesets, Required Status Checks & Governance 8.4 Usage Limits, Billing Multipliers & Usage Metrics

9 Chapter 9: Secrets, Permissions & OIDC Cloud Authentication

9.1 Encrypted Secrets Architecture & Scopes 9.2 GITHUB_TOKEN & Least Privilege Configuration 9.3 OpenID Connect (OIDC) & Workload Identity Federation 9.4 Script Injection Prevention & Secure Workflow Patterns

10 Chapter 10: Supply Chain Hardening & Performance Optimization

10.1 Supply Chain Hardening: SHA Pinning, Dependabot & Artifact Attestations 10.2 Caching Dependencies with `actions/cache` 10.3 Artifacts Management & Job Handoff 10.4 Workflow Performance, Cost Optimization & Architecture Review

8.1 Enterprise & Organization Action Policies

Key Takeaways Explain This Topic AI

Enterprise policies establish a mandatory security baseline across all organizations, where lower levels (organizations and repositories) can only make policies more restrictive, never more permissive.

GitHub Actions permission tiers encompass four discrete settings: (1) Disable Actions completely, (2) Allow local actions and reusable workflows only, (3) Allow actions created by GitHub and verified marketplace creators, and (4) Allow specified actions and reusable workflows via custom allowlists.

Action allowlists support granular pattern-matching syntax including exact action references ( actions/checkout@v4 ), organization-wide globs ( actions/* , aws-actions/* ), and repository wildcards.

Fork pull request execution policies dictate whether pull requests from public or private forks can run workflows, whether workflows require first-time contributor approval, and ensure secrets are isolated from untrusted fork PRs.

Enterprise administrators can lock policies to enforce organizational compliance, preventing organization and repository owners from relaxing security guardrails.

Last updated: August 2026

Enterprise & Organization Action Policies

In enterprise environments, managing which GitHub Actions can execute across hundreds of repositories is a vital operational and security responsibility. Unrestricted action execution introduces severe supply chain risks, including secret exfiltration, malicious dependency injection, and unauthorized compute utilization.

GitHub provides a hierarchical governance model spanning the Enterprise Account , Organization , and Repository levels. Understanding how permission tiers operate, how policies are inherited and locked, and how to construct granular action allowlists is a critical domain on the GitHub Actions Certification (GH-200) examination.

1. Enterprise Governance Hierarchy & Policy Inheritance

GitHub Actions applies a strict top-down inheritance model across the administrative hierarchy: ┌─────────────────────────────────────────────────────────────┐

  • │ Enterprise Account │
  • │ Sets the foundational baseline policy for all organizations│
  • └──────────────────────────────┬──────────────────────────────┘
  • │
  • ▼ (Inherits & can only restrict)
  • ┌─────────────────────────────────────────────────────────────┐
  • │ Organization │
  • │ Applies org-wide policy; cannot loosen enterprise baseline │
  • └──────────────────────────────┬──────────────────────────────┘
  • │
  • ▼ (Inherits & can only restrict)
  • ┌─────────────────────────────────────────────────────────────┐
  • │ Repository │
  • │ Applies repo-level policy; cannot loosen org baseline │
  • └─────────────────────────────────────────────────────────────┘
  • The Cardinal Rule of Policy Inheritance

The Cardinal Rule: An organization or repository can only make its action policies more restrictive than its parent container— never more permissive .

For example:

If the Enterprise policy is configured to "Allow actions created by GitHub and verified marketplace creators" , an Organization administrator can restrict their organization further to "Allow local actions and reusable workflows only" .

However, that organization administrator cannot select "Allow all actions and reusable workflows" , because that would be more permissive than the enterprise baseline.

If an Enterprise administrator selects "Enforce policy for all organizations (Locked)" , organization and repository administrators cannot alter the action permission settings at all.

2. GitHub Actions Permission Tiers

Administrators at the Enterprise, Organization, and Repository levels can select from four discrete permission tiers under Settings → Actions → General → Actions permissions :

Tier 1: Disable GitHub Actions

Disables workflow execution entirely across the container.

Existing workflows will not trigger on any event (push, pull_request, schedule, manual dispatch).

The Actions tab in repository navigation is hidden or disabled.

Used for organizations or repositories that exclusively use external CI/CD systems (e.g., Jenkins, CircleCI) and want to eliminate accidental runner usage.

Tier 2: Allow Local Actions and Reusable Workflows Only

Workflows can only execute actions and reusable workflows defined within the same repository (e.g., uses: ./.github/actions/my-custom-action ) or within repositories owned by the same organization/enterprise.

Completely blocks all third-party actions from the GitHub Marketplace, including official actions/* repositories (such as actions/checkout or actions/setup-node ), unless those repositories have been mirrored internally into the organization.

Provides high security isolation for air-gapped or strictly internal compliance environments.

Tier 3: Allow Actions Created by GitHub and Verified Marketplace Creators

Automatically permits all actions created and maintained directly by GitHub under the actions/ and github/ organizations (e.g., actions/checkout , actions/cache , actions/upload-artifact ).

Automatically permits actions published by Verified Creators on the GitHub Marketplace (publishers whose identity has been vetted and verified by GitHub, indicated by a verified creator badge).

Blocks all actions created by individual community developers or non-verified third parties.

Tier 4: Allow Specified Actions and Reusable Workflows

Provides the most granular enterprise security control.

Administrators define an explicit Allowlist using comma-separated or newline-separated pattern-matching strings.

You can optionally check the box: "Allow actions created by GitHub" to automatically permit all actions/* repositories without listing each one manually.

You can also check: "Allow Marketplace actions by Marketplace verified creators" alongside custom allowlist patterns.

3. Action Allowlist Syntax & Pattern Matching

When configuring "Allow specified actions and reusable workflows" , GitHub evaluates workflow uses: statements against the defined pattern rules. An action is permitted if it matches at least one rule in the allowlist.

Pattern Syntax Specification

Pattern Syntax Scope & Matching Behavior Examples Matched Examples Blocked

owner/* All actions in all repositories owned by owner , at any version tag or commit SHA. actions/checkout@v4 ; actions/setup-python@v5 other-org/checkout@v4

owner/repo@* All versions/tags of a specific repository. aws-actions/configure-aws-credentials@v4 ; aws-actions/configure-aws-credentials@main aws-actions/amazon-ecr-login@v2

owner/repo@version Exact repository pinned to an exact version tag, branch name, or commit SHA. docker/build-push-action@v5 ; docker/build-push-action@v5.1.0 docker/build-push-action@v4 ; docker/build-push-action@main

owner/repo/path@* A specific action residing in a subdirectory within a repository. my-org/monorepo/actions/lint@v1 my-org/monorepo/actions/deploy@v1

* Wildcard permitting all actions (equivalent to Tier 0 / fully open). Any action from any repository. None.

  • Practical Enterprise Allowlist Example # Allow all official GitHub core actions
  • actions/*
  • github/*
  • # Allow official cloud provider partner actions
  • aws-actions/*
  • google-github-actions/*
  • azure/*
  • # Allow specific verified third-party tools pinned to major versions
  • docker/setup-buildx-action@v3
  • docker/build-push-action@v5
  • snyk/actions/*
  • # Allow all internal enterprise reusable workflows and composite actions
  • acme-corp/*

Warning

Pattern Strictness: Specifying actions/* matches any action inside the actions organization at any tag, branch, or SHA. If an enterprise requires cryptographic immutability, administrators should combine allowlists with ruleset commit SHA pinning policies.

4. Fork Pull Request Policies & Contributor Protections

Workflows executing on pull_request events from external forks represent a primary attack vector for public and internal open-source repositories. Attackers can submit pull requests containing modified workflow definitions designed to steal CI/CD secrets or execute cryptocurrency miners on hosted compute.

To mitigate this risk, enterprise and organization administrators configure Fork pull request workflow execution policies : Fork PR Event Triggered

  • │
  • ▼

Is the author a First-Time Contributor or Outside Collaborator?

  • ├── Yes ──► [Approval Gate: Maintainer with Write access must click 'Approve and run']
  • │ │
  • │ ├── Approved ──► Runner executes workflow (Secrets withheld)
  • │ └── Rejected ──► Workflow terminated without execution
  • └── No ──► Workflow executes automatically
  • Available Fork Approval Settings

Require approval for first-time contributors: Workflows created by contributors who have not previously had a pull request merged into the repository require approval from a collaborator with write permissions before running.

Require approval for all outside collaborators: Requires maintainer approval for any contributor who is not an explicit member of the repository or organization.

Require approval for all fork pull request workflows: Every single pull request originating from a fork requires manual maintainer approval, regardless of contributor history.

Run workflows from fork pull requests (Private repositories): By default, workflows do not run on pull requests from private forks. Admins can enable this setting, and specify whether pull_request runs from forks receive read-only tokens and masked secrets.

Secret Isolation for Fork Workflows

For pull_request events originating from a fork, GitHub Actions never passes repository secrets to the runner environment.

The default GITHUB_TOKEN provided to fork pull request workflows has strictly read-only permissions (regardless of organizational default settings).

If a workflow must access secrets to deploy or comment on a fork pull request, developers must use the pull_request_target event with strict checkout controls, as covered in security chapters.

5. Workflow Run Permissions & GITHUB_TOKEN Defaults

At both the Enterprise and Organization levels, administrators enforce baseline permissions for the automatically generated GITHUB_TOKEN :

Default GITHUB_TOKEN permissions:

Read and write permissions: Grants permissive access across repository contents, packages, issues, and pull requests. (Legacy default; discouraged for enterprise environments).

Read repository contents and packages permissions (Least Privilege): Grants read-only access by default. Individual workflows must explicitly declare write permissions using the top-level or job-level permissions: block.

Fork pull request workflow approvals: Administrators can globally enforce whether fork workflows are permitted to create or approve pull requests ( Allow GitHub Actions to create and approve pull requests ).

Loading diagram... GitHub Actions Enterprise Policy Inheritance and Restriction Hierarchy