From c15d8800e21654f700c1dc205dbeec742764027e Mon Sep 17 00:00:00 2001 From: Erik van Zijst Date: Tue, 17 Aug 2021 23:53:34 +0200 Subject: [PATCH] Releasing 0.1.0 --- README.md | 19 +++++++++++++++---- build.sbt | 2 +- 2 files changed, 16 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index c99d9b0..07406fa 100644 --- a/README.md +++ b/README.md @@ -44,6 +44,17 @@ accept-ranges: bytes ## Library +The project is published to Sonatype OSS: + + Group id / organization: io.github.erikvanzijst + Artifact id / name: scala-tlsproxy + +sbt users may add this to their `build.sbt`: + +``` +libraryDependencies += "io.github.erikvanzijst" %% "scala-tlsproxy_2.12" % "0.1.0" +``` + To use it as a library in-process: ```scala @@ -52,8 +63,8 @@ import io.github.erikvanzijst.scalatlsproxy.TlsProxy new TlsProxy(3128).run() ``` -The `run()` does not create any threads and run the entire proxy on the -calling thread. It does not return. +The `run()` method does not create any threads and runs the entire proxy on +the calling thread. It does not return. To move it to the background, pass it to a `Thread` or `Executor`: @@ -68,7 +79,7 @@ executor.submit(new TlsProxy(3128)) ## Caveat emptor -This is only implements the `CONNECT` method and can therefor only proxy HTTPS +This only implements the `CONNECT` method and can therefore only proxy HTTPS requests. It does not support unencrypted proxy requests using `GET`. Proxy requests for HTTP (non-TLS) `GET` requests result in an error and the @@ -81,7 +92,7 @@ connection getting closed: ## Robustness (or lack thereof) -* This implementation is totally susceptible to all kinds of [slowloris attacks](https://en.wikipedia.org/wiki/Slowloris_(computer_security). +* This implementation is totally susceptible to all kinds of [slowloris attacks](https://en.wikipedia.org/wiki/Slowloris_%28computer_security%29) * It does not support client authentication * Uses only 1 thread and cannot currently scale to multiple cores * Does not restrict non-standard upstream ports diff --git a/build.sbt b/build.sbt index f31e7d4..1e6a4ae 100644 --- a/build.sbt +++ b/build.sbt @@ -1,7 +1,7 @@ name := "scala-tlsproxy" organization := "io.github.erikvanzijst" -version := "0.1-SNAPSHOT" +version := "0.1.0" scalaVersion := "2.12.14"