Skip to content

Commit f09993a

Browse files
lecoursengithub-actionssubatoi
authored
Update screenshots in the images/azure directory (github#34520)
Co-authored-by: github-actions <[email protected]> Co-authored-by: Ben Ahmady <[email protected]>
1 parent 79bb4f1 commit f09993a

File tree

11 files changed

+34
-47
lines changed

11 files changed

+34
-47
lines changed
-74 Bytes
Loading
Loading
-13.5 KB
Binary file not shown.
-73.7 KB
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

content/admin/configuration/configuring-your-enterprise/deploying-github-ae.md

+3-5
Original file line numberDiff line numberDiff line change
@@ -27,12 +27,11 @@ You must have permission to perform the `/register/action` operation for the res
2727
The {% data variables.actions.azure_portal %} allows you to deploy the {% data variables.product.product_name %} account in your Azure resource group.
2828

2929
1. Click one of the following two links to begin deployment of {% data variables.product.product_name %}. The link you should click depends on the Azure cloud where you plan to deploy {% data variables.product.product_name %}. For more information about Azure Government, see [What is Azure Government?](https://docs.microsoft.com/en-us/azure/azure-government/documentation-government-welcome) in the Microsoft documentation.
30-
30+
3131
- [Deploy {% data variables.product.product_name %} to Azure Commercial](https://aka.ms/create-github-ae-instance)
3232
- [Deploy {% data variables.product.product_name %} to Azure Government](https://aka.ms/create-github-ae-instance-gov)
3333
1. To begin the process of adding a new {% data variables.product.product_name %} account, click **Create GitHub AE account**.
3434
1. Complete the "Project details" and "Instance details" fields.
35-
![{% data variables.actions.azure_portal %} search result](/assets/images/azure/github-ae-azure-portal-form.png)
3635
- **Account name:** The hostname for your enterprise
3736
- **Administrator username:** A username for the initial enterprise owner that will be created in {% data variables.product.product_name %}
3837
- **Administrator email:** The email address that will receive the login information
@@ -53,14 +52,13 @@ You can use the {% data variables.actions.azure_portal %} to navigate to your {%
5352

5453
1. On the {% data variables.actions.azure_portal %}, in the left panel, click **All resources**.
5554
1. From the available filters, click **All types**, then deselect **Select all** and select **GitHub AE**:
56-
![{% data variables.actions.azure_portal %} search result](/assets/images/azure/github-ae-azure-portal-type-filter.png)
5755

5856
## Next steps
5957

6058
- Once your deployment has been provisioned, the next step is to initialize {% data variables.product.product_name %}. For more information, see "[Initializing {% data variables.product.product_name %}](/github-ae@latest/admin/configuration/configuring-your-enterprise/initializing-github-ae)."
6159
- If you're trying {% data variables.product.product_name %}, you can upgrade to a full license at any time during the trial period by contacting contact {% data variables.contact.contact_enterprise_sales %}. If you haven't upgraded by the last day of your trial, then the deployment is automatically deleted. If you need more time to evaluate {% data variables.product.product_name %}, contact {% data variables.contact.contact_enterprise_sales %} to request an extension.
6260

63-
## Further reading
61+
## Further reading
6462

6563
- "[Enabling {% data variables.product.prodname_advanced_security %} features on {% data variables.product.product_name %}](/github/getting-started-with-github/about-github-advanced-security#enabling-advanced-security-features-on-github-ae)"
66-
- "[{% data variables.product.product_name %} release notes](/github-ae@latest/admin/overview/github-ae-release-notes)"
64+
- "[{% data variables.product.product_name %} release notes](/github-ae@latest/admin/overview/github-ae-release-notes)"

content/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -55,10 +55,10 @@ To configure {% data variables.product.prodname_ghe_server %} to use OIDC with a
5555
1. Register a new application in Azure Active Directory. For more information, see [Register an application](https://learn.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app#register-an-application) in the Azure documentation.
5656
1. In your Azure application, under "Essentials", take note of the values for "Application (client) ID" and "Directory (tenant) ID". These values are used later.
5757

58-
![Azure portal showing the Active Directory app "Essentials" section](/assets/images/azure/azure-aad-app-storage-ids.png)
58+
![Screenshot of the "Overview" page in Azure. The first four items in the "Essentials" section are highlighted with an orange outline.](/assets/images/azure/azure-aad-app-storage-ids.png)
5959
1. In your Azure application, under "Manage", click **Certificates & secrets**, select the **Federated credentials** tab, then click **Add credential**.
6060

61-
![Azure portal showing the Active Directory app "certificates & secrets" page](/assets/images/azure/azure-federated-credential.png)
61+
![Screenshot of the "Federated credentials" page in Azure. The "Certificates & secrets" tab, the "Federated credentials" tab, and the "Add credential" button are highlighted with orange outlines.](/assets/images/azure/azure-federated-credential.png)
6262
1. Enter the following details for the credential:
6363
1. For "Federated credential scenario", select **Other issuer**.
6464
1. For "Issuer", enter `https://HOSTNAME/_services/token`, where `HOSTNAME` is the public hostname for {% data variables.location.product_location_enterprise %}. For example, `https://my-ghes-host.example.com/_services/token`.

content/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/streaming-the-audit-log-for-your-enterprise.md

+29-40
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ You can set up streaming to S3 with access keys or, to avoid storing long-lived
6868
#### Setting up streaming to S3 with access keys
6969
{% endif %}
7070

71-
To stream audit logs to Amazon's S3 endpoint, you must have a bucket and access keys. For more information, see [Creating, configuring, and working with Amazon S3 buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) in the AWS documentation. Make sure to block public access to the bucket to protect your audit log information.
71+
To stream audit logs to Amazon's S3 endpoint, you must have a bucket and access keys. For more information, see [Creating, configuring, and working with Amazon S3 buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) in the AWS documentation. Make sure to block public access to the bucket to protect your audit log information.
7272

7373
To set up audit log streaming from {% data variables.product.prodname_dotcom %} you will need:
7474
* The name of your Amazon S3 bucket
@@ -117,7 +117,7 @@ For information on creating or accessing your access key ID and secret key, see
117117
```
118118
For more information, see [Creating IAM policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) in the AWS documentation.
119119
1. Configure the role and trust policy for the {% data variables.product.prodname_dotcom %} IdP. For more information, see [Creating a role for web identity or OpenID Connect Federation (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html) in the AWS documentation.
120-
120+
121121
- Add the permissions policy you created above to allow writes to the bucket.
122122
- Edit the trust relationship to add the `sub` field to the validation conditions, replacing `ENTERPRISE` with the name of your enterprise.
123123
```
@@ -154,84 +154,73 @@ You can consolidate your audit logs from {% data variables.product.product_name
154154
155155
### Setting up streaming to Azure Blob Storage
156156
157-
Before setting up a stream in {% data variables.product.prodname_dotcom %}, you must first have created a storage account and a container in Microsoft Azure. For details, see the Microsoft documentation, "[Introduction to Azure Blob Storage](https://docs.microsoft.com/en-us/azure/storage/blobs/storage-blobs-introduction)."
157+
Before setting up a stream in {% data variables.product.prodname_dotcom %}, you must first have created a storage account and a container in Microsoft Azure. For details, see the Microsoft documentation, "[Introduction to Azure Blob Storage](https://docs.microsoft.com/en-us/azure/storage/blobs/storage-blobs-introduction)."
158158
159159
To configure the stream in {% data variables.product.prodname_dotcom %} you need the URL of a SAS token.
160160
161161
**On Microsoft Azure portal**:
162162
1. On the Home page, click **Storage Accounts**.
163-
2. Click the name of the storage account you want to use, then click **Containers**.
164-
165-
![The Containers link in Azure](/assets/images/azure/azure-storage-containers.png)
166-
163+
1. Under "Name", click the name of the storage account you want to use.
164+
1. Under "Data storage", click **Containers**.
167165
1. Click the name of the container you want to use.
168-
1. Click **Shared access tokens**.
169-
170-
![The shared access token link in Azure](/assets/images/azure/azure-storage-shared-access-tokens.png)
171-
172-
1. In the **Permissions** drop-down menu, change the permissions to only allow `Create` and `Write`.
173-
174-
![The permissions drop-down menu](/assets/images/azure/azure-storage-permissions.png)
175-
166+
1. In the left sidebar, under "Settings", click **Shared access tokens**.
167+
1. Select the **Permissions** dropdown menu, then select `Create` and `Write` and deselect all other options.
176168
1. Set an expiry date that complies with your secret rotation policy.
177169
1. Click **Generate SAS token and URL**.
178170
1. Copy the value of the **Blob SAS URL** field that's displayed. You will use this URL in {% data variables.product.prodname_dotcom %}.
179171
180172
**On {% data variables.product.prodname_dotcom %}**:
181173
{% data reusables.enterprise.navigate-to-log-streaming-tab %}
182174
1. Click **Configure stream** and select **Azure Blob Storage**.
183-
175+
184176
![Choose Azure Blob Storage from the drop-down menu](/assets/images/help/enterprises/audit-stream-choice-azureblob.png)
185177
186178
1. On the configuration page, enter the blob SAS URL that you copied in Azure. The **Container** field is auto-filled based on the URL.
187179
188180
![Enter the stream settings](/assets/images/help/enterprises/audit-stream-add-azureblob.png)
189-
181+
190182
1. Click **Check endpoint** to verify that {% data variables.product.prodname_dotcom %} can connect and write to the Azure Blob Storage endpoint.
191-
183+
192184
![Check the endpoint](/assets/images/help/enterprises/audit-stream-check.png)
193185
194186
{% data reusables.enterprise.verify-audit-log-streaming-endpoint %}
195187
196188
### Setting up streaming to Azure Event Hubs
197189
198-
Before setting up a stream in {% data variables.product.prodname_dotcom %}, you must first have an event hub namespace in Microsoft Azure. Next, you must create an event hub instance within the namespace. You'll need the details of this event hub instance when you set up the stream. For details, see the Microsoft documentation, "[Quickstart: Create an event hub using Azure portal](https://docs.microsoft.com/en-us/azure/event-hubs/event-hubs-create)."
190+
Before setting up a stream in {% data variables.product.prodname_dotcom %}, you must first have an event hub namespace in Microsoft Azure. Next, you must create an event hub instance within the namespace. You'll need the details of this event hub instance when you set up the stream. For details, see the Microsoft documentation, "[Quickstart: Create an event hub using Azure portal](https://docs.microsoft.com/en-us/azure/event-hubs/event-hubs-create)."
199191
200-
You need two pieces of information about your event hub: its instance name and the connection string.
192+
You need two pieces of information about your event hub: its instance name and the connection string.
201193
202194
**On Microsoft Azure portal**:
203-
1. Search for "Event Hubs".
204-
205-
![The Azure portal search box](/assets/images/azure/azure-resources-search.png )
195+
1. At the top of the page, next to "Microsoft Azure", use the search box to search for "Event Hubs".
196+
1. Select **Event Hubs**. The names of your event hubs are listed.
206197
207-
1. Select **Event Hubs**. The names of your event hubs are listed.
208-
209198
![A list of event hubs](/assets/images/help/enterprises/azure-event-hubs-list.png)
210199
211200
1. Make a note of the name of the event hub you want to stream to.
212201
1. Click the required event hub. Then, in the left menu, select **Shared Access Policies**.
213202
1. Select a shared access policy in the list of policies, or create a new policy.
214-
203+
215204
![A list of shared access policies](/assets/images/help/enterprises/azure-shared-access-policies.png)
216205
217206
1. Click the button to the right of the **Connection string-primary key** field to copy the connection string.
218-
207+
219208
![The event hub connection string](/assets/images/help/enterprises/azure-connection-string.png)
220209
221210
**On {% data variables.product.prodname_dotcom %}**:
222211
{% data reusables.enterprise.navigate-to-log-streaming-tab %}
223212
1. Click **Configure stream** and select **Azure Event Hubs**.
224-
213+
225214
![Choose Azure Events Hub from the drop-down menu](/assets/images/help/enterprises/audit-stream-choice-azure.png)
226215
227216
1. On the configuration page, enter:
228217
* The name of the Azure Event Hubs instance.
229218
* The connection string.
230-
219+
231220
![Enter the stream settings](/assets/images/help/enterprises/audit-stream-add-azure.png)
232-
221+
233222
1. Click **Check endpoint** to verify that {% data variables.product.prodname_dotcom %} can connect and write to the Azure Events Hub endpoint.
234-
223+
235224
![Check the endpoint](/assets/images/help/enterprises/audit-stream-check.png)
236225
237226
{% data reusables.enterprise.verify-audit-log-streaming-endpoint %}
@@ -247,7 +236,7 @@ After you set up streaming to Datadog, you can see your audit log data by filter
247236
1. In Datadog, generate a client token or an API key, then click **Copy key**. For more information, see [API and Application Keys](https://docs.datadoghq.com/account_management/api-app-keys/) in Datadog Docs.
248237
{% data reusables.enterprise.navigate-to-log-streaming-tab %}
249238
1. Select the **Configure stream** dropdown menu and click **Datadog**.
250-
239+
251240
![Screenshot of the "Configure stream" dropdown menu with "Datadog" highlighted](/assets/images/help/enterprises/audit-stream-choice-datadog.png)
252241
1. Under "Token", paste the token you copied earlier.
253242
@@ -256,7 +245,7 @@ After you set up streaming to Datadog, you can see your audit log data by filter
256245
257246
![Screenshot of the "Site" dropdown menu](/assets/images/help/enterprises/audit-stream-datadog-site.png)
258247
1. To verify that {% data variables.product.prodname_dotcom %} can connect and write to the Datadog endpoint, click **Check endpoint**.
259-
248+
260249
![Check the endpoint](/assets/images/help/enterprises/audit-stream-check.png)
261250
{% data reusables.enterprise.verify-audit-log-streaming-endpoint %}
262251
1. After a few minutes, confirm that audit log data is appearing on the **Logs** tab in Datadog. If audit log data is not appearing, confirm that your token and site are correct in {% data variables.product.prodname_dotcom %}.
@@ -283,7 +272,7 @@ To set up streaming to Google Cloud Storage, you must create a service account i
283272
284273
![Screenshot of the "JSON Credentials" text field](/assets/images/help/enterprises/audit-stream-json-credentials-google-cloud-storage.png)
285274
286-
1. To verify that {% data variables.product.prodname_dotcom %} can connect and write to the Google Cloud Storage bucket, click **Check endpoint**.
275+
1. To verify that {% data variables.product.prodname_dotcom %} can connect and write to the Google Cloud Storage bucket, click **Check endpoint**.
287276
288277
![Screenshot of the "Check endpoint" button](/assets/images/help/enterprises/audit-stream-check-endpoint-google-cloud-storage.png)
289278
@@ -295,20 +284,20 @@ To stream audit logs to Splunk's HTTP Event Collector (HEC) endpoint you must ma
295284
296285
{% data reusables.enterprise.navigate-to-log-streaming-tab %}
297286
1. Click **Configure stream** and select **Splunk**.
298-
287+
299288
![Choose Splunk from the drop-down menu](/assets/images/help/enterprises/audit-stream-choice-splunk.png)
300289
301290
1. On the configuration page, enter:
302291
* The domain on which the application you want to stream to is hosted.
303-
304-
If you are using Splunk Cloud, `Domain` should be `http-inputs-<host>`, where `host` is the domain you use in Splunk Cloud. For example: `http-inputs-mycompany.splunkcloud.com`.
292+
293+
If you are using Splunk Cloud, `Domain` should be `http-inputs-<host>`, where `host` is the domain you use in Splunk Cloud. For example: `http-inputs-mycompany.splunkcloud.com`.
305294
306295
* The port on which the application accepts data.<br>
307296
308297
If you are using Splunk Cloud, `Port` should be `443` if you haven't changed the port configuration. If you are using the free trial version of Splunk Cloud, `Port` should be `8088`.
309298
310299
* A token that {% data variables.product.prodname_dotcom %} can use to authenticate to the third-party application.
311-
300+
312301
![Enter the stream settings](/assets/images/help/enterprises/audit-stream-add-splunk.png)
313302
314303
1. Leave the **Enable SSL verification** check box selected.
@@ -329,7 +318,7 @@ Datadog only accepts logs from up to 18 hours in the past. If you pause a stream
329318
330319
{% data reusables.enterprise.navigate-to-log-streaming-tab %}
331320
1. Click **Pause stream**.
332-
321+
333322
![Pause the stream](/assets/images/help/enterprises/audit-stream-pause.png)
334323
335324
1. A confirmation message is displayed. Click **Pause stream** to confirm.
@@ -341,7 +330,7 @@ When the application is ready to receive audit logs again, click **Resume stream
341330
342331
{% data reusables.enterprise.navigate-to-log-streaming-tab %}
343332
1. Click **Delete stream**.
344-
333+
345334
![Delete the stream](/assets/images/help/enterprises/audit-stream-delete.png)
346335
347336
1. A confirmation message is displayed. Click **Delete stream** to confirm.

0 commit comments

Comments
 (0)