Manage plugins in Microsoft Copilot for Security

Important

Some information in this article relates to a prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Copilot for Security comes with many preinstalled plugins available for Microsoft security services and other commonly used services and websites that you can use. You also have the option of extending default capabilities by adding your own custom plugins.

Note

Microsoft will be processing and storing data from these plugins according to our Privacy and Data policies.

Watch the following video to learn more about plugins:

Manage plugins

To personalize the way Copilot for Security interacts with you, there are two ways you can change the plugins on your list:

Turn plugins on or off

You can select which plugins Copilot for Security uses as a data source by turning service toggles on or off.

  1. Select the Copilot for Security plugin icon.

  2. Select the plugin you'd like to use by turning the toggle on or off.

  • Microsoft plugins
    Copilot for Security uses the on-behalf-of authentication flow to provide access to other Microsoft services that your organization already has access to. If a plugin requires its own authentication setup though, the plugin determines the authentication instead of on-behalf-of. For more information, see Understand authentication.

    Screenshot that shows Turn on or off toggles for plugins.

Personalize plugin settings

You can personalize some Copilot for Security plugin experiences by configuring the plugin setting. For example, a user who wants the Microsoft Sentinel plugin to use a single workspace that they designate every time they prompt can use the settings to specify the workspace.

Currently these settings are available for the following plugin:

  • Microsoft Sentinel
  1. Select the Copilot for Security plugin icon.

  2. Select the gear icon beside Microsoft Sentinel.

    Screenshot that shows Personalize plugin settings.

  3. Provide setting details, then select Save.

Manage custom plugins

Owners must set the permissions for adding custom plugins before they can be accessed. By default, only owners can add and manage their own custom plugins. In addition, owners are able to specify who has the ability to add and manage custom plugins for everyone in their organization.

Plugins added by owners can be set to be available only to them or to anyone in the organization.

Plugins added by owners and set to be available to anyone in the organization can be accessed, turned on or off, and used by all Copilot for Security users. However, only owners can make modifications to the plugin.

For instructions on creating your own plugins, read Custom plugins.

Options for managing custom plugins

Owners have two options:

Screenshot of plugin control options.

  • Option 1: Who can add and manage their own custom plugins?

    • Owners only:

      When an owner sets this configuration value, only owners can add and manage custom plugins for themselves (user scope).

    • Owners and Contributors:

      When an owner sets this configuration value, owners and contributors can add and manage custom plugins for themselves (user scope). This option will enable the second permission, "Who can add and manage custom plugins for everyone in the organization?".

  • Option 2: Who can add and manage custom plugins for everyone in the organization?

    • Owners only:

      When an owner sets this configuration value, only owners can add and manage custom plugins for the organization (tenant scope).

    • Owners and Contributors:

      When an owner sets this configuration value, owners and contributors can add and manage custom plugins for the organization (tenant scope).

In this section, you're guided on the available configuration settings.

Specify who can add and manage plugins (for owners only)

To manage plugins as an owner:

  1. Select the home menu icon.

    Screenshot showing home menu.

  2. In Preferences, navigate to the Owner settings section.

  3. Specify your selection for who can add and manage their own custom plugins and who can add and manage custom plugins for everyone in the organization. Select Owners only or Contributors and Owners.

Add custom plugins

Adding custom plugins extends the capabilities of Copilot for Security.

Important

You must take precaution and ensure that plugins you create or make available in your organization adhere to responsible AI practices. For more information, see Microsoft AI principles.

You must also ensure that custom plugins you make available to your organization are fully vetted. It is good practice to vet custom plugins at a user level first, before making plugins available to the entire organization.

Note

This option is only available if an Owner has configured Copilot for Security to allow Owners and Contributors to add and manage custom plugins for everyone in the organization.

  1. Select the Copilot for Security plugin icon.

  2. In Manage plugins, scroll down to the Custom section.

    Screenshot of Custom section of plugin.

  3. Select, Add plugin.

  4. From the drop-down options, specify if you want to make the plugin available to just yourself or anyone in the organization. Then choose between adding a Copilot for Security plugin or an OpenAI plugin.

    Screenshot that shows adding a plugin as an owner.

    Note

    If you choose to make a plugin available to just yourself, a private tag is added to the plugin. If you choose the option of making it available to anyone in the organization, then the plugin will be available to all Copilot for Security users.

  5. Depending on the plugin you'd like to add, follow the corresponding steps:

    1. Select Copilot for Security plugin.

    2. You can choose to upload a file or upload as a link.

      • To upload a file:

        1. Select the Upload file section.
        2. Select the file to upload, then select Add.
      • To upload a link:

        1. Turn on Upload as a link toggle.
        2. Paste a link to a .yaml or .json file.
        3. Specify the file type.
        4. Select Add.
  6. After the plugin is successfully added, some plugins might need to be set up. You can also choose to set up the plugin later.

  7. Provide the appropriate values for the settings fields, then select Setup.

    After completing the setup steps, your plugin will be visible in the Custom section. You can turn the toggle on or off.

Note

You'll need to complete the setup steps for the plugin to be available for use and appear in the Custom section.

Update custom plugin information

Depending on how owners manage custom plugins, you may be able to update your own custom plugins.

Custom plugins created by owners aren't editable by contributors.

If you need to make changes to the plugin that you added, you can edit the plugin file.

  1. Select the Copilot for Security plugin icon.

  2. In the Custom section, select the gear icon beside the plugin that you want to update.

  3. Select Edit file and make the appropriate updates.

  4. Select Save and confirm that you want to proceed.

Delete added plugins

Depending on how owners manage custom plugins, you may be able to delete custom plugins you added.

  1. Select the Copilot for Security plugin icon.

  2. In the Custom section, select the gear icon beside the plugin that you want to delete.

  3. Select Delete and confirm that you want to proceed.