Межаккаунтный обмен
ORDERS и ANALYTICS изолированы: order-svc публикует внутри первой, analytics-reader подписывается внутри второй.
Иногда нужно намеренное совместное использование.
Аналитике необходимо считать orders.shipped, но одинаковой подписки недостаточно.
Откроем только эту тему, сохранив остальные границы.
Экспорт и импорт
Нужны согласованные декларации обеих сторон.
Экспорт предлагает тему владельца другим: ORDERS экспортирует orders.shipped.
Импорт выбирает тему и запись владельца и включает в локальное пространство ANALYTICS.
Экспорт без импорта ничего не переносит. Импорт без экспорта отклоняет конфигурацию при запуске.
Тип экспорта
Stream export — односторонний pub/sub. ORDERS публикует, ANALYTICS читает. С потоками JetStream название не связано: stream здесь означает поток сообщений через границу.
Service export — двусторонний request/reply, например запрос цены ORDERS из ANALYTICS. Здесь не нужен; подробнее в exports.
Экспорт ORDERS
Добавьте exports к записи. Пользователи, права, SYS и system_account прежние; пример показывает только арендаторов:
accounts {
ORDERS: {
jetstream: enabled
users: [
{ user: order-svc, password: s3cr3t,
permissions: {
publish: { allow: ["orders.>"] }
subscribe: { allow: ["_INBOX.>"] }
}
}
]
exports: [
{ stream: "orders.shipped" }
]
}
ANALYTICS: {
users: [
{ user: analytics-reader, password: an4lytics }
]
}
}
Ключ stream: задаёт одновременно тип и тему. Service использовал бы service:.
Без ограничений экспорт публичный, импорт доступен любой записи сервера. Для выбранных перечислите accounts:
{ stream: "orders.shipped", accounts: [ANALYTICS] }
Здесь достаточно публичного.
Более сложные ограничения есть в режиме оператора.
Импорт ANALYTICS
Добавьте соответствующий imports:
accounts {
ORDERS: {
jetstream: enabled
users: [
{ user: order-svc, password: s3cr3t,
permissions: {
publish: { allow: ["orders.>"] }
subscribe: { allow: ["_INBOX.>"] }
}
}
]
exports: [
{ stream: "orders.shipped" }
]
}
ANALYTICS: {
users: [
{ user: analytics-reader, password: an4lytics }
]
imports: [
{ stream: { account: ORDERS, subject: "orders.shipped" } }
]
}
}
Stream должен совпадать с типом, account — ORDERS, subject — исходная orders.shipped.
Примените nats-server --signal reload=<pid> или перезапустите. Теперь тема появляется и в ANALYTICS.
По умолчанию имя прежнее. Prefix или to меняют локальное имя против конфликтов; здесь не нужны. См. imports.
Проверка обмена
Публикация order-svc и подписка analytics-reader связываются только экспортом/импортом.
Анимация также показывает неэкспортированную orders.created внутри ORDERS. Проверьте shipped:
- CLI
#!/bin/sh
# analytics-reader (in ANALYTICS) subscribes to the imported orders.shipped
# while order-svc (in ORDERS) publishes it. The export/import pair makes the
# message cross the account boundary.
#
# Assumes the server config from this page: ORDERS exports the stream
# "orders.shipped" and ANALYTICS imports it from ORDERS.
# Context for analytics-reader in the ANALYTICS account.
nats context save analytics \
--server nats://localhost:4222 \
--user analytics-reader \
--password an4lytics
# Context for order-svc in the ORDERS account.
nats context save orders \
--server nats://localhost:4222 \
--user order-svc \
--password s3cr3t
# Subscribe as analytics-reader to the imported subject (background).
nats --context analytics sub "orders.shipped" &
SUB_PID=$!
sleep 1
# Publish a shipment as order-svc in ORDERS.
nats --context orders pub orders.shipped \
'{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}'
sleep 1
kill "$SUB_PID"
# Expected (subscriber terminal): the message arrives even though it was
# published in a different account, because ORDERS exports orders.shipped
# and ANALYTICS imports it.
# [#1] Received on "orders.shipped"
# {"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}
Вывод подписчика:
14:19:26 Subscribing on orders.shipped
[#1] Received on "orders.shipped"
{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}
Заказ ord_8w2k поступает с тем же именем. Издатель не знает импортёра и выводит обычное Published 91 bytes to "orders.shipped". Связь полностью в серверной конфигурации.
Остальная изоляция
Orders.created и orders.canceled по-прежнему не видны ANALYTICS.
Exports перечисляет всё, что разрешено вынести из записи.
Третья запись тоже должна импортировать, возможно под другим именем без влияния на существующих.
Та же связь у оператора
В режиме оператора декларации находятся в JWT: nats auth account exports add Shipments "orders.shipped" ORDERS и nats auth account imports add Shipments "orders.shipped" ANALYTICS --source <ORDERS-public-key> --local orders.shipped. Обе записи нужно push. До этого связи нет без проверки запуска. В nats auth нет activation tokens: --token-position ограничивает wildcard-тему открытым ключом импортирующей записи.
Типичные ошибки
Несовпадения сторон:
Экспорт без импорта молчит, обратное останавливает сервер. Проверьте account импорта. Отсутствующий экспорт даёт при запуске:
nats-server: nats.conf:2:1: Error adding stream import "orders.shipped": stream import not authorized
В JWT-режиме непереданный импорт молча не действует. Проверяйте публикацией и подпиской.
Типы не взаимозаменяемы. Если импорт service orders.price существует, но отвечающего в ORDERS нет, приходит No responders are available:
- CLI
#!/bin/sh
# A service export is request/reply, not publish/subscribe. If ANALYTICS calls
# a service subject that ORDERS exports but no responder is running, the
# request comes back as "No responders are available" right away.
#
# This demo starts its own server on the default port, so stop the chapter's
# server first.
# 1. ORDERS exports a service "orders.price"; ANALYTICS imports it.
# No responder is started in ORDERS, so nothing can answer yet.
cat > cross-account-service.conf <<'EOF'
accounts {
ORDERS {
users: [
{ user: order-svc, password: s3cr3t }
]
exports: [
{ service: "orders.price" }
]
}
ANALYTICS {
users: [
{ user: analytics-reader, password: an4lytics }
]
imports: [
{ service: { account: ORDERS, subject: "orders.price" } }
]
}
}
EOF
# 2. Start the server.
nats-server -c cross-account-service.conf &
SERVER_PID=$!
sleep 1
# 3. analytics-reader requests the imported service. No responder is running
# in ORDERS, so the server answers immediately instead of letting the
# request wait out the full timeout.
nats --server nats://localhost:4222 \
--user analytics-reader --password an4lytics \
request orders.price '{"order_id":"ord_8w2k"}' --timeout 2s
# Expected (the CLI exits 0):
# 14:19:42 Sending request on "orders.price"
# 14:19:42 No responders are available
# "No responders" means the import matched the service export but nothing
# answered: start a responder in ORDERS. A request with no import at all gets
# the same immediate answer, because it never leaves ANALYTICS. An import that
# doesn't match any export fails earlier, when the server starts.
kill "$SERVER_PID"
14:19:42 Sending request on "orders.price"
14:19:42 No responders are available
CLI выводит статус и код 0 без ожидания. Запустите responder. Без импорта ответ такой же, поскольку запрос остаётся ANALYTICS. Несовпавший с экспортом импорт отвергается раньше, при запуске.
Переименованный импорт требует нового имени подписки. Prefix/to меняет локальную тему, а не публикацию владельца.
Что уже готово
Одна явная связь:
- ORDERS публично экспортирует stream orders.shipped.
- ANALYTICS импортирует её.
- Analytics-reader получает отправки.
- Остальные события изолированы.
Что дальше
Конфигурационная модель завершена: вход, права, записи, обмен. Теперь уберём список пользователей с сервера.
Перейдите к Режиму оператора.
См. также
- exports — accounts, response_type.
- imports — prefix, to.
- Режим оператора — подписанные JWT.
- Основные понятия → Безопасность.