TLS-Scanner 사용법 (TLS/DTLS 지원)

스캐너 URL

https://github.com/tls-attacker/TLS-Scanner

GitHub - tls-attacker/TLS-Scanner: The TLS-Scanner Module from TLS-Attacker

 

 

* 특이사항

💡 JDK 11 외 버전은 지원하지 않음.

⇒ pom.xml 파일에 컴파일러 버전 하드 코딩되어 있음.

<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>

 

💡 기존 설치된 JAVA(JDK)가 있다면,

1) 제어판 > 프로그램 및 기능에서 제거.

- 보통 Java SE Development Kit, Java Runtime Environment 이름으로 되어 있음.

2) 환경 변수 제거 or 새로 받은 버전 경로로 편집

 

 

[ Windows 기준 ]

1. GIT 다운로드

https://git-scm.com/download/win

Git - Downloading Package

winget install --id Git.Git -e --source winget

 

- GIT 설치 확인

git

 

 

 

 

---

2. JDK 11 버전 다운로드

2-1. 첫 번째 방법(로그인 필요)

https://www.oracle.com/kr/java/technologies/javase/jdk11-archive-downloads.html

Java Archive Downloads - Java SE 11 | Oracle 대한민국

 

 

경로는 보통 C:\Program Files\Java 밑에 위치함.

 

 

2-2. 두 번째 방법(로그인X, 경로 설정 수동)

https://jdk.java.net/java-se-ri/11

Java Platform, Standard Edition 11 Reference Implementations

 

 

다운로드한 파일 압축 풀고,

C:\Program Files\Java 밑으로 이동.

 

 

 

---

3. Maven 다운로드

https://maven.apache.org/download.cgi

Maven – Download Apache Maven

 

 

적당한 위치로 옮겨 파일 압축 해제

 

 

---

4. 환경 변수 설정

- JAVA_HOME 설정

윈도우 검색 > 시스템 환경 변수 편집 > 환경 변수 > 시스템 변수 > 새로 만들기

 

변수 이름 : JAVA_HOME

변수 값 : C:\Program Files\Java\jdk-11 (JDK 경로)

 

 

- MAVEN_HOME 설정

윈도우 검색 > 시스템 환경 변수 편집 > 환경 변수 > 시스템 변수 > 새로 만들기

 

변수 이름 : MAVEN_HOME

변수 값 : C:\Users\A\Downloads\apache-maven-3.9.8\bin (maven 경로 \bin까지 추가)

 

 

- Path 설정

윈도우 검색 > 시스템 환경 변수 편집 > 환경 변수 > 시스템 변수 > Path

 

새로 만들기 > %JAVA_HOME%

새로 만들기 > %MAVEN_HOME%

새로 만들기 > C:\\Program Files\\Java\\jdk-11\\bin (JDK 경로의 \bin까지 추가)

 

 

---

5. 정상 설치 확인

java --version
javac --version
mvn -v

 

 

---

6. 컴파일

cmd/powershell 관리자 권한으로 실행

git clone https://github.com/tls-attacker/TLS-Scanner.git
cd TLS-Scanner

git submodule update --init --recursive
mvn clean package -DskipTests=true
mvn clean install

 

 

💡 참고 mvn clean install 명령어 입력 시 완료까지 오래 걸림.

하지만 명령어 입력 후, 경로 내 apps/TLS-Server-Scanner.jar 파일이 생성된다면

바로 아래 java -jar … 명령어 사용하여 스캔이 가능함.

 

 

---

7. 사용법

ex.

java -jar apps/TLS-Server-Scanner.jar -connect localhost:4433

java -jar apps/TLS-Server-Scanner.jar -connect [IP]:[PORT]

 

 

- DTLS 통신을 확인하고 싶을 때는 -dtls 옵션 추가

java -jar apps/TLS-Server-Scanner.jar -dtls -connect [IP]:[PORT]