Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Перед настройкой протокола нужно, что бы на сервере был установлен действительный (valid) SSL-сертификат.

Image Added

Image Added

В приведённой выше таблице можно увидеть как выгладит окно браузера, в случает когда установлен действительный SSL-сертификат и в случае, когда SSL-сертификат не действителен (напр. выдан другому сайту).

Общие положения

Все требуемые для настройки конфигурационные переменные находятся в разделе "Configuration -> System Variables" административной консоли сайта. Независимо о того для какой части сайта настраивается SSL всегда требуется указать значение конфигурационной переменной SSL_URL ("SSL Full URL (https://www.domain.com/path)").

SSL для административной консоли

...

Для подключения SSL к административной консоли требуется включить конфигурационную переменную Require_AdminSSL ("Require SSL for Administrative Console"). Далее нажимаем кнопку Save на панели инструментов и выходим из системы (logout). На странице ввода имени пользователя и пароля должны увидеть то, что обведено на приведённом слева изображении. Вот и все – протокол успешно настроен для административной консоли.

SSL для пользовательской части сайта

Для подключения SSL к пользовательской части сайта требуется включить некоторые (в зависимости от функциональности настраиваемого сайта) из ниже приведённых конфигурационных переменных:

Название конфигурационной переменной

Описание

Require_SSL
Require SSL for login & checkout

Включение SSL режима для страниц сайта, где в html коде шаблона прописан тег <inp2:m_CheckSSL mode="required" condition="Require_SSL"/>

Force_HTTP_When_SSL_Not_Required
Redirect to HTTP when SSL is not required

Эта опция нужна для того, чтобы при переходе со страницы с включенным SSL протоколом на страницу без SSL, происходил автоматический переход на адрес без https.

UseModRewriteWithSSL
Enable MOD_REWRITE for SSL

Если пользовательская часть сайта использует технологию MOD_REWRITE, то можно (но не обязательно) включить данную опцию, для того, чтобы в SSL-режиме тоже строились MOD_REWRITE ссылки.

Для перехода в SSL-режим и обратно на шаблонах следует использовать тэг m_CheckSSL. Его рекомендуется ставить в начале шаблона или после тэга m_RequireLogin, когда таковой используется. Ниже приведён пример использования данного тега в шаблоне:

Code Block
languagehtml
<inp2:m_CheckSSL mode="required"/>
<inp2:m_include template="inc/header"/> <!-- внутри шаблона "inc/header" должен быть тэг <inp2:m_CheckSSL/> -->
HTML Code
<inp2:m_include template="inc/footer"/> 

Описание параметров тега m_CheckSSL:

Название параметра

Описание

Anchor
mode
mode
mode (string)

Если указать "required" в качестве значения данного параметра, то шаблон будет помечен, как требующий наличия SSL-режима для своей корректной работы. Если потом зайти на этот шаблон не из SSL-режима, то будет автоматически включён SSL-режим. Если параметр не указывать или указать пустое значение, то произойдёт обратное действие.

Anchor
for_logged_in_only
for_logged_in_only
for_logged_in_only (int)

Если указать данный параметр, то SSL-режим будет включаться только для авторизованных пользователей.

Anchor
condition
condition
condition (string)

Название конфигурационной переменной, значение которой нужно проверить перед тем, как разрешать переход в SSL-режим. Если указанная конфигурационная переменная отсутствует или выключена, то переход в SSL-режим осуществлён не будет.

Tip

Для пользовательской части сайта можно использовать конфигурационную переменную Require_SSL.

Если планируется переключать некоторые части сайта в SSL-режим в зависимости от настроек конфигурации, то этот параметр является тем, что нужно.

...

Вот в принципе и все, после включения всех соответствующих опций и установки тэга m_CheckSSL можно считать настройку законченной. На приведённом слева изображении показана страница My Account, со включенным протоколом SSL. На ней также можно отчётливо видеть 2 корректных "SSL замочка", которые свидетельствуют о том, что защищённый режим установлен правильно. Если же эти "замочки" показаны с перечёркнутой линией, то это означает, что протокол не корректно установлен на сервере или время его действия истекло.

Secure_warning.jpgImage Added

Возможна ситуация, когда браузер может, при попадании на страницу, показывать приведённое на изображении слева сообщение об ошибке. Как правило, такое сообщение можно увидеть тогда, когда на странице есть ссылка, которая прописана не через относительный путь, а через абсолютный и без указания факта использования протокола SSL. Чтобы этого избежать настоятельно рекомендуется все ссылки на элементы сайта (изображения, таблицы стилей и т.п.) формировать при помощи тэга m_TemplatesBase:

  • не правильно<img src="http://www.youdomain.com/img/sample_image.gif" alt=""/>

  • правильно<img src="<inp2:m_TemplatesBase/>/img/sample_image.gif" alt=""/>