Skip to main content

Toolkit for testing if you actually verify TLS certificates

Project description

=======
jorji
=======

[![Build Status](https://travis-ci.org/rackerlabs/jorji.svg)](https://travis-ci.org/rackerlabs/jorji)
[![Coverage Status](https://coveralls.io/repos/rackerlabs/jorji/badge.png)](https://coveralls.io/r/rackerlabs/jorji)

jorji has a forged passp^H^H^H^H^Hcertificate. Will you catch it?

This contains the tools you need to produce a TLS server (by default,
an HTTPS server) with bogus certificates. This is useful to write
integration tests to verify that your application actually checks the
certificate provided by the server.

Using jorji
===========

With Twisted_
------------

If you're already using Twisted,

```python
from jorji import make_cert, run
TODO!!!
```

Without Twisted (a.k.a. with Twisted, secretly, anyway)
-------------------------------------------------------

The recommended way to use jorji without Twisted is crochet_. It will
run the Twisted reactor off in a thread somewhere so you don't have to
worry about it.

Thanks!
=======

I'd like to thank Rackspace_ for giving me the opportunity to produce
open-source software on company time.

Contributing to jorji
=====================

Please send pull requests to `lvh/jorji`_ on Github.

.. _Twisted: https://twistedmatrix.com/trac/
.. _crochet: https://github.com/itamarst/crochet
.. _Rackspace: http://www.rackspace.com/
.. _`lvh/jorji`: https://github.com/lvh/jorji

Project details


Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page