Skip to content

Commit 1b9defc

Browse files
authored
Merge pull request #745 from tls-attacker/remoteRepository
changed pom to contain snapshot deployment information
2 parents 1fc3517 + 9aaad62 commit 1b9defc

File tree

2 files changed

+27
-30
lines changed

2 files changed

+27
-30
lines changed

README.md

Lines changed: 17 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# TLS-Attacker
22

3-
[![release](https://img.shields.io/badge/Release-v3.6.0-blue.svg)](https://github.com/RUB-NDS/TLS-Attacker/releases)
3+
[![release](https://img.shields.io/badge/Release-v3.6.0-blue.svg)](https://github.com/tls-attacker/TLS-Attacker/releases)
44
![licence](https://img.shields.io/badge/License-Apachev2-brightgreen.svg)
55
[![Build Status](https://hydrogen.cloud.nds.rub.de/buildStatus/icon.svg?job=TLS-Attacker)](https://hydrogen.cloud.nds.rub.de/job/TLS-Attacker/)
66

@@ -13,28 +13,11 @@ In order to compile and use TLS-Attacker, you need to have Java and Maven instal
1313
```bash
1414
$ sudo apt-get install maven
1515
```
16-
TLS-Attacker currently needs Java JDK 8 to run. Since version 3.5.0, TLS-Attacker also required ASN.1-Tool and X509-Attacker as a dependency.
17-
18-
Installing ASN.1 Tool:
19-
```bash
20-
$ git clone https://github.com/RUB-NDS/ASN.1-Tool
21-
$ cd ASN.1-Tool
22-
$ mvn clean install
23-
$ cd ..
24-
25-
```
26-
27-
Installing X509-Attacker:
28-
```bash
29-
$ git clone https://github.com/RUB-NDS/x509-Attacker
30-
$ cd X509-Attacker
31-
$ mvn clean install
32-
$ cd ..
33-
```
34-
16+
TLS-Attacker currently needs Java JDK 8 to run.
3517

3618
If you have the correct Java version you can run the maven command from the TLS-Attacker directory:
3719
```bash
20+
$ git clone https://github.com/tls-attacker/TLS-Attacker.git
3821
$ cd TLS-Attacker
3922
$ mvn clean install
4023
```
@@ -44,6 +27,17 @@ $ mvn clean install -DskipTests=true
4427
```
4528
The resulting jar files are placed in the "apps" folder.
4629

30+
If you want to use this project as a dependency, you do not have to compile it yourself and can include it in your pom
31+
.xml as follows.
32+
```xml
33+
<dependency>
34+
<groupId>de.rub.nds.tlsattacker</groupId>
35+
<artifactId>TLS-Attacker</artifactId>
36+
<version>3.7.0</version>
37+
<type>pom</type>
38+
</dependency>
39+
```
40+
4741
TLS-Attacker ships with demo applications which provide you easy access to TLS-Attacker functionality.
4842

4943
You can run TLS-Attacker as a client with the following command:
@@ -75,7 +69,7 @@ TLS-Attacker consists of several (maven) projects:
7569
- Transport: Transport utilities for lower layers
7670
- Utils: A collection of utility classes
7771

78-
![TLS-Attacker design](https://github.com/RUB-NDS/TLS-Attacker/blob/master/resources/figures/design.png)
72+
![TLS-Attacker design](https://github.com/tls-attacker/TLS-Attacker/blob/master/resources/figures/design.png)
7973

8074
You can find more information about these modules in the Wiki.
8175

@@ -133,10 +127,7 @@ State state = new State(config, trace);
133127
DefaultWorkflowExecutor executor = new DefaultWorkflowExecutor(state);
134128
executor.executeWorkflow();
135129
```
136-
TLS-Attacker uses the concept of WorkflowTraces to define a "TLS message flow". A WorkflowTrace consists of a list of actions which are then executed one after the other.
137-
Although for a typical "TLS message flow" only SendAction's and ReceiveAction's are needed, the framework does not
138-
stop here and implements a lot of different other actions
139-
which can be used to execute even more arbitrary message flows. A list of currently implemented actions with explanations can be found in the Wiki.
130+
TLS-Attacker uses the concept of WorkflowTraces to define a "TLS message flow". A WorkflowTrace consists of a list of actions which are then executed one after the other. Although for a typical "TLS message flow" only SendAction's and ReceiveAction's are needed, the framework does not stop here and implements a lot of different other actions which can be used to execute even more arbitrary message flows. A list of currently implemented actions with explanations can be found in the Wiki.
140131

141132
We know many of you hate Java. Therefore, you can also use an XML structure and run your customized TLS protocol from XML:
142133
```xml
@@ -186,7 +177,7 @@ Given this XML structure is located in TLS-Attacker/apps/workflow.xml, you would
186177
$ java -jar TLS-Client.jar -connect [host]:[port] -workflow_input workflow.xml
187178
```
188179
## Modifiable Variables
189-
TLS-Attacker uses the concept of Modifiable Variables to allow runtime modifications to predefined Workflows. Modifiable variables allow one to set modifications to basic types after or before their values are actually set. When their actual values are determined and one tries to access the value via getters the original value will be returned in a modified form accordingly. More details on this concept can be found at https://github.com/RUB-NDS/ModifiableVariable.
180+
TLS-Attacker uses the concept of Modifiable Variables to allow runtime modifications to predefined Workflows. Modifiable variables allow one to set modifications to basic types after or before their values are actually set. When their actual values are determined and one tries to access the value via getters the original value will be returned in a modified form accordingly. More details on this concept can be found at https://github.com/tls-attacker/ModifiableVariable.
190181

191182
```java
192183
ModifiableInteger i = new ModifiableInteger();

pom.xml

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,9 @@
2020

2121
<distributionManagement>
2222
<snapshotRepository>
23-
<id>ossrh</id>
24-
<url>https://oss.sonatype.org/content/repositories/snapshots</url>
23+
<id>rub-nexus</id>
24+
<name>TLS-Attacker Internal Repository</name>
25+
<url>https://hydrogen.cloud.nds.rub.de/nexus/repository/maven-snapshots/</url>
2526
</snapshotRepository>
2627
<repository>
2728
<id>ossrh</id>
@@ -157,7 +158,7 @@
157158
<dependency>
158159
<groupId>de.rub.nds</groupId>
159160
<artifactId>ModifiableVariable</artifactId>
160-
<version>3.1.0</version>
161+
<version>3.1.0-SNAPSHOT</version>
161162
</dependency>
162163
<dependency>
163164
<groupId>org.reflections</groupId>
@@ -172,7 +173,7 @@
172173
<dependency>
173174
<groupId>de.rub.nds</groupId>
174175
<artifactId>X509Attacker</artifactId>
175-
<version>1.2.0</version>
176+
<version>1.2.0-SNAPSHOT</version>
176177
</dependency>
177178
</dependencies>
178179
<build>
@@ -479,6 +480,11 @@
479480
<additionalparam>-Xdoclint:none</additionalparam>
480481
</configuration>
481482
</plugin>
483+
<plugin>
484+
<groupId>org.apache.maven.plugins</groupId>
485+
<artifactId>maven-deploy-plugin</artifactId>
486+
<version>3.0.0-M1</version>
487+
</plugin>
482488
</plugins>
483489
</reporting>
484490

0 commit comments

Comments
 (0)