Различия

Показаны различия между двумя версиями страницы.

--- symantec:synamtec-liveupdate-administrator-2-3-howto-changing-replace-ssl-certificate [19.05.2017 17:35] – Алексей Максимов
+++ symantec:synamtec-liveupdate-administrator-2-3-howto-changing-replace-ssl-certificate [19.05.2017 18:39] (текущий) – Алексей Максимов
@@ Строка 3: / Строка 3: @@
 {{:symantec:pasted:20170519-203525.png }}
-Одной из задач, которая может возникнуть перед администратором **Symantec LiveUpdate Administrator** (**LUA**), является замена автоматически сгенерированного в процессе установки само-подписанного цифрового SSL-сертификата, который используется для защиты соединения веб-сервером **Tomcat** из состава LUA.
+Одной из задач, которая может возникнуть перед администратором **Symantec LiveUpdate Administrator** (**LUA**), является замена автоматически сгенерированного в процессе установки само-подписанного цифрового SSL-сертификата, который используется для защиты соединения веб-сервером **Tomcat** из состава LUA. Чтобы выполнить данную задачу, за основу возьмём последовательность действий, описанную в посте [[https://www.niwis.com/forum/forum/endpoint-security/symantec-endpoint-protection-11-12/tipps-tricks/32719-liveupdate-administrator-?-howto-changing-the-ssl-certificate|LiveUpdate Administrator – HOWTO changing the SSL Certificate]]
+\\
+==== Получение сертификата в формате PFX ====
+Первый делом получаем из доверенного Центра Сертификации (ЦС) сертификат в формате **PKCS #12** [.**PFX**], содержащий все желаемые имена для нашего веб-сервера LUA. В моём случае используется SAN-сертификат, полученный от ЦС на базе Windows Server. Сертификат был запрошен непосредственно с сервера LUA (через оснастку управления сертификатами в **mmc.exe**). При формировании запроса сертификата нужно учесть ряд параметров:
+  * Алгоритм подписи **SHA256**
+  * Открытый ключ **RSA (2048 Bit)**
+  * Включён признак возможности экспорта закрытого ключа
+После того, ка сертификат получен от ЦС и установлен на сервер, через оснастку управления сертификатами в **mmc.exe** выполняем экспорт этого сертификата в паре с закрытым ключом в защищённый паролем **PFX**-файл.
+{{ :symantec:pasted:20170519-205741.png }}
+\\
+==== Замена файла Java Keystore ====
+Базовую информацию о замене сертификата в LUA можем посмотреть в документе [[https://support.symantec.com/en_US/article.TECH227252.html|Symantec Article TECH227252 - Replace LiveUpdate Administrator certificate]]. Кратко говоря, LUA использует веб-сервер **Tomcat**, который в свою очередь, использует файл формата **Java Keystore** (**JKS**) для хранения сертификата и его закрытого ключа. Нам потребуется создать новый JKS-файл и заменить этим файлом JKS-файл, используемый в Tomcat.
+Имя этого файла **server-cert.ssl** и хранится он в каталоге установки LUA. По умолчанию это каталог **C:\Program Files (x86)\Symantec\LiveUpdate Administrator\**.
+Итак, нам нужно удалить используемый JKS-файл **server-cert.ssl**, предварительно сохранив его копию (на случай возврата на прежнее место, если что-то пойдёт "не так")
+Открываем с правами Администратора командную строку и переходим в каталог установки LUA:
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">cd /d C:\Program Files (x86)\Symantec\LiveUpdate Administrator</div></pre></HTML>
+Делаем резервную копию JKS-файла и затем удаляем его:
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">copy server-cert.ssl server-cert.ssl.orig
+del server-cert.ssl</div></pre></HTML>
+Переходим в каталог подкаталог **\jre\bin** в каталоге установки LUA:
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">cd /d C:\Program Files (x86)\Symantec\LiveUpdate Administrator\jre\bin</div></pre></HTML>
+Конвертируем **PFX**-файл в новый **JKS**-файл хранилища сертификатов (будет сгенерирован новый файл **server-cert.ssl**), указав пароль от PFX-файла (в нашем примере ''pfxP@ssw0rd'') и задав собственный пароль для создаваемого JKS-хранилища (в нашем примере ''LuAjKsPazW0rd''):
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">keytool.exe -importkeystore -srckeystore "C:\Temp\cert.pfx" \ <br> -destkeystore "C:\Program Files (x86)\Symantec\LiveUpdate Administrator\server-cert.ssl" \ <br> -srcstoretype PKCS12 -deststoretype JKS \ <br> -srcstorepass pfxP@ssw0rd -deststorepass LuAjKsPazW0rd</div></pre></HTML>
+В процессе генерации будет выведено соообщение типа:
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">Entry for alias le-7e56697b-1b56-485c-88de-1b05f8c49375 successfully imported.
+Import command completed:  1 entries successfully imported, 0 entries failed or cancelled</div></pre></HTML>
+Поменяем **алиас** имортированного сертификата с сгенерированного значения (в нашем примере ''le-7e56697b-1b56-485c-88de-1b05f8c49375'') на значение ''lua''
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">keytool.exe -changealias \ <br> -alias le-7e56697b-1b56-485c-88de-1b05f8c49375 -destalias lua \ <br> -keypass pfxP@ssw0rd -storepass LuAjKsPazW0rd \ <br> -keystore "C:\Program Files (x86)\Symantec\LiveUpdate Administrator\server-cert.ssl"</div></pre></HTML>
+Чтобы проверить список сертификатов имеющихся в **JKS**-хранилище можно выполнить команду:
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">keytool.exe -list -v \ <br> -keystore "C:\Program Files (x86)\Symantec\LiveUpdate Administrator\server-cert.ssl" \ <br> -storepass LuAjKsPazW0rd</div></pre></HTML>
+Дополнительно устанавливаем **пароль** на доступ к ключу в **JKS**-хранилище таким же, как установлен пароль на доступ к самому хранилищу:
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">keytool.exe -keypasswd -alias lua \ <br> -keypass pfxP@ssw0rd -new LuAjKsPazW0rd -storepass LuAjKsPazW0rd \ <br> -keystore "C:\Program Files (x86)\Symantec\LiveUpdate Administrator\server-cert.ssl"</div></pre></HTML>
+Не забываем удалить PFX-файл из временной папки:
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">del "C:\Temp\cert.pfx"</div></pre></HTML>
+\\
+==== Правка catalina.properties ====
+Найдём файл **catalina.properties** в подкаталоге **\tomcat\conf** каталога установки LUA. Откроем этот файл в текстовом редакторе и закомментируем строку (постваим символ # в начале строки):
+<file ini catalina.properties>...
+org.apache.tomcat.util.digester.PROPERTY_SOURCE=com.symantec.lua.SSLPasswordDecrypt
+...</file>
+Аналогичным образом закомментируем строку со старым параметром ''ks.password''. Затем добавим новую строку, в которой в параметре ''ks.password'' укажем пароль на доступ к JKS-хранилищу, который мы задали ранее.
+В конечном итоге конец файла **catalina.properties** примет примерно следующий вид:
+<file ini catalina.properties>...
+ks.password=LuAjKsPazW0rd
+# ks.password=YqnftEU2J4Og5oF98l6eGQ==
+# org.apache.tomcat.util.digester.PROPERTY_SOURCE=com.symantec.lua.SSLPasswordDecrypt</file>
+\\
+==== Перезапуск LUA ====
+Чтобы веб-сервер LUA подхватил наше новое JKS-хранилище, перезагружаем службу **LUA Apache Tomcat**:
+<HTML><pre style="padding:3px;"><div style="background:#5a5a62;color:#ffffff;padding:10px;">net stop LUATomcat & net start LUATomcat</div></pre></HTML>
+<WRAP center tip 100%>
+Имейте ввиду, что служба может останавливаться длительное время.\\
+Кроме того, после запуска службы веб-консоль сервера LUA может быть недоступна длительно время (до тех пор пока не закончится инициализация веб-приложения).
+</WRAP>
+\\
+==== Проверяем результат ====
+В свойствах ярлыка для запуска LiveUpdate Administrator есть ссылка на файл "''C:\Program Files (x86)\Symantec\LiveUpdate Administrator\LiveUpdate Administrator.bat''". Поменяем в этом файле ссылку на использование нужного нам имени, например FQDN сервера и укажем протокол **HTTPS** порт (по умолчанию для HTTPS используется порт **7073**):
+<file cmd Administrator.bat>start https://KOM-AD01-LUA01.holding.com:7073/lua</file>
+После этого запускаем ярлык и проверяем результат - веб-консоль LUA должна использовать для протокола HTTPS установленный нами в JKS-хранилище сертификат, и теперь браузер не будет "ругаться" о недоверии сертификату.
 ----
 {{:user:blogroot.png?50&nolink |}} Автор первичной редакции:\\ [[user:blogroot|Алексей Максимов]] \\ Время публикации: 19.05.2017 20:20
-{{tag>Symantec LUA LiveUpdate "LiveUpdate Administrator" SSL Tomcat "Web Server" HTTPS PKCS12 PFX Java JRE JKS "Java keystore" keytool Certificate SHA256 Security}}
+{{tag>Symantec LUA LiveUpdate "LiveUpdate Administrator" SSL Apache Tomcat "Web Server" HTTPS PKCS12 PFX Java JRE JKS "Java keystore" keytool Certificate SHA256 Security}}
 ~~DISCUSSION~~