Skip to content

Commit 97b5daa

Browse files
authored
add rs.net462 required permissions for windows user (#250)
1 parent 0bdc9ba commit 97b5daa

File tree

3 files changed

+48
-13
lines changed

3 files changed

+48
-13
lines changed

implementer-guide/setup/installation.md

Lines changed: 26 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,37 @@ position: 200
1010

1111
# Report Server Installation
1212

13-
The Report Server web application is installed by a Windows MSI installer, which deploys two applications: a website named _Telerik Report Server_, automatically registered with its own application pool in the machine's IIS, and a non-UI application named _Telerik.ReportServer.ServiceAgent_, registered as a Windows Service. The Report Server web application is accessible by default on HTTP port 83 and the Service Agent on HTTP port 82.
13+
The Report Server web application is installed by a Windows MSI installer, which deploys two applications: a website named _Telerik Report Server_, automatically registered with its own application pool in the machine's IIS, and a non-UI application named _Telerik.ReportServer.ServiceAgent_, registered as a Windows Service. The Report Server web application is accessible by default on HTTP port 83 and the Service Agent on HTTP port 82.
1414

15-
When deploying a new instance of Report Server, the default behavior of the MSI installer is to suggest applying the [principle of least privilege](https://learn.microsoft.com/en-us/entra/identity-platform/secure-least-privileged-access) and create a dedicated Windows user named **ReportServerUser** whose identity will be used by both applications. The user is granted with the minimum necessary permissions to operate within the installation folder of Telerik Report Server. The **ReportServerUser** is created with a strong random password, which is not saved, as this user is dedicated to running only the Telerik Report Server and its agent. The MSI installer allows opting out of the safe workflow and installing the applications under the **LocalSystem** identity, which uses elevated permissions. The safety recommendations dictate that this option should be selected only if the Report Server is deployed and used in a safe environment. If needed, the Report Server applications can be configured to use an [identity with limited permissions]({%slug how-to-change-report-server-iis-user%}).
15+
## ReportServerUser, LocalSystem Indentity and Dedicated Users
1616

17-
Generally, it is possible to deploy multiple Report Server instances on the same IIS if they have different website names, ports, and application folders. However, the Scheduler Windows service cannot be duplicated and will always point to the Storage of the last installed Report Server instance. Installing multiple instances of Report Server will also affect the retrieval of the encryption keys stored in the user's environment variables. For those reasons, only one fully functional Telerik Report Server can be installed on a single machine.
17+
### ReportServerUser
18+
19+
When deploying a new instance of Report Server, the default behavior of the MSI installer is to suggest applying the [principle of least privilege](https://learn.microsoft.com/en-us/entra/identity-platform/secure-least-privileged-access) and create a dedicated Windows user named **ReportServerUser** whose identity will be used by both applications. The user is granted with the minimum necessary permissions to operate within the installation folder of Telerik Report Server. The **ReportServerUser** is created with a strong random password, which is not saved, as this user is dedicated to running only the Telerik Report Server and its agent.
20+
21+
### LocalSystem Identity
22+
23+
The MSI installer allows opting out of the safe workflow and installing the applications under the **LocalSystem** identity, which uses elevated permissions. The safety recommendations dictate that this option should be selected only if the Report Server is deployed and used in a safe environment. If needed, the Report Server applications can be configured to use an [identity with limited permissions]({%slug how-to-change-report-server-iis-user%}).
24+
25+
### Using Dedicated Users After Installation
26+
27+
After installing the Telerik Report Server product, one may want to assign a custom dedicated user be used by the Report Server and the Service Agent. This is supported as well, and you can find a step-by-step tutorial on how to do it in the [How to Run Report Server and Service Agent with Limited Permissions]({%slug how-to-change-report-server-iis-user%}) article.
28+
29+
Any custom Windows user must have the following permissions/policies for the Report Server, and it Service Agent, to function properly with all of the functionalities being supported:
30+
31+
- [Modify access](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/icacls) for the Report Server installation directory(`C:\Program Files (x86)\Progress\Telerik Report Server`), and all subdirectories
32+
- [Modify access](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/icacls) for the `%ProgramData%\Telerik\Reporting` directory - This is the place where the cache of the [Map](https://docs.telerik.com/reporting/report-items/map/overview) report item is stored.
33+
- [Log on as a service](https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-10/security/threat-protection/security-policy-settings/log-on-as-a-service) must be **enabled** for the user, or one of the user groups where it is included.
34+
35+
## Multiple Report Server Installations
36+
37+
Generally, it is possible to deploy multiple Report Server instances on the same IIS if they have different website names, ports, and application folders. However, the Scheduler Windows service cannot be duplicated and will always point to the Storage of the last installed Report Server instance.
38+
39+
Installing multiple instances of Report Server will also affect the retrieval of the encryption keys stored in the user's environment variables. For those reasons, only one fully functional Telerik Report Server can be installed on a single machine.
1840

1941
## Downloading and Installing
2042

21-
You can download the licensed product version from the **Telerik Control Panel**, which you can get from [Your Account](http://www.telerik.com/account). The Control Panel is a small Windows utility that will notify you when a new version of the Telerik product(s) you have purchased is available. Once you download the product, run the installer to install it on your machine.
43+
You can download the licensed product version from the [Telerik Control Panel](https://docs.telerik.com/controlpanel/introduction), which you can get from [Your Account](http://www.telerik.com/account). The Control Panel is a small Windows utility that will notify you when a new version of the Telerik product(s) you have purchased is available. Once you download the product, run the installer to install it on your machine.
2244

2345
## Installation Options
2446

implementer-guide/setup/system-requirements.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
title: System Requirements
3-
page_title: System Requirements
4-
description: System Requirements
3+
page_title: System Requirements for Telerik Report Server
4+
description: "Learn more about the system requirements for the Telerik Report Server for .NET, and .NET Framework."
55
slug: system-requirements
6-
tags: system,requirements
6+
tags: system,requirements,report,server,net,framework
77
published: True
88
position: 100
99
---
@@ -12,15 +12,17 @@ position: 100
1212

1313
## Report Server for .NET Framework
1414

15-
- Windows platform
16-
- Internet Information Services (IIS) 7+
17-
- Microsoft .NET Framework 4.6.2+
15+
- **Operating System** - Windows platform such as Windows 11, Windows Server 2025, Windows Server 2022, and so on.
16+
- **Web Server**- [Internet Information Services](https://www.iis.net/) (IIS) 7+
17+
- **Runtimes** - [Microsoft .NET Framework 4.6.2](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net462)+
18+
1819

1920
## Report Server for .NET
2021

21-
- Windows or Linux platform
22-
- ASP.NET Core web server, e.g. IIS 7+, Kestrel
23-
- Microsoft .NET 8
22+
- **Operating System** - Windows or Linux platform
23+
- **Web Server** - ASP.NET Core web server, e.g. IIS 7+, Kestrel. If **IIS** is used, the [ASP.NET Core Module (ANCM) for IIS](https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/aspnet-core-module) must be installed.
24+
- **Runtimes** - [ASP.NET Core 8+ Runtim](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
25+
2426

2527
## Client
2628

knowledge-base/how-to-change-report-server-iis-user.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,4 +71,15 @@ This tutorial will show you how to change the Report Server's IIS application po
7171

7272
`netsh http delete urlacl url=http://+:82/ReportServer/ServiceAgent/`
7373

74+
15. Ensure that the newly created Windows user has all of the required permissions for running the Report Server and its Service Agent:
75+
76+
- [Modify access](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/icacls) for the Report Server installation directory(`C:\Program Files (x86)\Progress\Telerik Report Server`), and all subdirectories
77+
- [Modify access](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/icacls) for the `%ProgramData%\Telerik\Reporting` directory - This is the place where the cache of the [Map](https://docs.telerik.com/reporting/report-items/map/overview) report item is stored.
78+
- [Log on as a service](https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-10/security/threat-protection/security-policy-settings/log-on-as-a-service) must be **enabled** for the user, or one of the user groups where it is included.
79+
7480
> Additional Actions: Consider adding the local user to databases used by Report Server data connections that utilize Windows Credentials login permissions.
81+
82+
## See Also
83+
84+
* [System Requirements for Telerik Report Server]({%slug system-requirements%})
85+
* [Report Server Installation]({%slug installation%})

0 commit comments

Comments
 (0)