Підтвердження клієнта

Запис клієнта і справжній сайт – це дві різні речі. Створення клієнта дає вам ключ і секрет; підтвердження – це те, що прив'язує цей запис до сайту, на якому ці дані введені. Доки воно не відбулося, клієнт не бере участі в обміні: ваш контент нікому не пропонується, а блоки на ваших сторінках лишаються порожніми.

У кабінеті його ніщо не запускає, і натискати тут нічого не треба. Підтвердження починається на боці сайту – тієї миті, коли дані там збережені.

Посібник з підключення

На сторінці клієнта є кнопка Посібник з підключення, і сам посібник відкривається одразу після створення нового клієнта. Він по черзі вказує на кожне поле і пояснює, що з ним робити, а ключ і секрет несе із собою – обидва можна скопіювати просто з нього, і це важливо, бо відкритий посібник затуляє картку під собою.

Закриття нічого не втрачає. Натисніть кнопку ще раз, коли знадобляться ті самі кроки.

Чотири кроки

1. Встановіть інтеграцію на своєму сайті. Перший крок перелічує доступні: офіційний плагін для WordPress, модуль для Drupal, який ще в розробці, і ваш власний код поверх REST API для будь-якої іншої платформи.
2. Скопіюйте API ключ. Це відкрита половина пари, яка ідентифікує ваш сайт. У плагіні для WordPress вона вводиться в поле API key на вкладці Traffman → Settings → API.
3. Скопіюйте API секрет. Секрет – це половина, яка доводить, що сайт ваш, тому на сторінці клієнта він прихований: копіювання не розкриває його. Вставте його поруч із ключем, у поле API secret.
4. Натисніть Save у плагіні. Це все: перевірка починається звідси.

Що робить наш сервер

Збереження надсилає нам ключ разом з адресою зворотного запиту на вашому сайті, підписані секретом. Цей підпис доводить, що той, хто звертається, знає секрет, – але ще не доводить, що звертається саме сайт. Тож наш сервер повертається до нього сам: викликає ту адресу і передає одноразовий токен, який сайт має підписати тим самим секретом і повернути. Клієнт підтверджується лише тоді, коли відповідь збігається.

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

Після успіху одразу змінюються три речі:

• поле Хост на сторінці клієнта заповнюється адресою підключеного сайту – вона береться саме з адреси зворотного запиту, тому доти лишається порожньою;
• клієнт активується, і його статус стає Активний – якщо ваша підписка дозволяє ще один активний клієнт (див. нижче);
• вам надходить лист із підтвердженням.

Статуси

Очікує підтвердження – це клієнт, за яким ще немає сайту; стан, з якого починається кожен клієнт. Активний – підтверджений клієнт, що бере участь в обміні.

Підтверджений клієнт теж може бути деактивований, і статус пояснює чому:

• Деактивовано: ліміт підписки – клієнт не вміщається в ліміт активних клієнтів вашої підписки: створити клієнтів можна більше, ніж дозволяє ліміт, але одночасно активними може бути лише стільки. Клієнт, підтверджений, коли ліміт уже вичерпано, не активується; після переходу на нижчу підписку деактивуються найновіші клієнти понад ліміт – про це надходить лист. Такий клієнт знову активується автоматично після покращення підписки; або деактивуйте інший клієнт на сторінці редагування й активуйте цей.
• Деактивовано – ви деактивували клієнт самі, на сторінці його редагування. Він лишається деактивованим за будь-яких змін підписки, доки ви не активуєте його знову.

Деактивований клієнт зберігає свій хост, але участі в обміні не бере.

Один сайт – один клієнт

Унікальним клієнт робить хост, а хост береться із сайту, який його підтвердив. Звідси два наслідки:

• Ті самі дані не можна використати на другому сайті. Щойно клієнт підтверджений, збереження його ключа і секрету деінде отримує у відповідь «Mismatch between client host and callback URL host.»
• Сайт, у якого вже є підтверджений клієнт, не може підтвердити поверх нього ще один: «The client host is already in use.»

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

Коли нічого не приходить

Невдала перевірка минає тихо: листа немає, а статус просто лишається Очікує підтвердження. Сама вона теж не повторюється – наш сервер звернувся один раз і не отримав придатної відповіді. Запустити її наново – це та сама кнопка Save на вкладці API, з тим самим ключем і секретом.

Перш ніж натискати ще раз, варто з'ясувати, що саме не склалося. Вкладка Healthcheck у плагіні просить наш сервер звернутися до сайту просто зараз і показує причину невдачі; обидві її кнопки описані у темі встановлення плагіна.

Найчастіша причина – що наш сервер узагалі не дістався до вашого сайту: захист від ботів на хостингу, фаєрвол або CDN відповіли йому капчею замість сторінки. Тема коли захист хостингу блокує наш сервер перелічує назви, під якими ховається ця опція, і показує, як пропустити нашу адресу.

Кілька натискань Save підряд упираються в обмеження частоти: «You can request client confirmation again in N seconds.» Це не означає, що щось зламалося, – перечекайте ці секунди і натисніть один раз.

Ми нагадуємо

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

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