Azure Web Application Firewall integration in Copilot for Security (preview)
Important
Azure Web Application Firewall integration in Microsoft Copilot for Security is currently in PREVIEW. See the Supplemental Terms of Use for Microsoft Azure Previews for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
Microsoft Copilot for Security is a cloud-based AI platform that provides natural language copilot experience. It can help support security professionals in different scenarios, like incident response, threat hunting, and intelligence gathering. For more information, see What is Microsoft Copilot for Security?
Azure Web Application Firewall (WAF) integration in Copilot for Security enables deep investigation of Azure WAF events. It can help you investigate WAF logs triggered by Azure WAF in a matter of minutes and provide related attack vectors using natural language responses at machine speed. It provides visibility into your environment’s threat landscape. It allows you to retrieve a list of most frequently triggered WAF rules and identify the top offending IPaddresses in your environment.
Copilot for Security integration is supported on both Azure WAF integrated with Azure Application Gateway and Azure WAF integrated with Azure Front Door.
Know before you begin
If you're new to Copilot for Security, you should familiarize yourself with it by reading these articles:
- What is Microsoft Copilot for Security?
- Microsoft Copilot for Security experiences
- Get started with Microsoft Copilot for Security
- Understand authentication in Microsoft Copilot for Security
- Prompting in Microsoft Copilot for Security
Azure WAF integration in Copilot for Security
This integration supports the standalone experience and is accessed through https://securitycopilot.microsoft.com. This is a chat-like experience that you can use to ask questions and get answers about your data. For more information, see Microsoft Copilot for Security experiences.
Features in the standalone experience
The preview standalone experience in Azure WAF can help you with:
Providing a list of top Azure WAF rules triggered in the customer environment and generating deep context with related attack vectors.
This capability provides details about Azure WAF rules that are triggered due to a WAF block. It provides an ordered list of rules based on trigger frequency in the desired time period. It does this by analyzing Azure WAF logs and connecting related logs over a specific time period. The result is an easy-to-understand natural language explanation of why a particular request was blocked.
Providing a list of malicious IP addresses in the customer environment and generating related threats.
This capability provides details about client IP addresses blocked by the Azure WAF. It does this by analyzing Azure WAF logs and connecting related logs over a specific time period. The result is an easy-to-understand natural language explanation of which IP addresses the WAF blocked and the reason for the blocks.
Summarizing SQL injection(SQLi) attacks.
This Azure WAF skill provides you with insights into why it blocks SQL injection (SQLi) attacks on web applications. It does this by analyzing Azure WAF logs and connecting related logs over a specific time period. The result is an easy-to-understand natural language explanation of why a SQLi request was blocked.
Summarizing Cross-site scripting(XSS) attacks.
This Azure WAF skill helps you understand why Azure WAF blocked Cross Site Scripting(XSS) attacks to web applications. It does this by analyzing Azure WAF logs and connecting related logs over a specific time period. The result is an easy-to-understand natural language explanation of why an XSS request was blocked.
Enable the Azure WAF integration in Microsoft Copilot for Security
To enable the integration, follow these steps:
- Ensure that you have at least Copilot contributor permissions.
- Open https://securitycopilot.microsoft.com/.
- Open the Microsoft Copilot for Security menu.
- Open Sources in the prompt bar.
- On the Plugins page, set the Azure Web Application Firewall toggle to On.
- Select the Settings on the Azure Web Application Firewall plugin to configure the Log Analytics workspace, Log Analytics subscription ID, and the Log Analytics resource group name for Azure Front Door WAF and/or the Azure Application Gateway WAF. You can also configure the Application Gateway WAF policy URI and/or Azure Front Door WAF policy URI.
- To start using the skills, use the prompt bar.
Sample prompts
You can create your own prompts in Copilot for Security to perform analysis on the attacks based on WAF logs. This section shows some ideas and examples.
Before you begin
Be clear and specific with your prompts. You might get better results if you include specific device IDs/names, app names, or policy names in your prompts.
It might also help to add WAF to your prompt. For example:
- Was there any SQL injection attack in my regional WAF in the last day?
- Tell me more about the top rules triggered in my global WAF
Experiment with different prompts and variations to see what works best for your use case. Chat AI models vary, so iterate and refine your prompts based on the results you receive For guidance on writing effective prompts, see Creating your own prompts.
The following example prompts might be helpful.
Summarize information about SQL injection attacks
- Was there a SQL injection attack in my global WAF in the last day?
- Show me IP addresses related to the top SQL injection attack in my global WAF
- Show me all SQL injection attacks in regional WAF in the last 24 hours
Summarize information about cross-site scripting attacks
- Was any XSS attack detected in my AppGW WAF in the last 12 hours?
- Show me list of all XSS attacks in my Azure Front Door WAF
Generate a list of threats in my environment based on WAF rules
- What were the top global WAF rules triggered in the last 24 hours?
- What are top threats related to the WAF Rule in my environment? <enter rule ID>
- Was there any bot attack in my regional WAF in the last day?
- Summarize custom rule blocks triggered by Azure Front Door WAF in the last day.
Generate a list of threats in my environment based on malicious IP addresses
- What was the top offending IP in regional WAF in the last day?
- Summarize list of malicious IP addresses in my Azure Front Door WAF in the last six hours?
Provide feedback
Your feedback on the Azure WAF integration with Copilot for Security helps with development. To provide feedback in Copilot, select How’s this response? At the bottom of each completed prompt and choose any of the following options:
- Looks right - Select if the results are accurate, based on your assessment.
- Needs improvement - Select if any detail in the results is incorrect or incomplete, based on your assessment.
- Inappropriate - Select if the results contain questionable, ambiguous, or potentially harmful information.
For each feedback item, you can provide more information in the next dialog box that appears. Whenever possible, and when the result is Needs improvement, write a few words explaining what can be done to improve the outcome.
Limitation
If you've migrated to Azure Log Analytics dedicated tables in the Application Gateway WAF V2 version, the Copilot for Security WAF Skills aren't functional. As a temporary workaround, enable Azure Diagnostics as the destination table in addition to the resource-specific table.
Privacy and data security in Microsoft Copilot for Security
To understand how Microsoft Copilot for Security handles your prompts and the data that’s retrieved from the service(prompt output), see Privacy and data security in Microsoft Copilot for Security.
Related content
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for