Шпаргалка · Безопасность
Аутентификация
Проблема
Как сервис узнаёт, кто к нему обращается: хранить пароли так, чтобы утечка не стала катастрофой, сессии и токены, сколько живёт токен и как его убить, вход через провайдера идентификации и второй фактор.
Чему вы научитесь
- Почему пароли хранят медленным хешем с солью: argon2 или bcrypt
- Серверные сессии и JWT access-токены: что когда подходит
- Короткий access-токен, refresh-токен и отзыв
- Вход через провайдера идентификации (OAuth2 / OIDC) и MFA
Диаграмма как код
Итоговая схема урока в виде текста: вставьте её в Jira, GitLab, GitHub, Notion или документацию, там Mermaid рисуется сам. Есть варианты для D2 и PlantUML (Confluence, IntelliJ).
Mermaid: схема
flowchart LR
n_user(("Пользователь"))
n_web(["Веб-приложение"])
n_api["Auth API"]
n_users[("База пользователей")]
n_sessions{{"Хранилище сессий"}}
n_orders["Сервис заказов"]
n_attacker(("Атакующий"))
n_idp>"Провайдер идентификации"]
n_user --> n_web
n_web --> n_api
n_api --> n_users
n_api --> n_sessions
n_web --> n_orders
n_web --> n_idp
n_api --> n_idp
n_attacker --x n_apiMermaid: последовательность запросов
sequenceDiagram
actor n_attacker as Атакующий
participant n_users as База пользователей
participant n_api as Auth API
participant n_web as Веб-приложение
participant n_orders as Сервис заказов
participant n_sessions as Хранилище сессий
participant n_idp as Провайдер идентификации
Note over n_attacker,n_users: Таблица пользователей утекла
n_attacker->>n_users: SELECT id, email, password_sha256 FROM users#59;
n_users-->>n_attacker: 120000 rows, first one:
Note over n_api,n_users: Храните медленный хеш с солью
n_api->>n_users: SELECT id, password_hash FROM users
n_users-->>n_api: 1 row
Note over n_web,n_api: Сессия: случайный ID в cookie
n_web->>n_api: POST /login HTTP/1.1
n_api-->>n_web: HTTP/1.1 200 OK
Note over n_orders,n_sessions: Каждый сервис ходит в хранилище сессий
n_orders->>n_sessions: GET sess:***
n_sessions-->>n_orders: #34;u_42#34;
Note over n_web,n_orders: JWT: подписанный токен, который проверит любой сервис
n_web->>n_orders: GET /orders HTTP/1.1
n_orders-->>n_web: HTTP/1.1 200 OK
Note over n_attacker,n_orders: Украденный токен живёт 30 дней
n_attacker->>n_orders: GET /orders HTTP/1.1
n_orders-->>n_attacker: HTTP/1.1 200 OK
Note over n_web,n_api: Короткий access-токен плюс refresh-токен
n_web->>n_api: POST /token HTTP/1.1
n_api-->>n_web: HTTP/1.1 200 OK
Note over n_api,n_sessions: Отзыв: выход, который действительно выходит
n_api->>n_sessions: DEL rt:u_42:fam_19
n_sessions-->>n_api: (integer) 1
Note over n_api,n_idp: Вход через провайдера идентификации
n_api->>n_idp: POST /oauth2/token HTTP/1.1
n_idp-->>n_api: HTTP/1.1 200 OK
Note over n_attacker,n_api: Второй фактор останавливает повторно использованные пароли
n_attacker->>n_api: POST /login HTTP/1.1
n_api-->>n_attacker: HTTP/1.1 401 UnauthorizedD2
direction: right
n_user: "Пользователь" {
shape: person
}
n_web: "Веб-приложение" {
shape: rectangle
}
n_api: "Auth API" {
shape: rectangle
}
n_users: "База пользователей" {
shape: cylinder
}
n_sessions: "Хранилище сессий" {
shape: hexagon
}
n_orders: "Сервис заказов" {
shape: rectangle
}
n_attacker: "Атакующий" {
shape: person
}
n_idp: "Провайдер идентификации" {
shape: cloud
}
n_user -> n_web
n_web -> n_api
n_api -> n_users
n_api -> n_sessions
n_web -> n_orders
n_web -> n_idp
n_api -> n_idp
n_attacker -> n_api {
target-arrowhead.shape: cross
}PlantUML: последовательность запросов
@startuml
actor "Атакующий" as n_attacker
database "База пользователей" as n_users
participant "Auth API" as n_api
participant "Веб-приложение" as n_web
participant "Сервис заказов" as n_orders
collections "Хранилище сессий" as n_sessions
boundary "Провайдер идентификации" as n_idp
note over n_attacker, n_users : Таблица пользователей утекла
n_attacker -> n_users : SELECT id, email, password_sha256 FROM users;
n_users --> n_attacker : 120000 rows, first one:
note over n_api, n_users : Храните медленный хеш с солью
n_api -> n_users : SELECT id, password_hash FROM users
n_users --> n_api : 1 row
note over n_web, n_api : Сессия: случайный ID в cookie
n_web -> n_api : POST /login HTTP/1.1
n_api --> n_web : HTTP/1.1 200 OK
note over n_orders, n_sessions : Каждый сервис ходит в хранилище сессий
n_orders -> n_sessions : GET sess:***
n_sessions --> n_orders : "u_42"
note over n_web, n_orders : JWT: подписанный токен, который проверит любой сервис
n_web -> n_orders : GET /orders HTTP/1.1
n_orders --> n_web : HTTP/1.1 200 OK
note over n_attacker, n_orders : Украденный токен живёт 30 дней
n_attacker -> n_orders : [дубль] GET /orders HTTP/1.1
n_orders --> n_attacker : HTTP/1.1 200 OK
note over n_web, n_api : Короткий access-токен плюс refresh-токен
n_web -> n_api : POST /token HTTP/1.1
n_api --> n_web : HTTP/1.1 200 OK
note over n_api, n_sessions : Отзыв: выход, который действительно выходит
n_api -> n_sessions : DEL rt:u_42:fam_19
n_sessions --> n_api : (integer) 1
note over n_api, n_idp : Вход через провайдера идентификации
n_api -> n_idp : POST /oauth2/token HTTP/1.1
n_idp --> n_api : HTTP/1.1 200 OK
note over n_attacker, n_api : Второй фактор останавливает повторно использованные пароли
n_attacker -> n_api : POST /login HTTP/1.1
n_api --> n_attacker : HTTP/1.1 401 Unauthorized
@endumlPlantUML: компоненты
@startuml
left to right direction
actor "Пользователь" as n_user
agent "Веб-приложение" as n_web
component "Auth API" as n_api
database "База пользователей" as n_users
stack "Хранилище сессий" as n_sessions
component "Сервис заказов" as n_orders
actor "Атакующий" as n_attacker
cloud "Провайдер идентификации" as n_idp
n_user --> n_web
n_web --> n_api
n_api --> n_users
n_api --> n_sessions
n_web --> n_orders
n_web --> n_idp
n_api --> n_idp
n_attacker -[#c62828]-> n_api
@endumlИтог
Четыре правила аутентификации.
1) Храните пароли медленным хешем с солью (argon2id, bcrypt). 2) Сессию легко отозвать, JWT легко проверить где угодно — поэтому делайте его коротким. 3) Сочетайте 15-минутный access-токен с ротируемым refresh-токеном и отзывайте, удаляя refresh-токены. 4) Для входа предпочитайте провайдера идентификации и добавьте MFA; никогда не кладите токены в URL, где их хранят логи.
Показатели: в начале и в конце
| Показатель | В начале | В конце |
|---|---|---|
| Взломано хешей | 62% | 0,5% |
| Время входа | 40 мс | 290 мс |
| Угоны аккаунтов | 35/день | 0/день |
Шаги
- Проблема Таблица пользователей утекла
Бэкап таблицы пользователей оказался в открытом доступе.
- Решение Храните медленный хеш с солью
API теперь хранит пароли через argon2id (подойдёт и bcrypt): случайная соль на пользователя и хеш, на вычисление которого уходит около 250 мс и 64 МБ.
- Кейс Сессия: случайный ID в cookie
Когда пароль сошёлся, API создаёт сессию в хранилище (
u_42, истекает через 7 дней) и отдаёт браузеру случайный ID в cookie. - Проблема Каждый сервис ходит в хранилище сессий
Появился сервис заказов.
- Решение JWT: подписанный токен, который проверит любой сервис
Auth API теперь выдаёт access-токен: JWT с ID пользователя и сроком, подписанный приватным ключом API.
- Проблема Украденный токен живёт 30 дней
Токен утёк через URL, попавший в лог.
- Решение Короткий access-токен плюс refresh-токен
Access-токены теперь живут 15 минут.
- Решение Отзыв: выход, который действительно выходит
При выходе или смене пароля API удаляет семейство refresh-токенов пользователя.
- Решение Вход через провайдера идентификации
Пользователи теперь входят корпоративным аккаунтом.
- Решение Второй фактор останавливает повторно использованные пароли
Атакующие перебирают на
/loginпары email и пароль, утёкшие с других сайтов. - Итоги Итоги
Четыре правила аутентификации.
Термины
- Хеш пароля с солью
- Хранят не сам пароль, а медленный хеш (argon2id или bcrypt) со случайной солью для каждого пользователя. Вход замедляется незаметно, а взлом утёкшей базы становится в миллионы раз дороже.
- JWT
- Подписанный токен, который любой сервис проверит без похода в базу. Мгновенно отозвать его нельзя, поэтому access-токен делают коротким и дополняют refresh-токеном.
- OAuth2 / OIDC
- Пользователь входит у провайдера идентификации и возвращается с одноразовым code, который API обменивает сервер-сервер на id token. Приложение вообще не видит пароль.
- Refresh-токен
- Долгоживущий токен, которым получают новый короткий access-токен, когда старый истёк. Его шлют только серверу авторизации, меняют при каждом использовании и отзывают при краже.