Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tuladhar/ssl-handshake
A command-line tool for testing SSL/TLS handshake latency, written in Go.
https://github.com/tuladhar/ssl-handshake
cli client debugging developer-tools devops golang hacktoberfest hacktoberfest-accepted https open-source ssl ssl-handshake terminal tls
Last synced: 11 days ago
JSON representation
A command-line tool for testing SSL/TLS handshake latency, written in Go.
- Host: GitHub
- URL: https://github.com/tuladhar/ssl-handshake
- Owner: tuladhar
- License: mit
- Created: 2021-12-24T08:09:54.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-12-22T15:43:45.000Z (11 months ago)
- Last Synced: 2024-10-24T22:11:46.124Z (19 days ago)
- Topics: cli, client, debugging, developer-tools, devops, golang, hacktoberfest, hacktoberfest-accepted, https, open-source, ssl, ssl-handshake, terminal, tls
- Language: Go
- Homepage:
- Size: 338 KB
- Stars: 66
- Watchers: 3
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ssl-handshake
A command-line tool for testing SSL/TLS handshake latency, written in [Go](https://go.dev/).
## Features
* TCP handshake latency
* SSL/TLS handshake latency
* TLS version used during the handshake
* SNI support
* Display handshake statistics
* Configurable endpoint port, handshake interval, timeout and count
##
## What is an SSL/TLS Handshake?
An SSL/TLS handshake is the process that kicks off a communication session between client and server that uses [TLS encryption](https://en.wikipedia.org/wiki/Transport_Layer_Security). During a TLS handshake, the two communicating sides exchange messages to acknowledge each other, verify each other, establish the encryption algorithms they will use, and agree on session keys. TLS handshakes are a foundational part of how HTTPS works and it is defined in [RFC 8446 (for TLS 1.3)](https://tools.ietf.org/html/rfc8446) or in [RFC 5246 (for TLS 1.2)](https://datatracker.ietf.org/doc/html/rfc5246).
TLS handshakes occur after a TCP connection has been opened via a TCP handshake.
TLS handshake packets captured with [Wireshark](https://www.wireshark.org/).
## Docker Image
Docker image is publicly available at DockerHub:
* https://hub.docker.com/r/ptuladhar/ssl-handshake
Run `ssl-handshake` as Docker container:
```
docker run --rm ptuladhar/ssl-handshake -c 5 tuladhar.github.io:443
```
You can also alias `ssl-handshake`, for ease of use:
```
alias ssl-handshake="docker run --rm ptuladhar/ssl-handshake"
ssl-handshake tuladhar.github.com:443
```
## Install binary
Binary is available for Linux, Windows and Mac OS (amd64 and arm64). Download the binary for your respective platform from the [releases page](https://github.com/tuladhar/ssl-handshake/releases).
Linux:
```
curl -sSLO https://github.com/tuladhar/ssl-handshake/releases/download/v1.6.1/ssl-handshake-v1.6.1-linux-amd64.tar.gz
```
```
tar zxf ssl-handshake-v1.6.1-linux-amd64.tar.gz
```
```
sudo install -m 0755 ssl-handshake /usr/local/bin/ssl-handshake
```
macOS (Intel):
```
curl -sSLO https://github.com/tuladhar/ssl-handshake/releases/download/v1.6.1/ssl-handshake-v1.6.1-darwin-amd64.tar.gz
```
```
tar zxf ssl-handshake-v1.6.1-darwin-amd64.tar.gz
```
```
sudo install -m 0755 ssl-handshake /usr/local/bin/ssl-handshake
```
macOS (Apple Silicon):
```
curl -sSLO https://github.com/tuladhar/ssl-handshake/releases/download/v1.6.1/ssl-handshake-v1.6.1-darwin-arm64.tar.gz
```
```
tar zxf ssl-handshake-v1.6.1-darwin-arm64.tar.gz
```
```
sudo install -m 0755 ssl-handshake /usr/local/bin/ssl-handshake
```
Windows:
```
curl -sSLO https://github.com/tuladhar/ssl-handshake/releases/download/v1.6.1/ssl-handshake-v1.6.1-windows-amd64.zip
```
```
unzip ssl-handshake-v1.6.1-windows-amd64.zip
```
## Development
If you wish to contribute or compile from source code, you'll first need Go installed on your machine. Go version 1.17+ is required. Currently, there are no dependencies on third-party modules.
```
git clone https://github.com/tuladhar/ssl-handshake
cd ssl-handshake
go build
```
## Release
1. [Draft new release](https://github.com/tuladhar/ssl-handshake/releases/new)
2. Choose a release tag, e.g: `v1.6.2`
3. Set release title and changelog
4. Click `Publish release`
Now, [GitHub action release workflow](https://github.com/tuladhar/ssl-handshake/actions/workflows/release.yml) will triggered to build binary for all major platforms.
## Contributors
- [See Contributors](https://github.com/tuladhar/ssl-handshake/graphs/contributors)