Admin: 1 revision imported

2021-03-04T14:58:39Z

1 revision imported

Admin at 16:28, 25 February 2021

2021-02-25T16:28:10Z

Admin: 1 revision imported

2021-02-07T06:55:29Z

1 revision imported

Admin at 06:03, 30 January 2021

2021-01-30T06:03:30Z

New page

{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Онлайн демонстрации]]}}
Данная онлайн демонстрация возможностей функции контролируемой среды исполнения [[ExecEx]] использует консольный http сервер и позволяет исполнять произвольный код программы непосредственно из текущей веб-страницы. Консольный сервер не использует подключение к базе данных, поэтому код обращения к базе данных не сможет работать (для демонстрации работы с базой данных, скачайте [[Демо-версия|демонстрационную версию клиента программы]]). Если сервер (работающий на машине с Apache http сервером) в данный момент недоступен, демонстрация не сможет функционировать правильно и будет выдавать сообщение об ошибке. Для уменьшения количества векторов атаки на консольный сервер, функция [[ExecEx]] вызывается со следующими ограничениями (см. описание функции):
* '''второй аргумент''' при вызове имеет значение: <code>0b1111111111111111111</code> (запрещены все опасные и визуальные функции, однако, работа с картинками разрешена).
* исполнение имеет '''ограничение по времени''', фрагмент не может исполняться дольше 5 секунд.

Ограничений по количеству запросов к демонстрации нет, однако, встроенная защита от DOS выведет Captcha и запросит ее решение после нескольких запросов, если Captcha решена неверно несколько раз подряд, будет включена защита, которая не позволит выполнять запросы с текущего IP-адреса в течение двух часов. Описание Captcha и дополнительную информацию по тестовому http серверу ищите в статье [[Онлайн демонстрации]]. Для данного примера использован объект ''XMLHttpRequest'', работающий по технологии ''AJAX''. Во время исполнения кода браузер ожидает получения информации от консольного сервера, по мере поступления, она будет выводиться в лог в нижней части страницы. Следующие функции и события выводят информацию в лог страницы:
* [[Message]] и [[Writeln]] -- стандартные функции для вывода информации в лог.
* Переменная ''Result'' позволяет возвратить текстовое значение, которое будет выведено на странице последним, выделено размером шрифта, и отделено от остального вывода полосой.
** Особое значение переменной ''Result'' может быть с типом ''картинка'', в этом случае, это значение будет перекодировано в строку, а затем в ''base64'' и отослано с меткой о том, что это картинка-результат. Картинка будет выведена на странице после полосы, отделяющей результат от обычного текста. Таким образом демонстрируется возможность передачи в одном пакете данных разного типа (см. ниже примеры).
* При ошибках компиляции и необработанных исключениях, информация также будет выведена в лог.
* При превышении времени исполнения, программа прерывается и информация об ошибке будет выведена в лог.

Путь прохождения запроса и ответа на запрос выглядит следующим образом:
# Java-скрипт в браузере создает URL запроса в виде <code>{{SERVERNAME}}/sfsl/?ExecuteReq=1</code> и отправляет его на сервер с помощью объекта ''XMLHttpRequest'', в теле запроса выгружается программный код, размещенный на этой странице.
# Apache http сервер получает POST запрос и передает его на адрес локального консольного SFSL сервера (прокси-запрос)
# Локальный консольный клиент создает событие типа ''OnTCPConnection'' и передает программе TCP объект соединения с Apache http сервером
# Программа создает новый поток, и запускает обработку, которая будет заниматься обслуживанием соединения
## Обработка получает http заголовок с помощью [[IPConnection.HTTPReceiveHeader|HTTPReceiveHeader]] и находит POST запрос с помощью [[IPConnection.HTTPGetOperation|HTTPGetOperation]], после чего также получает тело запроса ([[IPConnection.HTTPReceiveBody|HTTPReceiveBody]]) с кодированном в UTF-8 кодом данной страницы.
## Обработка создает обратный пакет, не заполняя поле ''Content-Length'' (так как информация будет передаваться по мере поступления и ее размер заранее неизвестен) и отправляет его с помощью [[IPConnection.HTTPSend|HTTPSend]], не разрывая текущего соединения.
## Обработка выполняет функцию [[ExecEx]] с заданной процедурой вывода информации.
### Процедура вывода информации, при получении новой строки, переводит ее в формат html и отсылает по активному соединению добавляя метку конца отрезка текста в размере 32-х символов с кодами ''0'', такое количество добавочных символов может быть необходимо при работе по стандарту https, так как передача информации производится блоками, не равными одному байту.
### Apache http сервер получает информацию и отправляет ее, в свою очередь, в ожидающий браузер.
### Браузер получает очередной блок информации, разделяет ее на отрезки с помощью меток их концов, и выводит ее в лог отдельными параграфами.
## По окончании исполнения функции, обработка разрывает связь, работа окончена.

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

<pre>
//Простейший пример, показывающий работу с переменной результата Result и выводом информации

//Изменяем переменную результата
Result:="Hello, World!";

//Выводим произвольную информацию. Заметьте, эта информация будет выведена в лог до текста результата!
Message("Вывод информации с помощью функции Message");
</pre>

<pre>
//Данный пример показывает, как при превышении времени исполнения, исполнение будет прервано и в лог страницы будет введено сообщение об ошибке
//Пример также демонстрирует разнообразную окраску лога с помощью функции Message

//Выводим сообщения с разными стилями
Message("Простой текст");
Message("Голубой (нейтральный) текст",".");
Message("Зеленый (положительный) текст","i");
Message("Текст об ошибке","!");
Message("Текст о серьезной ошибке","!!");
Message("Текст о критической ошибке","!!!");

//Ниже дается цикл, который будет исполняться не менее 10 секунд, однако, время исполнения ограничено пятью
// данный цикл никогда не будет завершен.
For i:=1 To 100 Do
Message("Цикл, значение i:="+i);
Sleep(100);
EndDo;
//Данное сообщение не будет выедено
Message("Цикл окончил работу!");
</pre>

<pre>
//Данный пример взят со страницы описания функции DecToBase
//Будет выведено "11101110001010001111010101"
Message(DecToBase(62432213,2));

//Будет выведено "186A0"
Message(DecToBase(100000,16));

//Будет выведено "FFFFFFFFFFFFFFFF" (отрицательное основание используется для представления беззнаковых чисел, в числе -1 все 64 бита установлены)
Message(DecToBase(-1,-16));

//Будет выведено "-BCPNB"
Message(DecToBase(-77777,16,"ABCDEFGHIJKLMNOP"));
</pre>

<pre>
//Данный пример взят со страницы описания функции Picture.Rectangle
//Он позволяет создать и присвоить переменной-результату картинку, которая будет выведена на эту страницу
aPic:=Picture.Create(400,400);
aPic.Rectangle(1,1,200,200,,_CLR_RED);
aPic.Rectangle(201,1,400,200,,_CLR_BLUE);
aPic.Rectangle(1,201,200,400,,_CLR_GREEN);
aPic.Rectangle(201,201,400,400,,_CLR_YELLOW);
aPic.Text(6,6,"1","Tahoma|40|B|"+DecToBase(_CLR_YELLOW,16),,,,3);
aPic.Text(206,6,"2","Tahoma|40|B|"+DecToBase(_CLR_GREEN,16),,,,3);
aPic.Text(6,206,"3","Tahoma|40|B|"+DecToBase(_CLR_BLUE,16),,,,3);
aPic.Text(206,206,"4","Tahoma|40|B|"+DecToBase(_CLR_RED,16),,,,3);
aPic.Rectangle(5,5,aPic.Width-5,aPic.Height-5,_CLR_RED);
Result:=aPic;
</pre>

<html>
<script type="text/javascript">
</script>
<form>
<table border="0" cellpadding="5" cellspacing="5" style="width:100%">
<tr><td align="left"><b>Программа для исполнения:</b></td></tr>
<tr><td><textarea id="aData" cols="100" rows="30" style="max-width:100%;min-width:400px;min-height:100px;"></textarea></td></tr>
<tr><td align="left"><input type="button" id="aExecBtn" value="Исполнить" /></td></tr>
</table>
<table border="0" cellpadding="5" cellspacing="0" style="width:100%" id="aResultTable" align="left" valign="top">
<tr><td align="left" valign="top"></td></tr>
<table border="0" cellpadding="5" cellspacing="5" id="aCaptchaTable" style="visibility:hidden">
<tr><td align="left"><b>Введите слово с картинки:</b></td>
<td><input type="text" id="aCaptcha" value="" /></td>
<td align="left"><input type="button" id="aCapBtn" value="Принять" /></td></tr>
</table>
</table>
</form>
<script type="text/javascript">
var key="";

function decoderesult(astr) {
if (astr.indexOf(String.fromCharCode(1))==0) {
//Getting the result
return '<hr>Переменная результата: <big>'+astr.slice(1)+'</big>';
} else if (astr.indexOf(String.fromCharCode(2))==0) {
//Getting the result as a picture
astr=astr.slice(1);

var aresult=document.createElement('div');
aresult.innerHTML='<hr>';
var cell=document.getElementById('aResultTable').rows[0].cells[0];
cell.appendChild(aresult);

var img=document.createElement('img');
img.src='data:image/png;base64,'+astr;
img.id='aPicture';
var cell=document.getElementById('aResultTable').rows[0].cells[0];
cell.appendChild(img);
return '';
} else {
return astr;
}
}

function addcaptcha(xcpt) {
var cell=document.getElementById('aResultTable').rows[0].cells[0];
cell.innerHTML='';

var atext=xcpt.responseText;
var one=String.fromCharCode(1);
pos=atext.indexOf(one);
key=atext.slice(0,pos);
var apic=atext.slice(pos+1);

var img=document.createElement('img');
img.src='data:image/png;base64,'+apic;
img.id='aPicture';
var cell=document.getElementById('aResultTable').rows[0].cells[0];
cell.appendChild(img);

document.getElementById('aCaptcha').value='';
var aTab=document.getElementById('aCaptchaTable');
aTab.style.visibility="visible";
}

function dothework() {
var cell=document.getElementById('aResultTable').rows[0].cells[0];
cell.innerHTML='';
var aTab=document.getElementById('aCaptchaTable');
aTab.style.visibility="hidden";

var src=document.URL;
var pos=src.indexOf('//');
var src2=src.slice(0,pos+2);
src=src.slice(pos+2);
pos=src.indexOf('/');
src=src2+src.slice(0,pos)+'/sfsl?ExecuteReq=1';
var adata=document.getElementById('aData').value;
var alen=0;
var skipzeros=0;

var xhttp=new XMLHttpRequest();
xhttp.onreadystatechange=function() {
if (this.status==403) {
if (this.readyState==4) {
addcaptcha(this);
}
} else if (this.readyState>2) {
var atext=this.responseText;
atext=atext.slice(alen);

//skipping zeros from the previous batch
if (skipzeros==1) {
ipos=0;
while (ipos<atext.length) {
if (atext.charAt(ipos)==zero) {
ipos=ipos+1;
} else {
break;
}
}
alen=alen+ipos;
atext=atext.slice(ipos);
skipzeros=0;
if (ipos==atext.length) {
skipzeros=1;
}
}

var atext2='';
var zero=String.fromCharCode(0);
while (atext.indexOf(zero)>=0) {
var ipos=atext.indexOf(zero);
ipos=ipos+1;
atext2=atext2+'<p>'+decoderesult(atext.slice(0,ipos))+'</p>';
//skipping all attached zeros
while (ipos<atext.length) {
if (atext.charAt(ipos)==zero) {
ipos=ipos+1;
} else {
break;
}
}
skipzeros=0;
if (ipos==atext.length) {
skipzeros=1;
}
alen=alen+ipos;
atext=atext.slice(ipos);
}

//end of connection
if (this.readyState==4) {
if (atext.length>0) {
atext2=atext2+'<p>'+decoderesult(atext)+'</p>';
}
}

var aresult=document.createElement('div');
aresult.innerHTML=atext2;
var cell=document.getElementById('aResultTable').rows[0].cells[0];
cell.appendChild(aresult);
}
};
xhttp.open("POST",src,true);
xhttp.send(adata);
}

document.getElementById('aCapBtn').onclick = function() {
var aval=document.getElementById('aCaptcha').value;
var src=document.URL;
var pos=src.indexOf('//');
var src2=src.slice(0,pos+2);
src=src.slice(pos+2);
pos=src.indexOf('/');
src=src2+src.slice(0,pos)+'/sfsl?CaptchaSolve&Key='+key+'&Answer='+btoa(aval);
var xcpt2=new XMLHttpRequest();
xcpt2.onreadystatechange=function() {
if (this.readyState==4) {
if (this.status==200) {
dothework();
} else if (this.status==403) {
addcaptcha(this);
}
}
}
xcpt2.open("GET",src,true);
xcpt2.send();
}

document.getElementById('aExecBtn').onclick = function() {
var cell=document.getElementById('aResultTable').rows[0].cells[0];
cell.innerHTML='';
var aTab=document.getElementById('aCaptchaTable');
aTab.style.visibility="hidden";

var src=document.URL;
var pos=src.indexOf('//');
var src2=src.slice(0,pos+2);
src=src.slice(pos+2);
pos=src.indexOf('/');
src=src2+src.slice(0,pos)+'/sfsl?CaptchaReq';

var xcpt=new XMLHttpRequest();
xcpt.onreadystatechange=function() {
if (this.readyState==4) {
if (this.status==200) {
dothework();
} else if (this.status==403) {
addcaptcha(this);
}
}
}
xcpt.open("GET",src,true);
xcpt.send();
}
</script>
</html>

← Older revision	Revision as of 14:58, 4 March 2021
(No difference)

@@ Line 271: / Line 271: @@
    var aTab=document.getElementById('aCaptchaTable');
    aTab.style.visibility="hidden";
    var src=document.URL;

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

Пример исполнения программного кода - Revision history

Admin: 1 revision imported

Admin at 16:28, 25 February 2021

Admin: 1 revision imported

Admin at 06:03, 30 January 2021