TirsvadCLI.NugetCertificate 0.1.1

Nuget certificate helper

Overview

Nuget certificate is a .NET tool designed to simplify the creation, management, and installation of self-signed certificates for use in development environments. It provides an easy-to-use API for generating certificates and managing their lifecycle.

Table of Contents

• Overview
• Features
• Usage
• Contributing
• Bug / Issue Reporting
• License
• Contact
• Acknowledgments

Features

• Generate self-signed certificates with customizable properties.
• Export certificates to .pfx files with private keys.
• Install certificates into the local certificate store.
• Remove certificates from the store by subject name.
• Fully asynchronous API for modern .NET applications.

Usage

1. Install the Tool
   Clone the repository and build the project targeting .NET 9.
   Example:

   dotnet build
   

2. Generate a Certificate
   Use the CreateCertificateAsync method to generate and optionally install a certificate:

   var certificateInfo = new CertificateInfo( "path/to/certificates", "myCert.pfx", "MyPassword123!", "MySubject", "MyOrganization", "MyOrgUnit", "MyLocality", "MyState", "US", 1, installInStore: true);
   var nugetCertificate = new NugetCertificate(certificateInfo); await nugetCertificate.CreateCertificateAsync();
   

3. Remove a Certificate
   Use the RemoveCertificateFromStoreAsync method to remove a certificate by subject:

   await NugetCertificate.RemoveCertificateFromStoreAsync("MySubject");
   

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
   • Note: Before committing, ensure you have created appropriate tests for your changes. This helps maintain the quality and reliability of the project.
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Bug / Issue Reporting

If you encounter a bug or have an issue to report, please follow these steps:

1. Go to the Issues Page
   Navigate to the GitHub Issues page.

2. Click "New Issue"
   Click the green "New Issue" button to create a new issue.

3. Provide Details

• Title: Write a concise and descriptive title for the issue.
• Description: Include the following details:
  • Steps to reproduce the issue.
  • Expected behavior.
  • Actual behavior.
  • Environment details (e.g., OS, .NET version, etc.).
• Attachments: Add screenshots, logs, or any other relevant files if applicable.

4. Submit the Issue
   Once all details are filled in, click "Submit new issue" to report it.

Your feedback is valuable and helps improve the project!

License

Distributed under the GPL-3.0 License.

Contact

Jens Tirsvad Nielsen - LinkedIn

Acknowledgments