Security ru RU

Безопасность

Шифрование

ASF на данный момент поддерживает следующие методы шифрования, как значения ECryptoMethod:

Value	Name
0	PlainText
1	AES
2	ProtectedDataForCurrentUser

Их полное описание и сравнение вы найдёте ниже.

Для создания зашифрованного пароля, например для использования в SteamPassword, вам нужно выполнить команду encrypt с соответствующим типом шифрования и вашим паролем в виде открытого текста. После этого, установите полученную зашифрованную строку в качестве значения для параметра SteamPassword, и, наконец, измените значение параметра PasswordFormat на соответствующее вашему методу шифрования.

---

PlainText

Это самый простой и небезопасный способ хранения пароля, который определён как ECryptoMethod равный 0. ASF ожидает что строка будет в виде открытого текста - пароль в его явном виде. Это самый простой в использовании, и 100% совместимый со всеми конфигурациями, а потому и используемый по умолчанию способ хранения секретных данных, совершенно небезопасный для хранения.

---

AES

Считающийся безопасным по современным стандартам, способ хранения пароля AES определён как ECryptoMethod равный 1. ASF ожидает что строка будет base64-кодированнаой последовательностью символов, которая после декодирования даст AES-зашифрованный массив байт, который можно будет расшифровать используя вектор инициализации и ключ шифрования ASF.

Описанный выше метод гарантирует безопасность при условии что атакующему неизвестен встроенный ключ AES-шифрования, используемый для для шифрования и расшифровки паролей. ASF позволяет вам задать ключ с помощью аргумента командной строки --cryptkey, который вам следует использовать для максимальной безопасности. Если вы решите опустить его, ASF будет использовать свой собственный ключ, который известен и жёстко запрограммирован в приложении, и кто угодно может расшифровать пароль зашифрованный ASF. Это всё равно требует некоторых усилий и не так просто сделать, однако это возможно, и поэтому вам всегда следует использовать шифрование AES со своим собственным --cryptkey, который вы храните в секрете. Метод шифрования AES, используемый в ASF, предоставляет безопасность, которая должна удовлетворить желание сбалансировать простоту PlainText и сложность ProtectedDataForCurrentUser, однако настоятельно рекомендуется использовать его с пользовательским --cryptkey. При правильном использовании гарантирует приемлемую безопасность хранения.

---

ProtectedDataForCurrentUser

На данный момент самый безопасный метод хранения пароля, представленный в ASF, и гораздо более безопасный чем AES, описанный выше, определён как ECryptoMethod равный 2. Главное достоинство этого метода это одновременно и главный его недостаток - вместо использования ключа шифрования (как в методе AES) данные шифруются с помощью учетных данных пользователя, вошедшего в систему, а это значит что расшифровка данных возможна только на той же машине где они зашифрованы, и в добавок к этому только тем пользователем, который выполнил шифрование. Это гарантирует, что даже если вы отправите весь файл Bot.json с зашифрованным этим методом SteamPassword кому-то ещё - он не сможет расшифровать пароль без доступа к вашему ПК. Это прекрасная мера безопасности, но одновременно имеет серьёзный недостаток, заключающийся в наименьшей совместимости, поскольку зашифрованный этим методом пароль будет несовместим с любым другим пользователем или машиной, включая вашу собственную, если вы решите, например, переустановить операционную систему. Однако это всё же самый лучший метод хранения паролей, и если вы беспокоитесь о безопасности PlainText, и не хотите вводить пароль каждый раз, то это наилучший вариант для вас, конечно, если вам не нужно иметь доступ к конфигурационным файлам с любой машины кроме собственной.

Пожалуйста, обратите внимание, на данный момент эта опция доступна только на машинах под управлением ОС Windows.

---

Рекомендации

Если вам не важна совместимость, и вас устраивает как работает метод ProtectedDataForCurrentUser, то это рекомендуемый вариант хранения пароля в ASF, поскольку он обеспечивает наилучшую безопасность. Метод AES это хороший выбор для людей, которые хотят использовать свои конфигурационные файлы на любой машине, а PlainText это самый простой метод хранения пароля, если вы не против что любой может посмотреть его в файле JSON.

Не забывайте, что все эти 3 метода считаются небезопасными если у атакующего есть доступ к вашему ПК. ASF должен иметь возможность расшифровать зашифрованные пароли, а если одна программа работающая на машине может это сделать, то любая программа работающая на той же машине тоже способна это сделать. ProtectedDataForCurrentUser это самый безопасный вариант, поскольку даже другой пользователь на том же ПК не сможет его расшифровать, но даже его можно расшифровать если кто-то украдёт ваши учётные данные и информацию о машине в добавок к конфигурационным файлам ASF.

В дополнение к методам шифрования, описанным выше, также возможно избежать указания пароля вообще, например использовав пустую строку или значение null в SteamPassword. ASF при необходимости запросит ваш пароль, и не будет его нигде сохранять, только хранить в памяти запущенного процесса, пока вы его не закроете. Хотя это самый безопасный метод работы с паролями (они нигде не сохраняются), но и самый неудобный, поскольку вам нужно вручную вводить пароль при каждом запуске ASF (когда он требуется). Если для вас это не проблема, это самый лучший вариант с точки зрения безопасности.

---

Расшифровка

ASF не содержит никаких средств для расшифровки уже зашифрованных паролей, поскольку методы расшифровки используются только для внутреннего доступа к данным внутри процесса. Если вы хотите отменить процедуру шифрования, например для переноса ASF на другую машину при использовании ProtectedDataForCurrentUser, просто повторите процедуру с самого начала в новом окружении.

---

Хэширование

ASF на данный момент поддерживает следующие методы хеширования, как значения ECryptoMethod:

Value	Name
0	PlainText
1	SCrypt
2	Pbkdf2

The exact description and comparison of them is available below.

Для генерации хеша, например для использования в качестве IPCPassword, вам нужно выполнить команду hash с соответствующим типом хеширования и вашим паролем в виде открытого текста. После этого, установите полученный хеш строки в качестве значения для параметра IPCPassword, и, наконец, измените значение параметра IPCPasswordFormat на соответствующее выбранному вами методу хеширования.

---

PlainText

Это самый простой и небезопасный способ хеширования пароля, который определён как EHashingMethod равный 0. ASF генерирует хеш, который совпадает с исходной строкой. It's the easiest one to use, and 100% compatible with all the setups, therefore it's a default way of storing secrets, totally insecure for safe storage.

---

SCrypt

Считающийся безопасным по современным стандартам, способ хеширования пароля SCrypt определён как EHashingMethod равный 1. Для генерации массива байт ASF будет использовать реализацию SCrypt с использованием 8 блоков, 8192 итерациями, длиной хеша 32 и ключом шифрования в качестве соли. Полученные байты будут затем закодированы в строку в формате base64.

ASF позволяет вам задать соль для этого метода с помощью аргумента командной строки --cryptkey, который вам следует использовать для максимальной безопасности. Если вы решите опустить его, ASF будет использовать свой собственный ключ, который известен и жёстко запрограммирован в приложении, а значит хеширование будет менее безопасным. If used properly, guarantees decent security for safe storage.

---

Pbkdf2

Считающийся слабым по современным стандартам, способ хеширования пароля Pbkdf2 определён как EHashingMethod равный 2. Для генерации массива байт ASF будет использовать реализацию Pbkdf2 с использованием 10000 итераций, длиной хеша 32 и ключом шифрования в качестве соли, с SHA-256 в качестве алгоритма hmac. The resulting bytes will then be encoded as base64 string.

ASF allows you to specify salt for this method via --cryptkey command-line argument, which you should use for maximum security. Если вы решите опустить его, ASF будет использовать свой собственный ключ, который известен и жёстко запрограммирован в приложении, а значит хеширование будет менее безопасным.

---

Recommendation

Если вы хотите использовать хеширование для хранения каких-то секретов, таких как IPCPassword, мы рекомендуем использовать SCrypt с пользовательской солью, поскольку это обеспечит приемлемую безопасность от попыток перебора. Pbkdf2 доступен только из соображений совместимости, в основном потому, что у нас уже есть работоспособная (и необходимая) реализация этого метода для других целей применительно к платформе Steam (например, для ПИНа родительского контроля). Это тоже считается безопасным, но слабым по сравнению с альтернативами (например SCrypt).