import { Readable } from 'stream'; import { exportJWK, generateKeyPair } from 'jose'; import type * as Koa from 'koa'; import type { errors, Configuration, KoaContextWithOIDC } from 'oidc-provider'; import type { ErrorHandler } from '../../../../src/http/output/error/ErrorHandler'; import type { ResponseWriter } from '../../../../src/http/output/ResponseWriter'; import { BasicRepresentation } from '../../../../src/http/representation/BasicRepresentation'; import { IdentityProviderFactory } from '../../../../src/identity/configuration/IdentityProviderFactory'; import type { JwkGenerator } from '../../../../src/identity/configuration/JwkGenerator'; import type { ClientCredentials, } from '../../../../src/identity/interaction/email-password/credentials/ClientCredentialsAdapterFactory'; import type { Interaction, InteractionHandler } from '../../../../src/identity/interaction/InteractionHandler'; import type { AdapterFactory } from '../../../../src/identity/storage/AdapterFactory'; import type { KeyValueStorage } from '../../../../src/storage/keyvalue/KeyValueStorage'; import { FoundHttpError } from '../../../../src/util/errors/FoundHttpError'; import { OAuthHttpError } from '../../../../src/util/errors/OAuthHttpError'; /* eslint-disable @typescript-eslint/naming-convention */ jest.mock('oidc-provider', (): any => ({ Provider: jest.fn().mockImplementation((issuer: string, config: Configuration): any => ({ issuer, config, use: jest.fn() })), })); const routes = { authorization: '/foo/oidc/auth', backchannel_authentication: '/foo/oidc/backchannel', code_verification: '/foo/oidc/device', device_authorization: '/foo/oidc/device/auth', end_session: '/foo/oidc/session/end', introspection: '/foo/oidc/token/introspection', jwks: '/foo/oidc/jwks', pushed_authorization_request: '/foo/oidc/request', registration: '/foo/oidc/reg', revocation: '/foo/oidc/token/revocation', token: '/foo/oidc/token', userinfo: '/foo/oidc/me', }; describe('An IdentityProviderFactory', (): void => { let baseConfig: Configuration; const baseUrl = 'http://example.com/foo/'; const oidcPath = '/oidc'; const webId = 'http://alice.example.com/card#me'; const redirectUrl = 'http://example.com/login/'; const oidcInteraction: Interaction = {} as any; let ctx: KoaContextWithOIDC; let interactionHandler: jest.Mocked; let adapterFactory: jest.Mocked; let storage: jest.Mocked>; let jwkGenerator: jest.Mocked; let credentialStorage: jest.Mocked>; let errorHandler: jest.Mocked; let responseWriter: jest.Mocked; let factory: IdentityProviderFactory; beforeEach(async(): Promise => { baseConfig = { claims: { webid: [ 'webid', 'client_webid' ]}}; ctx = { method: 'GET', req: Readable.from('data'), res: {}, request: { href: 'http://example.com/idp/', query: { client_id: 'CLIENT_ID', redirect_uri: 'REDIRECT_URI', }, }, accepts: jest.fn().mockReturnValue('type'), } as any; interactionHandler = { handleSafe: jest.fn().mockRejectedValue(new FoundHttpError(redirectUrl)), } as any; adapterFactory = { createStorageAdapter: jest.fn().mockReturnValue('adapter!'), }; const map = new Map(); storage = { get: jest.fn((id: string): any => map.get(id)), set: jest.fn((id: string, value: any): any => map.set(id, value)), } as any; const { privateKey, publicKey } = await generateKeyPair('ES256'); jwkGenerator = { alg: 'ES256', getPrivateKey: jest.fn().mockResolvedValue({ ...await exportJWK(privateKey), alg: 'ES256' }), getPublicKey: jest.fn().mockResolvedValue({ ...await exportJWK(publicKey), alg: 'ES256' }), }; credentialStorage = { get: jest.fn((id: string): any => map.get(id)), set: jest.fn((id: string, value: any): any => map.set(id, value)), } as any; errorHandler = { handleSafe: jest.fn().mockResolvedValue({ statusCode: 500 }), } as any; responseWriter = { handleSafe: jest.fn() } as any; factory = new IdentityProviderFactory(baseConfig, { adapterFactory, baseUrl, oidcPath, interactionHandler, storage, jwkGenerator, credentialStorage, showStackTrace: true, errorHandler, responseWriter, }); }); it('creates a correct configuration.', async(): Promise => { // This is the output of our mock function const provider = await factory.getProvider() as any; expect(provider.proxy).toBe(true); const { issuer, config } = provider as { issuer: string; config: Configuration }; expect(issuer).toBe(baseUrl); // Copies the base config expect(config.claims).toEqual(baseConfig.claims); (config.adapter as (name: string) => any)('test!'); expect(adapterFactory.createStorageAdapter).toHaveBeenCalledTimes(1); expect(adapterFactory.createStorageAdapter).toHaveBeenLastCalledWith('test!'); expect(config.cookies?.keys).toEqual([ expect.any(String) ]); expect(config.jwks).toEqual({ keys: [ expect.objectContaining({ alg: 'ES256' }) ]}); expect(config.routes).toEqual(routes); expect(config.pkce?.methods).toEqual([ 'S256' ]); expect((config.pkce!.required as any)()).toBe(true); expect(config.clientDefaults?.id_token_signed_response_alg).toBe('ES256'); await expect((config.interactions?.url as any)(ctx, oidcInteraction)).resolves.toBe(redirectUrl); let findResult = await config.findAccount?.({ oidc: { client: { clientId: 'clientId' }}} as any, webId); expect(findResult?.accountId).toBe(webId); await expect((findResult?.claims as any)()).resolves.toEqual({ sub: webId, webid: webId, azp: 'clientId' }); findResult = await config.findAccount?.({ oidc: {}} as any, webId); await expect((findResult?.claims as any)()).resolves.toEqual({ sub: webId, webid: webId }); await expect((config.extraTokenClaims as any)({}, {})).resolves.toEqual({}); const client = { clientId: 'my_id' }; await expect((config.extraTokenClaims as any)({}, { client })).resolves.toEqual({}); await credentialStorage.set('my_id', { webId: 'http://example.com/foo', secret: 'my-secret' }); await expect((config.extraTokenClaims as any)({}, { client })) .resolves.toEqual({ webid: 'http://example.com/foo' }); await expect((config.extraTokenClaims as any)({}, { kind: 'AccessToken', accountId: webId, clientId: 'clientId' })) .resolves.toEqual({ webid: webId }); expect(config.features?.resourceIndicators?.enabled).toBe(true); expect((config.features?.resourceIndicators?.defaultResource as any)()).toBe('http://example.com/'); expect((config.features?.resourceIndicators?.getResourceServerInfo as any)()).toEqual({ scope: 'webid', audience: 'solid', accessTokenFormat: 'jwt', jwt: { sign: { alg: 'ES256' }}, }); // Test the renderError function const error = new Error('error!'); await expect((config.renderError as any)(ctx, {}, error)).resolves.toBeUndefined(); expect(errorHandler.handleSafe).toHaveBeenCalledTimes(1); expect(errorHandler.handleSafe) .toHaveBeenLastCalledWith({ error, request: ctx.req }); expect(responseWriter.handleSafe).toHaveBeenCalledTimes(1); expect(responseWriter.handleSafe).toHaveBeenLastCalledWith({ response: ctx.res, result: { statusCode: 500 }}); }); it('errors if there is no valid interaction redirect.', async(): Promise => { interactionHandler.handleSafe.mockRejectedValueOnce(new Error('bad data')); const provider = await factory.getProvider() as any; const { config } = provider as { config: Configuration }; await expect((config.interactions?.url as any)(ctx, oidcInteraction)).rejects.toThrow('bad data'); interactionHandler.handleSafe.mockResolvedValueOnce(new BasicRepresentation()); await expect((config.interactions?.url as any)(ctx, oidcInteraction)) .rejects.toThrow('Could not correctly redirect for the given interaction.'); }); it('copies a field from the input config if values need to be added to it.', async(): Promise => { baseConfig.cookies = { long: { signed: true }, }; factory = new IdentityProviderFactory(baseConfig, { adapterFactory, baseUrl, oidcPath, interactionHandler, storage, jwkGenerator, credentialStorage, showStackTrace: true, errorHandler, responseWriter, }); const { config } = await factory.getProvider() as unknown as { issuer: string; config: Configuration }; expect(config.cookies?.long?.signed).toBe(true); }); it('caches the provider.', async(): Promise => { const result1 = await factory.getProvider() as unknown as { issuer: string; config: Configuration }; const result2 = await factory.getProvider() as unknown as { issuer: string; config: Configuration }; expect(result1).toBe(result2); }); it('uses cached keys in case they already exist.', async(): Promise => { const result1 = await factory.getProvider() as unknown as { issuer: string; config: Configuration }; // Create a new factory that is not cached yet const factory2 = new IdentityProviderFactory(baseConfig, { adapterFactory, baseUrl, oidcPath, interactionHandler, storage, jwkGenerator, credentialStorage, showStackTrace: true, errorHandler, responseWriter, }); const result2 = await factory2.getProvider() as unknown as { issuer: string; config: Configuration }; expect(result1.config.cookies).toEqual(result2.config.cookies); expect(storage.get).toHaveBeenCalledTimes(2); expect(storage.set).toHaveBeenCalledTimes(1); expect(storage.set).toHaveBeenCalledWith('cookie-secret', result1.config.cookies?.keys); }); it('updates errors if there is more information.', async(): Promise => { const provider = await factory.getProvider() as any; const { config } = provider as { config: Configuration }; const error = new Error('bad data') as errors.OIDCProviderError; error.error_description = 'more info'; error.error_detail = 'more details'; const oAuthError = new OAuthHttpError(error, error.name, 500, 'bad data - more info - more details'); await expect((config.renderError as any)(ctx, {}, error)).resolves.toBeUndefined(); expect(errorHandler.handleSafe).toHaveBeenCalledTimes(1); expect(errorHandler.handleSafe) .toHaveBeenLastCalledWith({ error: oAuthError, request: ctx.req }); expect(responseWriter.handleSafe).toHaveBeenCalledTimes(1); expect(responseWriter.handleSafe).toHaveBeenLastCalledWith({ response: ctx.res, result: { statusCode: 500 }}); expect(oAuthError.message).toBe('bad data - more info - more details'); expect(oAuthError.stack).toContain('Error: bad data - more info - more details'); }); it('throws a specific error for unknown clients.', async(): Promise => { const provider = await factory.getProvider() as any; const { config } = provider as { config: Configuration }; const error = new Error('invalid_client') as errors.OIDCProviderError; error.error_description = 'client is invalid'; error.error_detail = 'client not found'; await expect((config.renderError as any)(ctx, {}, error)).resolves.toBeUndefined(); expect(errorHandler.handleSafe).toHaveBeenCalledTimes(1); expect(errorHandler.handleSafe) .toHaveBeenLastCalledWith({ error: expect.objectContaining({ statusCode: 400, name: 'BadRequestHttpError', message: 'Unknown client, you might need to clear the local storage on the client.', errorCode: 'E0003', details: { client_id: 'CLIENT_ID', redirect_uri: 'REDIRECT_URI', }, }), request: ctx.req }); expect(responseWriter.handleSafe).toHaveBeenCalledTimes(1); expect(responseWriter.handleSafe).toHaveBeenLastCalledWith({ response: ctx.res, result: { statusCode: 500 }}); }); it('adds middleware to make the OIDC provider think the request wants HTML.', async(): Promise => { const provider = await factory.getProvider() as any; const use = provider.use as jest.Mock, Parameters>; expect(use).toHaveBeenCalledTimes(1); const middleware = use.mock.calls[0][0]; const oldAccept = ctx.accepts; const next = jest.fn(); await expect(middleware(ctx, next)).resolves.toBeUndefined(); expect(next).toHaveBeenCalledTimes(1); expect(ctx.accepts('json', 'html')).toBe('html'); expect(oldAccept).toHaveBeenCalledTimes(0); }); it('does not modify the context accepts function in other cases.', async(): Promise => { const provider = await factory.getProvider() as any; const use = provider.use as jest.Mock, Parameters>; expect(use).toHaveBeenCalledTimes(1); const middleware = use.mock.calls[0][0]; const oldAccept = ctx.accepts; const next = jest.fn(); await expect(middleware(ctx, next)).resolves.toBeUndefined(); expect(next).toHaveBeenCalledTimes(1); expect(ctx.accepts('something')).toBe('type'); expect(oldAccept).toHaveBeenCalledTimes(1); expect(oldAccept).toHaveBeenLastCalledWith('something'); }); });