Шпаргалка · Безопасность
Авторизация
Проблема
Знать, кто обращается, ещё не значит знать, что ему можно. Сервис счетов, общий для многих компаний, усваивает это на собственных ошибках: подменённый ID в URL, забытая проверка и сервисный аккаунт, которому можно всё.
Чему вы научитесь
- Аутентификация и авторизация: почему валидный токен — не разрешение
- Проверка владения на каждом запросе и баг IDOR
- RBAC и ABAC, одна политика в одном месте
- Минимальные привилегии для сервисных аккаунтов
Диаграмма как код
Итоговая схема урока в виде текста: вставьте её в 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_filesMermaid: последовательность запросов
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 invoicesD2
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_filesPlantUML: последовательность запросов
@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
@endumlPlantUML: компоненты
@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 p95 | 45 мс | 54 мс |
| Права джоба | 412 | 3 |
Шаги
- Кейс Валидный токен — и больше ничего
Алиса из компании
c_7открывает счётinv_1042. - Проблема Поменял ID в URL — получил чужой счёт
Борис работает в другой компании,
c_9. - Решение Проверяйте владение прямо в запросе
API теперь загружает счёт только вместе с компанией вызывающего, взятой из токена, а не из URL.
- Кейс RBAC: что можно каждой роли
Внутри компании не каждый может утверждать счета.
- Проблема Сорок эндпоинтов, одна забытая проверка
Проверка владения скопирована в каждый эндпоинт вручную.
- Решение Одна политика, спрашиваем в одном месте
Все правила переезжают в одну политику: по субъекту, действию и ресурсу она отвечает «разрешить» или «запретить».
- Решение ABAC: правила про атрибуты, а не только роли
Новые правила: бухгалтер утверждает счета только до 50 миллионов, никогда — созданные им самим, и только в рабочее время.
- Проблема Джоб отчётов с ключами от всего
Ночной джоб собирает файлы выгрузки.
- Решение Least privilege: только то, что нужно джобу
Джоб получает свою роль
reports_ro: читать счета, писать только в свою временную таблицу и класть файлы только в свою папку в хранилище. - Итоги Итоги
Четыре правила авторизации.
Термины
- RBAC и ABAC
- RBAC выдаёт права по ролям, ABAC — по правилам об атрибутах пользователя, ресурса и контекста. Оба живут в одной политике в одном месте, по умолчанию — отказ.
- IDOR (прямой доступ к чужому объекту)
- Сервер отдаёт запись по id из запроса, но не проверяет, что она принадлежит этому пользователю. Поменяв число в URL, можно открыть чужой заказ или документ.