mufassall

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

Аутентификация

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

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

Проблема

Как сервис узнаёт, кто к нему обращается: хранить пароли так, чтобы утечка не стала катастрофой, сессии и токены, сколько живёт токен и как его убить, вход через провайдера идентификации и второй фактор.

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

  • Почему пароли хранят медленным хешем с солью: argon2 или bcrypt
  • Серверные сессии и JWT access-токены: что когда подходит
  • Короткий access-токен, refresh-токен и отзыв
  • Вход через провайдера идентификации (OAuth2 / OIDC) и MFA
Итоговая сцена
55%25%

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

Итоговая схема урока в виде текста: вставьте её в 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_api

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

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 Unauthorized

D2

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
@enduml

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

@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/день

Шаги

  1. Проблема Таблица пользователей утекла

    Бэкап таблицы пользователей оказался в открытом доступе.

  2. Решение Храните медленный хеш с солью

    API теперь хранит пароли через argon2id (подойдёт и bcrypt): случайная соль на пользователя и хеш, на вычисление которого уходит около 250 мс и 64 МБ.

  3. Кейс Сессия: случайный ID в cookie

    Когда пароль сошёлся, API создаёт сессию в хранилище (u_42, истекает через 7 дней) и отдаёт браузеру случайный ID в cookie.

  4. Проблема Каждый сервис ходит в хранилище сессий

    Появился сервис заказов.

  5. Решение JWT: подписанный токен, который проверит любой сервис

    Auth API теперь выдаёт access-токен: JWT с ID пользователя и сроком, подписанный приватным ключом API.

  6. Проблема Украденный токен живёт 30 дней

    Токен утёк через URL, попавший в лог.

  7. Решение Короткий access-токен плюс refresh-токен

    Access-токены теперь живут 15 минут.

  8. Решение Отзыв: выход, который действительно выходит

    При выходе или смене пароля API удаляет семейство refresh-токенов пользователя.

  9. Решение Вход через провайдера идентификации

    Пользователи теперь входят корпоративным аккаунтом.

  10. Решение Второй фактор останавливает повторно использованные пароли

    Атакующие перебирают на /login пары email и пароль, утёкшие с других сайтов.

  11. Итоги Итоги

    Четыре правила аутентификации.

Термины

Хеш пароля с солью
Хранят не сам пароль, а медленный хеш (argon2id или bcrypt) со случайной солью для каждого пользователя. Вход замедляется незаметно, а взлом утёкшей базы становится в миллионы раз дороже.
JWT
Подписанный токен, который любой сервис проверит без похода в базу. Мгновенно отозвать его нельзя, поэтому access-токен делают коротким и дополняют refresh-токеном.
OAuth2 / OIDC
Пользователь входит у провайдера идентификации и возвращается с одноразовым code, который API обменивает сервер-сервер на id token. Приложение вообще не видит пароль.
Refresh-токен
Долгоживущий токен, которым получают новый короткий access-токен, когда старый истёк. Его шлют только серверу авторизации, меняют при каждом использовании и отзывают при краже.