Staging-host попадает в пост, когда ссылка строится из текущего request host, preview URL или переменной окружения с безопасным значением по умолчанию. Исправление — один обязательный public origin для production и проверка уже готового payload перед очередью публикации.
Сначала остановите только затронутую очередь или канал, не удаляя историю. Сохраните ID публикации, ревизию контента и конечный URL без приватных query-параметров. Затем определите, ошибка уже была в карточке материала или появилась при рендеринге шаблона.
Источник ссылки виден по форме ошибки
| Что опубликовано | Где искать | Контрольный признак |
|---|---|---|
| staging.example целиком | PUBLIC_BASE_URL | Одинаковый host во всех постах релиза |
| Правильный host, тестовый path | CMS или route mapping | Путь есть только в preview |
| localhost или внутреннее имя | Fallback из request host | Ошибка зависит от worker окружения |
| Старая production-страница | Payload создан заранее | Очередь хранит прежний canonical URL |
| URL с тестовым query | UTM builder | Host верен, параметры взяты из sandbox |
Не редактируйте опубликованную ссылку до фиксации payload и source revision: иначе исчезнет доказательство, на каком шаге произошла подмена. После разбора пост можно исправить штатным API площадки или новой публикацией по правилам канала.
URL собирает parser, а не конкатенация строк
function buildPublicUrl(publicOrigin, articlePath) {
if (!publicOrigin) throw new Error("PUBLIC_ORIGIN is required");
const url = new URL(articlePath, publicOrigin);
const allowed = new Set(["www.example.com", "example.com"]);
if (url.protocol !== "https:" || !allowed.has(url.hostname)) {
throw new Error("Public URL is outside the production allowlist");
}
url.username = "";
url.password = "";
return url.href;
}Стандартный URL parser разделяет scheme, authority, path, query и fragment. Простая проверка startsWith("https://example.com") опасна: строка с похожим доменом или userinfo способна пройти визуальный тест. Сравнивайте разобранные protocol и hostname с точным allowlist.
Production origin не наследуется от входящего запроса
Host header и URL preview подходят для навигации внутри окружения, но не для внешней публикации. Worker может выполняться без HTTP-запроса, за reverse proxy или в review app. PUBLIC_ORIGIN задаётся явно для production deployment и не имеет значения localhost по умолчанию.
- Конфигурация проверяется при старте worker, а не при первом посте.
- Preview и canonical URL хранятся в разных полях.
- Redirect URL тоже проходит проверку конечного host, если система его разрешает.
- UTM builder меняет только query готового публичного URL.
- Канал публикации имеет собственный allowlist, если брендов несколько.
Guard ставится перед необратимым API-вызовом
Редакторская форма может быть правильной, а шаблон канала — подставить другой URL. Поэтому последний guard читает фактический outgoing payload сразу перед enqueue или send. При нарушении он переводит запись в blocked с понятной причиной и не делает автоматических повторов.
Запрет не должен молча заменять host на production: path тестовой страницы может не существовать публично или вести к другому материалу. Нужна явная повторная сборка из исходного content ID и подтверждение preview.
Очередь хранит ссылку и её происхождение
Для воспроизводимости сохраните canonical URL, content revision, public_origin_version и payload hash. При повторе используйте тот же утверждённый payload либо создайте новую ревизию; смесь нового текста со старой ссылкой затруднит аудит. Сам URL можно хранить без чувствительных одноразовых параметров.
Контрольный набор ловит похожие домены
- Production HTTPS host и обычный относительный path — разрешены.
- Staging, review-app и localhost — блокируются.
- example.com.evil.test — блокируется как другой hostname.
- URL с userinfo перед @ — блокируется или очищается по политике.
- Protocol-relative ссылка получает заданный production base.
- Утверждённый пост после нового deploy сохраняет тот же canonical URL.
Разбор не требует доступа к аккаунту соцсети
Подготовьте обезличенный outgoing payload, content ID, revision, значения public origin по окружениям и код сборки URL. Access token площадки и приватные preview-ссылки удалите. Этих данных достаточно, чтобы воспроизвести ошибку локально и добавить блокирующий тест до следующей публикации.