Name | spsdk-pkcs11 JSON |
Version |
0.1.1
JSON |
| download |
home_page | None |
Summary | Signature Provider plugin for SPSDK using PKCS#11 interface |
upload_time | 2024-11-15 11:42:46 |
maintainer | None |
docs_url | None |
author | NXP |
requires_python | >=3.9 |
license | BSD-3-Clause |
keywords |
nxp
spsdk
pkcs11
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
PKCS#11 Signature Provider
==========================
Signature Provider plugin for SPSDK using PKCS#11 interface
Features
--------
* Using a PKCS#11 library to sign data using HSM
* Supported signing schemes: RSA, RSA-PSS, ECDSA
Installation
------------
* Activate virtual env, where you have SPSDK
- if SPSDK is not installed, the latest one will be installed automatically from [PyPI](https://pypi.org/project/spsdk/)
* `pip install spsdk-pkcs11`
Usage
-----
* To use this Signature Provider, you have to update your signature provider configuration string(s) in YAML file(s)
* Configuration string Parameters:
- `type`: set to `pkcs11`
- `so_path`: Path to (or name of) your PKCS#11 library (usually delivered by HSM vendor)
- Plugin is looking for the library in current directory, and paths defined in PATH environment variable
- Path can be set also in an environment variable (e.g.: $MY_PKCS_LIB)
- `user_pin`: Pin to your HSM
- Pin can be placed directly in the config string (not recommended!)
- You may place your pin into environment variable (e.g: $MY_PKCS_PIN)
- You may place your pin into a file, then simply provide the path
- `token_label` and/or `token_serial`: Label or serial to identify the Token in your HSM containing your key
- `key_label` and/or `key_id`: Label or ID to identify the key you want to use
* Configuration string example:
- `type=pkcs11;so_path:c:/SoftHSM2/lib/softhsm2-x64.dll;user_pin=~/test_pin.txt;token_label=My token 1;key_label=rsa_2048`
Limitations
-----------
Currently the plugin doesn't wok on Windows when using Python 3.12 (https://github.com/pyauth/python-pkcs11/issues/165)
Credits
-------
This package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [SPSDK Signature Provider project template](https://github.com/nxp-mcuxpresso/spsdk/blob/master/examples/plugins/templates/cookiecutter-spsdk-sp-plugin.zip).
Raw data
{
"_id": null,
"home_page": null,
"name": "spsdk-pkcs11",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Michal Starecek <michal.starecek@nxp.com>",
"keywords": "NXP, SPSDK, pkcs11",
"author": "NXP",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/cc/0b/f0a7a3ce1e1e537caf7a9275c6c5753e5743a25e7e95105b41cfdf8faa5c/spsdk_pkcs11-0.1.1.tar.gz",
"platform": null,
"description": "\r\nPKCS#11 Signature Provider\r\n==========================\r\n\r\nSignature Provider plugin for SPSDK using PKCS#11 interface\r\n\r\n\r\nFeatures\r\n--------\r\n\r\n* Using a PKCS#11 library to sign data using HSM\r\n* Supported signing schemes: RSA, RSA-PSS, ECDSA\r\n\r\nInstallation\r\n------------\r\n\r\n* Activate virtual env, where you have SPSDK\r\n - if SPSDK is not installed, the latest one will be installed automatically from [PyPI](https://pypi.org/project/spsdk/)\r\n* `pip install spsdk-pkcs11`\r\n\r\n\r\nUsage\r\n-----\r\n\r\n* To use this Signature Provider, you have to update your signature provider configuration string(s) in YAML file(s)\r\n* Configuration string Parameters:\r\n - `type`: set to `pkcs11`\r\n - `so_path`: Path to (or name of) your PKCS#11 library (usually delivered by HSM vendor)\r\n - Plugin is looking for the library in current directory, and paths defined in PATH environment variable\r\n - Path can be set also in an environment variable (e.g.: $MY_PKCS_LIB)\r\n - `user_pin`: Pin to your HSM\r\n - Pin can be placed directly in the config string (not recommended!)\r\n - You may place your pin into environment variable (e.g: $MY_PKCS_PIN)\r\n - You may place your pin into a file, then simply provide the path\r\n - `token_label` and/or `token_serial`: Label or serial to identify the Token in your HSM containing your key\r\n - `key_label` and/or `key_id`: Label or ID to identify the key you want to use\r\n\r\n* Configuration string example:\r\n - `type=pkcs11;so_path:c:/SoftHSM2/lib/softhsm2-x64.dll;user_pin=~/test_pin.txt;token_label=My token 1;key_label=rsa_2048`\r\n\r\nLimitations\r\n-----------\r\n\r\nCurrently the plugin doesn't wok on Windows when using Python 3.12 (https://github.com/pyauth/python-pkcs11/issues/165)\r\n\r\n\r\nCredits\r\n-------\r\n\r\nThis package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [SPSDK Signature Provider project template](https://github.com/nxp-mcuxpresso/spsdk/blob/master/examples/plugins/templates/cookiecutter-spsdk-sp-plugin.zip).\r\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Signature Provider plugin for SPSDK using PKCS#11 interface",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/nxp-mcuxpresso/spsdk_plugins/tree/master/pkcs11",
"Issues": "https://github.com/nxp-mcuxpresso/spsdk_plugins/issues"
},
"split_keywords": [
"nxp",
" spsdk",
" pkcs11"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b7b1c5372dabfb966b012c0022e4bcacc1a5e3f8622d2dfc0e202e8c6db60935",
"md5": "ab5a11eb38d846738c2b978bac06df76",
"sha256": "567393d2b0e958ba297c75e49c03204084904a9bc3ee2156d8e92976c91a300a"
},
"downloads": -1,
"filename": "spsdk_pkcs11-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ab5a11eb38d846738c2b978bac06df76",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6556,
"upload_time": "2024-11-15T11:42:44",
"upload_time_iso_8601": "2024-11-15T11:42:44.607333Z",
"url": "https://files.pythonhosted.org/packages/b7/b1/c5372dabfb966b012c0022e4bcacc1a5e3f8622d2dfc0e202e8c6db60935/spsdk_pkcs11-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cc0bf0a7a3ce1e1e537caf7a9275c6c5753e5743a25e7e95105b41cfdf8faa5c",
"md5": "cb267b2cab5f09986c948fbf9cea4f55",
"sha256": "9af27c00076bb489b20cb90abe3476d8090c0a12ecb1554ad7c4fc0ab29b0e9c"
},
"downloads": -1,
"filename": "spsdk_pkcs11-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "cb267b2cab5f09986c948fbf9cea4f55",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 7442,
"upload_time": "2024-11-15T11:42:46",
"upload_time_iso_8601": "2024-11-15T11:42:46.021674Z",
"url": "https://files.pythonhosted.org/packages/cc/0b/f0a7a3ce1e1e537caf7a9275c6c5753e5743a25e7e95105b41cfdf8faa5c/spsdk_pkcs11-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-15 11:42:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nxp-mcuxpresso",
"github_project": "spsdk_plugins",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "spsdk-pkcs11"
}