|
| 1 | +--- |
| 2 | +title: About enterprise-managed plugin standards for {% data variables.copilot.copilot_cli_short %} |
| 3 | +shortTitle: Enterprise plugin standards |
| 4 | +allowTitleToDifferFromFilename: true |
| 5 | +intro: 'Enterprise administrators can centrally define plugin policies for {% data variables.copilot.copilot_cli_short %}, ensuring consistent plugin availability across their enterprise.' |
| 6 | +versions: |
| 7 | + feature: copilot |
| 8 | +contentType: concepts |
| 9 | +category: |
| 10 | + - Learn about Copilot # Copilot discovery page |
| 11 | + - Learn about Copilot CLI # Copilot CLI bespoke page |
| 12 | +docsTeamMetrics: |
| 13 | + - copilot-cli |
| 14 | +--- |
| 15 | + |
| 16 | +> [!NOTE] This feature is in {% data variables.release-phases.public_preview %} and subject to change. |
| 17 | +
|
| 18 | +Enterprise-managed plugin standards allow administrators to **define and enforce policies for plugin availability** in {% data variables.copilot.copilot_cli_short %} across their enterprise. By configuring a `settings.json` file in the enterprise's `.github-private` repository, administrators can specify which plugin marketplaces are available to users and which plugins are automatically installed for all enterprise users. |
| 19 | + |
| 20 | +## How plugin standards work |
| 21 | + |
| 22 | +Enterprise plugin standards use a configuration file stored in your enterprise's `.github-private` repository. The configuration is defined in a `settings.json` file at the following path: `.github/copilot/settings.json`. |
| 23 | + |
| 24 | +For plugin standards, the file can define: |
| 25 | + |
| 26 | +* **Known marketplaces**. Plugin marketplaces that are available to users for browsing and installing plugins. |
| 27 | +* **Default-enabled plugins**. Specific plugins that are automatically installed for all enterprise users when they authenticate with the CLI. |
| 28 | + |
| 29 | +When a user signs in to {% data variables.copilot.copilot_cli_short %}, the client queries an API endpoint that reads the `settings.json` from the enterprise's `.github-private` repository. The policies defined in the file are then applied to the user's CLI session. |
| 30 | + |
| 31 | +## Why use enterprise-managed plugin standards |
| 32 | + |
| 33 | +Enterprise-managed plugin standards help administrators address several common challenges: |
| 34 | + |
| 35 | +* **Consistency across clients**. Ensure that all developers using {% data variables.copilot.copilot_cli_short %} with an enterprise-assigned {% data variables.product.prodname_copilot_short %} license have access to the same plugins and marketplaces. |
| 36 | +* **Centralized governance**. Manage plugin availability from a single configuration file, rather than relying on individual developers to install the correct plugins. |
| 37 | +* **Version-controlled policies**. Because the configuration lives in a Git repository, all changes to plugin standards are tracked, auditable, and reviewable through pull requests. |
| 38 | +* **Reduced onboarding friction**. New developers automatically receive the enterprise's standard plugins when they authenticate, without any manual setup. |
| 39 | + |
| 40 | +## Next step |
| 41 | + |
| 42 | +To configure enterprise plugin standards for {% data variables.copilot.copilot_cli_short %}, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-plugin-standards). |
0 commit comments