Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eldersantoss/pycertmanager
Module to assist in the programmatic management of PFX digital certificates on Windows operating system.
https://github.com/eldersantoss/pycertmanager
certificate cryptography pfx pki powershell windows
Last synced: 15 days ago
JSON representation
Module to assist in the programmatic management of PFX digital certificates on Windows operating system.
- Host: GitHub
- URL: https://github.com/eldersantoss/pycertmanager
- Owner: eldersantoss
- License: mit
- Created: 2022-09-23T17:30:52.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2022-10-17T14:52:39.000Z (about 2 years ago)
- Last Synced: 2024-10-10T03:41:25.916Z (about 1 month ago)
- Topics: certificate, cryptography, pfx, pki, powershell, windows
- Language: Python
- Homepage: https://pypi.org/project/pycertmanager/
- Size: 43.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Python Certificate Manager
Module to assist in the programmatic management of `PFX` digital certificates on
`Windows` operating system.
Working with A1 digital certificates (e-CPF and e-CNPJ), it is extremely common
to need to install and remove them from operating system, or even obtain some
information like expiration date or issuer of these objects. So this module
was made for provide these operations programmatically and easily.
[](https://github.com/eldersantoss/pycertmanager/blob/main/LICENSE)
[](https://github.com/eldersantoss/pycertmanager/issues)
[](https://pypi.org/project/pycertmanager/)
[](https://github.com/eldersantoss/pycertmanager/commits/main)
[](https://github.com/eldersantoss/pycertmanager/actions/workflows/testing.yml)
## Table of content
* [Installing](#installing)
* [Requirements](#requirements)
* [Using](#using)
* [Examples](#examples)
* [How does it works](#how-does-it-works)
* [Support](#support)
* [Contributing](#contributing)
* [Setup your environment (Windows PowerShell)](#setup-your-environment-windows-powershell)
* [Roadmap](#roadmap)
* [License](#license)
## Installing
```powershell
pip install pycertmanager
```
### Requirements
The module currently supports only `Windows` operating system and has been tested over `Python >= 3.10`.
## Using
The main entity of the module is the `Certificate` class which provides the
methods for manipulating certificates within the operating system and
obtaining relevant information from them.
### Examples
```python
from pycertmanager import Certificate
# creating certificate object
certificate = Certificate("mycertificate.pfx", "123456")
# installing certificate on system
certificate.install()
# getting a list with certificate subject data
subject_data = certificate.get_subject_data()
# getting certificate expiration date
expiration_date = certificate.get_expiration_date()
# getting certificate expiration date
issue_date = certificate.get_issue_date()
# removing a certificate
# note that it is a class method and 'pycertmanager.test' is the
# Common Name (CN) of the certificate you want to remove
Certificate.remove("pycertmanager.test")
```
## How does it works
In short, some methods (install and remove) calls
[PowerShell cmdlets](https://learn.microsoft.com/en-us/powershell/module/pki/)
through subprocess built-in module while the remaining methods uses
[cryptography](https://github.com/pyca/cryptography) package primitives.
## Support
Found a problema? Please open an `Issue` describing it or a `Pull Request` if
you know how to fix it. Make sure to write the `tests` from your code.
## Contributing
Pull requests are welcome. For major changes, please open an issue first to
discuss what you would like to change. Reinforcing, make sure to write tests from your code.
### Setup your environment (Windows PowerShell)
```powershell
# clone this repository
git clone https://github.com/eldersantoss/pycertmanager.git
# create and activate virtual environment
cd pycertmanager
python -m venv venv
& venv/Scripts/Activate
# install dependencies
pip install -r requirements.txt
# run tests
python -m unittest
```
## Roadmap
* **Implement Linux support:** the intention is to make this module
cross-platform.
## License
This project is licensed under the terms of the [MIT License](https://github.com/eldersantoss/pycertmanager/blob/main/LICENSE).