Как настроить URL-адрес портала «white-label» в Tridens

Подробное руководство по перенаправлению домена брендированного клиентского портала на Tridens и его использованию для порталов Tridens EV Charge и Tridens Monetization.

Данное руководство предназначено для администраторов клиентов и ИТ-специалистов, которые хотят использовать URL-адрес портала с собственным брендом вместо перенаправления пользователей на общий домен приложения. С помощью настраиваемой записи CNAME ваши клиенты смогут получать доступ к своим порталам по брендированному адресу, например: https://portal.example.com/ev-charge или https://portal.example.com/monetization.

Настройка DNS проста, но важны все детали. Цель записи CNAME должна указывать на app.tridenstechnology.com. Не добавляйте https:// внутри записи DNS. Протокол HTTPS используется, когда пользователи открывают окончательный URL-адрес портала в браузере.

Краткий обзор

URL-адрес портала в формате «white-label» позволяет вашим клиентам использовать ваш собственный субдомен для доступа к порталу Tridens. Публичный URL-адрес остается под вашим брендом, а Tridens обеспечивает работу приложения, расположенного за ним.

Например, если ваша компания владеет example.com, вы можете создать субдомен portal.example.com. После настройки DNS и активации домена портала ваши клиенты смогут перейти по правильному адресу портала:

• https://portal.example.com/ev-charge для портала Tridens EV Charge.
• https://portal.example.com/monetization для портала Tridens Monetization.

Что Вам нужно перед началом работы

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

• Активная среда Tridens с включенным необходимым порталом.
• Доступ к настройкам DNS для домена вашей компании.
• Выбранный субдомен, например портал, мой, учётная запись, или клиенты.
• Подтверждение того, что выбранный субдомен ещё не используется другим веб-сайтом или приложением.
• Разрешение от вашей внутренней ИТ-службы, службы безопасности или группы администраторов домена, если управление DNS осуществляется централизованно.

Используйте субдомен вместо корневого домена. Например, используйте portal.example.com, а не example.com. Таким образом, ваш основной веб-сайт остается отдельным от портала Tridens.

Как работает URL-адрес портала «White-Label»

Настройка «white-label» обеспечивает подключение вашего домена к приложению Tridens через DNS. Ваш клиент вводит URL-адрес с вашим брендом, запись DNS направляет поддомен на Tridens, а Tridens перенаправляет посетителя по нужному пути на портале.

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

Если вы используете и то, и другое Tridens EV Charge и Tridens Monetization, прежде чем публиковать брендированную ссылку, убедитесь, какие пути портала должны быть видны вашим конечным пользователям.

Настройка записи CNAME

Провайдеры DNS используют слегка отличающиеся обозначения, но структура записей, как правило, одинакова. Вам необходимо создать запись CNAME для выбранного вами субдомена и настроить её так, чтобы она указывала на хост приложения Tridens.

Шаг 1: Выберите субдомен

Выберите короткое название, которое запомнится клиентам. Среди наиболее популярных вариантов: портал, учётная запись, мой, или клиенты. В данном руководстве мы используем portal.example.com.

Шаг 2: Откройте диспетчер DNS

Войдите в систему, в которой осуществляется управление записями DNS вашего домена. Это может быть ваш регистратор доменов, хостинг-провайдер, учетная запись Cloudflare, панель управления DNS Microsoft 365 или другой сервис управляемого DNS.

Шаг 3: Добавьте запись CNAME

Создайте новую запись CNAME со следующими значениями:

Сохраните запись. Изменения в DNS часто вступают в силу в течение нескольких минут, однако их распространение может занять больше времени в зависимости от провайдера DNS и состояния кэша.

Шаг 4: Попросите Tridens активировать домен портала

После сохранения записи CNAME свяжитесь с менеджером вашего проекта Tridens или в службу поддержки и сообщите домен брендированного портала, который вы хотите активировать. Tridens подключит домен к вашей среде и сообщит, когда он будет готов к тестированию.

Не публикуйте ссылку на новый портал для клиентов до завершения его активации и тестирования.

Проверьте URL-адреса портала

Как только Tridens подтвердит, что домен активен, протестируйте портал так, как это сделал бы обычный пользователь. Начните с открытия окна браузера в режиме приватного просмотра или инкогнито, чтобы кэшированные сессии не скрывали проблемы с настройкой.

1. Открыть https://portal.example.com/ev-charge если вы пользуетесь порталом EV Charge.
2. Открыть https://portal.example.com/monetization если вы пользуетесь порталом монетизации.
3. Убедитесь, что страница загружается по протоколу HTTPS и в браузере отображается индикатор безопасного соединения.
4. Проверьте брендинг, навигацию, вход в систему и все действия на портале, доступные для клиентов.
5. Попросите другого пользователя или внутреннего тестировщика проверить работоспособность ссылки из другой сети.

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

Устранение неполадок

Большинство проблем с настройкой возникают из-за конфликтов записей DNS, задержек в распространении данных или ввода целевого значения в неправильном формате.

Портал не загружается

Убедитесь, что запись CNAME существует именно для того поддомена, который вы хотите использовать. Также убедитесь, что нет записей A, AAAA или других записей CNAME, использующих тот же поддомен.

Адрес DNS был введен с использованием протокола HTTPS

В записях DNS не используются протоколы URL. Если в качестве адреса назначения указано https://app.tridenstechnology.com, замените его на app.tridenstechnology.com.

URL с брендом открывает не ту страницу

Убедитесь, что пользователи указывают правильный путь после домена. Портал EV Charge использует /ev-charge. Портал монетизации использует /монетизация.

HTTPS пока не готов

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

Где использовать URL-адрес вашего портала под собственным брендом

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

• Ссылки в верхнем и нижнем колонтитулах сайта.
• Письма по электронной почте для привлечения новых клиентов.
• QR-коды на печатных материалах или в инструкциях к зарядному устройству.
• Сопроводительная документация и статьи справочного центра.
• Управление учетной записью и уведомления о выставлении счетов.

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