Skip to main content
Skip to content

About Actions policies

Govern how GitHub Actions workflows run within your repository, organization, or enterprise.

About Actions policies

Actions policies let you govern how GitHub Actions workflows run. You can configure them in the Policies section of your GitHub Actions settings (separate from the General settings).

Actions policies are available at the enterprise, organization, and repository levels. They currently contain one type of policy: workflow execution protections. GitHub plans to add more policies over time.

About workflow execution protections

Informationen zu den Actions-Richtlinien

Mithilfe von Aktionsrichtlinien können Sie steuern, wie GitHub Actions Workflows in Ihren Organisationen und Repositorys ausgeführt werden. Sie konfigurieren Aktionsrichtlinien in einem neuen Abschnitt Ihrer GitHub Actions Einstellungen, getrennt von den vorhandenen allgemeinen Einstellungen.

Aktionsrichtlinien sind auf Unternehmens-, Organisations- und Repositoryebene verfügbar.

Aktionsrichtlinien enthalten derzeit einen Richtlinientyp: Workflowausführungsschutz. GitHub plant, im Laufe der Zeit weitere Richtlinien hinzuzufügen.

Informationen zu Schutzmechanismen für die Workflow-Ausführung

Mit Workflowausführungsschutz können Sie eine Zulassungsliste definieren, die steuert, wer Workflows auslösen GitHub Actions kann und welche Ereignisse sie ausführen dürfen. Workflowausführungsschutz umfasst zwei Regeltypen: Ereignis und Akteur. GitHub plant, im Laufe der Zeit weitere Regeln hinzuzufügen.

Die Schutzmechanismen für die Workflowausführung basieren auf dem GitHub-Framework für rulesets, sodass das Targeting, das Sie bereits von rulesets kennen, auch hier funktioniert. Mithilfe von benutzerdefinierten Repositoryeigenschaften können Sie Schutzmaßnahmen mit Regelets anwenden und auf bestimmte Repositorys beschränken. Weitere Informationen zu Regelsätzen finden Sie unter Informationen zu Regelsätzen. These protections can disrupt several real-world attack patterns:

  • Poisoned pipeline execution from pull requests. Restrict or prohibit pull_request_target, including in public repositories where it is most often exploited.
  • Manual-trigger abuse. Limit workflow_dispatch so untrusted identities cannot start workflows.
  • Untrusted-actor execution. Block low-trust identities from triggering workflows entirely.
  • Misconfiguration exploitation. Apply central policy that overrides any single misconfigured workflow file.

When enforced, disallowed workflow runs will fail with an error. For example:

Event 'workflow_dispatch' is not allowed to trigger Actions workflows. Workflow file: '.github/workflows/0-welcome.yml'.

Hinweis

GitHub has added a default policy that will block the pull_request_target event in public repositories. This policy will be enforced on November 2, 2026. See Sichere Verwendung von pull_request_target.

Available rules

  • Actor rules control who can trigger workflows, including individual users, repository roles, GitHub Apps, Copilot, and Dependabot. By default, every user with write access to a repository can trigger workflows. Actor rules let you separate who contributes code from who runs your CI, so you can grant a contributor write access without granting them the ability to execute workflows.
  • Event rules control which events are permitted, such as push, pull_request, pull_request_target, and workflow_dispatch.

GitHub plans to add more rules over time.

Next steps

To configure workflow execution protections, see Controlling who can execute GitHub Actions workflows.

To manage policies programmatically, see REST API endpoints for GitHub Actions policies.