Skip to main content

A simple python client for the Icelandic government authentication service Íslykill (

Project description

A simple python client for the Icelandic government authentication service Íslykill (
You must apply for access before using this library.


Just remember to set the `username`, `password` and `service_id` as your own.
`service_id` is the ID you are given from the national registry of Iceland (, e.g. for the id is `` and the Íslykill authentication url is

>>> import islykill
>>> islykill.username = "Your-username-here"
>>> islykill.password = "Your-password-here"
>>> islykill.service_id = ""
>>> token = 'Some-received-token' # the token received from
>>> ip_address = '' # remote user ip address
>>> result = islykill.generate_saml_from_token(token, ip_address)
>>> print result
{'ssn': '1234567890', 'ip_address': '', 'name': u'Jon Jonsson'}

If an error occurs, the result from `generate_saml_from_token` will return a dictionary with the
key "error" with the body of the error as value, e.g.

>>> print result
{'error': 'HTTPError = 500'}

500 usually mean that you can make the request again immediately, just a glitch in the

>>> print result
{'error': 'Unable to find SAML assertion from token.'}

"Unable to find SAML assertion from token" means that the token is invalid or expired somehow,
which means the user has to authenticate again.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py-islykill-0.1.tar.gz (5.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page