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

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

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

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

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

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

Локальное хранилище

Cookies

Уязвимости?

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

Локальное хранилище: XSS — межсайтовый скриптинг. Уязвимость XSS позволяет злоумышленнику внедрить JavaScript на сайт.

Cookies: CSRF — подделка межсайтовых запросов. CSRF уязвимость позволяет злоумышленнику выполнять действия на веб-сайте от имени авторизованного пользователя.

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

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

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

предоставляется клиенту с использованием собственного бэк-энда

имеет тот же домен, что и ваш бэк-энд

выполняет вызовы API, которые требуют аутентификации для бэк-энда

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

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

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

Одностраничное приложение (SPA) React на фронт-энд

Серверная часть Node + Express

Web Cookies (Secure, HttpOnly, Same Site)

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

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

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

Парсинг cookie

JavaScript

123const cookieParser = require(‘cookie-parser’) app.use(cookieParser())

Установка cookie

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

JavaScript

READ
Видео VK пользуются все большей популярностью среди пользователей
1234567// Set a cookieresponse.cookie(‘nameOfCookie’, ‘cookieValue’, {  maxAge: 60 * 60 * 1000, // 1 hour  httpOnly: true,  secure: true,  sameSite: true,})

Same Site — предотвращает отправку cookie в межсайтовых запросах

HTTP Only — файлы cookie доступны только с сервера

Secure — cookie должны передаваться по HTTPS

Получение cookie

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

JavaScript

12// Get a cookieresponse.cookies.nameOfCookie

Очистка cookie

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

JavaScript

12// Clear a cookieresponse.clearCookie(‘nameOfCookie’)

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

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

JavaScript

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

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

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

JavaScript

1234dist     # Distribution folder of the production React SPA buildsrc  client # React source files  server # Express server files

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

JavaScript

1234567891011121314151617// src/server/index.js // Initialize Express appconst express = require(‘express’)const app = express()const router = require(‘./router’) // Serve all static files from the dist folderapp.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.htmlapp.get(‘*’, (request, response) => {  response.sendFile(path.join(__dirname, ‘../../dist/index.html’))})

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

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

READ
Три CSS альтернативы навигации в JavaScript

JavaScript

12345src  server    router    handlers    index.js

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

JavaScript

12345678910// 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.

JavaScript

12345678910111213// src/server/routes/authors.js const router = require(‘express’).Router()const authorHandlers = require(‘../handlers/authors’) // Getrouter.get(‘/’, authorHandlers.getAllAuthors)router.get(‘/:author’, authorHandlers.getAuthor) // Postrouter.post(‘/’, authorHandlers.addAuthor) module.exports = router

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

JavaScript

12345678910111213// 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.

JavaScript

1234567// src/server/index.js // Set up all API routesconst router = require(‘./router’) // Use all API routesapp.use(‘/api’, router)

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

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

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

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

JavaScript

12345678910111213141516171819202122232425262728293031323334353637383940414243444546// 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 на всех маршрутах.

JavaScript

1234567// 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.

JavaScript

12345678// 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 для разработки.

JavaScript

12345678910devServer: {  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

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

Оценить статью
Блог о самом интересном.