Merge pull request #701 from goodhousekeeper/russian/developer_information

Russian Documentation / Client Developer Information

Author: Tom

content/ru/docs/account-id.md

@@ -1,4 +1,28 @@
 ---
+title: Как определить идентификатор вашего аккаунта
 slug: account-id
-untranslated: 1
+top_graphic: 1
+date: 2016-08-10
+lastmod: 2019-07-30
 ---
+
+{{< lastmod >}}
+
+При описании возникающих проблем, как правило, требуется указать идентификатор вашего аккаунта в Let's Encrypt.
+Весь процесс создания аккаунта автоматизирован, взаимодействие с серверами Let's Encrypt ведёт ваш ACME-клиент.
+Также, у вас может быть несколько аккаунтов для Let's Encrypt.
+
+Идентификатор вашего аккаунта - это URL вида `https://acme-v02.api.letsencrypt.org/acme/acct/12345678` или 
+`https://acme-v01.api.letsencrypt.org/acme/reg/12345678`.
+
+Если вы используете Certbot, идентификатор вашего аккаунта находится в поле "uri" внутри файла
+`/etc/letsencrypt/accounts/acme-v01.api.letsencrypt.org/directory/*/regr.json`.
+
+Если вы используете альтернативный ACME-клиент, конкретные рекомендации по определению идентификатора
+аккаунта зависят от программной реализации клиентского ПО. Прежде всего, поищите в логах строки, похожие
+на URL из предыдущего абзаца. Если ваш ACME-клиент не записывает в логи идентификатор аккаунта, вы можете
+получить его, отправив повторный запрос на регистрацию имеющегося доменного имени. Для более подробной информации
+обратитесь к [спецификации протокола ACME](https://github.com/ietf-wg-acme/acme/blob/master/draft-ietf-acme-acme.md#registration).
+
+Кроме того, идентификатор вашего аккаунта (в числовой форме) находится в заголовке ответа от [Boulder](https://github.com/letsencrypt/boulder) 
+на каждый POST-запрос вашего ACME-клиента.

content/ru/docs/acme-protocol-updates.md

@@ -1,4 +1,37 @@
 ---
+title: Обновления протокола ACME
 slug: acme-protocol-updates
-untranslated: 1
+top_graphic: 1
+lastmod: 2019-10-07
 ---
+
+{{< lastmod >}}
+
+[Стандартизованный IETF](https://letsencrypt.org/2019/03/11/acme-protocol-ietf-standard.html) протокол ACME, [RFC 8555](https://datatracker.ietf.org/doc/rfc8555/) - это краеугольный камень в концепции работы Let's Encrypt.
+
+# Версии API
+
+В настоящее время мы поддерживаем следущие версии API. Пожалуйста, ознакомьтесь с [отступлениями от протокола ACME](https://github.com/letsencrypt/boulder/blob/master/docs/acme-divergences.md) для сравнения реализаций.
+
+## ACME v2 (RFC 8555)
+
+* [Production] `https://acme-v02.api.letsencrypt.org/directory`
+* [Staging] `https://acme-staging-v02.api.letsencrypt.org/directory`
+
+## ACME v1 (не рекомендовано к использованию)
+
+* [Production] `https://acme-v01.api.letsencrypt.org/directory`
+* [Staging] `https://acme-staging.api.letsencrypt.org/directory`
+
+# Новые возможности протокола ACME, с обратной совместимостью
+
+Время от времени, Let's Encrypt принимает решение о внедрении ранее нереализованных возможностей протокола ACME.
+Как правило, такие изменения в API обладают обратной совместимостью, тщательно описаны в публичной документации,
+и не вызывают сбоев в корректно реализованных ACME-клиентах.
+
+# Новые версии протокола ACME, без обратной совместимости
+
+Мы не планируем нарушать обратную совместимость при поддержке протокола ACME. Тем не менее, если это всё же потребуется,
+мы постараемся обеспечить плавный переход за разумное время, предупредив всех наших пользователей заранее.
+Системные администраторы должны иметь возможность своевременно обновить клиентское ПО в случае, когда обратная совместимость
+версий будет нарушена.