@boxyhq/saml-jackson 0.2.2 → 0.2.3-beta.208

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/ nodemon.json +12 -0
  2. package/.github/workflows/main.yml +2 -2
  3. package/.nyc_output/2ce4e6ea-b6d5-420c-a785-5bf972000431.json +1 -0
  4. package/.nyc_output/373b0bbd-e18f-4f72-bdcf-a89b611f6db1.json +1 -0
  5. package/.nyc_output/d97c16a4-039f-4dee-aabe-3a0333e17d9a.json +1 -0
  6. package/.nyc_output/processinfo/2ce4e6ea-b6d5-420c-a785-5bf972000431.json +1 -0
  7. package/.nyc_output/processinfo/373b0bbd-e18f-4f72-bdcf-a89b611f6db1.json +1 -0
  8. package/.nyc_output/processinfo/d97c16a4-039f-4dee-aabe-3a0333e17d9a.json +1 -0
  9. package/.nyc_output/processinfo/index.json +1 -0
  10. package/Dockerfile +2 -2
  11. package/README.md +35 -1
  12. package/package.json +23 -15
  13. package/.eslintrc.js +0 -13
  14. package/prettier.config.js +0 -4
  15. package/src/controller/api.js +0 -136
  16. package/src/controller/error.js +0 -12
  17. package/src/controller/oauth/allowed.js +0 -19
  18. package/src/controller/oauth/code-verifier.js +0 -16
  19. package/src/controller/oauth/redirect.js +0 -18
  20. package/src/controller/oauth.js +0 -321
  21. package/src/controller/utils.js +0 -19
  22. package/src/db/db.js +0 -81
  23. package/src/db/db.test.js +0 -302
  24. package/src/db/encrypter.js +0 -36
  25. package/src/db/mem.js +0 -111
  26. package/src/db/mongo.js +0 -89
  27. package/src/db/redis.js +0 -88
  28. package/src/db/sql/entity/JacksonIndex.js +0 -42
  29. package/src/db/sql/entity/JacksonStore.js +0 -42
  30. package/src/db/sql/entity/JacksonTTL.js +0 -23
  31. package/src/db/sql/model/JacksonIndex.js +0 -9
  32. package/src/db/sql/model/JacksonStore.js +0 -10
  33. package/src/db/sql/model/JacksonTTL.js +0 -8
  34. package/src/db/sql/sql.js +0 -153
  35. package/src/db/store.js +0 -42
  36. package/src/db/utils.js +0 -30
  37. package/src/env.js +0 -39
  38. package/src/index.js +0 -67
  39. package/src/jackson.js +0 -145
  40. package/src/read-config.js +0 -24
  41. package/src/saml/claims.js +0 -40
  42. package/src/saml/saml.js +0 -223
  43. package/src/saml/x509.js +0 -48
  44. package/src/test/api.test.js +0 -161
  45. package/src/test/data/metadata/boxyhq.js +0 -6
  46. package/src/test/data/metadata/boxyhq.xml +0 -30
  47. package/src/test/data/saml_response +0 -1
  48. package/src/test/oauth.test.js +0 -342
@@ -0,0 +1,12 @@
1
+ {
2
+ "restartable": "rs",
3
+ "ignore": [".git", "node_modules/", "dist/", "coverage/"],
4
+ "watch": ["src/"],
5
+ "execMap": {
6
+ "ts": "node -r ts-node/register"
7
+ },
8
+ "env": {
9
+ "NODE_ENV": "development"
10
+ },
11
+ "ext": "js,json,ts"
12
+ }
@@ -98,7 +98,7 @@ jobs:
98
98
 
99
99
  - name: Get short SHA
100
100
  id: slug
101
- run: echo "::set-output name=sha8::$(echo ${GITHUB_SHA} | cut -c1-7)"
101
+ run: echo "::set-output name=sha7::$(echo ${GITHUB_SHA} | cut -c1-7)"
102
102
 
103
103
  - name: Set up Docker Buildx
104
104
  id: buildx
@@ -117,7 +117,7 @@ jobs:
117
117
  context: ./
118
118
  file: ./Dockerfile
119
119
  push: true
120
- tags: ${{ github.repository }}:latest,${{ github.repository }}:${{ steps.slug.outputs.sha8 }}
120
+ tags: ${{ github.repository }}:latest,${{ github.repository }}:${{ steps.slug.outputs.sha7 }}
121
121
 
122
122
  - name: Image digest
123
123
  run: echo ${{ steps.docker_build.outputs.digest }}
@@ -0,0 +1 @@
1
+ {"parent":"d97c16a4-039f-4dee-aabe-3a0333e17d9a","pid":3602,"argv":["/opt/hostedtoolcache/node/16.13.1/x64/bin/node","/home/runner/work/jackson/jackson/src/test/oauth.test.ts"],"execArgv":["-r","/home/runner/work/jackson/jackson/node_modules/ts-node/register/index.js"],"cwd":"/home/runner/work/jackson/jackson","time":1640696742405,"ppid":3591,"coverageFilename":"/home/runner/work/jackson/jackson/.nyc_output/2ce4e6ea-b6d5-420c-a785-5bf972000431.json","externalId":"src/test/oauth.test.ts","uuid":"2ce4e6ea-b6d5-420c-a785-5bf972000431","files":[]}
@@ -0,0 +1 @@
1
+ {"parent":"d97c16a4-039f-4dee-aabe-3a0333e17d9a","pid":3608,"argv":["/opt/hostedtoolcache/node/16.13.1/x64/bin/node","/home/runner/work/jackson/jackson/src/test/api.test.ts"],"execArgv":["-r","/home/runner/work/jackson/jackson/node_modules/ts-node/register/index.js"],"cwd":"/home/runner/work/jackson/jackson","time":1640696742406,"ppid":3591,"coverageFilename":"/home/runner/work/jackson/jackson/.nyc_output/373b0bbd-e18f-4f72-bdcf-a89b611f6db1.json","externalId":"src/test/api.test.ts","uuid":"373b0bbd-e18f-4f72-bdcf-a89b611f6db1","files":[]}
@@ -0,0 +1 @@
1
+ {"parent":null,"pid":3591,"argv":["/opt/hostedtoolcache/node/16.13.1/x64/bin/node","/home/runner/work/jackson/jackson/node_modules/.bin/tap","--ts","--timeout=100","src/test/api.test.ts","src/test/oauth.test.ts"],"execArgv":[],"cwd":"/home/runner/work/jackson/jackson","time":1640696742097,"ppid":3580,"coverageFilename":"/home/runner/work/jackson/jackson/.nyc_output/d97c16a4-039f-4dee-aabe-3a0333e17d9a.json","externalId":"","uuid":"d97c16a4-039f-4dee-aabe-3a0333e17d9a","files":[]}
@@ -0,0 +1 @@
1
+ {"processes":{"2ce4e6ea-b6d5-420c-a785-5bf972000431":{"parent":"d97c16a4-039f-4dee-aabe-3a0333e17d9a","externalId":"src/test/oauth.test.ts","children":[]},"373b0bbd-e18f-4f72-bdcf-a89b611f6db1":{"parent":"d97c16a4-039f-4dee-aabe-3a0333e17d9a","externalId":"src/test/api.test.ts","children":[]},"d97c16a4-039f-4dee-aabe-3a0333e17d9a":{"parent":null,"children":["2ce4e6ea-b6d5-420c-a785-5bf972000431","373b0bbd-e18f-4f72-bdcf-a89b611f6db1"]}},"files":{},"externalIds":{"src/test/oauth.test.ts":{"root":"2ce4e6ea-b6d5-420c-a785-5bf972000431","children":[]},"src/test/api.test.ts":{"root":"373b0bbd-e18f-4f72-bdcf-a89b611f6db1","children":[]}}}
package/Dockerfile CHANGED
@@ -1,5 +1,5 @@
1
1
  # Install dependencies only when needed
2
- FROM node:16.9.1-alpine3.14 AS deps
2
+ FROM node:16.13.1-alpine3.14 AS deps
3
3
  # Check https://github.com/nodejs/docker-node/tree/b4117f9333da4138b03a546ec926ef50a31506c3#nodealpine to understand why libc6-compat might be needed.
4
4
  RUN apk add --no-cache libc6-compat
5
5
  WORKDIR /app
@@ -8,7 +8,7 @@ COPY package.json package-lock.json ./
8
8
  RUN npm ci --only=production
9
9
 
10
10
  # Production image, copy all the files and run next
11
- FROM node:16.9.1-alpine3.14 AS runner
11
+ FROM node:16.13.1-alpine3.14 AS runner
12
12
  WORKDIR /app
13
13
 
14
14
  ENV NODE_OPTIONS="--max-http-header-size=81920"
package/README.md CHANGED
@@ -85,7 +85,21 @@ router.get('/api/v1/saml/config', async (req, res) => {
85
85
  });
86
86
  }
87
87
  });
88
+ // delete config
89
+ router.delete('/api/v1/saml/config', async (req, res) => {
90
+ try {
91
+ // apply your authentication flow (or ensure this route has passed through your auth middleware)
92
+ ...
88
93
 
94
+ // only when properly authenticated, call the config function
95
+ await apiController.deleteConfig(req.body);
96
+ res.status(200).end();
97
+ } catch (err) {
98
+ res.status(500).json({
99
+ error: err.message,
100
+ });
101
+ }
102
+ });
89
103
  // OAuth 2.0 flow
90
104
  router.get('/oauth/authorize', async (req, res) => {
91
105
  try {
@@ -228,6 +242,26 @@ curl -G --location 'http://localhost:6000/api/v1/saml/config' \
228
242
 
229
243
  The response returns a JSON with `provider` indicating the domain of your Identity Provider. If an empty JSON payload is returned then we do not have any configuration stored for the attributes you requested.
230
244
 
245
+ #### 2.2 SAML delete config API
246
+
247
+ This endpoint can be used to delete an existing IdP metadata.
248
+
249
+ ```
250
+ curl -X "DELETE" --location 'http://localhost:6000/api/v1/saml/config' \
251
+ --header 'Authorization: Api-Key <Jackson API Key>' \
252
+ --header 'Content-Type: application/x-www-form-urlencoded' \
253
+ --data-urlencode 'tenant=boxyhq.com' \
254
+ --data-urlencode 'product=demo'
255
+ ```
256
+
257
+ ```
258
+ curl -X "DELETE" --location 'http://localhost:6000/api/v1/saml/config' \
259
+ --header 'Authorization: Api-Key <Jackson API Key>' \
260
+ --header 'Content-Type: application/x-www-form-urlencoded' \
261
+ --data-urlencode 'clientID=<Client ID>'
262
+ --data-urlencode 'clientSecret=<Client Secret>'
263
+ ```
264
+
231
265
  ### 3. OAuth 2.0 Flow
232
266
 
233
267
  Jackson has been designed to abstract the SAML login flow as a pure OAuth 2.0 flow. This means it's compatible with any standard OAuth 2.0 library out there, both client-side and server-side. It is important to remember that SAML is configured per customer unlike OAuth 2.0 where you can have a single OAuth app supporting logins for all customers.
@@ -293,7 +327,7 @@ The short-lived access token can now be used to request the user's profile. You'
293
327
 
294
328
  ```
295
329
  curl --request GET \
296
- --url https://localhost:5000/oauth/me \
330
+ --url https://localhost:5000/oauth/userinfo \
297
331
  --header 'authorization: Bearer <access token>' \
298
332
  --header 'content-type: application/json'
299
333
  ```
package/package.json CHANGED
@@ -1,9 +1,10 @@
1
1
  {
2
2
  "name": "@boxyhq/saml-jackson",
3
- "version": "0.2.2",
3
+ "version": "0.2.3-beta.208",
4
4
  "license": "Apache 2.0",
5
5
  "description": "SAML 2.0 service",
6
- "main": "src/index.js",
6
+ "main": "dist/index.js",
7
+ "types": "dist/types.d.ts",
7
8
  "engines": {
8
9
  "node": ">=14.18.1"
9
10
  },
@@ -15,12 +16,14 @@
15
16
  "SAML 2.0"
16
17
  ],
17
18
  "scripts": {
19
+ "build": "tsc",
18
20
  "start": "cross-env IDP_ENABLED=true node src/jackson.js",
19
21
  "dev": "cross-env IDP_ENABLED=true nodemon src/jackson.js",
20
- "mongo": "cross-env JACKSON_API_KEYS=secret DB_ENGINE=mongo DB_URL=mongodb://localhost:27017/jackson nodemon src/jackson.js",
22
+ "mongo": "cross-env JACKSON_API_KEYS=secret DB_ENGINE=mongo DB_URL=mongodb://localhost:27017/jackson DB_ENCRYPTION_KEY=RiVoTxDoLUUoIUOp224abMxK6PGGfFuF nodemon --config nodemon.json src/jackson.ts",
23
+ "sql": "cross-env JACKSON_API_KEYS=secret DB_ENGINE=sql DB_TYPE=postgres DB_URL=postgres://postgres:postgres@localhost:5432/jackson DB_ENCRYPTION_KEY=RiVoTxDoLUUoIUOp224abMxK6PGGfFuF nodemon src/jackson.js",
21
24
  "pre-loaded": "cross-env JACKSON_API_KEYS=secret DB_ENGINE=mem PRE_LOADED_CONFIG='./_config' nodemon src/jackson.js",
22
25
  "pre-loaded-db": "cross-env JACKSON_API_KEYS=secret PRE_LOADED_CONFIG='./_config' nodemon src/jackson.js",
23
- "test": "tap --timeout=100 src/**/*.test.js",
26
+ "test": "tap --ts --timeout=100 src/**/*.test.ts",
24
27
  "dev-dbs": "docker-compose -f ./_dev/docker-compose.yml up -d",
25
28
  "dev-dbs-destroy": "docker-compose -f ./_dev/docker-compose.yml down --volumes --remove-orphans"
26
29
  },
@@ -33,15 +36,15 @@
33
36
  },
34
37
  "dependencies": {
35
38
  "@boxyhq/saml20": "0.2.0",
36
- "@peculiar/webcrypto": "1.2.2",
37
- "@peculiar/x509": "1.6.0",
39
+ "@peculiar/webcrypto": "1.2.3",
40
+ "@peculiar/x509": "1.6.1",
38
41
  "cors": "2.8.5",
39
- "express": "4.17.1",
40
- "mongodb": "4.2.1",
42
+ "express": "4.17.2",
43
+ "mongodb": "4.2.2",
41
44
  "mysql2": "2.3.3",
42
45
  "pg": "8.7.1",
43
46
  "rambda": "6.9.0",
44
- "redis": "4.0.0-rc.4",
47
+ "redis": "4.0.1",
45
48
  "reflect-metadata": "0.1.13",
46
49
  "ripemd160": "2.0.2",
47
50
  "thumbprint": "0.0.1",
@@ -51,17 +54,22 @@
51
54
  "xmlbuilder": "15.1.1"
52
55
  },
53
56
  "devDependencies": {
57
+ "@types/redis": "4.0.11",
58
+ "@types/sinon": "10.0.6",
59
+ "@types/tap": "15.0.5",
54
60
  "cross-env": "7.0.3",
55
- "eslint": "8.4.0",
61
+ "eslint": "8.5.0",
56
62
  "husky": "7.0.4",
57
- "lint-staged": "12.1.2",
63
+ "lint-staged": "12.1.4",
58
64
  "nodemon": "2.0.15",
59
65
  "prettier": "2.5.1",
60
66
  "sinon": "12.0.1",
61
- "tap": "15.1.5"
67
+ "tap": "15.1.5",
68
+ "ts-node": "10.4.0",
69
+ "typescript": "4.5.4"
62
70
  },
63
71
  "lint-staged": {
64
- "*.js": "eslint --cache --fix",
65
- "*.{js,css,md}": "prettier --write"
72
+ "*.{js,ts}": "eslint --cache --fix",
73
+ "*.{js,ts,css,md}": "prettier --write"
66
74
  }
67
- }
75
+ }
package/.eslintrc.js DELETED
@@ -1,13 +0,0 @@
1
- module.exports = {
2
- "env": {
3
- "es2021": true,
4
- "node": true
5
- },
6
- "extends": "eslint:recommended",
7
- "parserOptions": {
8
- "ecmaVersion": 13,
9
- "sourceType": "module"
10
- },
11
- "rules": {
12
- }
13
- };
@@ -1,4 +0,0 @@
1
- module.exports = {
2
- singleQuote: true,
3
- trailingComma: 'es5',
4
- };
@@ -1,136 +0,0 @@
1
- const saml = require('../saml/saml.js');
2
- const x509 = require('../saml/x509.js');
3
- const dbutils = require('../db/utils.js');
4
- const { indexNames } = require('./utils.js');
5
- const { JacksonError } = require('./error.js');
6
-
7
- const crypto = require('crypto');
8
-
9
- let configStore;
10
-
11
- const extractHostName = (url) => {
12
- try {
13
- const pUrl = new URL(url);
14
- if (pUrl.hostname.startsWith('www.')) {
15
- return pUrl.hostname.substring(4);
16
- }
17
- return pUrl.hostname;
18
- } catch (err) {
19
- return null;
20
- }
21
- };
22
-
23
- const config = async (body) => {
24
- const { rawMetadata, defaultRedirectUrl, redirectUrl, tenant, product } =
25
- body;
26
-
27
- if (!rawMetadata) {
28
- throw new JacksonError('Please provide rawMetadata', 400);
29
- }
30
-
31
- if (!defaultRedirectUrl) {
32
- throw new JacksonError('Please provide a defaultRedirectUrl', 400);
33
- }
34
-
35
- if (!redirectUrl) {
36
- throw new JacksonError('Please provide redirectUrl', 400);
37
- }
38
-
39
- if (!tenant) {
40
- throw new JacksonError('Please provide tenant', 400);
41
- }
42
-
43
- if (!product) {
44
- throw new JacksonError('Please provide product', 400);
45
- }
46
-
47
- const idpMetadata = await saml.parseMetadataAsync(rawMetadata);
48
-
49
- // extract provider
50
- let providerName = extractHostName(idpMetadata.entityID);
51
- if (!providerName) {
52
- providerName = extractHostName(
53
- idpMetadata.sso.redirectUrl || idpMetadata.sso.postUrl
54
- );
55
- }
56
-
57
- idpMetadata.provider = providerName ? providerName : 'Unknown';
58
-
59
- let clientID = dbutils.keyDigest(
60
- dbutils.keyFromParts(tenant, product, idpMetadata.entityID)
61
- );
62
- let clientSecret;
63
-
64
- let exists = await configStore.get(clientID);
65
- if (exists) {
66
- clientSecret = exists.clientSecret;
67
- } else {
68
- clientSecret = crypto.randomBytes(24).toString('hex');
69
- }
70
-
71
- const certs = await x509.generate();
72
- if (!certs) {
73
- throw new Error('Error generating x59 certs');
74
- }
75
-
76
- await configStore.put(
77
- clientID,
78
- {
79
- idpMetadata,
80
- defaultRedirectUrl,
81
- redirectUrl: JSON.parse(redirectUrl), // redirectUrl is a stringified array
82
- tenant,
83
- product,
84
- clientID,
85
- clientSecret,
86
- certs,
87
- },
88
- {
89
- // secondary index on entityID
90
- name: indexNames.entityID,
91
- value: idpMetadata.entityID,
92
- },
93
- {
94
- // secondary index on tenant + product
95
- name: indexNames.tenantProduct,
96
- value: dbutils.keyFromParts(tenant, product),
97
- }
98
- );
99
-
100
- return {
101
- client_id: clientID,
102
- client_secret: clientSecret,
103
- provider: idpMetadata.provider,
104
- };
105
- };
106
-
107
- const getConfig = async (body) => {
108
- const { clientID, tenant, product } = body;
109
-
110
- if (clientID) {
111
- const samlConfig = await configStore.get(clientID);
112
- if (!samlConfig) {
113
- return {};
114
- }
115
-
116
- return { provider: samlConfig.idpMetadata.provider };
117
- } else {
118
- const samlConfigs = await configStore.getByIndex({
119
- name: indexNames.tenantProduct,
120
- value: dbutils.keyFromParts(tenant, product),
121
- });
122
- if (!samlConfigs || !samlConfigs.length) {
123
- return {};
124
- }
125
-
126
- return { provider: samlConfigs[0].idpMetadata.provider };
127
- }
128
- };
129
-
130
- module.exports = (opts) => {
131
- configStore = opts.configStore;
132
- return {
133
- config,
134
- getConfig,
135
- };
136
- };
@@ -1,12 +0,0 @@
1
- class JacksonError extends Error {
2
- constructor(message, statusCode = 500) {
3
- super(message);
4
-
5
- this.name = this.constructor.name;
6
- this.statusCode = statusCode;
7
-
8
- Error.captureStackTrace(this, this.constructor);
9
- }
10
- }
11
-
12
- module.exports = { JacksonError };
@@ -1,19 +0,0 @@
1
- module.exports = {
2
- redirect: (redirectUrl, redirectUrls) => {
3
- const url = new URL(redirectUrl);
4
-
5
- for (const idx in redirectUrls) {
6
- const rUrl = new URL(redirectUrls[idx]);
7
- // TODO: Check pathname, for now pathname is ignored
8
- if (
9
- rUrl.protocol === url.protocol &&
10
- rUrl.hostname === url.hostname &&
11
- rUrl.port === url.port
12
- ) {
13
- return true;
14
- }
15
- }
16
-
17
- return false;
18
- },
19
- };
@@ -1,16 +0,0 @@
1
- const crypto = require('crypto');
2
-
3
- const transformBase64 = (input) => {
4
- return input.replace(/=/g, '').replace(/\+/g, '-').replace(/\//g, '_');
5
- };
6
-
7
- const encode = (code_challenge) => {
8
- return transformBase64(
9
- crypto.createHash('sha256').update(code_challenge).digest('base64')
10
- );
11
- };
12
-
13
- module.exports = {
14
- encode,
15
- transformBase64,
16
- };
@@ -1,18 +0,0 @@
1
- module.exports = {
2
- error: (res, redirectUrl, err) => {
3
- var url = new URL(redirectUrl);
4
- url.searchParams.set('error', err);
5
-
6
- res.redirect(url);
7
- },
8
-
9
- success: (redirectUrl, params) => {
10
- const url = new URL(redirectUrl);
11
-
12
- for (const [key, value] of Object.entries(params)) {
13
- url.searchParams.set(key, value);
14
- }
15
-
16
- return url.href;
17
- },
18
- };