IPConnection.InitEncryption - Revision history

Admin: 1 revision imported

2022-03-13T10:09:28Z

1 revision imported

1>Admin at 06:22, 1 January 2022

2022-01-01T06:22:41Z

Admin: 1 revision imported

2021-02-07T06:51:25Z

1 revision imported

Admin at 10:29, 28 January 2021

2021-01-28T10:29:08Z

New page

{{infobox function
|name=InitEncryption
|object=[[Объект IP]]
|caption=Шифрование соединения
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, внешняя ошибка
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект IP]]}}
Функция инициализирует шифрование клиентской стороны на существующем IP соединении (чаще всего TCP/IP). Связь должна быть уже установлена, шифрование может быть инициализировано уже после отсылки предварительной информации. На соединение с включенной функцией шифрования, накладываются некоторые ограничения на использование функций, к примеру, не получится использовать функции [[IPConnection.Receive|Receive]] или [[IPConnection.Peek|Peek]]. Блокирующие сокеты рекомендуются для использования совместно с шифрованным соединением, так как не все типы шифрования могут поддерживать иное. Чаще всего эта функция используется для включения шифрования на клиенте при обмене, на серверной стороне необходимо использовать функцию [[IPConnection.InitServerEncryption|InitServerEncryption]].

== Синтаксис ==
<code>
{{Grey|IPConnection.}}'''InitEncryption'''(''<Тип шифрования (STRING)>'',''<Путь и имя библиотеки шифрования (STRING)>''{{Optional|,<Сертификаты и ключи (STRING)>,<Наименование метода клиента (STRING)>}})
</code>

==== Аргументы ====
* <code>''<Тип шифрования (STRING)>''</code> - Тип используемого шифрования. Последующие параметры будут зависеть от типа шифрования. На данный момент доступны следующие типы:
** '''AES''' -- для шифрования используется алгоритм AES-256, никаких дополнительных данных не отсылается для установки протокола, клиент и сервер должны иметь одинаковый ключ шифрования при инициализации шифрования. Функцию ''InitEncryption'' можно вызывать как для сервера, так и для клиента. Второй параметр функции задает расписание шифрования AES-256, и должен являться ANSI строкой с размером 240 байт созданной с помощью функции [[CreateKeySchedule]] с первым параметром, равным нулю.
** '''OpenSSL''' -- для шифрования инициализируются алгоритмы SSL/TLS, используемые при https соединениях с помощью бесплатных библиотек OpenSSL. Для серверной стороны необходимо пользоваться функцией [[IPConnection.InitServerEncryption|InitServerEncryption]] вместо текущей. Второй, третий и четвертый параметры заданы следующим образом:
*** <code>''<Путь и имя библиотеки шифрования (STRING)>''</code> - задается путь и наименование библиотеки <code>libssl*.dll</code>, по этому же пути должна находиться библиотека <code>libcrypto*.dll</code>. Для 64-битных версий клиента, должны быть использованы 64-битные версии библиотеки (см. [[ProgramArchitecture]]). Работа библиотек была протестирована на версии 1.1.1, рекомендуется использование указанной или более поздних версий.
*** <code>''<Сертификаты и ключи (STRING)>''</code> - {{Planned }} задается путь и имя личного сертификата, если он необходим при соединении. Сертификат должен иметь формат ''PEM''.
*** <code>''<Наименование метода клиента (STRING)>''</code> - Аргумент может задавать имя определенного метода соединения. По умолчанию, используется метод OpenSSL ''TLS_client_method'', однако, к примеру, можно форсировать использование ''TLSv1_1_client_method'' или ''TLSv1_client_method''.
** '''LibreSSL''' -- для шифрования инициализируются алгоритмы SSL/TLS, используемые при https соединениях с помощью бесплатных библиотек LibreSSL. Использование LibreSSL вместо OpenSSL позволяет загрузить информацию с сайтов, с которыми OpenSSL работает неверно. Для серверной стороны необходимо пользоваться функцией [[IPConnection.InitServerEncryption|InitServerEncryption]] вместо текущей. Второй, третий и четвертый параметры заданы следующим образом:
*** <code>''<Путь и имя библиотеки шифрования (STRING)>''</code> - задается путь и наименование библиотеки <code>libtls-*.dll</code>, по этому же пути должны находиться библиотеки <code>libssl-*.dll</code> и <code>libcrypto-*.dll</code>. Для 64-битных версий клиента, должны быть использованы 64-битные версии библиотеки (см. [[ProgramArchitecture]]). Работа библиотек была протестирована на версии 2.5.5, рекомендуется использование указанной или более поздних версий.
*** <code>''<Сертификаты и ключи (STRING)>''</code> - {{Planned }} задается путь и имя личного сертификата, если он необходим при соединении. Сертификат должен иметь формат ''PEM''.
*** <code>''<Наименование метода клиента (STRING)>''</code> - Аргумент не используется.

== Примеры ==
<pre>
//Пример показывает, как можно осуществить загрузку веб-страницы по ее адресу.
//Для загрузки по протоколу https требуется указание пути к библиотекам OpenSSL или LibreSSL.

Function LoadPage(URL)
bHTTPs:=pos("https://",Lowercase(URL));
If pos("//",URL)>0 Then
tearStr(URL,"//");
EndIf;
СтрДоб:=URL;
URL:=tearStr(СтрДоб,"/");
//URL может содержать название параграфа
СтрДоб:=TearStr(СтрДоб,"#");
For i:=1 to 3 Do
if bHTTPs Then
tcp:=IPConnection.Connect(URL+?(Pos(":",URL)+Pos("=",URL)=0,"=443"),1);
Else
tcp:=IPConnection.Connect(URL+?(Pos(":",URL)+Pos("=",URL)=0,"=80"));
EndIf;
if tcp.IsConnected Then
Break;
EndIf;
EndDo;
if not tcp.IsConnected Then
Message("Could not connect: "+URL,"!");
Exit;
EndIf;
СтрДоб:="/"+СтрДоб;
if bHTTPs then
//tcp.InitEncryption("LibreSSL","C:\LibreSSL255\libtls-15.dll");
tcp.InitEncryption("OpenSSL","C:\OpenSSL111e\libssl-1_1.dll");
endif;
tcp.HTTPSetOperation("GET "+СтрДоб+" HTTP/1.0");
tcp.HTTPSetHeaderField("Host",tcp.HTTPPunycodeEncode(URL));
tcp.HTTPSetHeaderField("User-Agent","Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)");
tcp.HTTPSetHeaderField("Accept","text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
tcp.HTTPSetHeaderField("Accept-Language","en");
tcp.HTTPSetHeaderField("Connection","Close");
Стр:="";
Try
If tcp.HTTPSendAndReceive Then
Стр:=tcp.HTTPBodyAsString;
If _And(Pos(_NEWLINE,Стр)=0,Pos(Chr(10),Стр)>0) Then
Стр:=Replace(Стр,Chr(10),_NEWLINE);
EndIf;
EndIf;
Except
Message("Could not load: "+URL,"!");
EndTry;
Exit Стр;
EndFunction

s:=LoadPage("https://en.wikipedia.org/wiki/Main_Page");
Message(s);
</pre>

← Older revision	Revision as of 10:09, 13 March 2022
(No difference)

@@ Line 24: / Line 24: @@
 ** '''AES''' -- для шифрования используется алгоритм AES-256, никаких дополнительных данных не отсылается для установки протокола, клиент и сервер должны иметь одинаковый ключ шифрования при инициализации шифрования. Функцию ''InitEncryption'' можно вызывать как для сервера, так и для клиента. Второй параметр функции задает расписание шифрования AES-256, и должен являться ANSI строкой с размером 240 байт созданной с помощью функции [[CreateKeySchedule]] с первым параметром, равным нулю.
 ** '''OpenSSL''' -- для шифрования инициализируются алгоритмы SSL/TLS, используемые при https соединениях с помощью бесплатных библиотек OpenSSL. Для серверной стороны необходимо пользоваться функцией [[IPConnection.InitServerEncryption|InitServerEncryption]] вместо текущей. Второй, третий и четвертый параметры заданы следующим образом:
-*** <code>''<Путь и имя библиотеки шифрования (STRING)>''</code> - задается путь и наименование библиотеки <code>libssl*.dll</code>, по этому же пути должна находиться библиотека <code>libcrypto*.dll</code>. Для 64-битных версий клиента, должны быть использованы 64-битные версии библиотеки (см. [[ProgramArchitecture]]). Работа библиотек была протестирована на версии 1.1.1, рекомендуется использование указанной или более поздних версий.
+*** <code>''<Путь и имя библиотеки шифрования (STRING)>''</code> - задается путь и наименование библиотеки <code>libssl*.dll</code>, по этому же пути должна находиться библиотека <code>libcrypto*.dll</code>. Для 64-битных версий клиента, должны быть использованы 64-битные версии библиотеки (см. [[ProgramArchitecture]]). Работа библиотек была протестирована на версии 1.1.1 и на версии 3.0, рекомендуется использование указанных или более поздних версий.
 *** <code>''<Сертификаты и ключи (STRING)>''</code> - {{Planned }} задается путь и имя личного сертификата, если он необходим при соединении. Сертификат должен иметь формат ''PEM''.
 *** <code>''<Наименование метода клиента (STRING)>''</code> - Аргумент может задавать имя определенного метода соединения. По умолчанию, используется метод OpenSSL ''TLS_client_method'', однако, к примеру, можно форсировать использование ''TLSv1_1_client_method'' или ''TLSv1_client_method''.

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)