1. Дополнительные объекты Javascript

Обзор

В этом разделе описаны дополнения Zabbix к языку JavaScript, реализованные с помощью Duktape, а также поддерживаемые глобальные функции JavaScript.

Встроенные объекты

Zabbix

Объект Zabbix обеспечивает взаимодействие с внутренней функциональностью Zabbix.

Пример:

Zabbix.log(3, "this is a log entry written with 'Warning' log level")

Вы можете использовать следующие псевдонимы:

Пример (задержка выполнения на 15 секунд):

Zabbix.sleep(15000)

HttpRequest

Этот объект инкапсулирует дескриптор cURL, позволяя выполнять простые HTTP-запросы. Ошибки генерируются как исключения.

Пример:

try {
    Zabbix.log(4, 'jira webhook script value='+value);

    var result = {
        'tags': {
            'endpoint': 'jira'
        }
    },
    params = JSON.parse(value),
    req = new HttpRequest(),
    fields = {},
    resp;

    req.addHeader('Content-Type: application/json');
    req.addHeader('Authorization: Basic '+params.authentication);

    fields.summary = params.summary;
    fields.description = params.description;
    fields.project = {"key": params.project_key};
    fields.issuetype = {"id": params.issue_id};
    resp = req.post('https://jira.example.com/rest/api/2/issue/',
        JSON.stringify({"fields": fields})
    );

    if (req.getStatus() != 201) {
        throw 'Response code: '+req.getStatus();
    }

    resp = JSON.parse(resp);
    result.tags.issue_id = resp.id;
    result.tags.issue_key = resp.key;
} catch (error) {
    Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));
    Zabbix.log(4, 'jira issue creation failed : '+error);

    result = {};
}

return JSON.stringify(result);

XML

Объект XML позволяет обрабатывать XML-данные при предобработке элемента данных, низкоуровневом обнаружении и в вебхуках.

Пример:

Входные данные:

<menu>
    <food type = "breakfast">
        <name>Chocolate</name>
        <price>$5.95</price>
        <description></description>
        <calories>650</calories>
    </food>
</menu>

Выходные данные:

{
    "menu": {
        "food": {
            "@type": "breakfast",
            "name": "Chocolate",
            "price": "$5.95",
            "description": null,
            "calories": "650"
        }
    }
}

Правила сериализации

Преобразование XML в JSON будет выполняться в соответствии со следующими правилами (для преобразования JSON в XML применяются обратные правила):

1. Атрибуты XML будут преобразованы в ключи, к именам которых добавляется префикс '@'.

Пример:

Входные данные:

<xml foo="FOO">
  <bar>
    <baz>BAZ</baz>
  </bar>
</xml>

Выходные данные:

{
  "xml": {
    "@foo": "FOO",
    "bar": {
      "baz": "BAZ"
    }
  }
}

2. Самозакрывающиеся элементы (<foo/>) будут преобразованы как имеющие значение 'null'.

Пример:

Входные данные:

<xml>
  <foo/>
</xml>

Выходные данные:

{
  "xml": {
    "foo": null
  }
}

3. Пустые атрибуты (со значением "") будут преобразованы как имеющие значение пустой строки ('').

Пример:

Входные данные:

<xml>
  <foo bar="" />
</xml>

Выходные данные:

{
  "xml": {
    "foo": {
      "@bar": ""
    }
  }
}

4. Несколько дочерних узлов с одинаковым именем элемента будут преобразованы в один ключ, значением которого будет массив значений.

Пример:

Входные данные:

<xml>
  <foo>BAR</foo>
  <foo>BAZ</foo>
  <foo>QUX</foo>
</xml>

Выходные данные:

{
  "xml": {
    "foo": ["BAR", "BAZ", "QUX"]
  }
}

5. Если текстовый элемент не имеет атрибутов и дочерних элементов, он будет преобразован в строку.

Пример:

Входные данные:

<xml>
    <foo>BAZ</foo>
</xml>

Выходные данные:

{
  "xml": {
    "foo": "BAZ"
   }
}

6. Если текстовый элемент не имеет дочерних элементов, но имеет атрибуты, текстовое содержимое будет преобразовано в элемент с ключом '#text', а содержимое — в значение; атрибуты будут преобразованы, как описано в правиле сериализации 1.

Пример:

Входные данные:

<xml>
  <foo bar="BAR">
    BAZ
  </foo>
</xml>

Выходные данные:

{
  "xml": {
    "foo": {
      "@bar": "BAR",
      "#text": "BAZ"
    }
  }
}

Глобальные функции JavaScript

С помощью Duktape были реализованы дополнительные глобальные функции JavaScript:

• btoa(data) — кодирует данные в строку base64.
• atob(base64_string) — декодирует строку base64 в буфер Uint8Array.

try {
    b64 = btoa("test string");
    buffer = atob(b64);

    // Обратите внимание, что логика декодирования зависит от формата данных буфера.
    decoded = String.fromCharCode.apply(this, [].slice.call(buffer));
} 
catch (error) {
    return {'error.name' : error.name, 'error.message' : error.message};
}

• md5(data) — вычисляет MD5-хеш данных.
• sha256(data) — вычисляет SHA256-хеш данных.

• hmac('<hash type>',key,data) — возвращает HMAC-хеш в виде строки в шестнадцатеричном формате; в качестве hash type поддерживаются md5 и sha256; параметры key и data поддерживают двоичные данные.

  Примеры:

  • hmac('md5',key,data)
  • hmac('sha256',key,data)

• sign(hash,key,data) — возвращает вычисленную подпись (RSA-подпись с SHA-256) в виде строки, где:
  hash — допускается только sha256, в противном случае будет сгенерирована ошибка.
  key — закрытый ключ. Он должен соответствовать стандарту PKCS#1 или PKCS#8. Ключ может быть предоставлен в разных формах:
  

  • с пробелами вместо переводов строк
  • с экранированными или неэкранированными \n вместо переводов строк
  • без переводов строк, как однострочная строка
  • как строка в формате JSON

  Ключ также может быть загружен из пользовательского макроса/секретного макроса/хранилища секретов.

  data — данные, которые будут подписаны. Это может быть строка (также поддерживаются двоичные данные) или буфер (Uint8Array/ArrayBuffer).

  Пример:

  • sign('sha256',key,data)

  Для вычисления подписей используется OpenSSL или GnuTLS. Если Zabbix был собран без какой-либо из этих библиотек шифрования, будет сгенерирована ошибка ('missing OpenSSL or GnuTLS library').