SSX Server Quickstart
This guide will help you quickly create an SSX Server powered by Express.js
SSX Server enables you to have sessions for each user, ensure that generated nonces belong to the same session, provide validation when requests are made, and more.
Start by creating a new
JavaScript project and running init with your preferred package manager. In this guide, we'll be using yarn:yarn init
After that, go into your new project folder and do the following:
- Create a folder called
src/(if on a UNIX-based OS runmkdir src) - Create a file under
src/calledindex.tsand add the following:
/* src/index.ts */
import express from 'express';
import dotenv from 'dotenv';
import cors from 'cors';
dotenv.config();
const PORT = process.env.PORT || '4000';
const app = express();
app.use(cors({ credentials: true, origin: true }));
app.use(express.urlencoded({ extended: true }));
app.use(express.json());
app.get('/', (_req, res) => {
res.send('SSX Server Online\n');
});
app.listen(PORT, () => {
console.log(`⚡️[server]: Server is running at http://localhost:${PORT}`);
});
To run this and prepare it to work with
ssx run the following commands to install some dependencies:yarn add -D typescript @types/cors @types/node @types/express ts-nodeyarn add @spruceid/ssx-server express cors dotenv
Head to your
package.json located at the root of your project and add the following:...
"license": "MIT",
+ "scripts": {
+ "start": "ts-node src/index"
+ },
"devDependencies": {
...
You can now run
yarn start and have a fully functional express server. To test it, run curl localhost:4000 at your terminal, that should output: UP.Now that you have the basic setup, adding
ssx can be done with just one extra step, head to src/index.ts and add the following:/* src/index.ts */
import express from 'express';
import dotenv from 'dotenv';
+ import { SSXServer, SSXExpressMiddleware } from '@spruceid/ssx-server';
import cors from 'cors';
dotenv.config();
const app = express();
+ const ssx = new SSXServer({
+ signingKey: process.env.SSX_SECRET,
+ });
const PORT = process.env.PORT || '4000';
app.use(cors({ credentials: true, origin: true }));
app.use(express.urlencoded({ extended: true }));
app.use(express.json());
+ app.use(SSXExpressMiddleware(ssx));
app.get('/', (_req, res) => {
res.send('SSX Server Online\n');
});
app.listen(PORT, () => {
console.log(`⚡️[server]: Server is running at http://localhost:${PORT}`);
});
The creation of a configuration file will also be necessary. To do that, create in the project's root folder a file named
.env , and in that file, add the following:SSX_SECRET=
Make sure to change that value to avoid using any default value.
And that's it! You can stop the server (if you were still running it) and re-launch it.
Now you have a
SSX Server powered by Express.js. To test it, you can run any of the examples available in the ssx monorepo and link to this API.If you want to test it, you can also run the following command in your terminal to get a 16-character long nonce:
curl localhost:4000/ssx-nonceLast modified 3mo ago