# Let's Encrypt

**Let's Encrypt** — это бесплатный автоматизированный центр сертификации (CA), который выпускает доверенные SSL/TLS-сертификаты для защиты веб-сайтов и сервисов по протоколу HTTPS.

**Когда будет полезен такой сертификат в MikoPBX?**

* Если ваша АТС доступна из интернета и вы хотите защитить веб-интерфейс администратора.
* Для безопасного подключения WebRTC-клиентов (звонки через браузер требуют HTTPS).
* Чтобы избавиться от предупреждений браузера о «небезопасном соединении».
* Если используете мобильные приложения или SIP-клиенты, которым требуется валидный сертификат.

**Системные требования:**

1. Для АТС должен быть выделен домен, к примеру **sip.test.ru**
2. Web-интерфейс АТС по протоколу `HTTP` должен быть доступен из интернета на порту **`80` (для способа проверки - HTTP01)**
3. В общих настройках (раздел "**HTTP/HTTPS**") отключите использование опции «**`Редирект на HTTPS`**», Сервер Lets encrypt для проверки ресурса обращается по **`http`** к вашей АТС. **(для способа проверки - HTTP01)**

### Установка модуля

1. Перейдите в раздел "**Модули**" -> "**Маркетплейс модулей**".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F7j2dgebHU5a3jBSymBXk%2FMikoPBX_ModuleMarketplace.png?alt=media&#x26;token=c657b091-9d6e-4c92-b60d-fed1305e19f4" alt=""><figcaption><p>Раздел "Модули" -> "Маркетплейс модулей"</p></figcaption></figure>

2. Далее перейдите в раздел "**Маркетплейс**". Установите модуль "**Генератор SSL сертификатов через Let\`s Encrypt**".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fj95NtQcb8X6m4uZSgdUp%2FLet&#x27;s_EncryptDownload.png?alt=media&#x26;token=0a6b0c12-a8f5-4674-b217-ba747bebbf71" alt=""><figcaption><p>Установка модуля</p></figcaption></figure>

### Получение сертификата

1. Вернитесь в раздел "**Установленные модули**". Далее, включите установленный модуль и перейдите в его параметры.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FWEp1IZezRvTCnJ6OjZwU%2FInstalledModules-AutoSSL.png?alt=media&#x26;token=b4721b0f-8769-424d-a697-efcdc5bf2d25" alt=""><figcaption><p>Включение и переход в настройки установленного модуля</p></figcaption></figure>

2. Заполните общую информацию:

* Имя домена - укажите доменное имя Вашей станции.&#x20;
* Выберите способ проверки, доступно две опции: "HTTP-01 (Port 80)" и "DNS-01".

{% hint style="info" %}

* **HTTP-01**: сервер должен быть доступен из интернета на порту 80. Порт будет открыт временно на время проверки.
* **DNS-01**: сертификат выпускается через API вашего DNS-провайдера. Порт 80 не нужен. Поддерживаются wildcard-сертификаты (\*.domain.com).
  {% endhint %}

- Выберите опцию "**Обновлять сертификат автоматически**".

Если вы выбрали способ проверки **DNS-01**, заполните дополнительные поля:

* **DNS-провайдер** — выберите из списка вашего провайдера, у которого делегирован домен (например, Cloudflare, Route53, NameCheap и др.)
* **API-токен** — вставьте токен для доступа к API, полученный в личном кабинете вашего DNS-провайдера. Токен должен иметь права на создание и удаление TXT-записей в зоне домена.
* **Account ID** — идентификатор вашего аккаунта у DNS-провайдера. Обычно находится в настройках профиля или в разделе «Обзор» личного кабинета.
* **Zone ID** — идентификатор DNS-зоны вашего домена. Как правило, отображается на главной странице домена в личном кабинете провайдера.

Нажмите "**Получить/обновить SSL сертификат**".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FQJoZxx0rcCHtNj6WaJQX%2FAutoSSLParameters1.png?alt=media&#x26;token=9d2c3bcb-c535-483e-9c63-c4aa78feacdb" alt=""><figcaption><p>Параметры модуля (генерация сертификата)</p></figcaption></figure>

Вы увидите результат запроса сертификата в появившемся черном окне.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FL2ElLg2azTts2qgbQXTp%2FSuccessfulLetsEncrypt.png?alt=media&#x26;token=0a1c1ae2-1d49-45ed-9a02-d804e26b7155" alt=""><figcaption><p>Успешное получение сертификата</p></figcaption></figure>

В разделе "**Система**" -> "**Общие настройки**", во вкладке "**HTTP/HTTPS**" Вы можете найти информацию о выпущенном сертификате.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fz3ZFSSt4aKGmkHybl3cA%2FissuedCertificateLet&#x27;sEncrypt.png?alt=media&#x26;token=9904c7c4-f4ca-4b6e-8a96-21c1d7118c6a" alt=""><figcaption><p>Выпущенный сертификат. Вкладка "HTTP/HTTPS" в системных настройках.</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/modules/miko/module-get-ssl-lets-encrypt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.