Портал документации Рутокен

Page tree

Для миграции данных из SafeNet Authentication Manager в Rutoken KeyBox убедитесь, что выполнены следующие предварительные условия:

Со стороны SAM:

  • версия SafeNet Authentication Manager 8.0, 8.2 Rev E и 9.0 SP2/SP3;
  • хранилище данных SAM в Active Directory;
  • редакция удостоверяющего центра Microsoft, сертификаты которого будут перенесены;
  • известны все типы устройств (USB-токенов, смарт-карт) и значения их ATR (Answer To Reset), которые используются в SAM и будут использоваться в Rutoken KeyBox.

Со стороны Rutoken KeyBox:

  • версия Rutoken KeyBox Server 4.1.3 и выше;
  • хранилище данных в Active Directory или Microsoft SQL.

Процесс миграции

Чтобы мигрировать данные, выполните следующие действия:

  1. Настройте Rutoken KeyBox для работы с данными из SAM и создайте политики использования устройств.
  2. Настройте утилиту миграции IndeedCM.Migrate.SAM:
    1. Заполните файл конфигурации IndeedCM.Migrate.SAM.exe.config.
    2. Заполните файл конфигурации unity.config.
    3. Запустите процесс миграции.

Настройка Rutoken KeyBox для работы с данными из SAM

Прежде чем приступить к выгрузке данных из SAM, подготовьте Rutoken KeyBox к приему этих данных:

  1. Убедитесь, что каталог пользователей Rutoken KeyBox совпадает с каталогом пользователей SAM. Путь к каталогу пользователей задается в разделе Каталог пользователей Мастера настройки Rutoken KeyBox.
  2. Убедитесь, что в разделе Конфигурация→Лицензии есть действующая лицензия на достаточное количество пользователей.
  3. Убедитесь, что в разделе Конфигурация→Типы устройств добавлены все типы устройств eToken, которые используются в SAM.
  4. Для всех пользователей, устройства которых будут переноситься из SAM, созданы и назначены политики использования устройств в Rutoken KeyBox.

Создание политики использования устройств

Rutoken KeyBox использует механизм политик выпуска устройств пользователям. Каждая политика содержит в себе параметры работы с устройством: перечень УЦ и шаблонов сертификатов, требования к установке PIN-кодов, перечень действий с устройством доступных пользователю и т.д. Каждая политика имеет свою область действия. Для каталога пользователей Rutoken KeyBox в Active Directory это:

  • Домен (Domain);
  • Контейнер (Container);
  • Подразделение (Organizational Unit).

Всем пользователям, расположенным в объекте действия политики будут выпускаться устройства с определенными в политике параметрами. Действие политики может распространяться как на весь объект (домен, контейнер или подразделение), так и на отдельные группы пользователей, входящие в него. Если пользователь попадает под область действия нескольких политик выпуска устройств (например, состоит в двух группах, расположенных в одном OU), то действовать на пользователя будет политика с большим приоритетом.

Перед миграцией данных из SAM необходимо заранее создать одну или несколько политик использования устройств в Rutoken KeyBox.

Такая политика должна обязательно содержать те же самые УЦ и шаблоны, которые использовались для выпуска сертификатов в SAM.

В результате миграции данных из SAM все пользователи, обладающие токенами и сертификатами, попадут под действие ранее созданных политик Rutoken KeyBox.

IndeedCM.Migrate.SAM

Перенос данных из SAM осуществляется при помощи утилиты IndeedCM.Migrate.SAM.exe, расположенной в дистрибутиве сервера Rutoken KeyBox (каталог Misc\SAMMigration). Для работы утилиты необходимо заполнить файлы конфигурации:

IndeedCM.Migrate.SAM.exe.config

Откройте файл ...SAMMigration\IndeedCM.Migrate.SAM.exe.config от имени администратора в текстовом редакторе и заполните следующие секции:

  • samSettings – параметры подключения к хранилищу данных SAM.

  • MsCAConnectorId – идентификатор коннектора к Microsoft CA. Значение параметра можно найти в файле XML коннектора в каталоге SAM. Путь по умолчанию C:\ProgramFiles\SafeNet\Authentication\SAM\x64\Bin\MsCAConnectorDescriptor.xml. Значение по умолчанию: {1A30B883-CD69-4cbb-8D61-E72E9697D8B1}.

  • connectionString - путь к файлу XML (в названии файла имя домена, в котором развернут SAM) c информацией для подключения к SAM серверу. Путь по умолчанию C:\ProgramData\SafeNet\Authentication\SAM.

  • migrateSAMSettings – параметры переноса данных.

  • ignoreCMCertificateTemplateNotFoundError – параметр импорта устройств. Может иметь два значения:

    • true – из SAM импортируется устройство вместе с сертификатами, для которых в политике Rutoken KeyBox создан шаблон;
    • false – из SAM не импортируется устройство, если в политике Rutoken KeyBox нет хотя бы одного шаблона для сертификата, выпущенного в SAM.
      При этом процесс импорта карт не останавливается ни в одном из случаев. Атрибут необязательный, значение по умолчанию – false.

  • notIssuedTokenAdminPin - если ключевой носитель в SAM находится в состоянии Зарегистрирован и ни разу не выпускался, то в этом параметре задается PIN-код администратора, который будет установлен на устройстве после его переноса в Rutoken KeyBox.

  • issuedTokenAdminPin - если ключевой носитель в SAM находится любом другом состоянии и выпускался без инициализации, то в параметре задается PIN-код администратора, который будет установлен на устройстве после его переноса в Rutoken KeyBox.

  • tokenTypes – секция, в которой должны быть перечислены все устройства, которые необходимо перенести из SAM в Rutoken KeyBox. Необходимо указать модель устройства (токена, смарт-карты), product name, цвет устройства и значение ATR (Answer To Reset).

Значение ATR для каждого устройства можно получить у производителя или при помощи стороннего ПО, обратившись в службу Технической поддержки.

Если при работе утилиты IndeedCM.Migrate.SAM.exe с хранилищем SAM встречается устройство с моделью и product name, которые не указаны в секции tokenTypes, то такие устройства не будут перенесены в хранилище Rutoken KeyBox, а утилита выведет соответствующую ошибку.

  • adPersistenceSettings – параметры подключения к хранилищу данных Rutoken KeyBox в Active Directory. Содержимое секции должно полностью совпадать с содержимым одноименной секции файла конфигурации Консоли управления Rutoken KeyBox (mc\Web.config).

  • sqlPersistenceSettings – параметры подключения к хранилищу данных Rutoken KeyBox в Microsoft SQL. По умолчанию секция закомментирована символами <! - - . . . - ->. Содержимое секции должно полностью совпадать с содержимым одноименной секции файла конфигурации Консоли управления Rutoken KeyBox (mc\Web.config).

  • adUserCatalogSettings – параметры подключения к каталогу пользователей Rutoken KeyBox в Active Directory. Содержимое секции должно полностью совпадать с содержимым одноименной секции файла конфигурации Консоли управления Rutoken KeyBox (mc\Web.config).

Сохраните внесенные изменения.

<samSettings MsCAConnectorId="{1A30B883-CD69-4cbb-8D61-E72E9697D8B1}"
connectionString="C:\ProgramData\SafeNet\Authentication\SAM\demo.local.xml" />
<migrateSAMSettings ignoreCMCertificateTemplateNotFoundError="true"
notIssuedTokenAdminPin="adminpass"
issuedTokenAdminPin="adminpass2">
<tokenTypes>
<tokenType model="Token 12.0.0.0 12.0.12"
productName="SafeNet eToken 5110"
color="8"
atr="3bd5180081313a7d8073c8211030" />
<tokenType model="Token JC"
productName="eToken PRO Java 72K OS755"
color="4"
atr="3bd518008131fe7d8073c82110f4" />
</migrateSAMSettings>
<adPersistenceSettings path="LDAP://CN=RutokenKeyBox,CN=Rutoken Identity,
DC=demo,DC=local" userName="DEMO\cmadmin" password="Password1"
cryptoAlgName="AES"
cryptoKey="11d2f5051684451860ad177ebc39b55cacaf2a0a843b05ddf273b955c93ae015" />
<adUserCatalogSettings>
<rootContainers>
<container path="LDAP://OU=SAM_USERS,DC=demo,DC=local" userName="DEMO\cmadmin"
password="Password1" />
</rootContainers>
</adUserCatalogSettings>

IndeedCM.Migrate.SAM.unity.config

Откройте файл ...SAMMigration\unity.config от имени администратора в текстовом редакторе и заполните секцию container:

  • все строки до <register type="ISAMDbContext". . . /> должны совпадать с теми, что указаны в файле конфигурации Консоли управления Rutoken KeyBox (mc\unity.config);

    Добавлять секции, которых по умолчанию нет в unity.config утилиты миграции (но есть в mc\unity.config) не нужно.

  • <register type="IMigrateReporter" mapTo="IndeedCM.Migrate.SAM.Reporter.CSVMigrateReporter, IndeedCM.Migrate.SAM/>" – определяет режим вывода отчета по работе утилиты миграции. Если секция не закомментирована символами <! - - . . . - ->, то отчет будет записываться в файл CSV, созданный в папке расположения утилиты с именем IndeedCM.Migrate.SAM.Report_dd-MM-yyyy_HH-mm-ss.csv. По умолчанию отчет не будет создаваться.

  • <register type="IMigrateReporter" mapTo="IndeedCM.Migrate.SAM.Reporter.NullMigrateReporter, IndeedCM.Migrate.SAM/>" – отключает создание отчета о работе утилиты миграции данных. По умолчанию секция закомментирована символами *<! - - . . . - ->.

    Использование двух активных секций с параметрами IndeedCM.Migrate.SAM.Reporter.CSVMigrateReporter, IndeedCM.Migrate.SAM и IndeedCM.Migrate.SAM.Reporter.NullMigrateReporter, IndeedCM.Migrate.SAM не допускается. Одна из них обязательно должна быть закомментирована или удалена.

Сохраните внесенные изменения.

<container>

<register type="ICardRepository" mapTo="IndeedCM.Persistence.AD.CardRepository, IndeedCM.Persistence.AD" />
 <register type="IUserDataRepository" mapTo="IndeedCM.Persistence.AD.UserDataRepository, IndeedCM.Persistence.AD" />
 <register type="IPolicyRepository" mapTo="IndeedCM.Persistence.AD.PolicyRepository, IndeedCM.Persistence.AD" />
 <register type="ICardTypeRepository" mapTo="IndeedCM.Persistence.AD.CardTypeRepository, IndeedCM.Persistence.AD" />
 <register type="ILicenseRepository" mapTo="IndeedCM.Persistence.AD.LicenseRepository, IndeedCM.Persistence.AD" />
 <register type="ISkziRepository" mapTo="IndeedCM.Persistence.AD.SkziRepository, IndeedCM.Persistence.AD" />
 <register type="IUserCatalog" mapTo="IndeedCM.UserCatalog.AD.UserCatalog, IndeedCM.UserCatalog.AD" />
 <register type="ISAMDbContext" mapTo="IndeedCM.Migrate.SAM_8_0.Core.SAMDbContext, IndeedCM.Migrate.SAM_8_0" />
 <register type="ISAMHelpers" mapTo="IndeedCM.Migrate.SAM_8_0.Utils.SAMHelpers, IndeedCM.Migrate.SAM_8_0" />
<register type="IMigrateReporter" mapTo="IndeedCM.Migrate.SAM.Reporter.CSVMigrateReporter, IndeedCM.Migrate.SAM" />

</container>

Работа с утилитой IndeedCM.Migrate.SAM

Для старта процесса миграции данных выполните следующие действия:

  1. Выполните вход на сервер SAM под сервисной учетной записью SAM (Service Account).
  2. Запустите утилиту в тестовом режиме IndeedCM.Migrate.SAM.exe /test в командной строке Windows, запущенной от имени администратора. Тестовый запуск утилиты требуется для генерации отчета о том, какие устройства и сертификаты будут перенесены в ходе миграции, а так же для вывода информации по возникшим ошибкам. В этом режиме работы утилиты данные с репозиториев не переносятся, а так же не заносятся события в журнал.
  3. Если в тестовом режиме не было выявлено никаких критических ошибок, то продолжите миграцию. Для этого запустите утилиту IndeedCM.Migrate.SAM.exe в командной строке Windows, запущенной от имени администратора.
  4. В ходе работы утилита будет отображать выполняемые действия с устройствами и выводить сведения об ошибках.

Если в файле конфигурации IndeedCM.Migrate.SAM.exe.config включена опция ведения отчета, то файл отчета с именем IndeedCM.Migrate.SAM.Report_dd-MM-yyyy_HH-mm-ss.csv будет создан автоматически в каталоге с утилитой миграции.

События успешности или ошибки переноса данных могут быть записаны в журнал на сервере Rutoken KeyBox.

Для записи событий миграции в журнал сервера Rutoken KeyBox необходимо использовать компонент RutokenKeyBox.EventLog.Proxy, который позволяет записывать события в журнал сервера с удаленных рабочих станций (других серверов Rutoken KeyBox или сервера SAM, на котором работает утилита миграции).

Для настройки записи событий утилиты миграции данных в журнал событий сервера Rutoken KeyBox выполните следующие действия:

  1. Откройте файл ...SAMMigration\IndeedCM.Migrate.SAM.exe.config от имени администратора в текстовом редакторе и добавьте элемент proxyServer в секцию eventLogAuditSettings со следующими атрибутами:
    • url – путь к сервису eventlogproxy, развернутому на сервере Rutoken KeyBox;

    • userName – имя пользователя, под которым осуществлять подключение к сервису (должно совпадать с именем в секции authorization файла web.config приложения eventlogproxy);

    • password - пароль учетной записи, используемой для подключения к сервису.

      <proxyServer url="https://server.demo.local/eventlogproxy"
      userName="DEMO\Administrator" password="P@ssw0rd" />

  2. Сохраните изменения.
  3. Установите компонент RutokenKeyBox.EventLog.Proxy (располагается в каталоге дистрибутива сервера) на сервер Rutoken KeyBox.

  4. Откройте файл C:\inetpub\wwwroot\eventlogproxy\Web.config от имени администратора в текстовом редакторе и укажите в секции authorization учетные данные для доступа к сервису eventlogproxy.

    <proxyServer url="https://server.demo.local/eventlogproxy"
    userName="DEMO\Administrator" password="P@ssw0rd" />

  5. Сохраните изменения.


  • No labels