An authentication module adds new ways for users to login to the application. It consists of properties that can be set by the user as well as methods that are called on certain events (e.g. during initialization). All authentication modules are based on Passport.js implementation, which is the de facto authentication library for Node.js.
Authentication modules are located in /server/modules/authentication.
A unique folder is created for each module. The folder contains two files:
This file contains information about your module.
key: example
title: Example Storage
author: John Doe
useForm: false
props:
firstExampleProperty: String
secondExampleProperty: Number
false for oauth2 based strategies.)This file contains methods that will be called upon initialization.
/* global WIKI */
// ------------------------------------
// Example Auth Account
// ------------------------------------
const ExampleStrategy = require('example')
module.exports = {
init (passport, conf) {
passport.use('example',
new ExampleStrategy({
propA: conf.propA,
propB: conf.propB
}, function (accessToken, refreshToken, profile, cb) {
WIKI.db.users.processProfile(profile).then((user) => {
return cb(null, user) || true
}).catch((err) => {
return cb(err, null) || true
})
}
))
}
}
All methods are required and must be implemented.
Upon initialization of Wiki.js (both startups or restarts).
init (passport, conf) { }
Parameter passport is the Passport.js instance on which your strategy can be added.
Parameter conf is an object containing the configuration of the authentication strategy. For example, if you defined properties clientId and clientSecret for the module props, conf will be an object with properties clientId and clientSecret containing the values entered by the user in the administration area.
Learn more about Passport.js configuration here.