В системе Документерра доменное имя по умолчанию можно изменить на пользовательское имя по своему выбору.
По умолчанию имя любого портала Документерры выглядит примерно так: mycompany.documenterra.net. Существует возможность присвоить порталу пользовательское доменное имя. Как правило, может возникнуть необходимость сделать портал документации поддоменом основного домена компании: docs.my-company-website.com. Для этого потребуется внести изменения в DNS-записи домена компании, чтобы новый домен указывал на ваш портал Документерры. Чтобы это сделать вам может понадобиться помощь вашего ИТ-отдела. Вот пример того, как это выглядит у одного из популярных регистраторов доменных имен Beget :
Кроме того, вам понадобится SSL-сертификат для соответствующего доменного имени, если вы хотите использовать свой собственный сертификат.
| Применение пользовательского доменного имени к порталу не приводит к простою. Однако после этого всем вашим пользователям придется снова войти на портал. |
Назначение пользовательского доменного имени
Перед настройкой пользовательского доменного имени в системе Документерра, попросите ИТ-службу изменить DNS-записи через интерфейс регистратора домена. Смысл изменения прост — вы связываете имя портала по умолчанию со своим собственным доменным именем, создав специальную запись CNAME.
| Внесение DNS-записей может занять несколько часов на стороне регистратора домена. Старые записи могут кэшироваться в сети, что увеличивает время обновления — можно перезагрузить интернет-прокси или маршрутизатор, чтобы обновить свои DNS-записи. |
Для изменения доменного имени:
- Нажмите Настройки.
- Перейдите в раздел Администрирование → Управление доменами. Откроется страница настроек управления доменом, где вы сможете настроить пользовательское доменное имя.
-
Нажмите кнопку Добавить пользовательское доменное имя , после чего откроется мастер:
- Введите новое Доменное имя в соответствующем поле на шаге 1 в мастере и нажмите Проверить запись DNS. После этого начнется проверка, это может занять некоторое время.
- После завершения проверки нажмите Дальше.
-
На шаге 2 выберите тип SSL-сертификата:
- Let's Encrypt. Это бесплатный базовый сертификат. Если вы выберете эту опцию, сертификат будет выдан автоматически, вам не нужно будет делать это вручную. Он также будет автоматически обновляться.
- Пользовательский. Это платный сертификат, который обновляется вручную. Загрузите сертификат в формате PFX и укажите пароль к PFX-файлу в соответствующем поле. Если пароль не требуется, оставьте поле для ввода пароля пустым.
-
Нажмите Дальше.
- На следующем шаге мастера будет показан результат настройки. Если вы выбрали сертификат Let's Encrypt, начнется процесс получения сертификата. Как только сертификат Let's Encrypt будет применен, мы отправим вам уведомление по электронной почте.
- Нажмите Завершить.
После применения сертификата, ваш портал онлайн-документации станет доступен по новому пользовательскому доменному имени. Таким образом, вы получите уникальное доменное имя, которое будет соответствовать имени вашего основного сайта и повысит вашу узнаваемость в Интернете.
Обновление SSL-сертификата
Если ваш пользовательский SSL-сертификат истёк или вы хотите изменить тип сертификата, вы можете легко обновить его через Настройки портала. Для этого следуйте приведённым ниже инструкциям:
- Перейдите в Настройки → Администрирование → Управление доменами.
- Нажмите кнопку Обновить сертификат, чтобы запустить мастер обновления сертификата.

- Выберите тип сертификата. В мастере вам будет доступно два варианта:
- Let's Encrypt: бесплатный базовый SSL-сертификат, который автоматически выпускается и продлевается, не требуя ручного обновления.

- Пользовательский: если вы предпочитаете использовать свой SSL-сертификат, загрузите его в формате PFX и введите пароль для PFX-файла в соответствующее поле. Если пароль не требуется, оставьте поле пустым.

- Let's Encrypt: бесплатный базовый SSL-сертификат, который автоматически выпускается и продлевается, не требуя ручного обновления.
- Нажмите Дальше, чтобы проверить результат настройки.
- Нажмите Завершить.
Следуя этим шагам, вы сможете обновить ваш SSL-сертификат.