KeyCloak 설치 및 구성

앞선 설명했듯이, 오프소스 SSO중 Keycloak 은 애플리케이션과 서비스에 초점을 둔 ID 및 접근 관리(Access Management)에 통합 인증(SSO)을 허용하는 오픈 소스 소프트웨어로 Kubernetes 또는 MSA 환경에 최적화 된 솔루션 입니다. 쉽게 말하면 인증(Authentification)과 인가(Authorization)를 쉽게 해주고 SSO(Single-Sign-On)를 가능하게 해주는 것이다.

 

오늘은 우분투(Ubuntu) 환경에서 Keycloak를 설치 해 보자.

 

※ 우분투 버전은 Ubuntu 22.04.1 LTS 입니다.

 

사 전 준 비

1. JAVA 설치

sudo apt-get install openjdk-11-jdk

 최신 Keycloak는 OpenJDK 11 이상 설치가 필요하다.

 

2. KeyCloak 다운로드

다운로드 keycloak-21.1.1.tar.gz

최신버전 keycloak 공식 홈페이지에서 확인 바랍니다.  

downloads - Keycloak

3. 다운로드 된 파일 압축 풀기

$ tar -zxvf keycloak-21.1.1.tar.gz

 

4. 기본 실행

• keycloak 디렉터리로 이동합니다.

$cd keycloak-21.1.1/

• Keycloak를 시작하기 전에 초기 관리자 계정을 생성 해야 합니다.
• Keycloak는 default admin 유저가 없으므로 환경을 셋팅하여 실행해야 합니다.

$ export KEYCLOAK_ADMIN=admin
$ export KEYCLOAK_ADMIN_PASSWORD=admin

• keycloak을 실행 합니다.

$ cd bin
$ ./kc.sh start-dev

 

• http://localhost:8080 접속

keycloak 화면

 

5. Administration Console 접속

위 페이지가 나오면 Adminnistration Console 탭을 클릭해 줍니다.

Keycloak 로그인 화면

초기에 export한 관리자 계정과 패스워드를 입력합니다. ( admin / admin )

 

로그인을 하게 되면 아래와 같은 KeyCloak 기본 대시보드가 표시된다.

 

다음편에는 realm, client, user 생성등을 알아보자.