Enforcing policies for GitHub Actions in your enterprise

About policies for GitHub Actions in your enterprise

GitHub Actions helps members of your enterprise automate software development workflows on GitHub Enterprise Server. For more information, see "Understanding GitHub Actions."

If you enable GitHub Actions, any organization on GitHub Enterprise Serverインスタンス can use GitHub Actions. You can enforce policies to control how members of your enterprise on GitHub Enterprise Server use GitHub Actions. By default, organization owners can manage how members use GitHub Actions. For more information, see "Disabling or limiting GitHub Actions for your organization."

Enforcing a policy to restrict the use of GitHub Actions in your enterprise

Enterprise 内のすべての Organization に対して GitHub Actions を無効化するか、特定の Organization のみを許可するかを選択できます。 You can also limit the use of public actions , so that people can only use local actions that exist in your enterprise.

1. GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings（Enterpriseの設定）をクリックしてく� さい。

2. Enterpriseアカウントのサイドバーで、 Policies（ポリシー）をクリックしてく� さい。

3. Under " Policies", click Actions.

4. "Policies（ポリシー）"の下で、オプションを選択してく� さい。

   If you choose Allow select actions, actions within your enterprise are allowed, and there are additional options for allowing other specific actions. For more information, see "Allowing select actions to run."

   Note: To enable access to public actions, you must first configure GitHub Enterprise Serverインスタンス to connect to GitHub.com. 詳しい情� �については「GitHub Connectを使用したGitHub.comのアクションへの自動アクセスの有効化」を参照してく� さい。

   

5. [Save] をクリックします。

Allowing select actions to run

When you choose Allow select actions, local actions are allowed, and there are additional options for allowing other specific actions:

• Allow actions created by GitHub: You can allow all actions created by GitHub to be used by workflows. Actions created by GitHub are located in the actions and github organizations. For more information, see the actions and github organizations.

• Allow Marketplace actions by verified creators: This option is available if you have GitHub Connect enabled and configured with GitHub Actions. For more information, see "Enabling automatic access to GitHub.com actions using GitHub Connect." You can allow all GitHub Marketplace actions created by verified creators to be used by workflows. When GitHub has verified the creator of the action as a partner organization, the badge is displayed next to the action in GitHub Marketplace.

• Allow specified actions: You can restrict workflows to use actions in specific organizations and repositories.

  To restrict access to specific tags or commit SHAs of an action, use the same syntax used in the workflow to select the action.

  • For an action, the syntax is <OWNER>/<REPO>@<TAG OR SHA>. For example, use actions/javascript-action@v1.0.1 to select a tag or actions/javascript-action@172239021f7ba04fe7327647b213799853a9eb89 to select a SHA. For more information, see "Finding and customizing actions."

  You can use the * wildcard character to match patterns. For example, to allow all actions in organizations that start with space-org, you can specify space-org*/*. To allow all actions in repositories that start with octocat, you can use */octocat**@*. For more information about using the * wildcard, see "Workflow syntax for GitHub Actions."

This procedure demonstrates how to add specific actions to the allow list.

1. GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings（Enterpriseの設定）をクリックしてく� さい。

2. Enterpriseアカウントのサイドバーで、 Policies（ポリシー）をクリックしてく� さい。

3. Under " Policies", click Actions.

4. "Policies（ポリシー）"の下で、Allow select actionsを選択し、必要なアクションをリストに追� してく� さい。

   

Enforcing a policy for artifact and log retention in your enterprise

GitHub Actions can store artifact and log files. For more information, see "Downloading workflow artifacts."

デフォルトでは、ワークフローによって生成された成果物とログファイルは、90日間保持された後自動的に削除されます。 You can change this retention period to anywhere between 1 day or 400 days.

保持期間をカスタマイズした� �合、適用されるのは新しい成果物とログファイルに対してであり、既存のオブジェクトにさかのぼっては適用されません。 管理されたリポジトリ及びOrganizationについては、最大の保持期間は管理するOrganizationあるいはEnterpriseによって設定された上限を超えることはできません。

1. GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings（Enterpriseの設定）をクリックしてく� さい。

2. Enterpriseアカウントのサイドバーで、 Policies（ポリシー）をクリックしてく� さい。

3. Under " Policies", click Actions.

4. Under Artifact and log retention, enter a new value.

5. Save（保存）をクリックして、変更を適用してく� さい。

Enforcing a policy for fork pull requests in your enterprise

You can enforce policies to control how GitHub Actions behaves for GitHub Enterprise Serverインスタンス when members of your enterprise run workflows from forks.

Enforcing a policy for fork pull requests in private repositories

プライベートリポジトリのフォークの利用に依存しているなら、ユーザがどのようにpull_requestイベントの際にワークフローを実行できるかを制御するポリシーを設定できます。 Available to private and internal repositories only, you can configure these policy settings for your enterprise, organizations, or repositories.

If a policy is enabled for an enterprise, the policy can be selectively disabled in individual organizations or repositories. If a policy is disabled for an enterprise, individual organizations or repositories cannot enable it.

• Run workflows from fork pull requests（フォークのPull Requestからワークフローを実行） - 読み取りのみの権限を持ち、シークレットにはアクセスできないGITHUB_TOKENを使って、フォークのPull Requestからワークフローを実行することをユーザに許可します。
• Send write tokens to workflows from pull requests（Pull Requestから書き込みトークンをワークフローに送信） - 書き込み権限を持つGITHUB_TOKENの利用をフォークからのPull Requestに許可します。
• Send secrets to workflows from pull requests（Pull Requestからワークフローにシークレットを送信） - すべてのシークレットをPull Requestから利用可能にします。

1. GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings（Enterpriseの設定）をクリックしてく� さい。

2. Enterpriseアカウントのサイドバーで、 Policies（ポリシー）をクリックしてく� さい。

3. Under " Policies", click Actions.

4. Fork pull request workflows（Pull Requestワークフローのフォーク）の下で、オプションを選択してく� さい。 例:

5. Save（保存）をクリックして、設定を適用してく� さい。