Skip to content

Commit e1e2544

Browse files
Update how-to-change-report-server-iis-user.md (#203)
* Update how-to-change-report-server-iis-user.md * Update how-to-change-report-server-iis-user.md * Update how-to-change-report-server-iis-user.md * Update how-to-change-report-server-iis-user.md * Update how-to-change-report-server-iis-user.md * Update how-to-change-report-server-iis-user.md * Update how-to-change-report-server-iis-user.md
1 parent fe9d2fa commit e1e2544

File tree

1 file changed

+27
-25
lines changed

1 file changed

+27
-25
lines changed
Lines changed: 27 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: How to Create a Non-Privileged IIS User for Report Server and Service Agent
3-
description: This tutorial shows how to use a low-privileged user to host Report Server on IIS.
3+
description: "This tutorial shows how to use a low-privileged user to host the Report Server on IIS."
44
type: how-to
55
page_title: How to Run Report Server and Service Agent with Limited Permissions
66
slug: how-to-change-report-server-iis-user
@@ -13,60 +13,62 @@ res_type: kb
1313
| | |
1414
|---------|-----------------|
1515
| Product | Progress® Telerik® Report Server |
16-
| Version | 10.1.24.514 |
16+
| Version | 10.1.24.514+ |
1717

1818
## Description
1919

2020
This tutorial will show you how to change the Report Server's IIS application pool and service agent to use an identity with limited permissions.
2121

2222
## Solution
2323

24-
1. Create a new Windows user with limited permissions, for example `RSUser`.
24+
1. Create a new Windows user with limited permissions, for example, `RSUser`.
2525

26-
![](images/change-iis-user/1-add-new-user.png)
26+
![Adding new Windows user with limited permissions to the system.](images/change-iis-user/1-add-new-user.png)
2727

28-
For more help, see [Microsoft Docs - Manage User Accounts in Windows](https://support.microsoft.com/en-us/windows/manage-user-accounts-in-windows-104dc19f-6430-4b49-6a2b-e4dbd1dcdf32).
28+
For more help, see [Microsoft Docs - Manage User Accounts in Windows](https://support.microsoft.com/en-us/windows/manage-user-accounts-in-windows-104dc19f-6430-4b49-6a2b-e4dbd1dcdf32).
2929

3030
2. Go to Telerik Report Server's installation directory (`C:\Program Files (x86)\Progress\Telerik Report Server`) and give `RSUser` full access permissions to the `Telerik.ReportServer.Web` and `Services` sub-folders.
3131

32-
![](images/change-iis-user/2-add-permissions-to-rsuser.png)
32+
![Allowing full control for the Telerik.ReportServer.Web and Services sub-folders of the Report Server installation folder to the new user.](images/change-iis-user/2-add-permissions-to-rsuser.png)
3333

34-
- Ensure the user does not have read or write permissions to any other folders.
35-
- You can use any username you prefer, the `RSUser` recommended here applies the semantic naming practices.
36-
- For more help, see [Microsoft Q&A - How do I set up user account and manage permissions](https://learn.microsoft.com/en-us/answers/questions/1389054/how-do-i-set-up-user-accounts-and-manage-permissio).
34+
- Ensure the user does not have read or write permissions to any other folders.
35+
- You can use any username you prefer, the `RSUser` recommended here applies the semantic naming practices.
36+
- For more help, see [Microsoft Q&A - How do I set up user account and manage permissions](https://learn.microsoft.com/en-us/answers/questions/1389054/how-do-i-set-up-user-accounts-and-manage-permissio).
3737

3838
3. Open Internet Information Services (IIS) Manager by selecting `Windows Key` + `R` to open the Run window, and then enter `inetmgr`.
39-
4039
4. In the left column, expand the machine's node and select **Application Pools**. Right-click on the `TelerikReportServer` application pool and select **Advanced Settings** from the context menu.
4140

42-
![](images/change-iis-user/2.5-locate-application-pool.png)
41+
![Opening Advanced Settings of the TelerikReportServer Application Pool.](images/change-iis-user/2.5-locate-application-pool.png)
4342

44-
5. Select the **Identity** item and click the ellipsis button.
43+
5. Select the **Identity** item and click the ellipsis button.
4544

46-
![](images/change-iis-user/3-open-iis-apppool-advanced-settings.png)
45+
![Selecting the Application Pool Identity.](images/change-iis-user/3-open-iis-apppool-advanced-settings.png)
4746

48-
6. Select **Custom account**, click **Set…** and enter the name of the newly created user (for example, `RSUser`) and its password:
47+
6. Select **Custom account**, click **Set…**, and enter the name of the newly created user (for example, `RSUser`) and its password:
4948

50-
![](images/change-iis-user/4-set-iis-apppool-identity.png)
49+
![Changing the Application Pool Identity to Custom account and setting the credentials.](images/change-iis-user/4-set-iis-apppool-identity.png)
5150

5251
7. Right-click the `TelerikReportServer` application pool and select **Recycle...** from the context menu.
53-
5452
8. Open the Report Server Manager application in the web browser to confirm it is working with the new user identity.
53+
9. Open Windows's Services app by selecting `Windows Key` + `R` to open the Run window, and then enter `services.msc`.
54+
10. Scroll to the `Telerik.ReportServer.ServiceAgent` service instance:
5555

56-
9. Open Windows's Services app by selecting `Windows Key` + `R` to open the Run window, and then enter `services.msc`.
56+
![Scrolling to the Telerik.ReportServer.ServiceAgent service instance.](images/change-iis-user/5-services-panel.png)
5757

58-
10. Scroll to the `Telerik.ReportServer.ServiceAgent` service instance:
58+
11. Double-click to show the service's **Properties** panel. Select the **Log On** tab.
59+
12. Click **This account** and enter the new user name (for example, `.\RSUser`) and its password:
5960

60-
![](images/change-iis-user/5-services-panel.png)
61+
![Changing the Log On credentials of the Telerik.ReportServer.ServiceAgent service.](images/change-iis-user/6-services-set-local-user.png)
6162

62-
11. Double-click to show the service's **Properties** panel. Select the **Log On** tab.
63+
13. Right-click `Telerik.ReportServer.ServiceAgent` and select **Restart** to restart the service with the new user.
64+
14. Ensure it is working by running a **scheduled task** or a **data alert** from the Report Server Manager web UI, or on the URL `http://{MachineNameHere}:82/ReportServer/ServiceAgent?wsdl`:
6365

64-
12. Click **This account** and enter the new user name (for example, `.\RSUser`) and its password:
66+
If the Report Server Manager cannot connect to the Telerik.ReportServer.ServiceAgent, most probably the WCF service doesn't have a reservation for the corresponding port (the default one is `82`). Ensure reserving the port by running the proper [Netsh command](https://learn.microsoft.com/en-us/windows-server/networking/technologies/netsh/netsh-contexts) as an Administrator in the _command prompt_ or _terminal_. Here is a sample command that reserves port `82` for `ReportServer/ServiceAgent/` running under user `RSUser`:
6567

66-
![](images/change-iis-user/6-services-set-local-user.png)
68+
`netsh http add urlacl url=http://+:82/ReportServer/ServiceAgent/ user=RSUser`
6769

68-
13. Right-click `Telerik.ReportServer.ServiceAgent` and select **Restart** to restart the service with the new user.
70+
If the default port `82` is already reserved by another application, you may change the port and reserve the new port as above, or release port `82` with the `delete urlacl` command and then reserve it with the above command. Here is a sample code releasing port `82` from the Telerik.ReportServer.ServiceAgent:
6971

70-
14. Ensure it is working by running a **scheduled task** or a **data alert** from Report Server Manager web UI.
72+
`netsh http delete urlacl url=http://+:82/ReportServer/ServiceAgent/`
7173

72-
> Additional Actions: Consider adding the local user to databases used by Report Server data connections that utilize Windows Credentials login permissions.
74+
> Additional Actions: Consider adding the local user to databases used by Report Server data connections that utilize Windows Credentials login permissions.

0 commit comments

Comments
 (0)