From 3410c5645e48a64813062b151a1c3b8642149ee2 Mon Sep 17 00:00:00 2001
From: Dominique Emond <dremond@ca.ibm.com>
Date: Tue, 4 Jun 2019 12:07:38 -0400
Subject: [PATCH] docs: add a tutorial about authentication

Add a tutorial about authentication.
Instructions to download and run the
completed loopback4-example-shopping application, and
an explanation of how authentication was
added to the loopback4-example-shopping application.
---
 docs/site/imgs/json_web_token_overview.png    | Bin 0 -> 81120 bytes
 docs/site/sidebars/lb4_sidebar.yml            |   4 +
 .../authentication/Authentication-Tutorial.md | 974 ++++++++++++++++++
 3 files changed, 978 insertions(+)
 create mode 100644 docs/site/imgs/json_web_token_overview.png
 create mode 100644 docs/site/tutorials/authentication/Authentication-Tutorial.md

diff --git a/docs/site/imgs/json_web_token_overview.png b/docs/site/imgs/json_web_token_overview.png
new file mode 100644
index 0000000000000000000000000000000000000000..a780e2e05f3624e3f3c8dc04ea20eaa17eb0e069
GIT binary patch
literal 81120
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
HG~oXN)5h6m

literal 0
HcmV?d00001

diff --git a/docs/site/sidebars/lb4_sidebar.yml b/docs/site/sidebars/lb4_sidebar.yml
index 8df4fbbe3156..268aa868914d 100644
--- a/docs/site/sidebars/lb4_sidebar.yml
+++ b/docs/site/sidebars/lb4_sidebar.yml
@@ -107,6 +107,10 @@ children:
     url: express-with-lb4-rest-tutorial.html
     output: 'web, pdf'
 
+  - title: 'How to secure your LoopBack 4 application with JWT authentication'
+    url: Authentication-Tutorial.html
+    output: 'web, pdf'
+
 - title: 'Examples'
   url: Examples.html
   output: 'web, pdf'
diff --git a/docs/site/tutorials/authentication/Authentication-Tutorial.md b/docs/site/tutorials/authentication/Authentication-Tutorial.md
new file mode 100644
index 000000000000..d10c96c2cfcd
--- /dev/null
+++ b/docs/site/tutorials/authentication/Authentication-Tutorial.md
@@ -0,0 +1,974 @@
+---
+lang: en
+title: 'How to secure your LoopBack 4 application with JWT authentication'
+keywords: LoopBack 4.0, LoopBack 4, Authentication, Tutorial
+sidebar: lb4_sidebar
+permalink: /doc/en/lb4/Authentication-Tutorial.html
+summary: A LoopBack 4 application that uses JWT authentication
+---
+
+## Overview
+
+LoopBack 4 has an authentication package `@loopback/authentication` which allows
+you to secure your application's API endpoints with custom authentication
+strategies and an `@authenticate` decorator.
+
+This tutorial showcases how `authentication` was added to the
+[loopback4-example-shopping](https://github.com/strongloop/loopback4-example-shopping)
+application by **creating** and **registering** a custom authentication strategy
+based on the `JSON Web Token (JWT)` approach.
+
+Here is a brief summary of the `JSON Web Token (JWT)` approach.
+
+![JSON Web Token Authentication Overview](../../imgs/json_web_token_overview.png)
+
+In the **JSON Web Token (JWT)** authentication approach, when the user provides
+the **correct** credentials to a **login** endpoint, the server creates a JWT
+token and returns it in the response. The token is of type **string** and
+consists of 3 parts: the **header**, the **payload**, and the **signature**.
+Each part is encrypted using a **secret**, and the parts are separated by a
+period.
+
+For example:
+
+```ts
+// {encrypted-header}.{encrypted-payload}.{encrypted-signature}
+eyJhbXVCJ9.eyJpZCI6Ij.I3wpRNCH4;
+// actual parts have been reduced in size for viewing purposes
+```
+
+{% include note.html content="The payload can contain anything
+the application developer wants, but at the very least contains the user id. It should never contain the user password." %}
+
+After logging in and obtaining this token, whenever the user attempts to access
+a protected endpoint, the token must be provided in the **Authorization**
+header. The server verifies that the token is valid and not expired, and then
+permits access to the protected endpoint.
+
+Please see [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token)
+for more details.
+
+To view and run the completed `loopback4-example-shopping` application, follow
+the instructions in the [Try it out](#try-it-out) section.
+
+To understand the details of how JWT authentication can be added to a LoopBack 4
+application, read the
+[Adding JWT Authentication to a LoopBack 4 Application](#adding-jwt-authentication-to-a-loopback-4-application)
+section.
+
+## Try it out
+
+If you'd like to see the final results of this tutorial as an example
+application, follow these steps:
+
+1. Start the application:
+
+   ```sh
+   git clone git@github.com:strongloop/loopback4-example-shopping.git
+   cd loopback4-example-shopping
+   npm install
+   npm run docker:start
+   npm start
+   ```
+
+   Wait until you see:
+
+   ```sh
+   Recommendation server is running at http://127.0.0.1:3001.
+   Server is running at http://[::1]:3000
+   Try http://[::1]:3000/ping
+   ```
+
+2. In a browser, navigate to [http://[::1]:3000](http://127.0.0.1:3000) or
+   [http://127.0.0.1:3000](http://127.0.0.1:3000), and click on `/explorer` to
+   open the `API Explorer`.
+
+3. In the `UserController` section, click on `POST /users`, click on
+   `'Try it out'`, specify:
+
+   ```ts
+   {
+   "id": "1",
+   "email": "user1@example.com",
+   "password": "thel0ngp@55w0rd",
+   "firstName": "User",
+   "lastName": "One"
+   }
+   ```
+
+   and click on `'Execute'` to **add** a new user named `'User One'`.
+
+4. In the `UserController` section, click on `POST /users/login`, click on
+   `'Try it out'`, specify:
+
+   ```ts
+   {
+     "email":    "user1@example.com",
+     "password": "thel0ngp@55w0rd"
+   }
+   ```
+
+   and click on `'Execute'` to **log in** as `'User One'`.
+
+   A JWT token is sent back in the response.
+
+   For example:
+
+   ```ts
+   {
+     "token": "some.token.value"
+   }
+   ```
+
+5. Perform a `GET` request on the secured endpoint `/users/me` making sure to
+   provide the JWT token in the `Authorization` header. If authentication
+   succeeds, the
+   [user profile](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/types.ts)
+   of the currently authenticated user will be returned in the response. If
+   authentication fails due to a missing/invalid/expired token, an
+   [HTTP 401 UnAuthorized](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401)
+   is thrown.
+
+   ```sh
+   curl -X GET \
+   --header 'Authorization: Bearer some.token.value' \
+   http://127.0.0.1:3000/users/me
+   ```
+
+   The response is:
+
+   ```sh
+   {"id":"1","name":"User One"}
+   ```
+
+## Adding JWT Authentication to a LoopBack 4 Application
+
+In this section, we will demonstrate how `authentication` was added to the
+[loopback4-example-shopping](https://github.com/strongloop/loopback4-example-shopping)
+application using the
+[JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) approach.
+
+### Installing @loopback/authentication
+
+The `loopback4-example-shopping` application **already** has the
+`@loopback/authentication` dependency set up in its **package.json**
+
+It was installed as a project dependency by performing:
+
+```sh
+npm install --save @loopback/authentication
+```
+
+### Adding the AuthenticationComponent to the Application
+
+The core of authentication framework is found in the
+[AuthenticationComponent](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/authentication.component.ts),
+so it is important to add the component in the `ShoppingApplication` class in
+[loopback4-example-shopping/packages/shopping/src/application.ts](https://github.com/strongloop/loopback4-example-shopping/blob/master/packages/shopping/src/application.ts).
+
+```ts
+import {
+  AuthenticationComponent
+} from '@loopback/authentication';
+
+export class ShoppingApplication extends BootMixin(
+  ServiceMixin(RepositoryMixin(RestApplication)),
+) {
+  constructor(options?: ApplicationConfig) {
+    super(options);
+
+    // ...
+
+    // Bind authentication component related elements
+    this.component(AuthenticationComponent);
+
+    // ...
+```
+
+### Securing an Endpoint with the Authentication Decorator
+
+Securing your application's API endpoints is done by decorating controller
+functions with the
+[Authentication Decorator](../../decorators/Decorators_authenticate.md).
+
+The decorator's syntax is:
+
+```ts
+@authenticate(strategyName: string, options?: object)
+```
+
+In the `loopback4-example-shopping` application, there is only one endpoint that
+is secured.
+
+In the `UserController` class in the
+[loopback4-example-shopping/packages/shopping/src/controllers/user.controller.ts](https://github.com/strongloop/loopback4-example-shopping/blob/master/packages/shopping/src/controllers/user.controller.ts),
+a user can print out his/her user profile by performing a `GET` request on the
+`/users/me` endpoint which is handled by the `printCurrentUser()` function.
+
+```ts
+  // ...
+
+  @get('/users/me', {
+    responses: {
+      '200': {
+        description: 'The current user profile',
+        content: {
+          'application/json': {
+            schema: UserProfileSchema,
+          },
+        },
+      },
+    },
+  })
+  @authenticate('jwt')
+  async printCurrentUser(
+    @inject(AuthenticationBindings.CURRENT_USER)
+    currentUserProfile: UserProfile,
+  ): Promise<UserProfile> {
+    return currentUserProfile;
+  }
+
+  // ...
+```
+
+The `/users/me` endpoint is decorated with
+
+```ts
+@authenticate('jwt')
+```
+
+and authentication will only succeed if a valid JWT token is provided in the
+`Authorization` header of the request.
+
+Basically, the
+[AuthenticateFn](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/providers/auth-action.provider.ts)
+action in the custom sequence `MyAuthenticationSequence` (discussed in a later
+section) asks
+[AuthenticationStrategyProvider](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/providers/auth-strategy.provider.ts)
+to resolve the registered authentication strategy with the name `'jwt'` (which
+is `JWTAuthenticationStrategy` and discussed in a later section). Then
+`AuthenticateFn` calls `JWTAuthenticationStrategy`'s `authenticate(request)`
+function to authenticate the request.
+
+If the provided JWT token is valid, then `JWTAuthenticationStrategy`'s
+`authenticate(request)` function returns the user profile. `AuthenticateFn` then
+places the user profile on the request context using the
+`AuthenticationBindings.CURRENT_USER` binding key. The user profile is available
+to the `printCurrentUser()` controller function in a variable
+`currentUserProfile: UserProfile` through dependency injection via the same
+`AuthenticationBindings.CURRENT_USER` binding key. The user profile is returned
+in the response.
+
+If the JWT token is missing/expired/invalid, then `JWTAuthenticationStrategy`'s
+`authenticate(request)` function fails and an
+[HTTP 401 UnAuthorized](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401)
+is thrown.
+
+If an **unknown** authentication strategy **name** is specified in the
+`@authenticate` decorator:
+
+```ts
+@authenticate('unknown')
+```
+
+then
+[AuthenticationStrategyProvider](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/providers/auth-strategy.provider.ts)'s
+`findAuthenticationStrategy(name: string)` function cannot find a registered
+authentication strategy by that name, and an
+[HTTP 401 UnAuthorized](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401)
+is thrown.
+
+So, be sure to specify the correct authentication strategy name when decorating
+your endpoints with the `@authenticate` decorator.
+
+### Creating a Custom Sequence and Adding the Authentication Action
+
+In a LoopBack 4 application with REST API endpoints, each request passes through
+a stateless grouping of actions called a [Sequence](../../Sequence.md).
+
+Authentication is **not** part of the default sequence of actions, so you must
+create a custom sequence and add the authentication action.
+
+The custom sequence `MyAuthenticationSequence` in
+`loopback4-example-shopping/packages/shopping/src/sequence.ts` implements the
+[SequenceHandler](https://github.com/strongloop/loopback-next/blob/master/packages/rest/src/sequence.ts)
+interface.
+
+```ts
+export class MyAuthenticationSequence implements SequenceHandler {
+  constructor(
+    @inject(SequenceActions.FIND_ROUTE) protected findRoute: FindRoute,
+    @inject(SequenceActions.PARSE_PARAMS)
+    protected parseParams: ParseParams,
+    @inject(SequenceActions.INVOKE_METHOD) protected invoke: InvokeMethod,
+    @inject(SequenceActions.SEND) protected send: Send,
+    @inject(SequenceActions.REJECT) protected reject: Reject,
+    @inject(AuthenticationBindings.AUTH_ACTION)
+    protected authenticateRequest: AuthenticateFn,
+  ) {}
+
+  async handle(context: RequestContext) {
+    try {
+      const {request, response} = context;
+      const route = this.findRoute(request);
+
+      //call authentication action
+      await this.authenticateRequest(request);
+
+      // Authentication successful, proceed to invoke controller
+      const args = await this.parseParams(request, route);
+      const result = await this.invoke(route, args);
+      this.send(response, result);
+    } catch (error) {
+      //
+      // The authentication action utilizes a strategy resolver to find
+      // an authentication strategy by name, and then it calls
+      // strategy.authenticate(request).
+      //
+      // The strategy resolver throws a non-http error if it cannot
+      // resolve the strategy. When the strategy resolver obtains
+      // a strategy, it calls strategy.authenticate(request) which
+      // is expected to return a user profile. If the user profile
+      // is undefined, then it throws a non-http error.
+      //
+      // It is necessary to catch these errors and add HTTP-specific status
+      // code property.
+      //
+      // Errors thrown by the strategy implementations already come
+      // with statusCode set.
+      //
+      // In the future, we want to improve `@loopback/rest` to provide
+      // an extension point allowing `@loopback/authentication` to contribute
+      // mappings from error codes to HTTP status codes, so that application
+      // don't have to map codes themselves.
+      if (
+        error.code === AUTHENTICATION_STRATEGY_NOT_FOUND ||
+        error.code === USER_PROFILE_NOT_FOUND
+      ) {
+        Object.assign(error, {statusCode: 401 /* Unauthorized */});
+      }
+
+      this.reject(context, error);
+      return;
+    }
+  }
+}
+```
+
+The authentication action/function is injected via the
+`AuthenticationBindings.AUTH_ACTION` binding key, is given the name
+`authenticateRequest` and has the type
+[AuthenticateFn](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/types.ts).
+
+Calling
+
+```ts
+await this.authenticateRequest(request);
+```
+
+before
+
+```ts
+// ...
+const result = await this.invoke(route, args);
+this.send(response, result);
+// ...
+```
+
+ensures that authentication has succeeded before a controller endpoint is
+reached.
+
+To add the custom sequence `MyAuthenticationSequence` in the application, we
+must code the following in
+`loopback4-example-shopping/packages/shopping/src/application.ts`:
+
+```ts
+export class ShoppingApplication extends BootMixin(
+  ServiceMixin(RepositoryMixin(RestApplication)),
+) {
+  constructor(options?: ApplicationConfig) {
+    super(options);
+
+    // ...
+
+    // Set up the custom sequence
+    this.sequence(MyAuthenticationSequence);
+
+    // ...
+  }
+}
+```
+
+### Creating a Custom JWT Authentication Strategy
+
+When creating a custom authentication strategy, it is necessary to implement the
+[AuthenticationStrategy](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/types.ts)
+interface.
+
+A custom JWT authentication strategy `JWTAuthenticationStrategy` in
+[loopback4-example-shopping/packages/shopping/src/authentication-strategies/jwt-strategy.ts](https://github.com/strongloop/loopback4-example-shopping/blob/master/packages/shopping/src/authentication-strategies/jwt-strategy.ts)
+was implemented as follows:
+
+```ts
+import {inject} from '@loopback/context';
+import {HttpErrors, Request} from '@loopback/rest';
+import {
+  AuthenticationStrategy,
+  UserProfile,
+  TokenService,
+} from '@loopback/authentication';
+import {TokenServiceBindings} from '../keys';
+
+export class JWTAuthenticationStrategy implements AuthenticationStrategy {
+  name: string = 'jwt';
+
+  constructor(
+    @inject(TokenServiceBindings.TOKEN_SERVICE)
+    public tokenService: TokenService,
+  ) {}
+
+  async authenticate(request: Request): Promise<UserProfile | undefined> {
+    const token: string = this.extractCredentials(request);
+    const userProfile: UserProfile = await this.tokenService.verifyToken(token);
+    return userProfile;
+  }
+
+  extractCredentials(request: Request): string {
+    if (!request.headers.authorization) {
+      throw new HttpErrors.Unauthorized(`Authorization header not found.`);
+    }
+
+    // for example: Bearer xxx.yyy.zzz
+    const authHeaderValue = request.headers.authorization;
+
+    if (!authHeaderValue.startsWith('Bearer')) {
+      throw new HttpErrors.Unauthorized(
+        `Authorization header is not of type 'Bearer'.`,
+      );
+    }
+
+    //split the string into 2 parts: 'Bearer ' and the `xxx.yyy.zzz`
+    const parts = authHeaderValue.split(' ');
+    if (parts.length !== 2)
+      throw new HttpErrors.Unauthorized(
+        `Authorization header value has too many parts. It must follow the pattern: 'Bearer xx.yy.zz' where xx.yy.zz is a valid JWT token.`,
+      );
+    const token = parts[1];
+
+    return token;
+  }
+}
+```
+
+It has a **name** `'jwt'`, and it implements the
+`async authenticate(request: Request): Promise<UserProfile | undefined>`
+function.
+
+An extra function `extractCredentials(request: Request): string` was added to
+extract the JWT token from the request. This authentication strategy expects
+every request to pass a valid JWT token in the `Authorization` header.
+
+`JWTAuthenticationStrategy` also makes use of a token service `tokenService` of
+type `TokenService` that is injected via the
+`TokenServiceBindings.TOKEN_SERVICE` binding key. It is used to verify the
+validity of the JWT token and return a user profile.
+
+This token service is explained in a later section.
+
+### Registering the Custom JWT Authentication Strategy
+
+To register the custom authentication strategy `JWTAuthenticationStrategy` with
+the **name** `'jwt'` as a part of the authentication framework, we need to code
+the following in
+`loopback4-example-shopping/packages/shopping/src/application.ts`.
+
+```ts
+import {registerAuthenticationStrategy} from '@loopback/authentication';
+
+export class ShoppingApplication extends BootMixin(
+  ServiceMixin(RepositoryMixin(RestApplication)),
+) {
+  constructor(options?: ApplicationConfig) {
+    super(options);
+    // ...
+    registerAuthenticationStrategy(this, JWTAuthenticationStrategy);
+    // ...
+  }
+}
+```
+
+### Creating a Token Service
+
+The token service `JWTService` in
+`loopback4-example-shopping/packages/shopping/src/services/jwt-service.ts`
+implements an **optional** helper
+[TokenService](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/services/token.service.ts)
+interface.
+
+```ts
+import {inject} from '@loopback/context';
+import {HttpErrors} from '@loopback/rest';
+import {promisify} from 'util';
+import {TokenService, UserProfile} from '@loopback/authentication';
+import {TokenServiceBindings} from '../keys';
+
+const jwt = require('jsonwebtoken');
+const signAsync = promisify(jwt.sign);
+const verifyAsync = promisify(jwt.verify);
+
+export class JWTService implements TokenService {
+  constructor(
+    @inject(TokenServiceBindings.TOKEN_SECRET)
+    private jwtSecret: string,
+    @inject(TokenServiceBindings.TOKEN_EXPIRES_IN)
+    private jwtExpiresIn: string,
+  ) {}
+
+  async verifyToken(token: string): Promise<UserProfile> {
+    if (!token) {
+      throw new HttpErrors.Unauthorized(
+        `Error verifying token: 'token' is null`,
+      );
+    }
+
+    let userProfile: UserProfile;
+
+    try {
+      // decode user profile from token
+      const decryptedToken = await verifyAsync(token, this.jwtSecret);
+      // don't copy over  token field 'iat' and 'exp', nor 'email' to user profile
+      userProfile = Object.assign(
+        {id: '', name: ''},
+        {id: decryptedToken.id, name: decryptedToken.name},
+      );
+    } catch (error) {
+      throw new HttpErrors.Unauthorized(
+        `Error verifying token: ${error.message}`,
+      );
+    }
+
+    return userProfile;
+  }
+
+  async generateToken(userProfile: UserProfile): Promise<string> {
+    if (!userProfile) {
+      throw new HttpErrors.Unauthorized(
+        'Error generating token: userProfile is null',
+      );
+    }
+
+    // Generate a JSON Web Token
+    let token: string;
+    try {
+      token = await signAsync(userProfile, this.jwtSecret, {
+        expiresIn: Number(this.jwtExpiresIn),
+      });
+    } catch (error) {
+      throw new HttpErrors.Unauthorized(`Error encoding token: ${error}`);
+    }
+
+    return token;
+  }
+}
+```
+
+`JWTService` generates or verifies JWT tokens using the `sign` and `verify`
+functions of [jsonwebtoken](https://www.npmjs.com/package/jsonwebtoken).
+
+It makes use of `jwtSecret` and `jwtExpiresIn` **string** values that are
+injected via the `TokenServiceBindings.TOKEN_SECRET` and the
+`TokenServiceBindings.TOKEN_EXPIRES_IN` binding keys respectively.
+
+The `async generateToken(userProfile: UserProfile): Promise<string>` function
+takes in a user profile of type
+[UserProfile](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/types.ts),
+generates a JWT token of type `string` using: the **user profile** as the
+payload, **jwtSecret** and **jwtExpiresIn**.
+
+The `async verifyToken(token: string): Promise<UserProfile>` function takes in a
+JWT token of type `string`, verifies the JWT token, and returns the payload of
+the token which is a user profile of type `UserProfile`.
+
+To bind the JWT `secret`, `expires in` values and the `JWTService` class to
+binding keys, we need to code the following in
+`loopback4-example-shopping/packages/shopping/src/application.ts`:
+
+```ts
+export class ShoppingApplication extends BootMixin(
+  ServiceMixin(RepositoryMixin(RestApplication)),
+) {
+  constructor(options?: ApplicationConfig) {
+    super(options);
+
+    // ...
+    this.setUpBindings();
+    // ...
+  }
+
+  setUpBindings(): void {
+    // ...
+
+    this.bind(TokenServiceBindings.TOKEN_SECRET).to(
+      TokenServiceConstants.TOKEN_SECRET_VALUE,
+    );
+
+    this.bind(TokenServiceBindings.TOKEN_EXPIRES_IN).to(
+      TokenServiceConstants.TOKEN_EXPIRES_IN_VALUE,
+    );
+
+    this.bind(TokenServiceBindings.TOKEN_SERVICE).toClass(JWTService);
+
+    // ...
+  }
+}
+```
+
+In the code above, `TOKEN_SECRET_VALUE` has a value of `'myjwts3cr3t'` and
+`TOKEN_EXPIRES_IN_VALUE` has a value of `'600'`.
+
+`JWTService` is used in two places within the application:
+`JWTAuthenticationStrategy` in
+`loopback4-example-shopping/packages/shopping/src/authentication-strategies/jwt-strategy.ts`,
+and `UserController` in
+`loopback4-example-shopping/packages/shopping/src/controllers/user.controller.ts`.
+
+### Creating a User Service
+
+The user service `MyUserService` in
+`loopback4-example-shopping/packages/shopping/src/services/user-service.ts`
+implements an **optional** helper
+[UserService](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/services/user.service.ts)
+interface.
+
+```ts
+export class MyUserService implements UserService<User, Credentials> {
+  constructor(
+    @repository(UserRepository) public userRepository: UserRepository,
+    @inject(PasswordHasherBindings.PASSWORD_HASHER)
+    public passwordHasher: PasswordHasher,
+  ) {}
+
+  async verifyCredentials(credentials: Credentials): Promise<User> {
+    const foundUser = await this.userRepository.findOne({
+      where: {email: credentials.email},
+    });
+
+    if (!foundUser) {
+      throw new HttpErrors.NotFound(
+        `User with email ${credentials.email} not found.`,
+      );
+    }
+    const passwordMatched = await this.passwordHasher.comparePassword(
+      credentials.password,
+      foundUser.password,
+    );
+
+    if (!passwordMatched) {
+      throw new HttpErrors.Unauthorized('The credentials are not correct.');
+    }
+
+    return foundUser;
+  }
+
+  convertToUserProfile(user: User): UserProfile {
+    // since first name and lastName are optional, no error is thrown if not provided
+    let userName = '';
+    if (user.firstName) userName = `${user.firstName}`;
+    if (user.lastName)
+      userName = user.firstName
+        ? `${userName} ${user.lastName}`
+        : `${user.lastName}`;
+    return {id: user.id, name: userName};
+  }
+}
+```
+
+The `async verifyCredentials(credentials: Credentials): Promise<User>` function
+takes in a credentials of type
+[Credentials](https://github.com/strongloop/loopback4-example-shopping/blob/master/packages/shopping/src/repositories/user.repository.ts),
+and returns a **user** of type
+[User](https://github.com/strongloop/loopback4-example-shopping/blob/master/packages/shopping/src/models/user.model.ts).
+It searches through an injected user repository of type `UserRepository`.
+
+The `convertToUserProfile(user: User): UserProfile` function takes in a **user**
+of type `User` and returns a user profile of type
+[UserProfile](https://github.com/strongloop/loopback-next/blob/master/packages/authentication/src/types.ts).
+A user profile, in this case, is the minimum set of user properties which
+indentify an authenticated user.
+
+`MyUserService` is used in by `UserController` in
+`loopback4-example-shopping/packages/shopping/src/controllers/user.controller.ts`.
+
+To bind the `MyUserService` class, and the password hashing utility it uses, to
+binding keys, we need to code the following in
+`loopback4-example-shopping/packages/shopping/src/application.ts`:
+
+```ts
+export class ShoppingApplication extends BootMixin(
+  ServiceMixin(RepositoryMixin(RestApplication)),
+) {
+  constructor(options?: ApplicationConfig) {
+    super(options);
+
+    // ...
+
+    this.setUpBindings();
+
+    // ...
+  }
+
+  setUpBindings(): void {
+    // ...
+
+    // Bind bcrypt hash services - utilized by 'UserController' and 'MyUserService'
+    this.bind(PasswordHasherBindings.ROUNDS).to(10);
+    this.bind(PasswordHasherBindings.PASSWORD_HASHER).toClass(BcryptHasher);
+
+    this.bind(UserServiceBindings.USER_SERVICE).toClass(MyUserService);
+
+    // ...
+  }
+}
+```
+
+### Adding Users
+
+In the `UserController` class in the
+`loopback4-example-shopping/packages/shopping/src/controllers/user.controller.ts`,
+users can be added by performing a `POST` request to the `/users` endpoint which
+is handled by the `create()` function.
+
+```ts
+export class UserController {
+  constructor(
+    // ...
+    @repository(UserRepository) public userRepository: UserRepository,
+    @inject(PasswordHasherBindings.PASSWORD_HASHER)
+    public passwordHasher: PasswordHasher,
+    @inject(TokenServiceBindings.TOKEN_SERVICE)
+    public jwtService: TokenService,
+    @inject(UserServiceBindings.USER_SERVICE)
+    public userService: UserService<User, Credentials>,
+  ) {}
+
+  // ...
+
+  @post('/users')
+  async create(@requestBody() user: User): Promise<User> {
+    // ensure a valid email value and password value
+    validateCredentials(_.pick(user, ['email', 'password']));
+
+    // encrypt the password
+    user.password = await this.passwordHasher.hashPassword(user.password);
+
+    // create the new user
+    const savedUser = await this.userRepository.create(user);
+    delete savedUser.password;
+
+    return savedUser;
+  }
+
+  // ...
+```
+
+A user of type
+[User](https://github.com/strongloop/loopback4-example-shopping/blob/master/packages/shopping/src/models/user.model.ts)
+is added to the database via the user repository if the user's email and
+password values are in an acceptable format.
+
+### Issuing a JWT Token on Successful Login
+
+In the `UserController` class in the
+`loopback4-example-shopping/packages/shopping/src/controllers/user.controller.ts`,
+a user can `log in` by performing a `POST` request, containing an `email` and
+`password`, to the `/users/login` endpoint which is handled by the `login()`
+function.
+
+```ts
+export class UserController {
+  constructor(
+    // ...
+    @repository(UserRepository) public userRepository: UserRepository,
+    @inject(PasswordHasherBindings.PASSWORD_HASHER)
+    public passwordHasher: PasswordHasher,
+    @inject(TokenServiceBindings.TOKEN_SERVICE)
+    public jwtService: TokenService,
+    @inject(UserServiceBindings.USER_SERVICE)
+    public userService: UserService<User, Credentials>,
+  ) {}
+
+  // ...
+
+  @post('/users/login', {
+    responses: {
+      '200': {
+        description: 'Token',
+        content: {
+          'application/json': {
+            schema: {
+              type: 'object',
+              properties: {
+                token: {
+                  type: 'string',
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+  })
+  async login(
+    @requestBody(CredentialsRequestBody) credentials: Credentials,
+  ): Promise<{token: string}> {
+    // ensure the user exists, and the password is correct
+    const user = await this.userService.verifyCredentials(credentials);
+
+    // convert a User object into a UserProfile object (reduced set of properties)
+    const userProfile = this.userService.convertToUserProfile(user);
+
+    // create a JSON Web Token based on the user profile
+    const token = await this.jwtService.generateToken(userProfile);
+
+    return {token};
+  }
+}
+```
+
+The user service returns a user object when the email and password are verified
+as valid; otherwise it throws an
+[HTTP 401 UnAuthorized](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401).
+The user service is then called to create a slimmer user profile from the user
+object. Then this user profile is used as the payload of the JWT token created
+by the token service. The token is returned in the response.
+
+### Summary
+
+We've gone through the steps that were used to add JWT `authentication` to the
+`loopback4-example-shopping` application.
+
+The final `ShoppingApplication` class in
+[loopback4-example-shopping/packages/shopping/src/application.ts](https://github.com/strongloop/loopback4-example-shopping/blob/master/packages/shopping/src/application.ts)
+should look like this:
+
+```ts
+import {BootMixin} from '@loopback/boot';
+import {ApplicationConfig, BindingKey} from '@loopback/core';
+import {RepositoryMixin} from '@loopback/repository';
+import {RestApplication} from '@loopback/rest';
+import {ServiceMixin} from '@loopback/service-proxy';
+import {MyAuthenticationSequence} from './sequence';
+import {
+  TokenServiceBindings,
+  UserServiceBindings,
+  TokenServiceConstants,
+} from './keys';
+import {JWTService} from './services/jwt-service';
+import {MyUserService} from './services/user-service';
+
+import * as path from 'path';
+import {
+  AuthenticationComponent,
+  registerAuthenticationStrategy,
+} from '@loopback/authentication';
+import {PasswordHasherBindings} from './keys';
+import {BcryptHasher} from './services/hash.password.bcryptjs';
+import {JWTAuthenticationStrategy} from './authentication-strategies/jwt-strategy';
+
+/**
+ * Information from package.json
+ */
+export interface PackageInfo {
+  name: string;
+  version: string;
+  description: string;
+}
+export const PackageKey = BindingKey.create<PackageInfo>('application.package');
+
+const pkg: PackageInfo = require('../package.json');
+
+export class ShoppingApplication extends BootMixin(
+  ServiceMixin(RepositoryMixin(RestApplication)),
+) {
+  constructor(options?: ApplicationConfig) {
+    super(options);
+
+    this.setUpBindings();
+
+    // Bind authentication component related elements
+    this.component(AuthenticationComponent);
+
+    registerAuthenticationStrategy(this, JWTAuthenticationStrategy);
+
+    // Set up the custom sequence
+    this.sequence(MyAuthenticationSequence);
+
+    // Set up default home page
+    this.static('/', path.join(__dirname, '../public'));
+
+    this.projectRoot = __dirname;
+    // Customize @loopback/boot Booter Conventions here
+    this.bootOptions = {
+      controllers: {
+        // Customize ControllerBooter Conventions here
+        dirs: ['controllers'],
+        extensions: ['.controller.js'],
+        nested: true,
+      },
+    };
+  }
+
+  setUpBindings(): void {
+    // Bind package.json to the application context
+    this.bind(PackageKey).to(pkg);
+
+    this.bind(TokenServiceBindings.TOKEN_SECRET).to(
+      TokenServiceConstants.TOKEN_SECRET_VALUE,
+    );
+
+    this.bind(TokenServiceBindings.TOKEN_EXPIRES_IN).to(
+      TokenServiceConstants.TOKEN_EXPIRES_IN_VALUE,
+    );
+
+    this.bind(TokenServiceBindings.TOKEN_SERVICE).toClass(JWTService);
+
+    // // Bind bcrypt hash services
+    this.bind(PasswordHasherBindings.ROUNDS).to(10);
+    this.bind(PasswordHasherBindings.PASSWORD_HASHER).toClass(BcryptHasher);
+
+    this.bind(UserServiceBindings.USER_SERVICE).toClass(MyUserService);
+  }
+}
+```
+
+## Running the Completed Application
+
+To run the completed application, follow the instructions in the
+[Try it out](#try-it-out) section.
+
+For more information, please visit
+[Authentication Component](../../Loopback-component-authentication.md).
+
+## Bugs/Feedback
+
+Open an issue in
+[loopback4-example-shopping](https://github.com/strongloop/loopback4-example-shopping)
+and we'll take a look!
+
+## Contributions
+
+- [Guidelines](https://github.com/strongloop/loopback-next/blob/master/docs/CONTRIBUTING.md)
+- [Join the team](https://github.com/strongloop/loopback-next/issues/110)
+
+## Tests
+
+Run `npm test` from the root folder.
+
+## Contributors
+
+See
+[all contributors](https://github.com/strongloop/loopback-next/graphs/contributors).
+
+## License
+
+MIT