You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/sentinel/data-connectors/github-using-webhooks-using-azure-function.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ ms.author: cwatson
12
12
13
13
The [GitHub](https://www.github.com) webhook data connector provides the capability to ingest GitHub subscribed events into Microsoft Sentinel using [GitHub webhook events](https://docs.github.com/en/developers/webhooks-and-events/webhooks/webhook-events-and-payloads). The connector provides ability to get events into Sentinel which helps to examine potential security risks, analyze your team's use of collaboration, diagnose configuration problems and more.
14
14
15
-
**Note:** If you are intended to ingest Github Audit logs, Please refer to GitHub Enterprise Audit Log Connector from "**Data Connectors**" gallery.
15
+
**Note:** If you are intended to ingest GitHub Audit logs, Please refer to GitHub Enterprise Audit Log Connector from "**Data Connectors**" gallery.
16
16
17
17
## Connector attributes
18
18
@@ -38,7 +38,7 @@ githubscanaudit_CL
38
38
39
39
To integrate with GitHub (using Webhooks) (using Azure Function) make sure you have:
40
40
41
-
-**Microsoft.Web/sites permissions**: Read and write permissions to Azure Functions to create a Function App is required. [See the documentation to learn more about Azure Functions](https://learn.microsoft.com/azure/azure-functions/).
41
+
-**Microsoft.Web/sites permissions**: Read and write permissions to Azure Functions to create a Function App is required. [See the documentation to learn more about Azure Functions](/azure/azure-functions/).
42
42
43
43
44
44
## Vendor installation instructions
@@ -48,12 +48,12 @@ To integrate with GitHub (using Webhooks) (using Azure Function) make sure you h
48
48
> This connector has been built on http trigger based Azure Function. And it provides an endpoint to which github will be connected through it's webhook capability and posts the subscribed events into Microsoft Sentinel. This might result in additional data ingestion costs. Check the [Azure Functions pricing page](https://azure.microsoft.com/pricing/details/functions/) for details.
49
49
50
50
51
-
>**(Optional Step)** Securely store workspace and API authorization key(s) or token(s) in Azure Key Vault. Azure Key Vault provides a secure mechanism to store and retrieve key values. [Follow these instructions](https://learn.microsoft.com/azure/app-service/app-service-key-vault-references) to use Azure Key Vault with an Azure Function App.
51
+
>**(Optional Step)** Securely store workspace and API authorization key(s) or token(s) in Azure Key Vault. Azure Key Vault provides a secure mechanism to store and retrieve key values. [Follow these instructions](/azure/app-service/app-service-key-vault-references) to use Azure Key Vault with an Azure Function App.
52
52
53
53
54
54
**Choose ONE from the following two deployment options to deploy the connector and the associated Azure Function**
55
55
56
-
>**IMPORTANT:** Before deploying the Github Webhook connector, have the Workspace ID and Workspace Primary Key (can be copied from the following).
56
+
>**IMPORTANT:** Before deploying the GitHub Webhook connector, have the Workspace ID and Workspace Primary Key (can be copied from the following).
57
57
58
58
59
59
@@ -78,7 +78,7 @@ Use the following step-by-step instructions to deploy the GitHub webhook data co
78
78
79
79
**1. Deploy a Function App**
80
80
81
-
> **NOTE:** You will need to [prepare VS code](https://learn.microsoft.com/azure/azure-functions/functions-create-first-function-python#prerequisites) for Azure function development.
81
+
> **NOTE:** You will need to [prepare VS code](/azure/azure-functions/functions-create-first-function-python#prerequisites) for Azure function development.
82
82
83
83
1. Download the [Azure Function App](https://aka.ms/sentinel-GitHubWebhookAPI-functionapp) file. Extract archive to your local development computer.
84
84
2. Start VS Code. Choose File in the main menu and select Open Folder.
@@ -127,7 +127,7 @@ If you're already signed in, go to the next step.
127
127
3. Go to "GetFunctionurl" and copy the function url.
128
128
129
129
130
-
**STEP 2 - Configure Webhook to Github Organization**
130
+
**STEP 2 - Configure Webhook to GitHub Organization**
131
131
132
132
1. Go to [GitHub](https://www.github.com) and open your account and click on "Your Organizations."
133
133
2. Click on Settings.
@@ -136,7 +136,7 @@ If you're already signed in, go to the next step.
136
136
5. Subscribe for events and Click on "Add Webhook"
137
137
138
138
139
-
*Now we are done with the github Webhook configuration. Once the github events triggered and after the delay of 20 to 30 mins (As there will be a dealy for LogAnalytics to spin up the resources for the first time), you should be able to see all the transactional events from the Github into LogAnalytics workspace table called "githubscanaudit_CL".*
139
+
*Now we are done with the github Webhook configuration. Once the github events triggered and after the delay of 20 to 30 mins (As there will be a dealy for LogAnalytics to spin up the resources for the first time), you should be able to see all the transactional events from the GitHub into LogAnalytics workspace table called "githubscanaudit_CL".*
140
140
141
141
For more details, Click [here](https://aka.ms/sentinel-gitHubwebhooksteps)
0 commit comments