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

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

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

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

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

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

Права [предыдущей страницы](/learn/security/authorization.md) ограничивают пользователя внутри записи; граница записи исключает пересечение сама.

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

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

Пока они полностью изолированы. Явная связь — [Межаккаунтный обмен](/learn/security/cross-account.md).

**Движение сообщений — Изоляция учётных записей (анимация):** Две учётные записи на одном сервере: ORDERS и ANALYTICS. order-svc публикует orders.shipped внутри ORDERS: подписчик той же учётной записи получает сообщение, а analytics-reader, подписанный на точно такую же строку темы в ANALYTICS, не получает ничего. Учётная запись — изолированное пространство тем: одинаковые имена в двух учётных записях означают разные темы.

* order-svc → NATS
* NATS → orders-sub
* NATS → analytics-reader

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

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

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

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

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

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

Системные темы и события — в [справочнике](/reference/system/.md).

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

Добавьте верхний accounts к конфигурации из [Основ аутентификации](/learn/security/authentication-basics.md) и перенесите пользователей внутрь. Права 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`](/reference/config/accounts/jetstream/.md) включает 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. Между записями ничего не придёт.

#### CLI

```
#!/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 проверяйте учётные записи сторон.

Одну тему намеренно пропустит [Межаккаунтный обмен](/learn/security/cross-account.md).

## За рамками

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

**Ограничения** соединений и JetStream-хранения, а также события — эксплуатационная тема. Поля в [справочнике](/reference/config/accounts/limits/.md).

**Экспорт/импорт** — намеренный переход темы через границу; [следующая страница](/learn/security/cross-account.md).

Все поля — в [accounts](/reference/config/accounts/.md). Здесь users и jetstream.

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

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

**No\_auth\_user снова открывает доступ.** Он помещает анонимных в запись выбранного пользователя. Не назначайте широкого пользователя $G, задайте узкого. Параметр не вводится и не меняется reload: `config reload not supported for NoAuthUser`, нужен рестарт. `nats-server -t` не обнаружит отсутствующего пользователя, ошибка появится при запуске. С доверенным оператором настройка запрещена. См. [no\_auth\_user](/reference/config/no_auth_user.md).

**В системной записи нет пользователя.** Тогда события и управление недоступны. Создайте SYS с пользователем и [`system_account: SYS`](/reference/config/system_account.md). Это остаётся в дальнейших конфигурациях:

```
accounts {

  # ORDERS and ANALYTICS unchanged

  SYS: {

    users: [ { user: sys-admin, password: syspass } ]

  }

}

system_account: SYS
```

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

#### CLI

```
#!/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 требуется явный [экспорт/импорт](/learn/security/cross-account.md).

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

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

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

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

## Что дальше

Аналитике нужны отправленные заказы. Откроем только orders.shipped: [Межаккаунтный обмен](/learn/security/cross-account.md).

## См. также

* [accounts](/reference/config/accounts/.md) — все параметры.
* [system](/reference/system/.md) — события и управление.
* [Межаккаунтный обмен](/learn/security/cross-account.md).
* [Основные понятия → Безопасность](/concepts/security.md).
