Аутентификация полного стека: файлы cookie и локальное хранилище

От автора: когда вы авторизуетесь в приложении, вы ожидаете, что в следующий раз, когда вы откроете новую вкладку или окно в браузере, вы все равно останетесь авторизованным. Это означает, что в некотором роде или форме, клиент (браузер) должен поддерживать ссылку на вас, чтобы вы оставались авторизованным.

Где я могу сохранить в клиенте состояние?

Работа с безопасностью и аутентификацией в приложении фронт-энд может быть сложной проблемой. Существует всего два способа поддерживать состояние клиента в веб-приложении:

Уязвимости?

Оба эти метода связаны с потенциальными проблемами безопасности:

Как я могу защититься от этого?

Если локальное хранилище может быть использовано сторонними скриптами (например, найденными в расширениях браузера) и если аутентификация может быть подделана с помощью файлов cookie, где допустимо размещать состояние клиента?

Из раздела Аутентификация в одностраничных приложениях с помощью файлов Cookies документации Auth0 мы узнаем, что если ваше приложение:

тогда есть способ безопасно использовать для аутентификации cookie.

На что это похоже?

Реальный пример установки:

Сервер Express будет обслуживать React SPA по всем маршрутам, кроме тех, которые начинаются с /api. Приложение React использует сервер Express для всех конечных точек. Благодаря этому методу фронт-энд приложение находится в том же домене и имеет сервер, позволяющий защищать файлы cookie с помощью параметров HttpOnly, Secure и Same Site.

Отсюда вы можете выполнять вызовы API для микросервисов или некоторых защищенных серверов. Конечные точки API и токены доступа не будут видны из браузера. Ниже я изложу некоторые основные концепции настройки этой архитектуры для приложения полного стека.

Использование HTTP-файлов cookie в Express

Для того, чтобы использовать cookie в Express, вы используете модуль cookie-parser.

Парсинг cookie

const cookieParser = require('cookie-parser') app.use(cookieParser())

Установка cookie

Вы можете установить cookie маршрута для объекта response, указав некоторые важные свойства:

// Set a cookie
response.cookie('nameOfCookie', 'cookieValue', { maxAge: 60 * 60 * 1000, // 1 hour httpOnly: true, secure: true, sameSite: true,
})

Получение cookie

Файл cookie теперь можно прочитать в последующих ответах.

// Get a cookie
response.cookies.nameOfCookie

Очистка cookie

После выхода из системы, вам нужно удалить cookie.

// Clear a cookie
response.clearCookie('nameOfCookie')

Локальные значения в middleware Express

Express работает на middleware. Если вы хотите обновить cookie в одном middleware и использовать его в следующем, вы можете сохранить его как локальный Express. Это может пригодиться, если вам нужно обновить токен доступа JWT по маршруту preAuth, использовать эту аутентификацию в обработчике и отправить в конце cookie в ответе.

// Create a local
const refreshMiddleware = (request, response, next) => { const accessToken = getNewAccessToken(refreshToken) // Set local response.locals.accessToken = accessToken next()
} // Use a local
const handler = (request, response) => { const updatedAccessToken = response.locals.accessToken
} router.post('/app/user', refreshMiddleware, handler)

Обслуживание фронт-энд приложения

Хороший пример этой настройки можно найти в настройке шаблона Simple React Full Stack. В конечном итоге вот как будет выглядеть макет вашего приложения:

dist # Distribution folder of the production React SPA build
src client # React source files server # Express server files

В этом случае файл сервера будет выглядеть примерно так:

// src/server/index.js // Initialize Express app
const express = require('express')
const app = express()
const router = require('./router') // Serve all static files from the dist folder
app.use(express.static(path.join(__dirname, '../../dist/'))) // Set up express router to serve all api routes (more on this below)
app.use('/api', router) // Serve any other file as the distribution index.html
app.get('*', (request, response) => { response.sendFile(path.join(__dirname, '../../dist/index.html'))
})

Маршруты и обработчики Express

Используя класс Express Router, вы можете организовать все маршруты API в подкаталоги и объединить их одной строкой в главной точке входа сервера.

src server router handlers index.js

Все маршруты могут быть организованы в отдельные подкаталоги.

// src/server/routes/index.js const router = require('express').Router()
const bookRoutes = require('./books')
const authorRoutes = require('./authors') router.use('/books', bookRoutes)
router.use('/authors', authorRoutes) module.exports = router

В одном наборе маршрутов, мы можем определить все маршруты GET, POST, DELETE и т.д. Поскольку маршрутизатор использует /api, и маршрут авторов использует /authors, вызов GET API для /api/authors/jk-rowling вызовет в этом примере обработчик getAuthor.

// src/server/routes/authors.js const router = require('express').Router()
const authorHandlers = require('../handlers/authors') // Get
router.get('/', authorHandlers.getAllAuthors)
router.get('/:author', authorHandlers.getAuthor) // Post
router.post('/', authorHandlers.addAuthor) module.exports = router

Вы можете поместить все связанные с ними обработчики автора в подкаталог handlers.

// src/server/handlers/authors.js module.exports = { getAllAuthors: async (request, response) => { // Some logic... if (success) { response.status(200).send(authors) } else { response.status(400).send({ message: 'Something went wrong' }) } }, addAuthor: async (request, response) => { ... },
}

Это возвращает нас к точке входа на сервер, которая вводит все маршруты для /api.

// src/server/index.js // Set up all API routes
const router = require('./router') // Use all API routes
app.use('/api', router)

Одностраничное приложение React

У Тайлера МакГинниса (Tyler McGinnis) есть отличная статья о защищенных маршрутах и аутентификации с помощью React Router, в которой рассказано, как можно создать компоненты PrivateRoute и PublicRoute.

Это защита аутентификации только на уровне фронт-энд. Ей нельзя доверять защиту конфиденциальных данных, которые должны быть защищены внутренними API, требующими маркеры доступа (или любого другого метода защиты) для возврата ответа.

Используя базовый пример маршрутов из упомянутой выше статьи, ниже показано, как вы можете выполнить API-вызов сервера Express из React, аутентифицировать некоторое состояние глобального контекста и направить приложение через фронт-энд.

// App.js import React, { Component } from 'react'
import { BrowserRouter as Router, Switch, Route, Redirect } from 'react-router-dom'
import axios from 'axios'
// ...plus page and context imports export default class App extends Component { static contextType = AuthContext state = { loading: true } async componentDidMount() { const Auth = this.context try { const response = await axios('/api/auth') Auth.authenticate() } catch (error) { console.log(error) } finally { this.setState({ loading: false }) } } render() { const Auth = this.context const { loading } = this.state if (loading) { return <div>Loading...</div> } return ( <Router> <Switch> <PublicRoute exact path="/login" component={LoginPage} /> <ProtectedRoute exact path="/dashboard" component={DashboardPage} /> <Route exact path="/logout" component={LogoutPage} /> <Redirect to="/login" /> </Switch> </Router> ) }
}

Теперь сервер разработки направит вас к правильному маршруту в зависимости от вашего статуса аутентификации. В производственном режиме будет обслуживаться файл index.html — подробнее об этом ниже.

Производство и разработка

При производственной настройке создается все приложение React для распространения, а приложение Express обслуживает SPA на всех маршрутах.

// package.json // Production
{ "build": "cross-env NODE_ENV=production webpack --config config/webpack.prod.js", "start": "npm run build && node src/server/index.js"
}

Для разработки это громоздко. Лучший способ для разработки — это обслуживать React на сервере разработки Webpack, как вы это делаете регулярно, и передавать все запросы API на сервер Express.

// package.json // Development
{ "client": "cross-env NODE_ENV=development webpack-dev-server --config config/webpack.dev.js", "server": "nodemon src/server/index.js", "dev": "concurrently \"npm run server\" \"npm run client\""
}

Вы, вероятно, будете обслуживать приложение React через порт 3000, а сервер через порт 5000, которые можно установить в конфигурационном файле Webpack для разработки.

devServer: { historyApiFallback: true, proxy: { '/api': 'http://localhost:5000', }, open: true, compress: true, hot: true, port: 3000,
}

Настройка historyApiFallback обеспечит правильную работу маршрутов приложения. Также важно установить для publicPathв Webpack значение /, чтобы гарантировать, что производственные маршруты обслуживают пакеты из корня.

Webpack Boilerplate является хорошим примером того, как настроить Webpack (в этом случае, вы бы просто переместили все из директории сборки для src непосредственно в src/client).

Заключение

Надеемся, что этот ресурс помог вам понять различные типы уязвимостей, связанных с постоянным хранилищем на стороне клиента (XSS и CSRF), а также некоторые подходы, которые мы можем использовать для защиты от атак, а именно HttpOnly, SameSite, Secure Web Cookies.

Автор: Tania Rascia

Источник: https://www.taniarascia.com

Редакция: Команда webformyself.