Simple TlsLibrary written in Kotlin - Provides DSL for creating TLS connections

Simon Wirtz

Last update: Jan 4, 2023

Related tags

Kotlin kotlin java tls ssl keystore kotlin-dsl jse

Overview

SeKurity - Kotlin powered TLS library

This library provides an API for creating basic SSL/TLS connections with standard Java Secure Socket Extension, JSSE. The Library is implemented in Kotlin. The Kotlin API is implemented with a "type-safe builder" approach, which is quite popular in the Groovy community.

Disclaimer: The current Version is not optimized for Java yet.

Motivation

If you also find it hard to use the complex JSSE structure to create your SSL sockets, which also generates lots of boilerplate when used directly, this tool is what you've been looking for.

The library provides means for creating SSLSocketFactories that can be used for most use cases where TLS/SSL connections are required. It's also supposed to provide usage examples and even sample implementations like SSL enabled servers, Apache HTTP Clients and others, which you can use directly in your application.

Demo of Kotlin DSL

In the following you can see some basic examples of using the Kotlin DSL for setting up ssl-(server)-socket-factories.

Creating a Client Socket for Mutual Authentication (Client Keystore must be provided):

val fac = createSocketFactory {
            keyManager {
                open("certsandstores/clientkeystore", "jks") withPass "123456"
            }
            trustManager {
                open("certsandstores/myTruststore", "jks") withPass "123456"
            }
            sockets {
                cipherSuites = listOf("TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256", "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384",
                        "TLS_DHE_RSA_WITH_AES_128_CBC_SHA", "TLS_DHE_RSA_WITH_AES_256_CBC_SHA")
                timeout = 10_000
            }
}

val socket = fac.createSocket("192.168.3.10", 443)

Creating a Server Socket with simple keystore (no Client Auth required)

val fac = createServerSocketFactory {
        keyManager {
            open("certsandstores/clientkeystore", "jks") withPass "123456"
        }
    }

    val accept = fac.createServerSocket(443).accept()
}

Getting Started

In your Gradle build, simply include the following repo as well as dependency:

maven { 
    setUrl("https://dl.bintray.com/s1m0nw1/SeKurity/")
}

compile("de.swirtz:sekurity:0.0.x")

Basics

You can read about TLS and Keystores here.

Simple TlsLibrary written in Kotlin - Provides DSL for creating TLS connections

Related tags

Overview

SeKurity - Kotlin powered TLS library

Motivation

Demo of Kotlin DSL

Creating a Client Socket for Mutual Authentication (Client Keystore must be provided):

Creating a Server Socket with simple keystore (no Client Auth required)

Getting Started

Basics

You might also like...

Code generation of Kotlin DSL for AWS CDK

Regular expression DSL on Kotlin

Kotlin Object Notation - Lightweight DSL to build fluid JSON trees

Kotlin parser library with an easy-to-use DSL

Kotlin DSL for Junit5

Kotlin-dsl-sample - Preferences project on android

GitHub Actions Kotlin DSL

Kotlin DSL inspired by bhailang.js

A light weight Compose Animation library to choreograph low level Animation API through Kotlin DSL.

Releases(v0.0.3)

v0.0.3(May 13, 2018)

v0.0.2(May 7, 2018)

Owner

Simon Wirtz

Nice and simple DSL for Espresso in Kotlin

A simple, classic Kotlin MVI implementation based on coroutines with Android support, clean DSL and easy to understand logic

An example of a test task for creating a simple currency converter application for the Android platform. The app is developed using Kotlin, MVI, Dagger Hilt, Retrofit, Jetpack Compose.

Android + Kotlin + Github Actions + ktlint + Detekt + Gradle Kotlin DSL + buildSrc = ❤️

A Kotlin DSL wrapper around the mikepenz/MaterialDrawer library.

{ } Declarative Kotlin DSL for choreographing Android transitions

Kotlin Dsl for Android RecyclerView

The most complete and powerful data-binding library and persistence infra for Kotlin 1.3, Android & Splitties Views DSL, JavaFX & TornadoFX, JSON, JDBC & SQLite, SharedPreferences.

DSL for constructing the drawables in Kotlin instead of in XML

Lightweight Kotlin DSL dependency injection library