io.reactivex.netty.examples.http.ssl.README.md Maven / Gradle / Ivy
Overview
========
TO enable HTTPS connection, configure ```io.reactivex.netty.pipeline.ssl.SSLEngineFactory``` using
HttpClientBuilder. For testing purposes ```io.reactivex.netty.pipeline.ssl.DefaultFactories``` class is provided
that makes it easy to build SSLEngineFactory instances for client and server endpoints. These are good only for testing environment.
Running
=======
To run the example execute:
```
$ cd RxNetty/rxnetty-examples
$ ../gradlew runSslHelloWorldServer
```
and in another console:
```
$ cd RxNetty/rxnetty-examples
$ ../gradlew runSslHelloWorldClient
```
HTTP client
===========
Here is the snippet from [SslHelloWordClient](SslHelloWorldClient.java):
```java
public HttpResponseStatus sendHelloRequest() throws Exception {
HttpClient rxClient = RxNetty.newHttpClientBuilder("localhost", port)
.withSslEngineFactory(DefaultFactories.trustAll())
.build();
HttpResponseStatus statusCode = rxClient.submit(HttpClientRequest.createGet("/hello"))
...
}
}
```
The client code is identical to its non-encrypted counterpart ([HelloWorldClient](../helloworld/README.md)), except
the HTTPClient creation step. The predefined DefaultFactories.trustAll() SSLEngineFactory used in the example
will accept all certificates without validation. It is good only for testing purposes.
HTTP server
===========
Here is the snippet from [SslHelloWordClient](SslHelloWorldServer.java):
```java
public HttpServer createServer() throws CertificateException, SSLException {
HttpServer server = RxNetty.newHttpServerBuilder(port, new RequestHandler() {
@Override
public Observable handle(HttpServerRequest request, final HttpServerResponse response) {
response.writeStringAndFlush("Welcome!!");
return response.close();
}
}).withSslEngineFactory(DefaultFactories.selfSigned()).build();
...
}
```
On the server side, SSLEngineFactory is configured with a temporary self signed certificate/private key generated automatically.
It will be accepted on the client side, since in it is configured to trusts all certificates.
This setup should NEVER be used in the production deployment. Its usage is limited to test code/examples.