[WebGoat] 실습 환경 구축하기

📂 출처
본 자료는 '개발자를 위한 웹 해킹' 책을 바탕으로 작성되었습니다.

01. 실습 프로그램 설치

Step 1. Docker Desktop 설치

📂 참고자료
- Ver. Windows
Windows에 Docker Desktop 설치하기
윈도우에 도커 데스크탑 설치

- Ver. Mac
[Docker] Docker MacOS 환경 최초 설치 및 실행 방법: Image, Container, Registry
[Docker] Mac OS에 Docker 설치

 

Step 2. 컨테이너 실행 및 설치

▶ 실습용 컨테이너 실행

Windows PowerShell을 [관리자로 실행] 버튼을 클릭하여 관리자 권한으로 실행시켜준다.

 

관리자 권한으로 실행된 PowerShell에서 다음과 같은 명령어를 입력해준다

※ 실습 프로그램 구축 과정에서 본 컨테이너 환경에서 실습을 진행할 것이기 때문에 창을 닫지 말고 그대로 두어야 한다

🗨️ 실습용 컨테이너 실행 명령어
docker run -it --name webgoat -p 8080:8080 -p 9090:9090 ubuntu

 

[ 컨테이너 실행 명령어 설명 ]

• docker run : 컨테이너 실행 명령
• -it : 컨테이너 입력 설정을 하는 -i 옵션과 터미널로 현재 쉘에 접근하는 -t 옵션을 하나로 합친 옵션
• --name : 생성할 컨테이너의 이름 설정 옵션
• -p : 호스트 포트를 컨테이너 포트에 포트포워딩 시키는 옵션
• ubuntu : 컨테이너 실행에 사용하는 이미지

 

⚠️ 포트포워딩이란?
포트포워딩(Port forwarding)은 간단히 말해서 포트(Port)를 전달(Forwarding)해 주는 것이라고 생각할 수 있다. 특정한 포트로 들어오는 데이터 패킷을 다른 포트로 바꿔서 다시 전송해주는 작업이다.
[ 참고자료 ]
- '포트 포워딩' 왜 하는 걸까? 🌐
- 포트포워딩: 포트포워딩의 정의와 설정 방법

 

 

02. 실습 프로그램 구축

Step 1. WebGoat 설치 및 환경 구성

구글에 WebGoat 검색 후 위 이미지와 같이 나오는 깃허브 레포지토리에 접속한다

 

그럼 위와 같이 WebGoat의 Github Repository로 넘어갈 수 있다.

 

실습 환경에서의 오류를 최소화하기 위해 상단 main 버튼을 눌러 Tags를 'v2023.3'으로 변경해준다

 

앞서 준비한 실습용 컨테이너에 WebGoat 소스코드를 빌드하여 실행하기 위해 WebGoat repository의 clone 주소를 복사해준다.

 

이후 다시 컨테이너로 돌아와 'apt update' 명령어를 실행해준다.

 

WebGoat 소스코드를 Clone 하기 위해 필요한 git 패키지와 소스코드 수정을 위해 필요한 vim 에디터 패키지를 'apt install git vim' 명령어를 입력하여 설치해준다.

 

다음으로 WebGoat 빌드와 실행에 필요한 JDK를 설치해준다. WebGoat는 JDK17을 기반으로 개발되었으므로 'apt install -y openjdk-17-jdk' 명령어를 입력하여 설치한다

 

설치가 완료되었다면 'java -version' 명령어를 입력하여 openjdk version이 17로 시작하는지 확인해볼 수 있다.

 

다음으로 위와 같이 3단계로 WebGoat 소스코드 빌드 과정을 수행해주어야 한다.

첫번째 부분은 WebGoat 소스코드를 root 계정의 홈 디렉터리로 이동 후 다운로드 및 빌드 과정을 수행해 주는 부분이다.

두번째 부분은 복사한 WebGoat repository의 clone 주소를 사용하여 WebGoat 소스코드를 clone 해줄 수 있다.

세번째 부분은 WebGoat 디렉터리에 접근한 후, 소스코드를 잘 받아왔는지 'git describe' 명령어를 입력하여 확인할 수 있다.

 

WebGoat 설정 파일 수정을 위해 'vi src/main/resources/application-webgoat.properties' 명령어를 입력하여 vi 에디터를 실행해준다.

 

해당 설정 파일에서 'webgoat.host=${WEBGOAT_HOST:127.0.0.1}'로 되어있는 것을 볼 수 있는데 이는 WebGoat를 127.0.0.1에서만 접근 가능하도록 만드는 설정으로, 이번 실습 환경에서는 호스트 PC 브라우저를 통해 접근하므로 해당 부분을 주석 처리하고 그 아래에 'webgoat.host=0.0.0.0'을 추가하여 호스트 pc에서 접근이 가능하도록 수정하고 저장해준다.

 

📂 vi 편집기 사용법
- 내용을 입력할 때는 키보드 'i'를 눌러 입력할 수 있다
- 작성 완료 후 저장 및 종료를 하고자 할 때는 'ESC' 키를 누르고 ':wq' 입력 후 엔터 버튼을 누르면 저장 후 다시 작성하던 쉘로 이동할 수 있다.

 

같은 경로에 있는 Webwolf 설정 파일도 'vi src/main/resources/application-webwolf.properties' 명령어를 사용하여 수정해준다.

 

 

설정파일의 수정이 완료되었다면 WebGoat를 빌드해주어야 한다. './mvnw clean install' 명령어를 사용하여 빌드 해줄 수 있다.

 

빌드 후, 'BUILD SUCCESS'가 표시되면 빌드가 성공적으로 종료된 것이다.

 

다음으로 './mvnw spring-boot:run' 명령어를 입력하여 빌드된 WebGoat를 실행시켜준다

 

위 이미지와 같은 문구가 보이면 정상적으로 실행된 것이다.

 

이제 브라우저를 통해 접근해보자. 브라우저 실행 후 주소창에 'http://localhost:8080/WebGoat'를 입력하면 WebGoat 로그인 화면으로 리다이렉트 되는 것을 확인할 수 있다.

 

WebGoat와 동일하게 브라우저 주소창에 'localhost:9090'을 입력하면 WebWolf의 홈화면을 확인할 수 있다.

이렇게 되면 실습 환경 구축은 끝!!

 

 

Step 2. WebGoat 계정 생성 및 접속

WebGoat 접속 후 회원가입을 위해 Sign in 하단에 있는 버튼을 클릭한다.

 

사용하고자 하는 Username과 비밀번호를 입력하고 'Sign up' 버튼을 클릭하면 된다.

 

회원가입이 완료되면 다음 화면으로 넘어가는 것을 볼 수 있다.