Password encoding with BCrypt in Spring Boot

Introduction

BCrypt helps keep passwords safe by turning them into secret codes. This way, even if someone sees the code, they can't easily guess the original password.

When you want to store user passwords safely in a database.

When building a login system that checks passwords securely.

When you want to protect user accounts from hackers.

When you need to compare a typed password with a stored secret code.

When you want to follow security best practices in your app.

Syntax

Spring Boot

import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
String encodedPassword = encoder.encode(rawPassword);
boolean matches = encoder.matches(rawPassword, encodedPassword);

Use encode() to turn a plain password into a secure code.

Use matches() to check if a typed password matches the stored code.

Examples

This creates a secret code from the password "mySecret123".

Spring Boot

BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
String encoded = encoder.encode("mySecret123");

This checks if the typed password matches the stored secret code.

Spring Boot

boolean isMatch = encoder.matches("mySecret123", encoded);

You can set the strength (work factor) to 12 for more security but slower encoding.

Spring Boot

BCryptPasswordEncoder encoder = new BCryptPasswordEncoder(12);

Sample Program

This program encodes a password and then checks if the original password matches the encoded one.

Spring Boot

package com.example.demo;

import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;

public class PasswordEncoderDemo {
    public static void main(String[] args) {
        BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
        String rawPassword = "helloWorld";
        String encodedPassword = encoder.encode(rawPassword);

        System.out.println("Raw password: " + rawPassword);
        System.out.println("Encoded password: " + encodedPassword);

        boolean matches = encoder.matches(rawPassword, encodedPassword);
        System.out.println("Password matches: " + matches);
    }
}

Important Notes

Each time you encode the same password, the result looks different because BCrypt adds random salt.

Never store plain passwords, always store the encoded version.

Use a strength of 10 or higher for good security without slowing your app too much.

Summary

BCrypt turns passwords into secure codes to protect user data.

Use encode() to create the code and matches() to check passwords.

Always store encoded passwords, never plain text.

Practice

1. What is the main purpose of using BCryptPasswordEncoder in Spring Boot?

easy

A. To validate email addresses

B. To decode passwords back to plain text

C. To generate random passwords for users

D. To securely encode passwords before storing them

Solution

1. Step 1: Understand BCryptPasswordEncoder role

   BCryptPasswordEncoder is used to convert plain passwords into a secure encoded form.

2. Step 2: Identify correct purpose

   It does not decode or generate passwords, only encodes them securely.

3. Final Answer:

   To securely encode passwords before storing them -> Option D

4. Quick Check:

   Password encoding = Secure storage [OK]

Hint: BCrypt encodes, never decodes passwords [OK]

Common Mistakes:

• Thinking BCrypt can decode passwords
• Confusing encoding with password generation
• Using it for unrelated tasks like email validation

2. Which of the following is the correct way to create a BCryptPasswordEncoder instance in Spring Boot?

easy

A. BCryptPasswordEncoder encoder = BCryptPasswordEncoder();

B. BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();

C. BCryptPasswordEncoder encoder = new BCryptPasswordEncoder.encode();

D. BCryptPasswordEncoder encoder = encode(new BCryptPasswordEncoder());

Solution

1. Step 1: Recall Java object creation syntax

   In Java, to create an object, use the new keyword followed by the constructor.

2. Step 2: Match correct syntax

   BCryptPasswordEncoder encoder = new BCryptPasswordEncoder(); correctly uses new BCryptPasswordEncoder(); to create an instance.

3. Final Answer:

   BCryptPasswordEncoder encoder = new BCryptPasswordEncoder(); -> Option B

4. Quick Check:

   Object creation = new + constructor [OK]

Hint: Use 'new' keyword to create objects in Java [OK]

Common Mistakes:

• Omitting 'new' keyword when creating objects
• Calling methods instead of constructors
• Incorrect method chaining in object creation

3. Given the following code snippet, what will be the output of matches method?

BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
String rawPassword = "mypassword";
String encodedPassword = encoder.encode(rawPassword);
boolean result = encoder.matches("mypassword", encodedPassword);
System.out.println(result);

medium

A. true

B. false

C. Compilation error

D. Runtime exception

Solution

1. Step 1: Understand encode and matches methods

   The encode method creates a hashed password. The matches method checks if the raw password matches the encoded hash.

2. Step 2: Analyze the code flow

   The raw password "mypassword" is encoded, then matches compares the same raw password with the encoded one, so it returns true.

3. Final Answer:

   true -> Option A

4. Quick Check:

   matches(raw, encoded) = true if same password [OK]

Hint: matches() returns true if raw matches encoded password [OK]

Common Mistakes:

• Assuming encode returns plain text
• Thinking matches compares encoded strings directly
• Expecting false because encoded password looks different

4. Identify the error in the following Spring Boot code snippet for password encoding:

BCryptPasswordEncoder encoder;
String encoded = encoder.encode("secret");

medium

A. String type cannot hold encoded password

B. encode method does not exist in BCryptPasswordEncoder

C. encoder is not initialized before use

D. Missing import statement for BCryptPasswordEncoder

Solution

1. Step 1: Check variable initialization

   The variable encoder is declared but not assigned an instance before calling encode.

2. Step 2: Understand consequences

   Using an uninitialized object causes a NullPointerException at runtime.

3. Final Answer:

   encoder is not initialized before use -> Option C

4. Quick Check:

   Uninitialized objects cause runtime errors [OK]

Hint: Always initialize objects before calling methods [OK]

Common Mistakes:

• Forgetting to create new instance with 'new'
• Assuming declaration equals initialization
• Ignoring runtime NullPointerException

5. You want to store user passwords securely in your Spring Boot application. Which approach correctly uses BCryptPasswordEncoder to encode and verify passwords during login?

hard

A. Encode password on registration, store encoded; on login, use matches(rawPassword, storedEncodedPassword)

B. Store plain password; on login, encode input and compare with stored plain password

C. Encode password on registration, store encoded; on login, encode input and compare encoded strings directly

D. Encode password on registration, store encoded; on login, decode stored password and compare with input

Solution

1. Step 1: Understand secure password storage

   Passwords must be encoded before storing; plain text storage is insecure.

2. Step 2: Verify password correctly on login

   Use matches(rawPassword, storedEncodedPassword) to check if input matches stored hash without decoding.

3. Final Answer:

   Encode password on registration, store encoded; on login, use matches(rawPassword, storedEncodedPassword) -> Option A

4. Quick Check:

   Use matches() to verify passwords securely [OK]

Hint: Use matches() to check raw vs encoded passwords [OK]

Common Mistakes:

• Comparing encoded strings directly (they differ each time)
• Storing plain text passwords
• Trying to decode encoded passwords (not possible)