For a basic OAuth implementation we need 2 files.
Create a routes/oauth.js file. This file takes care of creating an express router for OAuth-related endpoints.
const express = require('express');
const { getPublicToken } = require('./common/oauth');
let router = express.Router();
// GET /api/forge/oauth/token - generates a public access token (required by the Forge viewer).
router.get('/token', async (req, res, next) => {
try {
const token = await getPublicToken();
res.json({
access_token: token.access_token,
expires_in: token.expires_in
});
} catch(err) {
next(err);
}
});
module.exports = router;Now create a common subfolder in the routes folder, and prepare a routes/common/oauth.js file that will actually request
the access token from Forge. This will be reused in other parts of this tutorial.
const { AuthClientTwoLegged } = require('forge-apis');
const config = require('../../config');
/**
* Initializes a Forge client for 2-legged authentication.
* @param {string[]} scopes List of resource access scopes.
* @returns {AuthClientTwoLegged} 2-legged authentication client.
*/
function getClient(scopes) {
const { client_id, client_secret } = config.credentials;
return new AuthClientTwoLegged(client_id, client_secret, scopes || config.scopes.internal);
}
let cache = {};
async function getToken(scopes) {
const key = scopes.join('+');
if (cache[key]) {
return cache[key];
}
const client = getClient(scopes);
let credentials = await client.authenticate();
cache[key] = credentials;
setTimeout(() => { delete cache[key]; }, credentials.expires_in * 1000);
return credentials;
}
/**
* Retrieves a 2-legged authentication token for preconfigured public scopes.
* @returns Token object: { "access_token": "...", "expires_at": "...", "expires_in": "...", "token_type": "..." }.
*/
async function getPublicToken() {
return getToken(config.scopes.public);
}
/**
* Retrieves a 2-legged authentication token for preconfigured internal scopes.
* @returns Token object: { "access_token": "...", "expires_at": "...", "expires_in": "...", "token_type": "..." }.
*/
async function getInternalToken() {
return getToken(config.scopes.internal);
}
module.exports = {
getClient,
getPublicToken,
getInternalToken
};To avoid getting a new access token for each end-user request, which adds unnecessary latency, let's cache them in global variables. Note that we still need to refresh the tokens after expires_in seconds.
!> Share access token between users is only valid in this case, where all users are accessing the same information (2-legged). If your app uses per-user data (3-legged), DOT NOT use this approach.
Next: Upload file to OSS