This article assumes that you have planned and then started a trial of GitHub Advanced Security. For more information, see Planning a trial of GitHub Advanced Security.
The aim is to enable all the security features you want to trial quickly, as a starting point for deeper exploration. You should start getting results soon on the repositories in your trial enterprise and you can fine-tune the configuration later.
Step 1: Create an enterprise security configuration for your trial goals
When you planned your trial, you identified the features that you want to test and any enforcement needs. You should create one or more security configurations for your enterprise that enable these features and set any enforcement levels you require.
- In the top-right corner of GitHub, click your profile photo.
- Depending on your environment, click Your enterprise, or click Your enterprises then click your trial enterprise.
- Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Einstellungen.
- In the left sidebar, click Code security to display the security configurations page.
- Click New configuration to create a new configuration.
- Give the configuration a meaningful name and description.
- You will see that most features are already enabled. Review the features that are Not set and enable any that you want to trial, for example: "Automatic dependency submission."
- In the "Policy" area, set the "Use as default for newly created repositories" option as needed to define whether or not to apply the configuration to new repositories created in the enterprise.
- In the "Policy" area, notice that the "Enforce configuration" option is set to Enforce so that applying the configuration to a repository enforces all settings apart from any left as "Not set".
Tip
While you are testing GitHub Advanced Security, you may want to change this to Don't enforce to allow you to optimize repository settings as needed without modifying security configurations.
- When you have finished defining the configuration, click Save configuration.
The new enterprise security configuration is now available for use at the enterprise level and also within every organization in the enterprise.
Step 2: Apply your enterprise security configuration to repositories
You can apply an enterprise security configuration either at the enterprise level or at the organization level. The best option for you will depend on whether or not you want to apply the configuration to all repositories in the enterprise, or to a subset of repositories.
Note
Although GitHub Advanced Security is free of charge during trials, you will be charged for any actions minutes that you use. This includes actions minutes used by the default code scanning setup or by any other workflows you run.
- Enterprise-level application:
- Add an enterprise configuration to all repositories in the enterprise, or all repositories without an existing configuration in the enterprise.
- Organization-level application:
- Add an enterprise or an organization configuration to all repositories in the organization, or all repositories without an existing configuration in the organization.
- Add an enterprise or an organization configuration to a subset of repositories in the organization.
You may find it helpful to apply an enterprise security configuration to all repositories in your enterprise, and then work at the organization-level to select a subset of repositories and apply an alternative security configuration.
Enterprise-level application
- Open your trial enterprise.
- In the sidebar, click Settings and then Code security to display the security configurations page.
- For the configuration you want to apply, click Apply to and choose whether to apply the configuration to all repositories in the enterprise or just to the repositories without an existing security configuration.
Organization-level application
- Open an organization in your trial enterprise.
- Click the Settings tab to display the organization settings.
- In the sidebar, click Code security and then Configurations to display the security configurations page.
- Optionally, select the Apply to dropdown menu and click either All repositories, to apply any configuration to all repositories in the organization, or All repositories without configurations, to configure just the repositories in the organization without an existing security configuration.
- Optionally, in the "Apply configurations" section use the "Search repositories" field or Filter button to filter repositories. Then select one or more repositories and use the Apply configuration button to choose a configuration to apply to those repositories.
For more information, see Anwenden einer benutzerdefinierten Sicherheitskonfiguration.
Next steps
Now that you have enabled the security features you want to test, you are ready to look more deeply into how secret scanning and code scanning protect your code.