Программная работа с Ролями в 1С

Программная работа с Ролями в 1С

Для ограничения доступа пользователей к данным в 1С используются Роли. В статье речь пойдет о программной работе с ними.

Ограничение прав доступа в 1С
Привилегированный режим работы
Безопасный режим работы
Программная работа с Ролями
Программная работа с Ролями в БСП

Ограничение прав доступа в 1С

Роль — это объект метаданных, предназначенный для описания набора разрешенных действий (прав). Каждому пользователю прикладного решения может быть назначена одна или несколько ролей. Пользователь будет иметь право на объект, если хотя бы одна из назначенных ему ролей предоставляет право на этот объект. При попытке получить доступ к объекту, на который у пользователя нет прав, выдается ошибка:

Окно ошибки при нарушении прав доступа в 1С

В ролях можно управлять доступом не только на уровне объектов метаданных, но и на уровне объектов базы данных. Например, можно указать, что пользователю с определенной ролью разрешено изменять справочник Номенклатура, но только те его элементы, которые не помечены на удаление. Этот механизм называется RLS — Row Level Security (ограничение доступа на уровне записей).

Привилегированный режим работы

В системе есть возможность временно отключить проверку прав доступа. Такой режим называется привилегированным. В привилегированном режиме разрешены любые операции с базой и не производится контроль RLS.

Включение привилегированного режима осуществляется методом

УстановитьПривилегированныйРежим(Истина);

отключение:

УстановитьПривилегированныйРежим(Ложь);

Если вызвать метод УстановитьПривилегированныйРежим(Ложь) большее количество раз, чем УстановитьПривилегированныйРежим(Истина), то будет вызвано исключение.

Получить текущее значение привилегированного режима можно функцией

ПривилегированныйРежим()

которая возвращает значение типа Булево.

Безопасный режим работы

Иногда требуется наложить дополнительные ограничения при выполнении «ненадежного» кода, например, при вызове метода Выполнить(). В этом случае можно переключиться в безопасный режим работы.

В безопасном режиме:

  • привилегированный режим отменяется, а попытка перехода в привилегированный режим игнорируется;
  • запрещено использование внешних средств по отношению к 1С (доступ к файловой системе, доступ к интернету, загрузка внешних компонент, механизмы COM).

Включение безопасного режима осуществляется методом

УстановитьБезопасныйРежим(Истина);

отключение:

УстановитьБезопасныйРежим(Ложь);

Если вызвать метод УстановитьБезопасныйРежим(Ложь) большее количество раз, чем УстановитьБезопасныйРежим(Истина), то будет вызвано исключение.

Получить текущее значение безопасного режима можно функцией

БезопасныйРежим()

которая возвращает значение типа Булево.

Программная работа с Ролями

Для проверки доступности Роли текущему пользователю:

РольДоступна(<НаименованиеРоли>)
// Пример использования:
ЭтоАдминистратор = РольДоступна(Метаданные.Роли.АдминистраторСистемы);
//Тот же самый результат можно получить так:
ЭтоАдминистратор = РольДоступна(«АдминистраторСистемы»);

Для определения права доступа (чтение, изменение и т.д.) к объекту метаданных:

ПравоДоступа(<Право>, <ОбъектМетаданных>, <Пользователь/Роль>, <СтандартныйРеквизитСтандартнаяТабличнаяЧасть>)
// Пример использования: проверка у текущего пользователя права на изменение справочника ФизическиеЛица
МожноРедактироватьФизЛиц = ПравоДоступа(«Изменение», Метаданные.Справочники.ФизическиеЛица);

Для проверки прав доступа текущего пользователя на объект метаданных:

ВыполнитьПроверкуПравДоступа(<Право>, <ОбъектМетаданных>, <СтандартныйРеквизитСтандартнаяТабличнаяЧасть>)
//Примеры использования:
ВыполнитьПроверкуПравДоступа(«ИнтерактивноеОткрытиеВнешнихОбработок», Метаданные);
ВыполнитьПроверкуПравДоступа(«ИнтерактивнаяПометкаУдаления», Метаданные.Справочники.ФизическиеЛица);

Процедура ВыполнитьПроверкуПравДоступа() отличается от функции ПравоДоступа() тем, что доступна только для текущего пользователя. При отсутствии права вызывается исключение, а в журнал регистрации пишется событие ОтказВДоступе.

Для получение информации о праве доступа на определенный объект метаданных для пользователя или роли с учетом указанных полей:

ПараметрыДоступа(<НаименованиеПрава>, <ОбъектМетаданных>, <СписокПолей>, <Пользователь/Роль>)
//Пример использования:
ПараметрыДоступа = ПараметрыДоступа(«Чтение», Метаданные.РегистрыСведений.ТекущиеКадровыеДанныеСотрудников, «ТекущаяОрганизация,ФизическоеЛицо»);
ЕстьДоступ = ПараметрыДоступа.Доступность;
ОграничениеRLS = ПараметрыДоступа.ОграничениеУсловием;

Для получения представления права по имени:

ПредставлениеПрава(<ИмяПрава>)
//Пример использования:
Представление = ПредставлениеПрава(«ИнтерактивноеОткрытиеВнешнихОбработок»);
// Переменная Представление будет содержать строку «Интерактивное открытие внешних обработок»

Программная работа с Ролями в БСП

В типовых конфигурациях, построенных на Библиотеке стандартных подсистем, в общих модулях есть методы для работы с ролями. Вот некоторые из них:

Пользователи.РолиДоступны(ИменаРолей, Пользователь = Неопределено, УчитыватьПривилегированныйРежим = Истина)
Пользователи.ЭтоПолноправныйПользователь(Пользователь = Неопределено, ПроверятьПраваАдминистрированияСистемы = Ложь, УчитыватьПривилегированныйРежим = Истина)
УправлениеДоступом.ЕстьРоль(Знач Роль, Знач СсылкаНаОбъект = Неопределено, Знач Пользователь = Неопределено)
УправлениеДоступом.ЕстьПраво(Право, СсылкаНаОбъект, Пользователь = Неопределено)
УправлениеДоступом.ЧтениеРазрешено(ОписаниеДанных)
УправлениеДоступом.ИзменениеРазрешено(ОписаниеДанных)
УправлениеДоступом.ОграничиватьДоступНаУровнеЗаписей()
УправлениеДоступом.ПраваПоИдентификаторам(Идентификаторы = Неопределено)

В общих модулях у каждого метода есть подробное описание. Там можно посмотреть описание самого метода, входных параметров и возвращаемого значения.
 

Остались вопросы?
Спросите в комментариях к статье.

 

Смотри также:

Передача файла с клиента на сервер
Как открыть форму внешней обработки или отчета программно
Как получить список открытых окон 1С

Добавить комментарий

Ваш e-mail не будет опубликован.