redux-security

Redux security subsystem with user, group and access management

INSTALL

Stable

npm i -S redux-security

Development

npm i -S lokhmakov/redux-security

FEATURES

• Service architecture (redux-manager powered)
• Journaling (redux-journal powered)
• Persist state (PouchDB powered)
• Dynamic service configuration (state.config):
  • docsMax = 2 - maximum docs in state.docs
  • docsMaxOverRemove: true - remove old images over docsMax
• User management
• Session management
• Auth
  • signup
  • login
  • logout
  • email confirmation
• API
  • local
  • express
  • pouch
  • socket (SocketIO)

EXAMPLES

USERS: NODE-API

require('redux-journal').enable()

const tags = 'redux-security.examples.users.node-api'

import { write, error }   from 'redux-journal'
import { manager }        from 'redux-manager'
import { usersLocal }     from 'redux-security'

const api = usersLocal()

manager.enableLogger(require('redux-node-logger')())
manager.getStore()

api.create({ username: 'user1', password: 'password1' }).then(({ userID }) => {
  write(`USER _id = ${userID} CREATED`, `${tags}.api.create`)
  return api.update({ _id: userID, username: 'user2' }).then((result) => {
    write(`SUCCESS result = ${result}`, `${tags}.api.update`)
    return api.remove({ _id: userID })
  })
}).then((result) => {
  write(`SUCCESS result = ${result}`, `${tags}.api.remove`)
}).catch((e) => {
  error(e)
})

AUTH: NODE-API

require('redux-journal').enable()

const tags = 'redux-security.examples.auth.node-api'

import { write, error }     from 'redux-journal'
import { manager }          from 'redux-manager'

const serviceAuth     = 'auth'
const serviceSessions = 'sessions'
const serviceUsers    = 'users'

import { sessionsLocal }    from 'redux-security'

const apiSessions = sessionsLocal({ serviceName: serviceSessions })

import { usersLocal }       from 'redux-security'

const apiUsers = usersLocal({ serviceName: serviceUsers })

import { authLocal }        from 'redux-security'

const apiAuth = authLocal({ serviceName: serviceAuth, serviceSessions, serviceUsers })

manager.enableLogger(require('redux-node-logger')())
manager.getStore()

const username = 'root'
const password = 'toor'

apiUsers.create({ username, password }).then(() => {
  return apiAuth.login({ username, password})
}).then((result) => {
  write(`({ username = '${username}', password = '${password}'}) SUCCESS`, `${tags}.login`)
}).catch((e) => {
  error(e)
})

AUTH: NODE-REDUX

require('redux-journal').enable()

const tags = 'redux-security.examples.auth.node-redux'

import { write, error }     from 'redux-journal'
import { manager }          from 'redux-manager'

const serviceAuth     = 'auth'
const serviceSessions = 'sessions'
const serviceUsers    = 'users'

import { sessionsLocal }    from 'redux-security'

const apiSessions = sessionsLocal({ serviceName: serviceSessions })

import { usersLocal }       from 'redux-security'

const apiUsers = usersLocal({ serviceName: serviceUsers })

import { authLocal }        from 'redux-security'
import { authActions }      from 'redux-security'

const apiAuth = authLocal({ serviceName: serviceAuth, serviceSessions, serviceUsers })

manager.enableLogger(require('redux-node-logger')())
manager.getStore()

const username = 'root'
const password = 'toor'

apiUsers.create({ username, password }).then(() => {
  manager.dispatch(authActions.login({ username, password }), serviceAuth)
}).catch((e) => {
  error(e)
})

AUTH: NODE-SOCKET

server.js

require('redux-journal').enable()

const tags = 'redux-security.examples.auth.node-socket.server'

import { write, error }     from 'redux-journal'
import { manager }          from 'redux-manager'

const serviceAuth     = 'auth'
const serviceSessions = 'sessions'
const serviceUsers    = 'users'

import { sessionsLocal }    from 'redux-security'

sessionsLocal({ serviceName: serviceSessions })

import { usersLocal }       from 'redux-security'

const apiUsers = usersLocal({ serviceName: serviceUsers })

import { authLocal }        from 'redux-security'
import { authActions }      from 'redux-security'

authLocal({ serviceName: serviceAuth, serviceSessions, serviceUsers })

manager.enableLogger(require('redux-node-logger')())
manager.getStore()

const username = 'root'
const password = 'toor'

apiUsers.create({ username, password })

import Express              from 'express'
import { Server }           from 'http'
import SocketIO             from 'socket.io'

const PORT = 3000
const app = new Express()
const server = Server(app)
const io = SocketIO(server)

server.listen(PORT, (e) => {
  if (e) return error(e)
  write(`==> 🌎  0.0.0.0:${ PORT }`)
})

import { authConfigAPISocketServer } from 'redux-security'

authConfigAPISocketServer({ io })

client.js

require('redux-journal').enable()

const tags = 'redux-security.examples.auth.node-socket'

import { write, error }     from 'redux-journal'
import { manager }          from 'redux-manager'

const serviceAuth     = 'auth'
const serverServiceName = 'auth'

import { authSocket }        from 'redux-security'
import { authActions }      from 'redux-security'

const socket = require('socket.io-client')('http://localhost:3000')
authSocket({ serviceName: serviceAuth, serverServiceName, socket })

manager.enableLogger(require('redux-node-logger')())
manager.getStore()

const username = 'root'
const password = 'toor'

manager.dispatch(authActions.login({ username, password }), serviceAuth)

REACT

server.js

require('redux-journal').enable()

import { error, write }     from 'redux-journal'

import webpack              from 'webpack'
import webpackDevMiddleware from 'webpack-dev-middleware'
import webpackHotMiddleware from 'webpack-hot-middleware'
import webpackConfig        from '../webpack.config'

const PORT = 3000
const app = require('express')()
const server = require('http').Server(app)
const io = require('socket.io')(server)

const compiler = webpack(webpackConfig)
app.use(webpackDevMiddleware(compiler, { noInfo: false, publicPath: webpackConfig.output.publicPath }))
app.use(webpackHotMiddleware(compiler))

app.use((req, res) => { res.sendFile(__dirname + '/static/index.html') })

server.listen(PORT, (e) => {
  if (e) return error(e)
  write(`==> 🌎  0.0.0.0:${ PORT }`)
})

const tags = 'redux-security.examples.auth.react.server'

import { manager }          from 'redux-manager'

const serviceAuth     = 'auth'
const serviceSessions = 'sessions'
const serviceUsers    = 'users'

import { sessionsLocal }    from 'redux-security'

sessionsLocal({ serviceName: serviceSessions })

import { usersLocal }       from 'redux-security'

const apiUsers = usersLocal({ serviceName: serviceUsers })

import { authLocal }        from 'redux-security'
import { authActions }      from 'redux-security'

authLocal({ serviceName: serviceAuth, serviceSessions, serviceUsers })

manager.enableLogger(require('redux-node-logger')())
manager.getStore()

const username = 'root'
const password = 'toor'

apiUsers.create({ username, password })

import { authConfigAPISocketServer } from 'redux-security'

authConfigAPISocketServer({ io })

client.js

require('redux-journal').enable()

import injectTapEventPlugin from 'react-tap-event-plugin'

injectTapEventPlugin()

import { manager }          from 'redux-manager'
import { authSocket }       from 'redux-security'

const serviceAuth = 'auth'

const socket = require('socket.io-client')('http://localhost:3000')
authSocket({ serviceName: serviceAuth, socket })

manager.enableLogger(require('redux-logger')())
const store = manager.getStore()

import React                from 'react'
import ReactDOM             from 'react-dom'
import { Provider }         from 'react-redux'
import { connect }          from 'react-redux'

import MuiThemeProvider     from 'material-ui/styles/MuiThemeProvider'
import getMuiTheme          from 'material-ui/styles/getMuiTheme'
import AppBar               from 'material-ui/AppBar'

import { AuthAvatar }       from 'redux-security'
import { AuthFormTabs }     from 'redux-security'

const AuthAvatar1         = connect(state => ({ auth: state[serviceAuth] }))(AuthAvatar)
const AuthFormTabs1       = connect(state => ({ auth: state[serviceAuth] }))(AuthFormTabs)

const muiTheme = getMuiTheme({ palette: { accent1Color: require('material-ui/styles/colors').deepOrange500 }})

const render = () => ReactDOM.render(
  <Provider store={ store }>
    <MuiThemeProvider muiTheme={ muiTheme }>
      <div>
        <AppBar
          title='redux-security'
          iconElementLeft={ <div/> }
          iconElementRight={ <AuthAvatar1/> }
        />
        <AuthFormTabs1/>
      </div>
    </MuiThemeProvider>
  </Provider>,
  document.getElementById('app')
)

render()