Система лицензирования

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Шаг за шагом: защита расширения конфигурации 1С ======

В общем случае для защиты своей конфигурации 1С понадобится:
  * создать продукт в своем личном кабинете;
  * определить способ лицензирования продукта - по количеству пользователей или хостов;
  * установить на свой компьютер инструмент для выполнения процедуры защиты продукта;
  * добавить в продукт интерактивную форму активации продукта и вспомогательные модули системы лицензирования.

В данной инструкции рассмотрим всю процедуру по шагам на примере простого расширения конфигурации 1С. . Для выдачи лицензий на работу с ней  будем использовать демо-доступ к личному кабинету (адрес, логин и пароль высылаются на электронную почту после регистрации).
<note> Для удобства также существует [[http://www.youtube.com/watch?v=NVHpBUpbmNA|видеоинструкция на YouTube]]</note>
===== Обзор демонстрационной базы =====

Для примера будем использовать конфигурацию для учета домашних животных.
  - Скачайте файл демонстрационной базы "**КошкинДом.dt**" (ссылка в электронном письме).
  - Создайте новую информационную базу из загрузите в нее информационную базу из файла "**КошкинДом.dt**".\\ Структура конфигурации имеет следующий вид. {{ :stepbystep:21-10-2016_11-23-09.png?nolink |}} Центральным объектом конфигурации является справочник "**Котики**", в котором содержится вся информация о животных. В примере мы будем выгружать данные этого справочника в XML-файл при помощи расширения.
  - Перейдите к расширению "**Экспорт котов**". Для этого выполните: "**Конфигурация**" -> "**Расширения конфигурации**". В появившемся окне расширений конфигурации будет расширение "**ЭкспортКотов**". Нажмите "**Открыть конфигурацию**". Откроется окно конфигурации расширения. Единственный объект, который добавляет расширение - это форма списка "**Экспорт_ФормаСписка**". {{ :stepbystep:19-01-2017_15-11-47.png?nolink |}}
  - Откройте форму списка справочника. На форме расположена кнопка экспорта, которая вызывает диалоговое окно сохранения файла и формирует его содержимое. Код формирования файла расположен в **модуле менеджера справочника**: <sxh>Процедура ЭкспортКотов(ПолноеИмяФайла) Экспорт
	
	Запрос = Новый Запрос;
	Запрос.Текст = 
		"ВЫБРАТЬ
		|	Котики.Код КАК Код,
		|	Котики.Кличка КАК Кличка,
		|	Котики.Порода КАК Порода,
		|	Котики.Окрас КАК Окрас
		|ИЗ
		|	Справочник.Котики КАК Котики";
	
	РезультатЗапроса = Запрос.Выполнить();
	ТаблицаКотов = РезультатЗапроса.Выгрузить();
	
	ФайлXML = Новый ЗаписьXML;
	ФайлXML.ОткрытьФайл(ПолноеИмяФайла);
	ФайлXML.ЗаписатьОбъявлениеXML();
	
	ФайлXML.ЗаписатьНачалоЭлемента("Коты");
	
	Для Каждого СтрокаТаблицы Из ТаблицаКотов Цикл
	
		ФайлXML.ЗаписатьНачалоЭлемента("Кот");
		
		ФайлXML.ЗаписатьАтрибут("Код",    СтрокаТаблицы.Код);
		ФайлXML.ЗаписатьАтрибут("Порода", Строка(СтрокаТаблицы.Порода));
		ФайлXML.ЗаписатьАтрибут("Окрас",  СтрокаТаблицы.Окрас);
		
		ФайлXML.ЗаписатьТекст(СтрокаТаблицы.Кличка);
		
		ФайлXML.ЗаписатьКонецЭлемента();
		
	КонецЦикла;
	
	ФайлXML.ЗаписатьКонецЭлемента();
	ФайлXML.Закрыть();
	
КонецПроцедуры</sxh>
   - Код этого модуля мы будем защищать. Установите на него произвольный пароль командой главного меню "**Текст**" -> "**Установить пароль**" (например, 123).
   - Сохраните изменения и обновите конфигурацию базы данных.
   - Выгрузите расширение в файл с именем "**ЭкспортКотов.cfe**".

===== Регистрация продукта в личном кабинете =====

<note tip>**Фича** - это та функциональная опция программы, которая подлежит лицензированию. Программный модуль, обработка, а также вся конфигурация 1С в целом могут является фичей. \\
**Продукт** - это минимально допустимый набор функциональных опций, который мы предлагаем клиенту как готовое решение. Продукт может состоять как из одной так и из нескольких фич, в зависимости от сложности лицензируемого решения.</note>
В данном примере не будем выделять отдельные функции конфигурации, поэтому в продукте будет одна фича и лицензирование по количеству пользователей работающих с конфигурацией.
Перейдем к настройке продукта в личном кабинете разработчика.
  - Откройте личный кабинет и перейдите на страницу фич.
  - Добавьте новую фичу. В качестве названия укажите "**Экспорт котов**". Идентификатор фичи можно указать произвольный. {{ :stepbystep:19-01-2017_15-15-41.png?nolink |}} Некоторые данные (они будут выделены синим цветом) необходимо будет повторить в инструменте защиты конфигураций.
  - Далее перейдите к странице продуктов. Добавьте новый продукт "**Экспорт котов на 1 хост**". В продукт добавьте созданную ранее фичу. Способ лицензирования - на хост. {{ :stepbystep:19-01-2017_15-20-00.png?nolink |}} 
  - Сохраните продукт, идентификатор будет сгенерирован автоматически. {{ :stepbystep:produkt.png?nolink |}}

===== Настройка инструмента защиты =====

Настроим инструмент защиты конфигураций (содержится электронном письме).

  - Создайте новую информационную базу, загрузите в нее конфигурацию из файла "**МИКО_ЗащитаРасширений.cf**". Запустите ее в режиме "1С:Предпритие".
  - Заполните в настройках **префикс ключ** и **код поставщика (vendor code)**. Персональные ключи разработчика указаны в настройках личного кабинета. {{ :stepbystep:21-10-2016_11-53-26.png?nolink |}}{{ :stepbystep:dn_arrow.png?nolink&48 |}}{{ :stepbystep:21-10-2016_11-56-52.png?nolink |}}
  - В списке фич добавьте новую, с тем же кодом и наименованием, что и в личном кабинете. {{ :stepbystep:19-01-2017_15-25-40.png?nolink |}}
  - В пункте "**Компоненты**" подключите компонент закрытого модуля "**МИКО_КомпонентЗакрытогоМодуля_DEMO.zip**" (содержится в электронном письме). {{ :stepbystep:компонент_закрытого_модуля.png?nolink |}}
  - Перейдите к списку расширений и добавьте новое. В качестве файла расширения укажите "**ЭкспортКотов.cfe**", созданный ранее. Дождитесь завершения анализа конфигурации расширения, по окончанию будет сформирован образ конфигурации.
  - Откройте созданный образ конфигурации. В дереве метаданных будут отображены те программные модули, содержание которых было скрыто, в нашем случае это модуль менеджера справочника "Котики". {{ :stepbystep:obraz_sozdan.png?nolink |}}
  - Выберите модуль менеджера справочника "Котики". Рядом отобразятся процедуры и функции этого модуля. 
  - Установите в соответствие процедуре "ЭкспортКотов" фичу "**Экспорт котов**". {{ :stepbystep:obraz_sozdan_ficha.png?nolink |}}
  - Сохраните изменения.

Чтобы пользователи могли активировать ключи или использовать триальный период, заполним данные о продукте.
  - Откройте конфигурацию расширения "Экспорт котов".
  - Заполните поле "**Основная функция (фича)**", указав ту фичу, доступность которой будет проверятся системой при запуске расширения. В этом примере у нас одна фича, ее и укажем.
  - Заполните поле "**Идентификатор триального продукта**", указав идентификатор ранее созданного в личном кабинете продукта. {{ :stepbystep:identifikatori_produka.png?nolink |}}
  - Сохраните изменения.

===== Защита и проверка результатов =====

После выполнения настройки, можно установить защиту на расширение.
  - Перейдите в раздел "**Установка защиты**".
  - Выберите конфигурацию и ее образ в соответствующих полях.
  - Укажите путь к защищаемому файлу расширения (выберем тот же файл "**ЭкспортКотов.cfe**"). {{ :stepbystep:ustanovka_zashiti_ustanovit.png?nolink |}}
  - Нажмите кнопку "**Установить защиту**" и дождитесь окончанию процедуры. В результате будет сформирован новый файл "**ЭкспортКотов.protect.cfe**". {{ :stepbystep:ustanovka_zashiti_sozdan_protect.png?nolink |}}

Осталось проверить полученные результаты.
  - Откройте в конфигураторе информационную базу, из которой вы выгружали расширение "ЭкспортКотов" на этапе "Обзор демонстрационной базы". Откройте "Расширения конфигурации". 
  - Загрузите конфигурацию расширения из файла "**ЭкспортКотов.protect.cfe**" заменив оригинал.
  - Отключите безопасный режим работы расширения, если он был у вас был включен {{ :stepbystep:19-01-2017_16-28-42.png?nolink |}}
  - Убедитесь, что в конфигурации расширения появились новые объекты системы лицензирования, а текст защищаемого модуля стал недоступен. \\ \\ {{:stepbystep:novayakofiguraciya_rasshireniya.png?nolink|}}  {{ :stepbystep:tekst_modula_nedostupen.png?nolink|}}
  - Следующий раздел выполняете в этой же конфигурации.

===== Настройка захвата основной фичи =====
<note important>Захват основной фичи добавлен в функционал и будет доступен при работе инструментом защиты 1.2.2</note>
Теперь нужно внести изменения в получившуюся конфигурацию, для того чтобы при ее запуске захватывалась основная фича создавалась пользовательская сессия. \\ \\
1. Элемент нумерованного списка Элемент ненумерованного спискаВ основной конфигурации (а не в расширении) добавьте общий модуль с названием "**Переопределяемый**" (обращаю внимание, что название модуля должно быть именно таким). В настройках модуля должен быть флажок только "Сервер". {{ :stepbystep:modul_pereopredelayemiy.png?nolink |}} \\
2. Внесите в модуль следующий код <sxh>Процедура ЛицензируемыеПродукты(Продукты) Экспорт
	
	СтруктураДляЗапуска = Новый Структура;
	
	СтруктураДляЗапуска.Вставить("Наименование",                    "Экспорт котов");
	
	СтруктураДляЗапуска.Вставить("ПрефиксРасширения",	  	 "Экспорт_");
	
	СтруктураДляЗапуска.Вставить("ПрефиксКлюч",                     "DEMO");
	
	СтруктураДляЗапуска.Вставить("ИдентификаторФичи",               "102");
	
	СтруктураДляЗапуска.Вставить("ИдентификаторТриальногоПродукта", "96");
	
	Продукты.Добавить(СтруктураДляЗапуска);
	
КонецПроцедуры</sxh>

где значения структуры, соответствующие ключам "Наименование", "ПрефиксРасширения", "ПрефиксКлюч", "ИдентификаторФичи", "ИдентификаторТриальногоПродукта" возьмите из: Расширение "ЭкспортКотов" -> Общие формы -> "Экспорт_РегистрацияПродукта" -> модуль формы -> Функция "**ОписаниеПродукта()**" \\
{{ :stepbystep:znacheniyz_iz_modula_formi.png?nolink |}}

3. В **основной** конфигурации откройте **модуль управляемого приложения** и добавьте в него следующий код.
<sxh>Процедура ПриНачалеРаботыСистемы()
     
    ИнициализироватьСистемуЛицензирования("Экспорт котов");
     
КонецПроцедуры
 
Процедура ПриЗавершенииРаботыСистемы(Отказ, ТекстПредупреждения)
     
    ЗавершитьРаботуСистемыЛицензирования("Экспорт котов");
     
КонецПроцедуры
 
 
////////////////////////////////////////////////////////////////////////////////
 
Процедура ИнициализироватьСистемуЛицензирования(НаименованиеКонфигурации)
     
	Попытка
         
		Экспорт_Лицензирование.НачатьРаботу(НаименованиеКонфигурации);
	
    Исключение
         
        ПараметрыФормы = Новый Структура;
        ПараметрыФормы.Вставить("НаименованиеПродукта", НаименованиеКонфигурации);
        ПараметрыФормы.Вставить("ОписаниеОшибки",       ИнформацияОбОшибке().Описание);
         
        ОткрытьФорму("ОбщаяФорма.Экспорт_РегистрацияПродукта", ПараметрыФормы);
         
    КонецПопытки;
                                                  
КонецПроцедуры
 
Процедура ЗавершитьРаботуСистемыЛицензирования(НаименованиеКонфигурации)
     
    Экспорт_Лицензирование.ЗавершитьРаботу(НаименованиеКонфигурации);
     
КонецПроцедуры</sxh>

где параметр передающийся в процедуры "**ИнициализироватьСистемуЛицензирования**" "**ЗавершитьРаботуСистемыЛицензирования**" должен соответствовать значению ключа "Наименование" 
структуры "СтруктураДляЗапуска" в процедуре модуля "Переопределяемый". \\
4. Запустите конфигурацию 1С в пользовательском режиме. При первом запуске появится  предупреждение безопасности. Утвердительно ответьте на него, и запустите конфигурацию заново. {{ :stepbystep:предупреждение_безопасности.png?nolink |}} \\
5. Нажмите "**Регистрация продукта**". При первом запуске появится окно регистрации продукта. {{ :stepbystep:19-01-2017_16-37-37.png?nolink |}} \\
6. Нажмите кнопку "**Перейти к регистрации клиента...**" и заполните анкету нового клиента. {{ :stepbystep:19-01-2017_16-41-47.png?nolink |}}
7. Нажмите кнопку "**Зарегистрировать**". Если данные введены корректно, то система выдаст новый лицензионный ключ. Все выданные ключи можно увидеть в соответствующем разделе личного кабинета разработчика (фильтр должен быть заполнен). {{ :stepbystep:19-01-2017_16-45-26.png?nolink |}}
8. Проверим, что расширение работает. Откройте справочник "Котики" и нажмите кнопку "Экспорт...". Убедитесь, что файл сформировался. При этом будет выполнена привязка лицензионного ключа к текущему хосту, что можно проверить в разделе "**Монитор сессий**" личного кабинета разработчика (фильтр должен быть заполнен). {{ :stepbystep:19-01-2017_16-47-25.png?nolink |}}