{"id":22122599,"url":"https://github.com/thorgate/django-esteid","last_synced_at":"2025-07-25T14:30:57.939Z","repository":{"id":1875791,"uuid":"45055083","full_name":"thorgate/django-esteid","owner":"thorgate","description":"Django-esteid is a package that provides Esteid based authentication and signing for your Django applications.","archived":false,"fork":false,"pushed_at":"2023-11-21T14:42:36.000Z","size":1859,"stargazers_count":19,"open_issues_count":3,"forks_count":2,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-29T06:09:30.972Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thorgate.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-10-27T16:43:39.000Z","updated_at":"2023-03-01T08:10:49.000Z","dependencies_parsed_at":"2023-07-08T13:01:28.307Z","dependency_job_id":"b3a6ea75-ef8f-4d33-b62e-09f67e69e2e5","html_url":"https://github.com/thorgate/django-esteid","commit_stats":{"total_commits":195,"total_committers":12,"mean_commits":16.25,"dds":0.6205128205128205,"last_synced_commit":"512c8cda6075e3801948ceb62c6b74124db3ffa5"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thorgate%2Fdjango-esteid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thorgate%2Fdjango-esteid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thorgate%2Fdjango-esteid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thorgate%2Fdjango-esteid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thorgate","download_url":"https://codeload.github.com/thorgate/django-esteid/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227584197,"owners_count":17789665,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-01T15:26:38.068Z","updated_at":"2024-12-01T15:26:38.818Z","avatar_url":"https://github.com/thorgate.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# django-esteid\n\n[![pypi Status](https://badge.fury.io/py/django-esteid.png)](https://badge.fury.io/py/django-esteid)\n[![CI](https://github.com/thorgate/django-esteid/actions/workflows/test.yml/badge.svg)](https://github.com/thorgate/django-esteid/actions/workflows/test.yml)\n[![Coverage Status](https://coveralls.io/repos/github/thorgate/django-esteid/badge.svg?branch=master)](https://coveralls.io/github/thorgate/django-esteid?branch=master)\n\nDjango-esteid is a package that provides Esteid based authentication and signing for your Django applications.\n\n## Quickstart\n\nInstall `django-esteid`:\n\n    pip install django-esteid\n\nAdd `esteid` to installed apps:\n\n    INSTALLED_APPS = [\n        # ...\n        'esteid',\n        # ...\n    ]\n\nPlease refer to the more detailed guides on [signing](esteid/signing) and [authentication](esteid/authentication).    \n\nBe sure to read the [testing](#testing) section below.\n\nStatic files such as the services' logos and helper JS are also shipped with this library. \n\n### SmartID\n\nDetailed docs are [here](esteid/smartid/README.md).\n\n### MobileID\n\nDetailed docs are [here](esteid/mobileid/README.md).\n\n### ID Card\n\nDetailed docs are [here](esteid/idcard/README.md).\n\n### Service settings\n\nYou can \n\n### Context processors\n\n`esteid.context_processors.esteid_services` adds service enabled/demo statuses to the template context.\nThis way you can easily manage the necessary services displayed on the auth/signing page.\n\n## Testing\n\nFor a guide to authentication testing, please refer to [the authentication readme](./esteid/authentication/README.md).\n\nThere is a possibility to test the signing flow with ID card, SmartID \nand Mobile ID (the demo services) with the test views coming with the library.\n\n**NOTE:** you may not be able to use the live Esteid services even with live credentials.\nThe live services keep an IP address whitelist \nwhich only contains IP addresses as specified in customer's contract.\n\nTo run the django-esteid test server with the test views, \n* install the virtual environment if not installed yet,\n* run `./manage.py migrate` to create the SQLite DB for sessions,\n* run `./manage.py runserver 8765`, where 8765 is a port of your liking\n\nthen visit the URL http://localhost:8765/ and follow the instructions on that page.\n\n### Mobile ID\n\nTo test Mobile ID signing, you will need [test phone numbers and ID codes](https://github.com/SK-EID/MID/wiki/Test-number-for-automated-testing-in-DEMO).\n\nYou can not use real phone numbers or ID codes with the demo service.\n\n### SmartID\n\nTo test signing with SmartID, yoy can use [the test ID codes](https://github.com/SK-EID/smart-id-documentation/wiki/Environment-technical-parameters).\n \nYou can also register a demo SmartID account and use a demo SmartID app to enter the PINs; please visit the\n[demo SmartID portal](https://sid.demo.sk.ee/portal/login) for the details. \n\n### ID card\n\nID card signing requires SSL to work, even in a testing environment.  \nNote that the signature will not be valid neither with the real certificates, nor with the test ones. \n\nTo perform signing with ID card, you would need the `chrome-token-signing` browser plugin installed.\n`apt-get install chrome-token-signing`\n\n#### Testing with ssl\n\nYou can run an HTTPS webserver with `./manage.py runsslserver 127.0.0.1:8765`. It will use a development certificate\ncoming with the `djangosslserver` package. \n\nNote that the cert is self-signed, so you will need to create a security exception in browser.\n\nIf you need to create your own cert using openssl:\n```\nopenssl req -x509 -out localhost.crt -keyout localhost.key \\\n  -newkey rsa:2048 -nodes -sha256 \\\n  -subj '/CN=localhost' -extensions EXT -config \u003c( \\\n   printf \"[dn]\\nCN=localhost\\n[req]\\ndistinguished_name=dn\\n[EXT]\\nsubjectAltName=DNS:localhost\\nkeyUsage=digitalSignature\\nextendedKeyUsage=serverAuth\")\n```\nThen start the HTTPS webserver as follows: \n\n`python manage.py runsslserver 127.0.0.1:8765 --certificate localhost.crt --key localhost.key`\n\nA security exception is also necessary as marked above.\n\n#### ngrok\nIf you don't want to use a self-signed cert you can route the test site through HTTPS with [ngrok](https://ngrok.com/). \n\nWith `ngrok` installed, and the `./manage.py runserver 8765` started, run\n`ngrok http http://127.0.0.1:8765` and it will create a tunnel with an HTTPS URL for your local site.\n\n### Verify demo containers with digidoc-tool\n\nIt's possible to use the command line utility `digidoc-tool` \nfrom the [libdigidocpp library](https://github.com/open-eid/libdigidocpp/)\nto verify containers with signatures created by demo services:\n```\ndigidoc-tool open --tslurl=https://open-eid.github.io/test-TL/tl-mp-test-EE.xml --tslcert=trusted-test-tsl.crt \u003cfile\u003e\n```\nInstructions on setting up the environment \n[can be found here](https://github.com/open-eid/libdigidocpp/wiki/Using-test-TSL-lists#digidoc-toolexe-utility-program).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthorgate%2Fdjango-esteid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthorgate%2Fdjango-esteid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthorgate%2Fdjango-esteid/lists"}