jostedal icon indicating copy to clipboard operation
jostedal copied to clipboard

STUN and TURN server and client library for testing ICE in Python

Jostedal

An implementation of the STUN and TURN protocols in Python using Twisted.

The primary purpose of the project is to support testing of ICE.
Jostedal is named after the Jostedal Glacier as a pun for ice :icecream:.

Running a TURN server

A simple example script is provided to start a server:

jostedal INTERFACE [PORT [CONFIG-FILE]]

Configuration

Configuration is read in from a JSON file (by default config.json).

{
    "software": "Jostedal",
    "realm": "pexip.com",

    "users": {
        "passuser": {
            "password": "password"
        },
        "keyuser": {
            "key": "1b5c8156a9eee41c062037663f54cbac"
        }
    }
}

The values of the software and realm attributes can be configured here.

Long term credentials can also be specified - using either plain text passwords or HMAC-SHA-1 keys.
To generate HMAC-SHA-1 keys, you can use the hmac script.

hmac USERNAME REALM [PASSWORD]

Features

License

MIT