https://github.com/leroyguillaume/keycloak-bcrypt

Add BCrypt password provider in Keycloak
https://github.com/leroyguillaume/keycloak-bcrypt

Last synced: about 1 month ago
JSON representation

Add BCrypt password provider in Keycloak

• Host: GitHub
• URL: https://github.com/leroyguillaume/keycloak-bcrypt
• Owner: leroyguillaume
• License: apache-2.0
• Created: 2018-01-12T09:04:01.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-12-09T15:45:00.000Z (7 months ago)
• Last Synced: 2024-02-10T10:09:56.412Z (5 months ago)
• Language: Java
• Size: 133 KB
• Stars: 116
• Watchers: 7
• Forks: 73
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-keycloak - leroyguillaume/keycloak-bcrypt

README

        
# Keycloak BCrypt

Add a password hash provider to handle BCrypt passwords inside Keycloak.

## Build JAR

```bash

./gradlew assemble -Pdependency.keycloak.version=${KEYCLOAK_VERSION}

```

## Build Docker image

```bash

docker build \

    --build-arg keycloak_version=${KEYCLOAK_VERSION} \

    -t gleroy/keycloak-bcrypt \

    .

```

## Test with docker-compose

```bash

docker-compose up -d

```

## Install

### >= 17.0.0

```bash

curl -L https://github.com/leroyguillaume/keycloak-bcrypt/releases/download/${KEYCLOAK_BCRYPT_VERSION}/keycloak-bcrypt-${KEYCLOAK_BCRYPT_VERSION}.jar > ${KEYCLOAK_HOME}/providers/keycloak-bcrypt-${KEYCLOAK_BCRYPT_VERSION}.jar

```

You need to restart Keycloak.

### < 17.0.0

```bash

curl -L https://github.com/leroyguillaume/keycloak-bcrypt/releases/download/${KEYCLOAK_BCRYPT_VERSION}/keycloak-bcrypt-${KEYCLOAK_BCRYPT_VERSION}.jar > ${KEYCLOAK_HOME}/standalone/deployments/keycloak-bcrypt-${KEYCLOAK_BCRYPT_VERSION}.jar

```

You need to restart Keycloak.

## Run with Docker

```bash

docker run \

    -e KEYCLOAK_ADMIN=${KEYCLOAK_ADMIN} \

    -e KEYCLOAK_ADMIN_PASSWORD=${KEYCLOAK_ADMIN_PASSWORD} \

    -e KC_HOSTNAME=${KC_HOSTNAME} \

    gleroy/keycloak-bcrypt \

    start

```

The image is based on [Keycloak official](https://quay.io/repository/keycloak/keycloak) one.

## How to use

Go to `Authentication` / `Policies` / `Password policy` and add hashing algorithm policy with value `bcrypt`.

To test if installation works, create new user and set its credentials.