mufassall

Шпаргалка · Безопасность

Авторизация

12 мин · Средний · mufassall.dtwin.uz/ru/l/authorization/

← Открыть урок

Проблема

Знать, кто обращается, ещё не значит знать, что ему можно. Сервис счетов, общий для многих компаний, усваивает это на собственных ошибках: подменённый ID в URL, забытая проверка и сервисный аккаунт, которому можно всё.

Чему вы научитесь

  • Аутентификация и авторизация: почему валидный токен — не разрешение
  • Проверка владения на каждом запросе и баг IDOR
  • RBAC и ABAC, одна политика в одном месте
  • Минимальные привилегии для сервисных аккаунтов
Итоговая сцена
40%

Диаграмма как код

Итоговая схема урока в виде текста: вставьте её в Jira, GitLab, GitHub, Notion или документацию, там Mermaid рисуется сам. Есть варианты для D2 и PlantUML (Confluence, IntelliJ).

Mermaid: схема

flowchart LR
  n_alice(("Алиса (компания c_7)"))
  n_web(["Веб-приложение"])
  n_api["API счетов"]
  n_db[("База счетов")]
  n_bob(("Борис (компания c_9)"))
  n_policy["Сервис политик"]
  n_reports("Джоб отчётов")
  n_files[("Файлы выгрузки")]
  n_alice --> n_web
  n_web --> n_api
  n_api --> n_db
  n_bob --x n_api
  n_api --> n_policy
  n_reports --x n_db
  n_reports --> n_files

Mermaid: последовательность запросов

sequenceDiagram
  participant n_web as Веб-приложение
  participant n_api as API счетов
  actor n_bob as Борис (компания c_9)
  participant n_db as База счетов
  participant n_policy as Сервис политик
  participant n_reports as Джоб отчётов
  Note over n_web,n_api: Валидный токен — и больше ничего
  n_web->>n_api: GET /invoices/inv_1042 HTTP/1.1
  n_api-->>n_web: HTTP/1.1 200 OK
  Note over n_bob,n_api: Поменял ID в URL — получил чужой счёт
  n_bob->>n_api: GET /invoices/inv_1043 HTTP/1.1
  n_api-->>n_bob: HTTP/1.1 200 OK
  Note over n_api,n_db: Проверяйте владение прямо в запросе
  n_api->>n_db: SELECT id, amount, status FROM invoices
  n_db-->>n_api: (0 rows)
  Note over n_web,n_api: RBAC: что можно каждой роли
  n_web->>n_api: POST /invoices/inv_1042/approve HTTP/1.1
  n_api-->>n_web: HTTP/1.1 403 Forbidden
  Note over n_bob,n_api: Сорок эндпоинтов, одна забытая проверка
  n_bob->>n_api: GET /invoices/export?company_id=c_7 HTTP/1.1
  n_api-->>n_bob: HTTP/1.1 200 OK
  Note over n_api,n_policy: Одна политика, спрашиваем в одном месте
  n_api->>n_policy: POST /v1/check HTTP/1.1
  n_policy-->>n_api: HTTP/1.1 200 OK
  Note over n_api,n_policy: ABAC: правила про атрибуты, а не только роли
  n_api->>n_policy: POST /v1/check HTTP/1.1
  n_policy-->>n_api: HTTP/1.1 200 OK
  Note over n_reports,n_db: Джоб отчётов с ключами от всего
  n_reports->>n_db: SET ROLE app_owner#59;
  n_db-->>n_reports: DELETE 18240
  Note over n_reports,n_db: Least privilege: только то, что нужно джобу
  n_reports->>n_db: SET ROLE reports_ro#59;
  n_db-->>n_reports: ERROR: permission denied for table invoices

D2

direction: right

n_alice: "Алиса (компания c_7)" {
  shape: person
}
n_web: "Веб-приложение" {
  shape: rectangle
}
n_api: "API счетов" {
  shape: rectangle
}
n_db: "База счетов" {
  shape: cylinder
}
n_bob: "Борис (компания c_9)" {
  shape: person
}
n_policy: "Сервис политик" {
  shape: rectangle
}
n_reports: "Джоб отчётов" {
  shape: rectangle
  style.multiple: true
}
n_files: "Файлы выгрузки" {
  shape: stored_data
}

n_alice -> n_web
n_web -> n_api
n_api -> n_db
n_bob -> n_api {
  target-arrowhead.shape: cross
}
n_api -> n_policy
n_reports -> n_db {
  target-arrowhead.shape: cross
}
n_reports -> n_files

PlantUML: последовательность запросов

@startuml
participant "Веб-приложение" as n_web
participant "API счетов" as n_api
actor "Борис (компания c_9)" as n_bob
database "База счетов" as n_db
participant "Сервис политик" as n_policy
participant "Джоб отчётов" as n_reports
note over n_web, n_api : Валидный токен — и больше ничего
n_web -> n_api : GET /invoices/inv_1042 HTTP/1.1
n_api --> n_web : HTTP/1.1 200 OK
note over n_bob, n_api : Поменял ID в URL — получил чужой счёт
n_bob -> n_api : GET /invoices/inv_1043 HTTP/1.1
n_api --> n_bob : HTTP/1.1 200 OK
note over n_api, n_db : Проверяйте владение прямо в запросе
n_api -> n_db : SELECT id, amount, status FROM invoices
n_db --> n_api : (0 rows)
note over n_web, n_api : RBAC: что можно каждой роли
n_web -> n_api : POST /invoices/inv_1042/approve HTTP/1.1
n_api --> n_web : HTTP/1.1 403 Forbidden
note over n_bob, n_api : Сорок эндпоинтов, одна забытая проверка
n_bob -> n_api : GET /invoices/export?company_id=c_7 HTTP/1.1
n_api --> n_bob : HTTP/1.1 200 OK
note over n_api, n_policy : Одна политика, спрашиваем в одном месте
n_api -> n_policy : POST /v1/check HTTP/1.1
n_policy --> n_api : HTTP/1.1 200 OK
note over n_api, n_policy : ABAC: правила про атрибуты, а не только роли
n_api -> n_policy : POST /v1/check HTTP/1.1
n_policy --> n_api : HTTP/1.1 200 OK
note over n_reports, n_db : Джоб отчётов с ключами от всего
n_reports -> n_db : SET ROLE app_owner;
n_db --> n_reports : DELETE 18240
note over n_reports, n_db : Least privilege: только то, что нужно джобу
n_reports -> n_db : SET ROLE reports_ro;
n_db --> n_reports : ERROR: permission denied for table invoices
@enduml

PlantUML: компоненты

@startuml
left to right direction
actor "Алиса (компания c_7)" as n_alice
agent "Веб-приложение" as n_web
component "API счетов" as n_api
database "База счетов" as n_db
actor "Борис (компания c_9)" as n_bob
component "Сервис политик" as n_policy
collections "Джоб отчётов" as n_reports
storage "Файлы выгрузки" as n_files
n_alice --> n_web
n_web --> n_api
n_api --> n_db
n_bob -[#c62828]-> n_api
n_api --> n_policy
n_reports -[#c62828]-> n_db
n_reports --> n_files
@enduml

Итог

Четыре правила авторизации.

1) Валидный токен — это личность, а не разрешение. 2) Проверяйте владение на каждом запросе, тенант берите из токена, на чужие ID отвечайте 404. 3) Одна политика в одном месте, по умолчанию — запрет: RBAC для ролей, ABAC для условий. 4) У каждого сервисного аккаунта своя роль ровно с нужными правами.

Показатели: в начале и в конце

ПоказательВ началеВ конце
Прочитано чужих записей0/день0/день
API p9545 мс54 мс
Права джоба4123

Шаги

  1. Кейс Валидный токен — и больше ничего

    Алиса из компании c_7 открывает счёт inv_1042.

  2. Проблема Поменял ID в URL — получил чужой счёт

    Борис работает в другой компании, c_9.

  3. Решение Проверяйте владение прямо в запросе

    API теперь загружает счёт только вместе с компанией вызывающего, взятой из токена, а не из URL.

  4. Кейс RBAC: что можно каждой роли

    Внутри компании не каждый может утверждать счета.

  5. Проблема Сорок эндпоинтов, одна забытая проверка

    Проверка владения скопирована в каждый эндпоинт вручную.

  6. Решение Одна политика, спрашиваем в одном месте

    Все правила переезжают в одну политику: по субъекту, действию и ресурсу она отвечает «разрешить» или «запретить».

  7. Решение ABAC: правила про атрибуты, а не только роли

    Новые правила: бухгалтер утверждает счета только до 50 миллионов, никогда — созданные им самим, и только в рабочее время.

  8. Проблема Джоб отчётов с ключами от всего

    Ночной джоб собирает файлы выгрузки.

  9. Решение Least privilege: только то, что нужно джобу

    Джоб получает свою роль reports_ro: читать счета, писать только в свою временную таблицу и класть файлы только в свою папку в хранилище.

  10. Итоги Итоги

    Четыре правила авторизации.

Термины

RBAC и ABAC
RBAC выдаёт права по ролям, ABAC — по правилам об атрибутах пользователя, ресурса и контекста. Оба живут в одной политике в одном месте, по умолчанию — отказ.
IDOR (прямой доступ к чужому объекту)
Сервер отдаёт запись по id из запроса, но не проверяет, что она принадлежит этому пользователю. Поменяв число в URL, можно открыть чужой заказ или документ.