spsdk-pkcs11


Namespsdk-pkcs11 JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
SummarySignature Provider plugin for SPSDK using PKCS#11 interface
upload_time2024-11-15 11:42:46
maintainerNone
docs_urlNone
authorNXP
requires_python>=3.9
licenseBSD-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"
}
        
NXP
Elapsed time: 0.48911s