| Name | django-sslserver-v2 JSON |
| Version |
1.0
JSON |
| download |
| home_page | |
| Summary | An SSL-enabled development server for Django. Supports latest versions of Django and Python |
| upload_time | 2023-10-23 15:16:13 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=2 |
| license | MIT |
| keywords |
django-sslserver
sslserver
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
====================
Django SSL Server v2
====================
.. image:: https://img.shields.io/pypi/v/django-sslserver-v2.svg
:target: https://pypi.python.org/pypi/django-sslserver-v2
.. image:: https://img.shields.io/pypi/pyversions/django-sslserver-v2.svg
:target: https://pypi.python.org/pypi/django-sslserver-v2/
Django SSL Server v2 is a SSL-enabled development server for the Django Framework, a clone of `django-sslserver
<https://github.com/teddziuba/django-sslserver>`_. This project is actively maintained and supports the latest version of Django and Python.
Please note that this `should not be used for production setups
<https://docs.djangoproject.com/en/4.2/ref/django-admin/#runserver>`_. This
app is intended for special use-cases. Most people should instead do a proper
`production deployment
<https://docs.djangoproject.com/en/4.2/howto/deployment/>`_ where a real
webserver such as Apache or NGINX handles SSL.
Getting Started
===============
Install the module in your Python distribution or virtualenv::
$ pip install django-sslserver-v2
Add the application to your `INSTALLED_APPS`::
INSTALLED_APPS = (...
"sslserver",
...
)
Start a SSL-enabled debug server::
$ python manage.py runsslserver
and access app on https://localhost:8000 or start server on specified port::
$ python manage.py runsslserver 127.0.0.1:9000
IPv6 support::
$ python manage.py runsslserver -6 [::]:7443
You'll now be able to access your Django app on https://localhost:9000/
Browser Certificate Errors
==========================
Using the default settings, your local browser will make all sorts of noise that it *doesn't trust the certificate*. **This is expected.**
Django SSL Server ships "batteries included" with a self-signed server certificate. With self-signed certificates,
the server is effectively telling the user, "I'm such-and-such server, because I said so". Whereas, with a commercial
SSL certificate, the server tells the user, "I'm Bank of America, because VeriSign said so (or any other commercial certificate authority)."
There are two options for making the certificate warning go away in development:
**Option 1**: Tell your browser to explicitly trust the certificate. You can do this in your browser's "advanced settings"
tab, by installing ``sslserver/certs/development.crt`` as a trusted certificate. The mechanism for this varies from browser to browser.
**Option 2**: Use a certificate from a CA that your browser trusts, for example `Letsencrypt <https://letsencrypt.org>`_.
If you have a certificate/key pair from a certificate authority,
you can tell Django SSL Server to use it with the following arguments::
$ python manage.py runsslserver --certificate /path/to/certificate.crt --key /path/to/key.key
Third-Party Static File Handlers
================================
If you're using a wrapper around your WSGI application such as dj_static or WhiteNoise, you probably want to let it handle serving
static files. Otherwise, you may see 404s when requesting static files. You can disable the default behavior by using the ``--nostatic``
option.
Getting Involved
================
Feel free to open pull requests or issues. GitHub is the canonical location of this project.
Special Thanks
===============
Special thanks to `@teddziuba
<https://github.com/teddziuba>`_ for building `django-sslserver
<https://github.com/teddziuba/django-sslserver>`_ and all the `contributers
<https://github.com/shashwat2003/django-sslserver-v2/blob/master/AUTHORS>`_
Raw data
{
"_id": null,
"home_page": "",
"name": "django-sslserver-v2",
"maintainer": "",
"docs_url": null,
"requires_python": ">=2",
"maintainer_email": "",
"keywords": "django-sslserver,sslserver",
"author": "",
"author_email": "Shashwat <shashwat13.8@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/73/5a/8161cba4e470f71d1bb4e793b9ccdb9570ea1c4f5da1c0860cb1b67333dc/django-sslserver-v2-1.0.tar.gz",
"platform": null,
"description": "====================\nDjango SSL Server v2\n====================\n\n.. image:: https://img.shields.io/pypi/v/django-sslserver-v2.svg\n :target: https://pypi.python.org/pypi/django-sslserver-v2\n\n.. image:: https://img.shields.io/pypi/pyversions/django-sslserver-v2.svg\n :target: https://pypi.python.org/pypi/django-sslserver-v2/\n\nDjango SSL Server v2 is a SSL-enabled development server for the Django Framework, a clone of `django-sslserver\n<https://github.com/teddziuba/django-sslserver>`_. This project is actively maintained and supports the latest version of Django and Python.\n\nPlease note that this `should not be used for production setups\n<https://docs.djangoproject.com/en/4.2/ref/django-admin/#runserver>`_. This\napp is intended for special use-cases. Most people should instead do a proper\n`production deployment\n<https://docs.djangoproject.com/en/4.2/howto/deployment/>`_ where a real\nwebserver such as Apache or NGINX handles SSL.\n\nGetting Started\n===============\n\nInstall the module in your Python distribution or virtualenv::\n\n $ pip install django-sslserver-v2\n\nAdd the application to your `INSTALLED_APPS`::\n\n INSTALLED_APPS = (...\n \"sslserver\",\n ...\n )\n\nStart a SSL-enabled debug server::\n\n $ python manage.py runsslserver\n\nand access app on https://localhost:8000 or start server on specified port::\n\n $ python manage.py runsslserver 127.0.0.1:9000\n \nIPv6 support::\n\n $ python manage.py runsslserver -6 [::]:7443\n\nYou'll now be able to access your Django app on https://localhost:9000/\n\n\nBrowser Certificate Errors\n==========================\n\nUsing the default settings, your local browser will make all sorts of noise that it *doesn't trust the certificate*. **This is expected.**\n\nDjango SSL Server ships \"batteries included\" with a self-signed server certificate. With self-signed certificates,\nthe server is effectively telling the user, \"I'm such-and-such server, because I said so\". Whereas, with a commercial\nSSL certificate, the server tells the user, \"I'm Bank of America, because VeriSign said so (or any other commercial certificate authority).\"\n\nThere are two options for making the certificate warning go away in development:\n\n**Option 1**: Tell your browser to explicitly trust the certificate. You can do this in your browser's \"advanced settings\"\ntab, by installing ``sslserver/certs/development.crt`` as a trusted certificate. The mechanism for this varies from browser to browser.\n\n**Option 2**: Use a certificate from a CA that your browser trusts, for example `Letsencrypt <https://letsencrypt.org>`_.\nIf you have a certificate/key pair from a certificate authority,\nyou can tell Django SSL Server to use it with the following arguments::\n\n $ python manage.py runsslserver --certificate /path/to/certificate.crt --key /path/to/key.key\n\n\nThird-Party Static File Handlers\n================================\n\nIf you're using a wrapper around your WSGI application such as dj_static or WhiteNoise, you probably want to let it handle serving\nstatic files. Otherwise, you may see 404s when requesting static files. You can disable the default behavior by using the ``--nostatic``\noption.\n\nGetting Involved\n================\n\nFeel free to open pull requests or issues. GitHub is the canonical location of this project.\n\nSpecial Thanks\n===============\nSpecial thanks to `@teddziuba\n<https://github.com/teddziuba>`_ for building `django-sslserver\n<https://github.com/teddziuba/django-sslserver>`_ and all the `contributers\n<https://github.com/shashwat2003/django-sslserver-v2/blob/master/AUTHORS>`_\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An SSL-enabled development server for Django. Supports latest versions of Django and Python",
"version": "1.0",
"project_urls": null,
"split_keywords": [
"django-sslserver",
"sslserver"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "86a0bfc571b1905097af3c1c21d6a78f54fde50bfcb0495c21358bff7030cd21",
"md5": "14429d811885120f9259ae89fbca0459",
"sha256": "9f2f191534e74fc1a1a40724fe4e5293815acb92016770f1393524e67bdcf340"
},
"downloads": -1,
"filename": "django_sslserver_v2-1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "14429d811885120f9259ae89fbca0459",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=2",
"size": 11902,
"upload_time": "2023-10-23T15:16:10",
"upload_time_iso_8601": "2023-10-23T15:16:10.906252Z",
"url": "https://files.pythonhosted.org/packages/86/a0/bfc571b1905097af3c1c21d6a78f54fde50bfcb0495c21358bff7030cd21/django_sslserver_v2-1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "735a8161cba4e470f71d1bb4e793b9ccdb9570ea1c4f5da1c0860cb1b67333dc",
"md5": "98c317c3cfe6c1fd08f7c614ccd6b5fa",
"sha256": "4e1f84bc35a989bae25937ac017a6616ef04fdf99923cbba7b5c5dca27090f7c"
},
"downloads": -1,
"filename": "django-sslserver-v2-1.0.tar.gz",
"has_sig": false,
"md5_digest": "98c317c3cfe6c1fd08f7c614ccd6b5fa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2",
"size": 11175,
"upload_time": "2023-10-23T15:16:13",
"upload_time_iso_8601": "2023-10-23T15:16:13.327953Z",
"url": "https://files.pythonhosted.org/packages/73/5a/8161cba4e470f71d1bb4e793b9ccdb9570ea1c4f5da1c0860cb1b67333dc/django-sslserver-v2-1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-23 15:16:13",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "django-sslserver-v2"
}
