Let's Encrypt

Клієнтські реалізації ACME

Примітка: Англійська версія була оновлена з моменту перекладу () Переглянути англійською

Останнє оновлення: | Переглянути всю документацію

Let’s Encrypt використовує протокол ACME для підтвердження того, що ви контролюєте дане доменне ім’я, а також для видачі вам сертифіката. Щоб отримати сертифікат Let’s Encrypt, вам необхідно обрати для використання частину клієнтського програмного забезпечення ACME.

Наведені нижче клієнти ACME пропонуються третіми сторонами. Let’s Encrypt не контролює та не перевіряє сторонніх клієнтів і не може дати ніяких гарантій щодо їх безпеки або надійності.

Існують деякі браузерні клієнти ACME, але ми не наводимо їх тут, оскільки вони заохочують ручний процес оновлення, що призводить до поганого досвіду користувача та збільшує ризик виникнення пропущених оновлень.

Рекомендуємо: Certbot

Ми рекомендуємо більшості людей починати з клієнта Certbot. Це може просто принести вам сертифікат або допомогти в установці, в залежності від того, чому ви віддаєте перевагу. Він простий у використанні, працює на багатьох операційних системах та має відмінну документацію.

Якщо Certbot не задовольняє ваші потреби, або ви просто хочете спробувати щось інше, нижче представлено безліч інших клієнтів на вибір, згрупованих за мовою або середовищі, в якому вони працюють.

Інші клієнтські варіанти

Всі наступні клієнти підтримують API ACMEv2 (RFC 8555). Найближчим часом ми повністю відмовимося від підтримки ACMEv1. Якщо ви вже використовуєте один з перерахованих нижче клієнтів, обов’язково оновіть його до останньої версії. Якщо клієнт, який ви використовуєте, відсутній в списку нижче, можливо, він не підтримує ACMEv2, в цьому випадку ми рекомендуємо зв’язатися з супутнім проєктом або перейти на інший клієнт.

Bash

  • GetSSL (bash, also automates certs on remote hosts via ssh)
  • acme.sh (Compatible to bash, dash and sh)
  • dehydrated (Compatible to bash and zsh)
  • ght-acme.sh (batch update of http-01 and dns-01 challenges is available)
  • bacme (simple yet complete scripting of certificate generation)
  • wdfcert.sh (Only supports DNS-01 challenges and ECDSA-384 bit keys for both accounts and certificates, native Joker DNS support including wildcard plus root domain support for single-TXT-record DNS providers)

C

C++

Clojure

Configuration management tools

D

Domino

  • CertMatica (ACME certificate installation and renewals for HCL Domino™ servers)
  • HCL Domino (Full ACME V2 flow integration for HCL Domino™ servers)

Docker

Go

HAProxy

Java

Kubernetes

Lua

Microsoft Azure

nginx

Node.js

OpenShift

Perl

  • acme (Simple json config, autogen keys, issue cert, refresh cert, apache/nginx integration)
  • Crypt::LE

PHP

Python

  • ACME Tiny
  • simp_le
  • acmebot
  • sewer
  • acme-dns-tiny (Python 3)
  • Automatoes ACME V2 ManuaLE replacement with new features
  • acertmgr
  • acme-cert-tool
  • serverPKI PKI for internet server infrastructure, supporting distribution of certs, FreeBSD jails, DNS DANE support
  • acmetk acmetk is an ACMEv2 proxy to centralize certificate requests and challenges within an organisation and direct them using a single account to Let’s Encrypt or other ACMEv2 capable CA’s.

Ruby

Rust

Windows / IIS

Server

  • Certera (Crossplatform PKI to centrally manage keys and certificates)

Libraries

4D

C++

D

Delphi

Go

Java

.NET

Node.js

Perl

  • acme (Simple json config, autogen keys, issue cert, refresh cert, apache/nginx integration)
  • Crypt::LE
  • Net::ACME2
  • wdfcert.sh (Only supports DNS-01 challenges and ECDSA-384 bit keys for both accounts and certificates, native Joker DNS support including wildcard plus root domain support for single-TXT-record DNS providers)

PHP

Python

  • Модуль Python acme є частиною Certbot, але також використовується низкою інших клієнтів та доступний як окремий пакет через PyPI, Debian, Ubuntu, Fedora, а також інші дистрибутиви.
  • txacme (Twisted client for Python 2 / 3)

Ruby

Rust

  • instant-acme is an async, pure-Rust ACME (RFC 8555) client which relies on Tokio
  • rustls-acme provides TLS certificate management and serving using rustls
  • tokio-rustls-acme is an easy-to-use, async ACME client library for rustls

Проєкти, що інтегруються з Let's Encrypt

Додавання клієнта/проєкту

Якщо вам відомий клієнт ACME або проєкт, інтегрований з API ACMEv2 компанії Let’s Encrypt, який відсутній на вищевказаної сторінці, будь ласка, надішліть запит на включення змін в наш website repository на GitHub, оновивши файл data/clients.json.

Перед відправкою запиту на виправлення, будь ласка, переконайтеся, що:

  1. Клієнт дотримується політики торгової марки Let’s Encrypt.
  2. Клієнт не є браузерним та підтримує автоматичне оновлення.
  3. Ваш коміт додає вашого клієнта в кінець відповідні розділи (Не забудьте про “acme_v2”, якщо це доречно!).
  4. Ваш коміт оновлює мітку дати lastmod у верхній частині clients.json.