Skip to content

Commit 7e6afae

Browse files
committed
Add screenshots and permissions details.
1 parent 6cd2854 commit 7e6afae

File tree

9 files changed

+31
-17
lines changed

9 files changed

+31
-17
lines changed

articles/iot-central/core/howto-faq.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -174,4 +174,8 @@ sections:
174174
What are the differences between monitoring an IoT Central application in the Azure portal and using the audit logs within in IoT Central application.
175175
answer: |
176176
Monitoring in the Azure portal is useful for operations monitoring. The audit log in an IoT Central application lets you see who made changes to entities within the the application.
177+
- question: |
178+
Can I extend the audit log to store more than 30 days of data?
179+
answer: |
180+
Currently, you can't store more tha 30 days of data in the audit log. Entries older than 30 days are deleted automatically.
177181

articles/iot-central/core/howto-manage-users-roles.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Manage users and roles in Azure IoT Central application | Microsoft Docs
33
description: As an administrator, how to manage users and roles in your Azure IoT Central application
44
author: dominicbetts
55
ms.author: dobett
6-
ms.date: 06/22/2022
6+
ms.date: 08/01/2022
77
ms.topic: how-to
88
ms.service: iot-central
99
services: iot-central
@@ -218,6 +218,16 @@ When you define a custom role, you choose the set of permissions that a user is
218218
| Manage | None |
219219
| Full Control | Manage |
220220

221+
**Audit log permissions**
222+
223+
| Name | Dependencies |
224+
| ---- | -------- |
225+
| View | None |
226+
| Full Control | View |
227+
228+
> [!CAUTION]
229+
> Any user granted permission to view the audit log can see all log entries even if they don't have permission to view or modify the entities listed in the log. Therefore, any user who can view the log can view the identity of and changes made to any modified entity.
230+
221231
#### Managing users and roles
222232

223233
**Custom roles permissions**

articles/iot-central/core/howto-use-audit-logs.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -36,42 +36,42 @@ The log records changes to the following IoT Central entities:
3636

3737
The log records changes made by the following types of user:
3838

39-
- IoT Central user - the log shows the users email.
39+
- IoT Central user - the log shows the user's email.
4040
- API token - the log shows the token name.
41-
- Azure Active Directory user - the log shows the user email or Id.
41+
- Azure Active Directory user - the log shows the user email or ID.
4242
- Service principal - the log shows the service principal name.
4343

4444
The log stores data for 30 days, after which it's no longer available.
4545

4646
The following screenshot shows the audit log view with the location of the sorting and filtering controls highlighted:
4747

48-
<!-- TODO: Add a screenshot -->
48+
:::image type="content" source="media/howto-use-audit-logs/audit-log.png" alt-text="Screenshot that shows the audit log. The location of the sort and filter controls is highlighted.":::
49+
50+
## Customize the log
51+
52+
Select **Column options** to customize the audit log view. You can add and remove columns, reorder the columns, and change the column widths:
53+
54+
:::image type="content" source="media/howto-use-audit-logs/audit-logs-column-options.png" alt-text="Screenshot that shows the audit log column options.":::
4955

5056
## Sort the log
5157

5258
You can sort the log into ascending or descending timestamp order. To sort, select **Timestamp**:
5359

54-
<!-- TODO: Add a screenshot -->
60+
:::image type="content" source="media/howto-use-audit-logs/audit-logs-sorting.png" alt-text="Screenshot that shows how to sort the log into descending timestamp order.":::
5561

5662
## Filter the log
5763

5864
To focus on a specific time, filter the log by time range. Select **Edit time range** and specify the range you're interested in:
5965

60-
<!-- TODO: Add a screenshot -->
66+
:::image type="content" source="media/howto-use-audit-logs/audit-logs-time.png" alt-text="Screenshot that shows how filter the log to show the last hour of entries.":::
6167

6268
To focus on specific entries, filter by entity type or action. Select **Filter** and use the multi-select drop-downs to specify your filter conditions:
6369

64-
<!-- TODO: Add a screenshot -->
65-
66-
## Customize the log
67-
68-
Select **Column options** to customize the audit log view. You can add and remove columns, reorder the columns, and change the column widths:
69-
70-
<!-- TODO: Add a screenshot -->
70+
:::image type="content" source="media/howto-use-audit-logs/audit-logs-filter.png" alt-text="Screenshot that shows how filter the log to show only updates to user entities.":::
7171

7272
## Manage access
7373

74-
The built-in **App Administrator** role has access to the audit logs by default. The administrator can grant access to other roles, To learn more, see [Manage users and roles in your IoT Central application](howto-manage-users-roles.md).
74+
The built-in **App Administrator** role has access to the audit logs by default. The administrator can grant access to other roles. An administrator can assign either **Full control** or **View** audit log permissions to other roles. To learn more, see [Manage users and roles in your IoT Central application](howto-manage-users-roles.md).
7575

7676
> [!IMPORTANT]
7777
> Any user granted permission to view the audit log can see all log entries even if they don't have permission to view or modify the entities listed in the log. Therefore, any user who can view the log can view the identity of and changes made to any modified entity.
43.3 KB
Loading
55.6 KB
Loading
56.9 KB
Loading
47.2 KB
Loading
66.7 KB
Loading

articles/iot-central/core/overview-iot-central-admin.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -86,13 +86,13 @@ An administrator can:
8686

8787
To learn more, see [Create and use a custom application template](howto-create-iot-central-application.md#create-and-use-a-custom-application-template).
8888

89-
## Integrate with DevOps pipelines
89+
## Integrate with Azure Pipelines
9090

91-
Continuous integration and continuous delivery (CI/CD) refers to the process of developing and delivering software in short, frequent cycles using automation pipelines. You can use Azure DevOps pipelines to automate the build, test, and deployment of IoT Central application configurations.
91+
Continuous integration and continuous delivery (CI/CD) refers to the process of developing and delivering software in short, frequent cycles using automation pipelines. You can use Azure Pipelines to automate the build, test, and deployment of IoT Central application configurations.
9292

9393
Just as IoT Central is a part of your larger IoT solution, make IoT Central a part of your CI/CD pipeline.
9494

95-
To learn more, see [Integrate IoT Central into your Azure DevOps CI/CD pipeline](howto-integrate-with-devops.md).
95+
To learn more, see [Integrate IoT Central into your Azure CI/CD pipeline](howto-integrate-with-devops.md).
9696

9797
## Monitor application health
9898

0 commit comments

Comments
 (0)