/ACME-Server-ADCS

ACME (RFC 8555) Server compatible implementation, connecting to Active Directory Certificate Services (ADCS)

Primary LanguageC#OtherNOASSERTION

ACME-ADCS-Server

This project enables you to use an ACME (RFC 8555) compliant client, to request certificates via Microsoft® Windows® Server Active Directory Certificate Services.
The ACME (RFC 8555) protocol is famously used by Let's Encrypt® and thus there's a number of clients that can be used to obtain certificates.
If you are into PowerShell, you can e.g. use my open source module ACME-PS.

Please be advised that this project is NOT free for commercial-use, but you may test it in any company and use it for your personal projects as you see fit. Buying the license does not include maintenance, nevertheless I'll do my very best to answer issues here on GitHub as fast as possible. If you need help installing the software or getting it up and running in your environment or you want a maintenance contract, feel free to contact me via e-Mail and we'll figure something out.

The software is provided "as is", without warranty of any kind.

Install instructions

This small manual will show how to install ACME-ADCS as a website in IIS. I assume your machine is domain joined.

Prepare IIS

  • Install IIS (small list of helpers included, which make tracing easier).
# Install required IIS Features
IIS PS> Install-WindowsFeature Web-Server,Web-Http-Logging,Web-Request-Monitor,Web-Http-Tracing,Web-Filtering,Web-IP-Security,Web-Mgmt-Console;

  • Install the required LTS Version of .NET (8.0 LTS). You'll need the hosting bundle from the .NET Runtime section.

  • Download the latest release of ACME-ADCS

  • Extract the contents of the Release ZIP-file into C:\inetpub\wwwroot\.

  • Modify the IIS-AppPool, to not use .NET Framework (new .NET is loaded via another mechanism) and set it's identity to either a group managed service account (recommended), custom account or "NetworkService".

  • Allow the account to "Logon as a batch job". Read more about Appliction Pool Identites and Managed Service Accounts

Configure ACME-ADCS

  • Create a path for working files of ACME-ADCS, e.g C:\ACME-ADCS (this is the default path)

  • Grant read/write rights to the account used above

  • Copy C:\inetpub\wwwroot\appsettings-custom.dist.json to C:\inetpub\wwwroot\appsettings-custom.json

  • Open C:\inetpub\wwwroot\appsettings-custom.json in the editor of your choice.

  • Use certutil to get neccessary information about your CA (or ask your CA-Admin):

CMD> certutil -dump

  • Look for "Configuration" and set this as CAServer in the opened configuration file. Watch for '', which need to be escaped. Refer to 'appsettings-sample.json' to see how it might look like.

  • Use certutil -ADTemplate, certutil -CATemplates or certutil -Template to find the name of the template to be used (or ask your CA-Admin)

  • Set the TemplateName in the opened configuration file

  • If you did not use C:\ACME-ADCS as your directory for working files, set it in the opened configuration file to the proper path.

Finish

  • Call / on your server in a browser and you should see the service-description file as required from ACME.
  • Issue your first certificate with certbot or any other ACME compatible tool.

Troubleshoot

  • The server will default to write warnings and errors to the windows event log. Use this as starting point for troubleshooting.