import { isUserAdminFlagsValid, isUserDisplayNameValid, isUserRoleValid, isUserUsernameValid, isUserVideoQuotaDailyValid, isUserVideoQuotaValid } from '@server/helpers/custom-validators/users' import { logger } from '@server/helpers/logger' import { generateRandomString } from '@server/helpers/utils' import { PLUGIN_EXTERNAL_AUTH_TOKEN_LIFETIME } from '@server/initializers/constants' import { PluginManager } from '@server/lib/plugins/plugin-manager' import { OAuthTokenModel } from '@server/models/oauth/oauth-token' import { MUser } from '@server/types/models' import { RegisterServerAuthenticatedResult, RegisterServerAuthPassOptions, RegisterServerExternalAuthenticatedResult } from '@server/types/plugins/register-server-auth.model' import { UserAdminFlag, UserRole } from '@shared/models' import { BypassLogin } from './oauth-model' export type ExternalUser = Pick & { displayName: string } // Token is the key, expiration date is the value const authBypassTokens = new Map() async function onExternalUserAuthenticated (options: { npmName: string authName: string authResult: RegisterServerExternalAuthenticatedResult }) { const { npmName, authName, authResult } = options if (!authResult.req || !authResult.res) { logger.error('Cannot authenticate external user for auth %s of plugin %s: no req or res are provided.', authName, npmName) return } const { res } = authResult if (!isAuthResultValid(npmName, authName, authResult)) { res.redirect('/login?externalAuthError=true') return } logger.info('Generating auth bypass token for %s in auth %s of plugin %s.', authResult.username, authName, npmName) const bypassToken = await generateRandomString(32) const expires = new Date() expires.setTime(expires.getTime() + PLUGIN_EXTERNAL_AUTH_TOKEN_LIFETIME) const user = buildUserResult(authResult) authBypassTokens.set(bypassToken, { expires, user, npmName, authName, userUpdater: authResult.userUpdater }) // Cleanup expired tokens const now = new Date() for (const [ key, value ] of authBypassTokens) { if (value.expires.getTime() < now.getTime()) { authBypassTokens.delete(key) } } res.redirect(`/login?externalAuthToken=${bypassToken}&username=${user.username}`) } async function getAuthNameFromRefreshGrant (refreshToken?: string) { if (!refreshToken) return undefined const tokenModel = await OAuthTokenModel.loadByRefreshToken(refreshToken) return tokenModel?.authName } async function getBypassFromPasswordGrant (username: string, password: string): Promise { const plugins = PluginManager.Instance.getIdAndPassAuths() const pluginAuths: { npmName?: string, registerAuthOptions: RegisterServerAuthPassOptions }[] = [] for (const plugin of plugins) { const auths = plugin.idAndPassAuths for (const auth of auths) { pluginAuths.push({ npmName: plugin.npmName, registerAuthOptions: auth }) } } pluginAuths.sort((a, b) => { const aWeight = a.registerAuthOptions.getWeight() const bWeight = b.registerAuthOptions.getWeight() // DESC weight order if (aWeight === bWeight) return 0 if (aWeight < bWeight) return 1 return -1 }) const loginOptions = { id: username, password } for (const pluginAuth of pluginAuths) { const authOptions = pluginAuth.registerAuthOptions const authName = authOptions.authName const npmName = pluginAuth.npmName logger.debug( 'Using auth method %s of plugin %s to login %s with weight %d.', authName, npmName, loginOptions.id, authOptions.getWeight() ) try { const loginResult = await authOptions.login(loginOptions) if (!loginResult) continue if (!isAuthResultValid(pluginAuth.npmName, authOptions.authName, loginResult)) continue logger.info( 'Login success with auth method %s of plugin %s for %s.', authName, npmName, loginOptions.id ) return { bypass: true, pluginName: pluginAuth.npmName, authName: authOptions.authName, user: buildUserResult(loginResult), userUpdater: loginResult.userUpdater } } catch (err) { logger.error('Error in auth method %s of plugin %s', authOptions.authName, pluginAuth.npmName, { err }) } } return undefined } function getBypassFromExternalAuth (username: string, externalAuthToken: string): BypassLogin { const obj = authBypassTokens.get(externalAuthToken) if (!obj) throw new Error('Cannot authenticate user with unknown bypass token') const { expires, user, authName, npmName } = obj const now = new Date() if (now.getTime() > expires.getTime()) { throw new Error('Cannot authenticate user with an expired external auth token') } if (user.username !== username) { throw new Error(`Cannot authenticate user ${user.username} with invalid username ${username}`) } logger.info( 'Auth success with external auth method %s of plugin %s for %s.', authName, npmName, user.email ) return { bypass: true, pluginName: npmName, authName, userUpdater: obj.userUpdater, user } } function isAuthResultValid (npmName: string, authName: string, result: RegisterServerAuthenticatedResult) { const returnError = (field: string) => { logger.error('Auth method %s of plugin %s did not provide a valid %s.', authName, npmName, field, { [field]: result[field] }) return false } if (!isUserUsernameValid(result.username)) return returnError('username') if (!result.email) return returnError('email') // Following fields are optional if (result.role && !isUserRoleValid(result.role)) return returnError('role') if (result.displayName && !isUserDisplayNameValid(result.displayName)) return returnError('displayName') if (result.adminFlags && !isUserAdminFlagsValid(result.adminFlags)) return returnError('adminFlags') if (result.videoQuota && !isUserVideoQuotaValid(result.videoQuota + '')) return returnError('videoQuota') if (result.videoQuotaDaily && !isUserVideoQuotaDailyValid(result.videoQuotaDaily + '')) return returnError('videoQuotaDaily') if (result.userUpdater && typeof result.userUpdater !== 'function') { logger.error('Auth method %s of plugin %s did not provide a valid user updater function.', authName, npmName) return false } return true } function buildUserResult (pluginResult: RegisterServerAuthenticatedResult) { return { username: pluginResult.username, email: pluginResult.email, role: pluginResult.role ?? UserRole.USER, displayName: pluginResult.displayName || pluginResult.username, adminFlags: pluginResult.adminFlags ?? UserAdminFlag.NONE, videoQuota: pluginResult.videoQuota, videoQuotaDaily: pluginResult.videoQuotaDaily } } // --------------------------------------------------------------------------- export { onExternalUserAuthenticated, getBypassFromExternalAuth, getAuthNameFromRefreshGrant, getBypassFromPasswordGrant }