hebnern / sporsh-jostedal

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 🍦.

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

• RFC 5389 STUN
• RFC 5766 TURN

License

MIT