[Keycloak] 설치 및 초기 설정 가이드

1. Keycloak 설치 파일 다운로드

Keycloak 공식 사이트에서 최신 버전의 설치 파일을 다운로드하세요.

• 다운로드 링크:
  downloads - Keycloak

팁:
설치 파일이 압축된 경우, 압축 해제 후 설치 폴더 구조를 꼭 확인하세요.

 

 

2. JDK 설치 및 환경 변수 설정

Keycloak 실행을 위해 Java Development Kit(JDK)가 필요합니다.

• JDK 다운로드:
  Java Downloads | Oracle 대한민국
• 설치 후 JAVA_HOME 설정:
  1. sysdm.cpl 명령어 실행
  2. 고급 탭에서 환경 변수 버튼 클릭
  3. 시스템 변수에 JAVA_HOME 추가 (설치 경로 입력)

주의:
올바른 JDK 버전을 선택하고, JAVA_HOME이 제대로 설정되어 있는지 확인하세요.

 

 

3. Keycloak 실행 및 초기 로그인

Keycloak을 개발 모드로 실행하여 바로 테스트해볼 수 있습니다.

1. 실행 명령어:
   설치 폴더 내 bin 디렉터리에서 아래 명령어를 실행하세요.
   bash

   복사편집

   kc.bat start-dev
2. 로그인 과정:
   • 실행 후, 만약 패치 메시지가 뜬다면 재실행합니다.
   • 재실행 후 나타나는 로그인 화면에서 Username과 Password를 입력하여 정상 로그인 확인

팁:
개발 모드에서는 빠른 테스트가 가능하므로, 처음 Keycloak을 경험해보는 사용자에게 적합합니다.

 

4. 참고 자료 및 공식 문서

• Keycloak 공식 문서:
  Documentation - Keycloak
• 설치 파일 폴더 구조 설명:
  Directory Structure - Keycloak

추가 자료:
다양한 설정 옵션과 고급 기능에 대해서는 공식 문서를 꼼꼼히 읽어보시길 추천드립니다.