Keycloak 17.0.1 설치 및 DB 세팅 - 1

2022/04/19 기준 최신 버전 17.0.1을 설치하여 보자.

설치하기 앞서 OpenJDK 11 이상이 로컬에 설치되어 있어야 한다.

 

1. Keycloak 설치

2. 실행 오류 해결

3. PostgreSQL DB 연동

 

 

1. Keycloak 설치

Keycloak 17.0.1을 설치한다.

설치
wget https://github.com/keycloak/keycloak/releases/download/17.0.1/keycloak-17.0.1.tar.gz

압축
tar -zxf keycloak-17.0.1.tar.gz

2. Keycloak실행 오류 해결

설치 후 keycloak-17.0.1폴더 안에서 아래와 같이 명령어를 실행한다
bin/kc.sh start

실행 시 아래와 같이 운영 모드에서 hostname이 세팅안되어 있다고 에러난다. 실행 명령어 중 start-dev 개발 모드로 실행 시 에러 없지만 운영에서는 최소 설정을 확인 하는 것 같아 하나하나 해결 해보자.

아래와 같이 환경설정 세팅 후 다시 실행해 보자.

keycloak-17.0.1폴더 밑 conf/keycloak.conf에서 환경세팅을 할 수 있다.
cd conf
vi keycloak.conf


keycloak.conf파일에 아래와 같이 추가를 하였다.
hostname-strict=false // hostname 체크 해지
hostname-strict-https=false

이후 아래와 같이 https가 setup되어야 한다고 에러 난다. 다시 환경설정으로 돌아가서 추가하고 다시 실행하자!!

keycloak.conf파일에 아래와 같이 추가를 하였다.
http-enabled=true // http 접속 가능!!
http-port=5010 // 기본 포트 8080이라 5010으로 변경해서 테스트 진행하였습니다

아래와 같이 실행됨을 확인하였습니다.

 

 

혹시 위와 같이 어드민 등록 화면에서 에러 메시지가 나타나면 명령어를 통해서 직접 등록 할 수 있다.

// 어드민 계정을 로컬 환경설정에 등록 
export KEYCLOAK_ADMIN=admin
export KEYCLOAK_ADMIN_PASSWORD=admin

// 환경설정 읽어서 실행
-E bin/kc.sh start

 

 

3. DB 연동

자 이제 어드민 로그인 까지 성공 하였다면 DB연동을 해보자.

 

// keycloak-17.0.1 폴더 안에서 postgres사용하기 위해 build
bin/kc.sh build --db postgres

// build 후 keycloak-17.0.1/conf 폴더 아래 keycloak.conf를 열어서 db 세팅을 한다.

db=postgres
db-username=postgres
db-password=password
db-url=jdbc:postgresql://localhost:5432/postgres

keycloak.conf의 적용한 최종 세팅 정보들입니다.

-http-relative-path : keycloak접속 시 /auth로 접속할 수 있게 추가 하였습니다. (http://localhost:5010/auth/)

적용하고 다시 실행하면 위와 같이 db에 조회가 되는 것을 확인 할 수 있다.

DB 세팅까지 알아보았습니다 다음은 spring boot 와 keycloak 연동을 알아보겠습니다!