Перейти к основному содержимому

Учётные записи и многопользовательская изоляция

order-svc публикует orders.> и подписывается на _INBOX.>, analytics-reader пока не ограничен. Оба находятся в общем пространстве.

У команд разные владельцы и код; приватный трафик не должен смешиваться. Вместо растущих списков прав разделим их структурно по учётным записям.

Учётная запись​

Учётная запись — изолированный арендатор со своим пространством тем.

Публикации ORDERS видны только её подписчикам. Одинаковое имя orders.shipped в двух записях означает разные темы.

Права предыдущей страницы ограничивают пользователя внутри записи; граница записи исключает пересечение сама.

Платформе нужны:

  • ORDERS — сервис с публикациями orders.>.
  • ANALYTICS — читатель отправленных заказов.

Пока они полностью изолированы. Явная связь — Межаккаунтный обмен.

В анимации одинаковую orders.shipped получает лишь подписчик ORDERS, не analytics-reader.

Уже существующие записи​

До ваших записей сервер предоставляет две.

$G — глобальная. В ней живут подключения без accounts и прежние два пользователя. Начальное плоское пространство — тоже учётная запись.

$SYS — системная для мониторинга и управления, например $SYS.SERVER.>. В других записях подписка на такое имя принимается, но ничего не получает: отвечающие расположены только в системном пространстве.

Только $G зарезервировано: объявить его нельзя. Собственную $SYS объявить можно, она автоматически системная, но для своих имён яснее избегать $. Системную запись меняет верхний system_account.

Системные темы и события — в справочнике.

Минимальная конфигурация​

Добавьте верхний accounts к конфигурации из Основ аутентификации и перенесите пользователей внутрь. Права order-svc прежние. Удалите прежний authorization, иначе оставшиеся там пользователи будут в $G.

accounts {
ORDERS: {
jetstream: enabled
users: [
{
user: order-svc
password: s3cr3t
permissions: {
publish: { allow: ["orders.>"] }
subscribe: { allow: ["_INBOX.>"] }
}
}
]
}
ANALYTICS: {
users: [
{ user: analytics-reader, password: an4lytics }
]
}
}

Имена верхних элементов ORDERS и ANALYTICS определяют арендаторов и используются в обмене и журналах.

Users задаёт пользователей записи; один пользователь принадлежит одной. Имена уникальны на сервере, иначе запуск: Duplicate user "order-svc" detected. Поддерживаются прежние пароль и NKey.

Права order-svc теперь разрешают темы только внутри ORDERS; граница защищает от других.

jetstream: enabled включает JetStream для записи. Без него API даёт JetStream not enabled for account (10039). ANALYTICS поток не нужен. Старый поток из $G не перемещается вслед за пользователем: при необходимости создайте ORDERS заново в новой записи.

Запустите:

nats-server -c nats.conf

При наличии арендаторских записей анонимный вход больше не допускается: нужен пользователь одной из них.

nats pub orders.shipped 'hi'
nats: error: nats: Authorization Violation

Но accounts только с системной записью всё ещё допускает анонимных в $G: закрывает именно наличие арендаторов.

Проверка границы​

Опубликуйте order-svc и подпишитесь analytics-reader на orders.shipped. Между записями ничего не придёт.

#!/bin/sh
# Prove that two accounts never see each other's traffic.
#
# This uses the two-account nats.conf from the web-page. order-svc carries the
# permissions built on the Authorization page:
#
# accounts {
# ORDERS: {
# jetstream: enabled
# users: [
# {
# user: order-svc
# password: s3cr3t
# permissions: {
# publish: { allow: ["orders.>"] }
# subscribe: { allow: ["_INBOX.>"] }
# }
# }
# ]
# }
# ANALYTICS: {
# users: [
# { user: analytics-reader, password: an4lytics }
# ]
# }
# }
#
# Start the server with that config in another terminal:
# nats-server -c nats.conf

# 1. The analytics reader (in ANALYTICS) subscribes to orders.shipped.
# Leave this running in its own terminal.
nats sub --user analytics-reader --password an4lytics "orders.shipped"

# 2. The order service (in ORDERS) publishes a shipment to the same subject.
nats pub --user order-svc --password s3cr3t "orders.shipped" \
'{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}'
# Expected: Published 91 bytes to "orders.shipped"
# The subscriber from step 1 stays silent: identical subject name,
# different account, no crossing.

# 3. Positive control: publish the same payload from inside ANALYTICS.
# The subscriber from step 1 receives this one, because publisher and
# subscriber now share an account. (order-svc can't play the subscriber
# here: its subscribe allow list only covers _INBOX.>.)
nats pub --user analytics-reader --password an4lytics "orders.shipped" \
'{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}'
# Expected in the step-1 subscriber:
# [#1] Received on "orders.shipped"
# {"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}

# 4. Isolation on a request: with the subscriber from step 1 still running
# in ANALYTICS, order-svc sends a request to the same subject.
nats request --user order-svc --password s3cr3t "orders.shipped" 'status?'
# Expected, immediately (and the command exits 0):
# Sending request on "orders.shipped"
# No responders are available
# Not a permissions error: order-svc may publish orders.>. The only
# subscriber on orders.shipped is in ANALYTICS, so inside ORDERS the
# request finds no responders.
14:20:15 Subscribing on orders.shipped
14:20:16 Published 91 bytes to "orders.shipped"

91 байт опубликован в ORDERS, но ANALYTICS выводит лишь Subscribing on.

Положительная проверка: опубликуйте ту же нагрузку как analytics-reader; местный подписчик получит сразу.

[#1] Received on "orders.shipped"
{"order_id":"ord_8w2k","customer":"acme-co","total_cents":4200,"ts":"2026-05-22T10:14:22Z"}

Проверка выполняется внутри ANALYTICS, поскольку подписка order-svc на orders.shipped запрещена: Permissions Violation for Subscription to "orders.shipped".

Теперь order-svc делает request к той же теме при существующем подписчике ANALYTICS:

14:20:18 Sending request on "orders.shipped"
14:20:18 No responders are available

No responders are available приходит немедленно: внутри ORDERS отвечающих нет. При неожиданном no responders проверяйте учётные записи сторон.

Одну тему намеренно пропустит Межаккаунтный обмен.

За рамками​

У записи есть и другие возможности.

Ограничения соединений и JetStream-хранения, а также события — эксплуатационная тема. Поля в справочнике.

Экспорт/импорт — намеренный переход темы через границу; следующая страница.

Все поля — в accounts. Здесь users и jetstream.

Типичные ошибки​

Практические проблемы:

No_auth_user снова открывает доступ. Он помещает анонимных в запись выбранного пользователя. Не назначайте широкого пользователя $G, задайте узкого. Параметр не вводится и не меняется reload: config reload not supported for NoAuthUser, нужен рестарт. nats-server -t не обнаружит отсутствующего пользователя, ошибка появится при запуске. С доверенным оператором настройка запрещена. См. no_auth_user.

В системной записи нет пользователя. Тогда события и управление недоступны. Создайте SYS с пользователем и system_account: SYS. Это остаётся в дальнейших конфигурациях:

accounts {
# ORDERS and ANALYTICS unchanged
SYS: {
users: [ { user: sys-admin, password: syspass } ]
}
}
system_account: SYS

Проверим разницу арендатора и системного пользователя:

#!/bin/sh
# Confirm the system account is reachable once you declare a user for it.
#
# nats.conf for this example adds a SYS account to the page's config:
#
# accounts {
# ORDERS: { ... unchanged from the page ... }
# ANALYTICS: { users: [ { user: analytics-reader, password: an4lytics } ] }
# SYS: { users: [ { user: sys-admin, password: syspass } ] }
# }
# system_account: SYS
#
# Start it with: nats-server -c nats.conf

# A tenant user reaches only its own account.
nats account info --user analytics-reader --password an4lytics
# Expected (among other lines):
# Account: ANALYTICS (ANALYTICS)
# System Account: false

# The system-account user can query any account on the server.
nats server account info SYS --user sys-admin --password syspass
# Expected (among other lines):
# System Account: true

# Watch live server events flowing on $SYS.SERVER.> (Ctrl-C to stop).
nats subscribe '$SYS.SERVER.>' --user sys-admin --password syspass
# Expected: advisories such as $SYS.SERVER.ACCOUNT.ANALYTICS.CONNS
# as clients connect and disconnect.
User: analytics-reader
Account: ANALYTICS (ANALYTICS)
System Account: false

analytics-reader видит свою запись и System Account: false. sys-admin — Account: SYS (SYS), true, сведения любых записей через nats server account info и события $SYS.SERVER.ACCOUNT.ANALYTICS.CONNS. У order-svc даже строка Account может отсутствовать: его allow блокирует $SYS.REQ.USER.INFO.

Одинаковое имя не связывает записи. Для orders.shipped требуется явный экспорт/импорт.

Что уже готово​

Конфигурация содержит:

  • ORDERS с JetStream и правами order-svc.
  • ANALYTICS с пока неограниченным analytics-reader.
  • SYS с пользователем, назначенную системной.
  • Встроенные глобальные механизмы $G/$SYS.

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

Что дальше​

Аналитике нужны отправленные заказы. Откроем только orders.shipped: Межаккаунтный обмен.

См. также​