> ## Documentation Index
> Fetch the complete documentation index at: https://docs.instaforge.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Власні домени

> Дайте клієнту власну адресу, наприклад portal.their-site.com, для його кабінету, чату на сайті, сторінки запису та магазину.

Клієнт може мати власну адресу для всього, що бачать його клієнти та його команда: сторінки входу, кабінету, чату на сайті, сторінки запису та магазину. На portal.demo-salon.com власник бізнесу бачить свою назву й логотип, а його клієнти ніколи не бачать адреси платформи.

Адміністратори керують доменами на сторінці **Домени** в головному меню. Адміністратор із доступом лише до частини асистентів бачить домени лише тих клієнтів, з якими працює. Домен слугує адресою всіх асистентів клієнта, тому додати, перенести або видалити його може лише адміністратор із доступом до всіх асистентів цього клієнта.

![Сторінка «Домени»](https://mintcdn.com/instaforge/DZPPAhB5awuvrT5G/images/uk/domains.png?fit=max\&auto=format\&n=DZPPAhB5awuvrT5G\&q=85\&s=5bf650e572d40f8c967499fb72230694)

Додати домен (1), запис, який треба надіслати клієнту (2), робочий домен (3)

## Додайте домен

**1. Виберіть адресу разом із клієнтом**

Використовуйте піддомен його сайту, наприклад **portal.their-site.com** або **book.their-site.com**. Кореневий домен (their-site.com) працює, лише якщо DNS-провайдер клієнта дозволяє CNAME у корені домену (це часто називають CNAME flattening або ALIAS).

**2. Додайте його на сторінці «Домени»**

Введіть адресу, виберіть клієнта й натисніть **Додати домен** (1). Домен з'явиться зі статусом **Чекаємо DNS**.

**3. Надішліть клієнту DNS-записи**

У блоці **Надішліть це клієнту** (2) є два записи з кнопками копіювання: **CNAME**, де ім'я збігається з адресою клієнта, а значення вказує на **connect.instaforge.app**, і **TXT**-запис з ім'ям **\_domain-check.** та адресою після нього і значенням, яке починається з **domain-check=**. Клієнт або той, хто веде його сайт, додає обидва в налаштуваннях DNS.

**4. Дочекайтеся запуску**

Сторінка перевіряє все сама. Коли знайдено обидва записи, статус змінюється на **Випускаємо сертифікат**, а за кілька хвилин на **Працює** (3). Натисніть кнопку оновлення, щоб перевірити одразу.

> [!TIP]
>
> Якщо DNS клієнта теж у Cloudflare, запис має бути в режимі **DNS only** (сіра хмарка), без проксіювання.

## Навіщо TXT-запис

Клієнти всіх агенцій спрямовують CNAME на ту саму адресу, тому за CNAME не можна зрозуміти, яку агенцію вибрав клієнт. TXT-запис належить вашій агенції: домен запрацює лише в агенції, чий запис є в DNS клієнта. Ніхто інший не зможе забрати адресу, яку колишній клієнт залишив спрямованою на платформу, а інша агенція, що додала адресу раніше за вас, вам не завадить. Її заявка знімається, коли ви додаєте домен, і без свого запису вона ніколи не запрацює.

Запис той самий для вашої агенції та цієї адреси, тому якщо видалити домен і додати його знову, клієнту нічого змінювати не треба. Домени, які працювали до того, як з'явився TXT-запис, продовжують працювати.

## Що змінюється на домені клієнта

| Де | На домені клієнта |
| - | - |
| Сторінка входу й кабінет | Назва й логотип клієнта замість ваших |
| Чат на сайті | Посилання на чат і код для його сайту використовують його адресу |
| Сторінка запису та магазин | Працюють на його адресі |
| Посилання, які надсилає асистент | Посилання на запис, магазин, оплату та «Приведи друга» використовують його адресу |
| Листи власнику бізнесу | Запрошення, скидання пароля й сповіщення ведуть на його адресу |

![Сторінка входу на домені клієнта](https://mintcdn.com/instaforge/DZPPAhB5awuvrT5G/images/uk/client-domain-login.png?fit=max\&auto=format\&n=DZPPAhB5awuvrT5G\&q=85\&s=42b8375f0fe23fa17310f1b02ba404aa)

Сторінка входу на домені клієнта

Якщо логотипа немає, показується перша літера назви клієнта. Завантажте логотип на сторінці **Портал клієнта** цього клієнта; там само видно адресу клієнта, коли вона з'явиться.

![Адреса клієнта на сторінці «Портал клієнта»](https://mintcdn.com/instaforge/DZPPAhB5awuvrT5G/images/uk/portal-domain.png?fit=max\&auto=format\&n=DZPPAhB5awuvrT5G\&q=85\&s=5b4c6f47dfdabae961cd5749a76f3876)

Адреса клієнта на сторінці «Портал клієнта»

## Хто може там увійти

На домені клієнта можуть увійти лише власники бізнесу цього клієнта. Власник бізнесу іншого клієнта побачить повідомлення, що входити треба на своїй адресі. Ваша команда входить на адресі агенції, як і акаунт власника бізнесу з доступом до всіх асистентів або до асистентів кількох клієнтів. Домен належить клієнту, тому сесія співробітника не повинна зберігатися в браузері на цьому домені. Якщо співробітник раніше увійшов на домені клієнта, цей пристрій вийде з акаунта, коли наступного разу відкриє там панель. На власній адресі платформи всі входять як раніше.

Якщо ви дасте акаунту власника бізнесу іншу роль або асистентів іншого клієнта, він вийде на всіх своїх пристроях, а посилання, уже надіслані йому листом, перестануть працювати. Якщо запрошення ще не прийнято, надійде нове запрошення з посиланням на адресу, якою акаунт користується тепер.

## Що залишається на адресі платформи

Підключення Instagram і вхід через Google завжди відбуваються на власній адресі платформи, бо Meta і Google приймають лише адреси, заздалегідь у них зареєстровані. Це займає секунду, і клієнту нічого робити не треба.

## Лише через фаєрвол клієнта

Деякі клієнти тримають сайт за власним фаєрволом (WAF, наприклад Cloudflare, Imperva, Akamai або AWS WAF) і хочуть, щоб усе на їхньому домені проходило через нього. Чат на сайті працює на платформі, тому сам по собі він відповідає і на адресі платформи, і будь-хто, хто знає адресу чату, може відкрити його там, в обхід фаєрвола клієнта. **Лише через фаєрвол клієнта** це закриває: чат відповідає лише на домені клієнта і лише на запити із секретним заголовком, який фаєрвол клієнта додає до того, що пересилає.

**1. Поставте фаєрвол перед доменом**

Клієнт налаштовує фаєрвол так, щоб він пересилав домен на платформу. У Cloudflare дочекайтеся статусу **Працює**, потім перемкніть запис на **Proxied** (помаранчева хмара): тоді Cloudflare виконує власні правила клієнта, перш ніж запит дійде до платформи.

**2. Увімкніть**

На картці домену, у розділі **Лише через фаєрвол клієнта**, увімкніть перемикач. Він з'являється, коли домен запрацює. Секрет показується один раз, разом із назвою заголовка **X-InstaForge-Firewall**. Скопіюйте обидва й надішліть клієнту. З цієї миті чат не відповідає, доки його фаєрвол не почне додавати заголовок.

**3. Клієнт додає заголовок**

У Cloudflare: **Rules**, **Transform Rules**, **Modify Request Header**, для запитів до домену задайте постійний заголовок із цією назвою і значенням. В інших фаєрволах є схоже налаштування для додавання заголовка до пересланих запитів.

**4. Перевірте, що він доходить**

Картка показує, коли запит із заголовком востаннє дійшов до платформи, а також коли запит востаннє було відхилено і чому: без заголовка фаєрвола, з неправильним секретом або на іншій адресі.

Щоб змінити секрет, натисніть **Новий секрет**. Попередній працює ще 10 хвилин, щоб клієнт встиг поставити новий у свій фаєрвол, не зупиняючи чат. Якщо вимкнути перемикач, чат знову відповідає на всіх адресах, а секрет перестає працювати. Налаштування діє й тоді, коли з доменом проблема, тому чат залишається закритим, а не відкривається на адресі платформи. Попередній перегляд на сторінці **Чат на сайті** і далі працює для вашої команди.

> [!WARNING]
>
> Секрет показується лише один раз. Якщо він загубився, створіть новий. Будь-хто, у кого він є, може відкрити чат в обхід фаєрвола, тому йому місце лише в налаштуваннях фаєрвола клієнта.

## Змініть або видаліть домен

* **Перенести до іншого клієнта:** виберіть клієнта в полі **Клієнт** біля домену. У DNS нічого не змінюється. Власники бізнесу першого клієнта виходять з акаунта на всіх пристроях, а посилання, уже надіслані їм поштою, перестають працювати, бо за цією адресою тепер відкривається інший бізнес. Власник, який ще не прийняв запрошення, отримує нове.
* **Видалити:** натисніть на кошик. Адреса перестає працювати, а посилання клієнта повертаються на адресу платформи. Після цього клієнт може видалити свої DNS-записи.
* **Видалити одного з асистентів клієнта:** домен залишається в інших асистентів клієнта.
* **Видалити останнього асистента клієнта або самого клієнта:** домен видаляється разом із ним, як і його реєстрація в Cloudflare.

> [!WARNING]
>
> Якщо ви видалите домен, код чату на сайті клієнта, який використовує стару адресу, перестане працювати. Скопіюйте новий код на сторінці **Чат на сайті** і надішліть його клієнту.

> [accordion] Уже кілька годин висить «Чекаємо DNS»
>
> Перевірте записи разом із клієнтом. Ім'я CNAME має точно збігатися з доданою адресою, а значення має вказувати на connect.instaforge.app. Ім'я TXT-запису складається з \_domain-check. і адреси, а значення треба скопіювати точно. Деякі DNS-провайдери хочуть як ім'я лише першу частину (portal замість portal.their-site.com, \_domain-check.portal замість \_domain-check.portal.their-site.com). Якщо DNS клієнта в Cloudflare, CNAME має бути в режимі DNS only.

> [accordion] Статус «Проблема»
>
> На картці домену видно, що повідомив Cloudflare. Найчастіше запис видалили або він указує в інше місце. Виправте запис і натисніть кнопку оновлення або видаліть домен і додайте його знову.

> [accordion] Чи платить клієнт щось?
>
> Ні. Адреса належить клієнту, а сертифікат випускається й подовжується автоматично.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.