Включение и отключение «песочницы» для языка определения отчетов
Функция «песочницы» для языка определения отчетов позволяет обнаруживать и ограничивать использование определенных типов ресурсов отдельными пользователями в среде с многочисленными пользователями, которые используют единственную веб-ферму серверов отчетов. Примером этого является сценарий услуг хост-сервера, в котором может поддерживаться единственная веб-ферма серверов отчетов, применяемая несколькими пользователями, а также, возможно, другими компаниями. Администратор сервера отчетов может включить эту функцию для выполнения следующих задач.
Ограничение размера внешних ресурсов. Внешние ресурсы включают изображения, XSLT-файлы и данные карт.
Во время публикации отчета ограничить типы и члены, используемые в тексте выражения.
Во время выполнения ограничить длину текста и размер возвращаемых значений для выражений.
При включении функции «песочницы» для языка определения отчетов отключаются следующие функции:
пользовательский код в элементе определения отчета <Code>;
режим обратной совместимости выражений языка определения отчетов для пользовательских элементов отчета Службы SQL Server 2005 Reporting Services (SSRS);
именованные параметры в выражениях.
В этом разделе описывается каждый из элементов, вложенных в элемент <RDLSandboxing> в файле RSReportServer.Config. Дополнительные сведения об изменении этого файла см. в разделе Изменение файла конфигурации служб Reporting Services (RSreportserver.config). Операции с записями журнала трассировки сервера, связанные с функцией «песочницы» для выражений языка определения отчетов. Дополнительные сведения о журналах трассировки см. в разделе Журнал трассировки службы сервера отчетов.
Пример конфигурации
В следующем примере показаны параметры и примерные значения элемента <RDLSandboxing> в файле RSReportServer.Config.
<RDLSandboxing>
<MaxExpressionLength>5000</MaxExpressionLength>
<MaxResourceSize>5000</MaxResourceSize>
<MaxStringResultLength>3000</MaxStringResultLength>
<MaxArrayResultLength>250</MaxArrayResultLength>
<Types>
<Allow Namespace=”System.Drawing” AllowNew=”True”>Bitmap</Allow>
<Allow Namespace=”TypeConverters.Custom” AllowNew=”True”>*</Allow>
</Types>
<Members>
<Deny>Format</Deny>
<Deny>StrDup</Deny>
</Members>
</RDLSandboxing>
Параметры конфигурации
Сведения о параметрах настройки приведены в следующей таблице. Параметры представлены в том порядке, в котором они следуют в файле конфигурации.
Настройка |
Описание |
||
|---|---|---|---|
MaxExpressionLength |
Максимально допустимое число символов в выражении языка определения отчетов. По умолчанию: 1000 |
||
MaxResourceSize |
Максимально допустимый размер внешнего ресурса (КБ). По умолчанию: 100 |
||
MaxStringResultLength |
Максимально допустимое число символов для возвращаемого значения выражения языка определения отчетов. По умолчанию: 1000 |
||
MaxArrayResultLength |
Максимальное число элементов для возвращаемого значения выражения языка определения отчетов, допустимое в массиве. По умолчанию: 100 |
||
Типы |
Список членов, разрешенных для выражений языка определения отчетов. |
||
Allow |
Тип или набор типов, разрешенных для выражений языка определения отчетов. |
||
Пространство имен |
Атрибут для элемента Allow, представляющий пространство имен, содержащее один или несколько типов, применимых к атрибуту Value. Это свойство учитывает регистр символов. |
||
AllowNew |
Логический атрибут элемента Allow, указывающий, разрешено ли создание новых экземпляров этого типа в выражениях языка определения отчетов или в элементах языка определения отчетов <Class>.
|
||
Значение |
Значение элемента Allow, представляющее имя типа, разрешенного в выражениях языка определения отчетов. Значение * показывает, что разрешены все типы в пространстве имен. Это свойство учитывает регистр символов. |
||
Члены |
Для списка типов, включенных в элемент <Types>, представляет список имен членов, запрещенных в выражениях языка определения отчетов. |
||
Запретить |
Имя члена, запрещенного в выражении языка определения отчетов. Это свойство учитывает регистр символов.
|
Работа с выражениями в режиме «песочницы» для выражений языка определения отчетов
Функцию «песочницы» для выражений языка определения отчетов можно изменить, чтобы обеспечить управление ресурсами, используемыми в выражении, следующим образом:
ограничение количества символов, используемых в выражении;
ограничение размера результата, возвращаемого выражением;
разрешение списка определенных типов, которые могут быть использованы в выражении;
ограничение списка членов по именам для списка разрешенных типов, которые могут быть использованы в выражении;
функция «песочницы» для выражений языка определения отчетов позволяет создать список разрешенных типов и список запрещенных членов. Список разрешенных типов называется списком разрешений. Список запрещенных членов называется списком блокировок.
.gif "Примечание") Примечание |
|---|
В определении отчета компьютеру неизвестны типы всех экземпляров в справочниках выражений служб. При добавлении члена к списку блокировок в списке разрешений блокируются все члены всех типов с этим именем. |
Проверка результатов выражений языка определения отчетов производится во время выполнения. Выражения языка определения отчетов проверяются в определении отчета при публикации отчета. Наблюдение за журналом трассировки сервера отчетов на наличие нарушений. Дополнительные сведения см. в разделе Журнал трассировки службы сервера отчетов.
Работа с типами
При добавлении типа к списку разрешений осуществляется управление следующими точками входа, используемыми для доступа к выражениям языка определения отчетов:
статические члены этого типа;
метод Visual Basic New;
элемент <Classes> в определении отчета;
члены, добавленные к списку блокировок, для типа в списке разрешений.
Список разрешений не управляет следующими точками входа:
наборы данных отчетов. Поля в наборах данных отчетов, возвращаемые при запросах, могут содержать любой допустимый тип выражения языка определения отчетов;
параметры отчета. Указанные пользователем значения параметров могут содержать любой допустимый тип выражения языка определения отчетов;
члены разрешенного типа, не состоящие в списке блокировок. По умолчанию разрешены все члены всех типов в списке разрешений. При добавлении имени члена к списку блокировок в списке разрешений блокируются все члены всех типов с этим именем.
Чтобы разрешить член одного типа и запретить член другого типа с тем же именем, необходимо выполнить следующие действия:
добавить к имени члена элемент <Deny>;
в пользовательской сборке создать в классе член-посредник с другим именем для того члена, который необходимо разрешить;
добавить этот новый класс к списку разрешений.
Чтобы добавить функции Visual Basic .NET Framework к списку разрешений, добавьте к списку разрешений соответствующие типы из пространства имен Microsoft.VisualBasic.
Чтобы добавить ключевые слова, определяющие тип Visual Basic .NET Framework, добавьте к списку разрешений соответствующий тип CLR. Например, чтобы использовать ключевое слово Visual Basic .NET Framework Integer, добавьте к элементу <RDLSandboxing> следующий фрагмент XML:
<Allow Namespace="System">Int32</Allow>
Чтобы добавить универсальный или допускающий значения NULL тип .NET Framework Visual Basic к списку разрешений, выполните следующие действия:
создайте тип-посредник для универсального или допускающего значения NULL типа .NET Framework Visual Basic;
добавьте тип-посредник к списку разрешений.
При добавлении типа из пользовательской сборки к списку разрешений для сборки неявное предоставление разрешения на выполнение не выполняется. Необходимо специально изменить файл управления доступом для кода, предоставив разрешение на выполнение для данной сборки. Дополнительные сведения см. в разделе Управление доступом для кода в службах Reporting Services.
Обслуживание списка <Deny> для членов
В следующем списке показано, когда необходимо обновление списка заблокированных членов при добавлении нового типа к списку разрешений:
при обновлении пользовательской сборки до версии, в которой вводятся новые типы;
при добавлении новых членов к типам в списке разрешений;
при обновлении .NET Framework на сервере отчетов;
при обновлении сервера отчетов до последней версии служб Службы Reporting Services;
при обновлении сервера отчетов для обработки последней схемы языка определения отчетов при добавлении новых членов к типам языка определения отчетов.
Работа с операторами и оператором New
По умолчанию все операторы языка Visual Basic .NET Framework, кроме New, всегда разрешены. Оператор New управляется атрибутом AllowNew элемента <Allow>. Другие операторы языка, такие как оператор метода доступа коллекции по умолчанию, оператор !, и макросы приведения Visual Basic .NET Framework, такие как CInt, всегда разрешены.
Добавление операторов к списку заблокированных, включая пользовательские, не поддерживается. Чтобы исключить тип операторов, выполните следующие действия:
создайте тип-посредник, не реализующий операторы, которые необходимо исключить;.
добавьте тип-посредник к списку разрешений.
Чтобы создать новый массив в выражении языка определения отчетов, создайте массив в определяемом классе и добавьте этот класс к списку разрешений.
Чтобы создать новый массив в выражении языка определения отчетов, необходимо выполнить следующие действия:
определите новый класс и создайте массив в методе в этом классе;
добавьте этот класс к списку разрешений.