Áú»¢¶Ä²©

Objets JavaScript suppl¨¦mentaires

Aper?u

Cette section d¨¦crit les ajouts de Áú»¢¶Ä²© au langage JavaScript impl¨¦ment¨¦s avec Duktape et les fonctions JavaScript globales prises en charge.

Objets int¨¦gr¨¦s

Áú»¢¶Ä²©

L'objet Áú»¢¶Ä²© fournit une interaction avec la fonctionnalit¨¦ interne de Áú»¢¶Ä²©.

Exemple :

Áú»¢¶Ä²©.log(3, "this is a log entry written with 'Warning' log level")

Vous pouvez utiliser les alias suivants :

Exemple (retarder l'ex¨¦cution de 15 secondes) :

Áú»¢¶Ä²©.sleep(15000)

HttpRequest

This object encapsulates cURL handle allowing to make simple HTTP requests. Errors are thrown as exceptions.

Example:

try {
           Áú»¢¶Ä²©.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://tsupport.zabbix.lan/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) {
           Áú»¢¶Ä²©.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));
           Áú»¢¶Ä²©.log(4, 'jira issue creation failed : '+error);
         
           result = {};
       }
         
       return JSON.stringify(result);

XML

L'objet XML permet le traitement des donn¨¦es XML dans l'¨¦l¨¦ment et le pr¨¦traitement de d¨¦couverte de bas niveau et les webhooks.

Exemple :

Entr¨¦e :

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

Sortie :

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

R¨¨gles de s¨¦rialisation

La conversion XML vers JSON sera trait¨¦e selon les r¨¨gles suivantes (pour les conversions JSON vers XML, des r¨¨gles invers¨¦es sont appliqu¨¦es) :

1. Les attributs XML seront convertis en ³¦±ô¨¦s dont les noms seront pr¨¦c¨¦d¨¦s de '@'.

Exemple :

·¡²Ô³Ù°ù¨¦±ð:

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

Sortie :

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

2. Les ¨¦l¨¦ments ¨¤ fermeture automatique (<foo/>) seront convertis comme ayant une valeur 'null'.

Exemple :

·¡²Ô³Ù°ù¨¦±ð:

<xml>
         <foo/>
       </xml>

Sortie :

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

3. Les attributs vides (avec la valeur "") seront convertis comme ayant une valeur de cha?ne vide ('').

Exemple :

·¡²Ô³Ù°ù¨¦±ð:

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

Sortie :

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

4. Plusieurs n?uds enfants avec le m¨ºme nom d'¨¦l¨¦ment seront convertis en une seule ³¦±ô¨¦ qui a un tableau de valeurs comme valeur.

Exemple :

·¡²Ô³Ù°ù¨¦±ð:

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

Sortie :

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

5. Si un ¨¦l¨¦ment de texte n'a ni attribut ni enfant, il sera converti en cha?ne.

Exemple :

·¡²Ô³Ù°ù¨¦±ð:

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

Sortie :

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

6. Si un ¨¦l¨¦ment de texte n'a pas d'enfant, mais poss¨¨de des attributs : le contenu du texte sera converti en un ¨¦l¨¦ment avec la ³¦±ô¨¦ '#text' et le contenu comme valeur ; les attributs seront convertis comme d¨¦crit dans la r¨¨gle de s¨¦rialisation 1.

Exemple :

·¡²Ô³Ù°ù¨¦±ð:

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

Sortie :

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

Fonctions JavaScript globales

Des fonctions JavaScript globales suppl¨¦mentaires ont ¨¦t¨¦ impl¨¦ment¨¦es avec Duktape?:

• btoa(string) - encode la cha?ne en cha?ne base64
• atob(base64_string) - d¨¦code la cha?ne base64

try {
           b64 = btoa("utf8 string");
           utf8 = atob(b64);
       } 
       catch (error) {
           return {'error.name' : error.name, 'error.message' : error.message}
       }

• md5(donn¨¦es) - calcule le hachage MD5 d'une cha?ne

• sha256(donn¨¦es) - calcule le hachage SHA256 d'une cha?ne

• mac('<ype de hachage>',³¦±ô¨¦,donn¨¦es) - renvoie le hachage HMAC sous forme de cha?ne au format hexad¨¦cimal?; Les types de hachage MD5 et SHA256 sont pris en charge ; Les param¨¨tres de ³¦±ô¨¦ et de donn¨¦es prennent en charge les donn¨¦es binaires. Exemples :

  • ³ó³¾²¹³¦('³¾»å5',³¦±ô¨¦,»å´Ç²Ô²Ô¨¦±ð²õ)
  • ³ó³¾²¹³¦('²õ³ó²¹256',³¦±ô¨¦,»å´Ç²Ô²Ô¨¦±ð²õ)

• sign(hachage,³¦±ô¨¦,donn¨¦es) - renvoie la signature calcul¨¦e (signature RSA avec SHA-256) sous forme de cha?ne, o¨´?:
  hash - seul 'sha256' est autoris¨¦, sinon une erreur est renvoy¨¦e?;
  ³¦±ô¨¦ - la ³¦±ô¨¦ priv¨¦e. Il doit correspondre ¨¤ la norme PKCS#1 ou PKCS#8. La ³¦±ô¨¦ peut ¨ºtre fournie sous diff¨¦rentes formes?:
  

  • avec des espaces au lieu de retours ¨¤ la ligne?;
  • avec des '' ¨¦chapp¨¦s ou non au lieu de nouvelles lignes?;
  • sans aucun retour ¨¤ la ligne sous la forme d'une cha?ne ¨¤ une seule ligne?;
  • sous forme de cha?ne au format JSON.

  La ³¦±ô¨¦ peut ¨¦galement ¨ºtre charg¨¦e ¨¤ partir d'une macro utilisateur/macro secr¨¨te/coffre.

  data - les donn¨¦es qui seront sign¨¦es. Il peut s'agir d'une cha?ne (les donn¨¦es binaires sont ¨¦galement prises en charge) ou d'un tampon (Uint8Array/ArrayBuffer).
  OpenSSL ou GnuTLS est utilis¨¦ pour calculer les signatures. Si Áú»¢¶Ä²© a ¨¦t¨¦ compil¨¦ sans aucune de ces biblioth¨¨ques de chiffrement, une erreur sera g¨¦n¨¦r¨¦e ("biblioth¨¨que OpenSSL ou GnuTLS manquante").
  Cette fonction est prise en charge depuis Áú»¢¶Ä²© 6.0.15.