-
Notifications
You must be signed in to change notification settings - Fork 184
STAGED PAGE README
An ACME library and client for the .NET platform.
PS3 | PS4 | PS5 |
---|---|---|
For documentation and getting started, go to the wiki which includes the FAQ.
For announcements and discussions please see go to the Community Forums.
Please note, this project was formerly named letsencrypt-win
.
Jump To:
This project implements an ACME client library and PowerShell modules interoperable with the Let's Encrypt ACME CA server reference implemention and includes features comparable to the Let's Encrypt client reference implementation.
The PowerShell modules include installers for configuring:
- IIS 7.0+ either locally or remotely (over PSSession)
- AWS Server Certificates and ELB Listeners
This ACME client implementation is broken up into layers that build upon each other:
- Basic tools and service required for implementing ACME protocol (JSON Web Signature (JWS), persistence, PKI operations via OpenSSL)
- A low-level ACME protocol client that can inter-operate with a proper ACME server
- A PowerShell Module that implements a "local vault" for managing ACME Registrations, Identifiers and Certificates (PS Binary Module)
- A set of PowerShell Modules that implement installers for various servers/services (PS Script Modules)
- Windows Certificate Store
- Internet Information Server (IIS) Installer
- AWS Installers:
- IAM Server Certificate
- ELB HTTPS Listener
The client library and PowerShell module can be used to successfully interact with the Let's Encrypt CA:
- Registration - new accounts
- Authorization - verify DNS name ownership
- Certificates - request and retrieve signed certificates
- Installation - install certificates
You can find an example of how to get started quickly here.
Please note, all documentation is still work-in-progress.
Check out these other related projects:
- An alternative simple ACME client for Windows which features:
- simple usage for common scenarios
- IIS support
- automatic renewals
- A GUI interface to this project's PowerShell module
- The official python ACME client of the [Let's Encrypt] project
- The ACME specification which brings this all together (under development)
- See other contributions
Docs
- Overview
- FAQ
- Let's Encrypt Reference Sheet
- Quick Start
- Requirements
- Basic Concepts
- Vaults, Vault Providers and Vault Profiles
- Challenge Types, Challenge Handlers and Providers
- Troubleshooting
- Contributions
Legacy Docs - out of date
Reference
- Good to Know
- Proposed Extension Mechanism
- PowerShell Module Design
- Style Guides and Conventions
- Documentation Resources
A bit dated