ການໂຕ້ຕອບກັບ Check Point SandBlast ຜ່ານ API

ບົດຄວາມນີ້ຈະເປັນປະໂຫຍດກັບຜູ້ທີ່ຄຸ້ນເຄີຍກັບເຕັກໂນໂລຊີ Check Point ໂດຍການຈຳລອງໄຟລ໌ (ການຈຳລອງໄພຂົ່ມຂູ່) ແລະ​ການ​ທໍາ​ຄວາມ​ສະ​ອາດ​ໄຟລ​໌​ທີ່​ຕັ້ງ​ຫນ້າ (ການສະກັດເອົາໄພຂົ່ມຂູ່) ແລະຕ້ອງການທີ່ຈະກ້າວໄປສູ່ການອັດຕະໂນມັດວຽກງານເຫຼົ່ານີ້. ຈຸດກວດກາມີ API ປ້ອງກັນໄພຂົ່ມຂູ່, ເຊິ່ງເຮັດວຽກທັງໃນຄລາວແລະໃນອຸປະກອນທ້ອງຖິ່ນ, ແລະ ເຮັດວຽກມັນຄືກັນກັບການກວດສອບໄຟລ໌ໃນ web/smtp/ftp/smb/nfs traffic streams. ບົດຄວາມນີ້ແມ່ນສ່ວນຫນຶ່ງຂອງການຕີຄວາມຫມາຍຂອງຜູ້ຂຽນຂອງຊຸດຂອງບົດຄວາມຈາກເອກະສານທາງການ, ແຕ່ອີງໃສ່ປະສົບການການດໍາເນີນງານຂອງຕົນເອງແລະຕົວຢ່າງຂອງຂ້ອຍເອງ. ນອກຈາກນີ້ໃນບົດຄວາມທີ່ເຈົ້າຈະພົບເຫັນການເກັບກໍາ Postman ຂອງຜູ້ຂຽນສໍາລັບການເຮັດວຽກກັບ API ປ້ອງກັນໄພຂົ່ມຂູ່.

ຕົວຫຍໍ້ພື້ນຖານ

API ການ​ປ້ອງ​ກັນ​ໄພ​ຂົ່ມ​ຂູ່​ເຮັດ​ວຽກ​ຮ່ວມ​ກັບ​ສາມ​ອົງ​ປະ​ກອບ​ຕົ້ນ​ຕໍ​, ທີ່​ຖືກ​ເອີ້ນ​ວ່າ​ໃນ API ໂດຍ​ຜ່ານ​ຄ່າ​ຂໍ້​ຄວາມ​ດັ່ງ​ຕໍ່​ໄປ​ນີ້​:

av — ອົງ​ປະ​ກອບ​ຕ້ານ​ເຊື້ອ​ໄວຣ​ັ​ສ​, ຮັບ​ຜິດ​ຊອບ​ສໍາ​ລັບ​ການ​ວິ​ເຄາະ​ລາຍ​ເຊັນ​ຂອງ​ໄພ​ຂົ່ມ​ຂູ່​ທີ່​ຮູ້​ຈັກ​.

te - ອົງປະກອບການຈໍາລອງໄພຂົ່ມຂູ່, ຮັບຜິດຊອບໃນການກວດສອບໄຟລ໌ໃນ sandbox, ແລະເຮັດຄໍາຕັດສິນທີ່ເປັນອັນຕະລາຍ / ອ່ອນໂຍນຫຼັງຈາກການຈໍາລອງ.

ການສະກັດເອົາ - ອົງປະກອບການສະກັດເອົາໄພຂົ່ມຂູ່, ຮັບຜິດຊອບໃນການປ່ຽນເອກະສານຫ້ອງການເປັນຮູບແບບທີ່ປອດໄພ (ເຊິ່ງເນື້ອໃນທີ່ເປັນອັນຕະລາຍທັງໝົດຈະຖືກລຶບອອກ), ເພື່ອສົ່ງໃຫ້ຜູ້ໃຊ້/ລະບົບໄດ້ໄວ.

ໂຄງສ້າງ API ແລະຂໍ້ຈໍາກັດຕົ້ນຕໍ

API ປ້ອງກັນໄພຂົ່ມຂູ່ໃຊ້ພຽງແຕ່ 4 ຄໍາຮ້ອງຂໍ − ອັບໂຫລດ, ສອບຖາມ, ດາວໂຫລດ ແລະໂຄຕ້າ. ໃນຫົວຂໍ້ສໍາລັບຄໍາຮ້ອງຂໍທັງສີ່, ທ່ານຈໍາເປັນຕ້ອງຜ່ານລະຫັດ API ໂດຍໃຊ້ພາລາມິເຕີ ການອະນຸຍາດ. ຢູ່ glance ທໍາອິດ, ໂຄງສ້າງອາດຈະເບິ່ງຄືວ່າງ່າຍດາຍຫຼາຍກ່ວາໃນ API ການຈັດການ, ແຕ່ຈໍານວນຊ່ອງຂໍ້ມູນໃນການຮ້ອງຂໍການອັບໂຫລດແລະການສອບຖາມແລະໂຄງສ້າງຂອງຄໍາຮ້ອງຂໍເຫຼົ່ານີ້ແມ່ນຂ້ອນຂ້າງສັບສົນ. ສິ່ງເຫຼົ່ານີ້ສາມາດຖືກປຽບທຽບກັບໂປຣໄຟລ໌ການປ້ອງກັນໄພຂົ່ມຂູ່ໃນນະໂຍບາຍຄວາມປອດໄພຂອງປະຕູ/ກ່ອງຊາຍ.

ໃນປັດຈຸບັນ, ສະບັບດຽວຂອງ API ປ້ອງກັນໄພຂົ່ມຂູ່ໄດ້ຖືກປ່ອຍອອກມາ - 1.0 URL ສໍາລັບການໂທ API ຄວນປະກອບມີ v1 ໃນສ່ວນທີ່ທ່ານຈໍາເປັນຕ້ອງລະບຸສະບັບ. ບໍ່ເຫມືອນກັບ API ການຈັດການ, ມັນຈໍາເປັນຕ້ອງຊີ້ບອກສະບັບ API ໃນ URL, ຖ້າບໍ່ດັ່ງນັ້ນການຮ້ອງຂໍຈະບໍ່ຖືກປະຕິບັດ.

ອົງປະກອບຕ້ານເຊື້ອໄວຣັສ, ເມື່ອເອີ້ນວ່າບໍ່ມີອົງປະກອບອື່ນໆ (te, ການສະກັດເອົາ), ໃນປັດຈຸບັນພຽງແຕ່ສະຫນັບສະຫນູນການຮ້ອງຂໍການສອບຖາມກັບ md5 hash sums. ການຈຳແນກໄພຂົ່ມຂູ່ແລະການສະກັດເອົາໄພຂົ່ມຂູ່ຍັງຮອງຮັບ sha1 ແລະ sha256 hash sums.

ມັນເປັນສິ່ງສໍາຄັນທີ່ສຸດທີ່ຈະບໍ່ເຮັດຜິດພາດໃນການສອບຖາມ! ການຮ້ອງຂໍສາມາດຖືກປະຕິບັດໂດຍບໍ່ມີຄວາມຜິດພາດ, ແຕ່ບໍ່ແມ່ນຢ່າງສົມບູນ. ເບິ່ງໄປຂ້າງຫນ້າເລັກນ້ອຍ, ໃຫ້ເບິ່ງສິ່ງທີ່ສາມາດເກີດຂຶ້ນເມື່ອມີຂໍ້ຜິດພາດ / ພິມຜິດໃນຄໍາຖາມ.

ຮ້ອງ​ຂໍ​ດ້ວຍ​ການ​ພິມ​ຜິດ​ພາດ​ທີ່​ມີ​ຄໍາ​ວ່າ​ບົດ​ລາຍ​ງານ (ບົດ​ລາຍ​ງານ​)

{ "request":  [  

		{	
			"sha256": {{sha256}},
			"features": ["te"] , 
			"te": {
				"images": [
                    {
                        "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
                        "revision": 1
                    }
                ],
                reportss: ["tar", "pdf", "xml"]
            }
		}
	] 
}

ຈະບໍ່ມີຂໍ້ຜິດພາດໃນການຕອບສະຫນອງ, ແຕ່ຈະບໍ່ມີຂໍ້ມູນກ່ຽວກັບບົດລາຍງານທັງຫມົດ

{
  "response": [
    {
      "status": {
        "code": 1001,
        "label": "FOUND",
        "message": "The request has been fully answered."
      },
      "sha256": "9cc488fa6209caeb201678f8360a6bb806bd2f85b59d108517ddbbf90baec33a",
      "file_type": "pdf",
      "file_name": "",
      "features": [
        "te"
      ],
      "te": {
        "trust": 10,
        "images": [
          {
            "report": {
              "verdict": "malicious"
            },
            "status": "found",
            "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
            "revision": 1
          }
        ],
        "score": -2147483648,
        "combined_verdict": "malicious",
        "severity": 4,
        "confidence": 3,
        "status": {
          "code": 1001,
          "label": "FOUND",
          "message": "The request has been fully answered."
        }
      }
    }
  ]
}

ແຕ່ສໍາລັບການຮ້ອງຂໍໂດຍບໍ່ມີການ typo ໃນບົດລາຍງານທີ່ສໍາຄັນ

{ "request":  [  

		{	
			"sha256": {{sha256}},
			"features": ["te"] , 
			"te": {
				"images": [
                    {
                        "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
                        "revision": 1
                    }
                ],
                reports: ["tar", "pdf", "xml"]
            }
		}
	] 
}

ພວກເຮົາໄດ້ຮັບການຕອບສະຫນອງທີ່ມີ id ແລ້ວສໍາລັບການດາວໂຫຼດບົດລາຍງານ

{
  "response": [
    {
      "status": {
        "code": 1001,
        "label": "FOUND",
        "message": "The request has been fully answered."
      },
      "sha256": "9cc488fa6209caeb201678f8360a6bb806bd2f85b59d108517ddbbf90baec33a",
      "file_type": "pdf",
      "file_name": "",
      "features": [
        "te"
      ],
      "te": {
        "trust": 10,
        "images": [
          {
            "report": {
              "verdict": "malicious",
              "full_report": "b684066e-e41c-481a-a5b4-be43c27d8b65",
              "pdf_report": "e48f14f1-bcc7-4776-b04b-1a0a09335115",
              "xml_report": "d416d4a9-4b7c-4d6d-84b9-62545c588963"
            },
            "status": "found",
            "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
            "revision": 1
          }
        ],
        "score": -2147483648,
        "combined_verdict": "malicious",
        "severity": 4,
        "confidence": 3,
        "status": {
          "code": 1001,
          "label": "FOUND",
          "message": "The request has been fully answered."
        }
      }
    }
  ]
}

ຖ້າພວກເຮົາສົ່ງລະຫັດ API ທີ່ບໍ່ຖືກຕ້ອງ/ໝົດອາຍຸ, ພວກເຮົາຈະໄດ້ຮັບຂໍ້ຜິດພາດ 403 ໃນການຕອບໂຕ້.

SandBlast API: ໃນຄລາວ ແລະໃນອຸປະກອນທ້ອງຖິ່ນ

ການຮ້ອງຂໍ API ສາມາດຖືກສົ່ງໄປຫາອຸປະກອນ Check Point ທີ່ມີອົງປະກອບຂອງ Threat Emulation (ແຜ່ນໃບຄ້າຍຄື) ຖືກເປີດໃຊ້. ເປັນທີ່ຢູ່ສໍາລັບການຮ້ອງຂໍ, ທ່ານຈໍາເປັນຕ້ອງໃຊ້ ip/url ຂອງອຸປະກອນແລະພອດ 18194 (ຕົວຢ່າງ: https://10.10.57.19:18194/tecloud/api/v1/file/query). ນອກນັ້ນທ່ານຍັງຄວນໃຫ້ແນ່ໃຈວ່ານະໂຍບາຍຄວາມປອດໄພໃນອຸປະກອນອະນຸຍາດໃຫ້ການເຊື່ອມຕໍ່ນີ້. ການອະນຸຍາດຜ່ານລະຫັດ API ໃນອຸປະກອນທ້ອງຖິ່ນຕາມຄ່າເລີ່ມຕົ້ນ ປິດ ແລະກະແຈການອະນຸຍາດໃນສ່ວນຫົວຄຳຮ້ອງຂໍອາດຈະບໍ່ຖືກສົ່ງໄປເລີຍ.

ການຮ້ອງຂໍ API ກັບ CheckPoint cloud ຄວນຖືກສົ່ງໄປຫາ te.checkpoint.com (ຕົວຢ່າງ - https://te.checkpoint.com/tecloud/api/v1/file/query). ລະຫັດ API ສາມາດໄດ້ຮັບເປັນໃບອະນຸຍາດທົດລອງເປັນເວລາ 60 ມື້ໂດຍການຕິດຕໍ່ຄູ່ຮ່ວມງານຂອງ Check Point ຫຼືຫ້ອງການທ້ອງຖິ່ນຂອງບໍລິສັດ.

ໃນອຸປະກອນທ້ອງຖິ່ນ, ການສະກັດເອົາໄພຂົ່ມຂູ່ຍັງບໍ່ຖືກຮອງຮັບເປັນມາດຕະຖານເທື່ອ. API ປ້ອງກັນໄພຂົ່ມຂູ່ ແລະຄວນຈະຖືກນໍາໃຊ້ API ປ້ອງກັນໄພຂົ່ມຂູ່ສຳລັບປະຕູຄວາມປອດໄພ (ພວກເຮົາຈະເວົ້າກ່ຽວກັບມັນໃນລາຍລະອຽດເພີ່ມເຕີມໃນຕອນທ້າຍຂອງບົດຄວາມ).

ອຸປະກອນທ້ອງຖິ່ນບໍ່ຮອງຮັບການຮ້ອງຂໍໂຄຕ້າ.

ຖ້າບໍ່ດັ່ງນັ້ນ, ບໍ່ມີຄວາມແຕກຕ່າງລະຫວ່າງການຮ້ອງຂໍກັບອຸປະກອນທ້ອງຖິ່ນແລະຄລາວ.

ອັບໂຫລດການໂທ API

ວິ​ທີ​ການ​ນໍາ​ໃຊ້ -​ POST

ໂທ​ຫາ​ທີ່​ຢູ່ - https:///tecloud/api/v1/file/upload

ຄໍາຮ້ອງຂໍປະກອບມີສອງສ່ວນ (ຂໍ້ມູນແບບຟອມ): ໄຟລ໌ທີ່ມີຈຸດປະສົງສໍາລັບການຈໍາລອງ / ທໍາຄວາມສະອາດແລະສ່ວນຄໍາຮ້ອງຂໍທີ່ມີຂໍ້ຄວາມ.

ການຮ້ອງຂໍຂໍ້ຄວາມບໍ່ສາມາດຫວ່າງເປົ່າໄດ້, ແຕ່ມັນອາດຈະບໍ່ມີການຕັ້ງຄ່າໃດໆ. ເພື່ອໃຫ້ຄໍາຮ້ອງຂໍປະສົບຜົນສໍາເລັດ, ທ່ານຕ້ອງສົ່ງຢ່າງຫນ້ອຍຂໍ້ຄວາມຕໍ່ໄປນີ້ໃນຄໍາຮ້ອງຂໍ:

ຕໍາ່ສຸດທີ່ຕ້ອງການສໍາລັບການຮ້ອງຂໍການອັບໂຫລດ

HTTP POST

https:///tecloud/api/v1/file/upload

ສ່ວນຫົວ:

ການອະນຸຍາດ:

ຮ່າງກາຍ

{

"ຮ້ອງຂໍ": {

}

}

ເອກະສານ

ເອກະສານ

ໃນ​ກໍ​ລະ​ນີ​ນີ້​, ໄຟລ​໌​ຈະ​ໄດ້​ຮັບ​ການ​ປະ​ຕິ​ບັດ​ຕາມ​ຕົວ​ກໍາ​ນົດ​ການ​ເລີ່ມ​ຕົ້ນ​: ອົງ​ປະ​ກອບ - te, ຮູບ​ພາບ OS - Win XP ແລະ Win 7, ໂດຍບໍ່ມີການສ້າງບົດລາຍງານ.

ຄໍາເຫັນກ່ຽວກັບຊ່ອງຂໍ້ມູນຕົ້ນຕໍໃນຄໍາຮ້ອງຂໍຂໍ້ຄວາມ:

ຊື່​ເອ​ກະ​ສານ и file_type ທ່ານສາມາດປ່ອຍໃຫ້ພວກເຂົາຫວ່າງເປົ່າຫຼືບໍ່ສົ່ງພວກມັນເລີຍ, ເພາະວ່ານີ້ບໍ່ແມ່ນຂໍ້ມູນທີ່ເປັນປະໂຫຍດໂດຍສະເພາະໃນເວລາອັບໂຫລດໄຟລ໌. ໃນການຕອບສະຫນອງ API, ຊ່ອງຂໍ້ມູນເຫຼົ່ານີ້ຈະຖືກຕື່ມໃສ່ໂດຍອັດຕະໂນມັດໂດຍອີງໃສ່ຊື່ຂອງໄຟລ໌ທີ່ດາວໂຫລດ, ແລະຂໍ້ມູນໃນ cache ຍັງຈະຕ້ອງຖືກຄົ້ນຫາໂດຍໃຊ້ md5/sha1/sha256 hash.

ການຮ້ອງຂໍຕົວຢ່າງທີ່ມີ file_name ແລະ file_type ຫວ່າງເປົ່າ

{

"request": {

"file_name": "",

"file_type": "",

}

}

ຄຸນ​ລັກ​ສະ​ນະ — ບັນ​ຊີ​ລາຍ​ການ​ທີ່​ຊີ້​ບອກ​ການ​ທໍາ​ງານ​ທີ່​ຈໍາ​ເປັນ​ໃນ​ເວ​ລາ​ທີ່​ການ​ປຸງ​ແຕ່ງ​ໃນ sandbox ໄດ້ - av (Anti​-Virus​)​, te (Threat Emulation​)​, ການ​ສະ​ກັດ​ເອົາ (ການ​ສະ​ກັດ​ໄພ​ຂົ່ມ​ຂູ່​)​. ຖ້າພາລາມິເຕີນີ້ບໍ່ໄດ້ຜ່ານທັງຫມົດ, ຫຼັງຈາກນັ້ນພຽງແຕ່ອົງປະກອບເລີ່ມຕົ້ນທີ່ຈະຖືກນໍາໃຊ້ - te (Threat Emulation).

ເພື່ອເປີດໃຊ້ການກວດສອບສາມອົງປະກອບທີ່ມີຢູ່, ທ່ານຈໍາເປັນຕ້ອງລະບຸອົງປະກອບເຫຼົ່ານີ້ໃນຄໍາຮ້ອງຂໍ API.

ຕົວຢ່າງຂອງຄໍາຮ້ອງຂໍທີ່ມີການກວດສອບໃນ av, te ແລະການສະກັດເອົາ

{ "request":  [  

		{	
			"sha256": {{sha256}},
			"features": ["av", "te", "extraction"]  
		}
	] 
}

ຄີໃນພາກ te

ຮູບພາບ — ບັນ​ຊີ​ລາຍ​ຊື່​ທີ່​ປະ​ກອບ​ດ້ວຍ​ວັດ​ຈະ​ນາ​ນຸ​ກົມ​ທີ່​ມີ ID ແລະ​ຈໍາ​ນວນ​ການ​ປັບ​ປຸງ​ຂອງ​ລະ​ບົບ​ປະ​ຕິ​ບັດ​ການ​ທີ່​ຈະ​ໄດ້​ຮັບ​ການ​ກວດ​ສອບ​ໄດ້​. IDs ແລະຕົວເລກການແກ້ໄຂແມ່ນຄືກັນສໍາລັບອຸປະກອນທ້ອງຖິ່ນທັງຫມົດແລະຄລາວ.

ບັນຊີລາຍຊື່ຂອງລະບົບປະຕິບັດການແລະການດັດແກ້

OS Image ID

ການແກ້ໄຂ

ຮູບພາບ OS ແລະແອັບພລິເຄຊັນ

e50e99f3-5963-4573-af9e-e3f4750b55e2

1

Microsoft Windows: XP - 32bit SP3
ຫ້ອງການ: 2003, 2007
Adobe Acrobat Reader: 9.0
Flash Player 9r115 ແລະ Active X 10.0
Java Runtime: 1.6.0u22

7e6fe36e-889e-4c25-8704-56378f0830df

1

Microsoft Windows: 7 - 32bit
ຫ້ອງການ: 2003, 2007
Adobe Acrobat Reader: 9.0
Flash Player: 10.2r152 (Plugin& Active X)
Java Runtime: 1.6.0u0

8d188031-1010-4466-828b-0cd13d4303ff

1

Microsoft Windows: 7 - 32bit
ຫ້ອງການ: 2010
Adobe Acrobat Reader: 9.4
Flash Player: 11.0.1.152 (Plugin & Active X)
Java Runtime: 1.7.0u0

5e5de275-a103-4f67-b55b-47532918fa59

1

Microsoft Windows: 7 - 32bit
ຫ້ອງການ: 2013
Adobe Acrobat Reader: 11.0
Flash Player: 15 (Plugin & Active X)
Java Runtime: 1.7.0u9

3ff3ddae-e7fd-4969-818c-d5f1a2be336d

1

Microsoft Windows: 7 - 64bit
ຫ້ອງການ: 2013 (32bit)
Adobe Acrobat Reader: 11.0.01
Flash Player: 13 (Plugin & Active X)
Java Runtime: 1.7.0u9

6c453c9b-20f7-471a-956c-3198a868dc92 

 

1 

Microsoft Windows: 8.1 - 64bit
ຫ້ອງການ: 2013 (64bit)
Adobe Acrobat Reader: 11.0.10
Flash Player: 18.0.0.160 (Plugin & Active X)
Java Runtime: 1.7.0u9

10b4a9c6-e414-425c-ae8b-fe4dd7b25244 

 

1

Microsoft Windows: 10
ຫ້ອງການ: Professional Plus 2016 en-us  
Adobe Acrobat Reader: DC 2015 MUI
Flash Player: 20 (Plugin & Active X)
Java Runtime: 1.7.0u9

ຖ້າຄີຮູບພາບບໍ່ໄດ້ຖືກລະບຸໄວ້ທັງຫມົດ, ຫຼັງຈາກນັ້ນການຈໍາລອງຈະເກີດຂຶ້ນໃນຮູບພາບທີ່ແນະນໍາໂດຍ Check Point (ປະຈຸບັນ Win XP ແລະ Win 7). ຮູບພາບເຫຼົ່ານີ້ແມ່ນແນະນໍາໂດຍອີງໃສ່ການພິຈາລະນາຄວາມສົມດຸນທີ່ດີທີ່ສຸດຂອງການປະຕິບັດແລະອັດຕາການຈັບ.

ບົດລາຍງານ — ບັນ​ຊີ​ລາຍ​ການ​ຂອງ​ການ​ລາຍ​ງານ​ທີ່​ພວກ​ເຮົາ​ຮ້ອງ​ຂໍ​ໃນ​ກໍ​ລະ​ນີ​ທີ່​ໄຟລ​໌​ກາຍ​ເປັນ​ອັນ​ຕະ​ລາຍ​. ຕົວເລືອກຕໍ່ໄປນີ້ແມ່ນມີຢູ່:

1. ສະ​ຫຼຸບ​ສັງ​ລວມ - .tar.gz ຮວບຮວມມີບົດລາຍງານກ່ຽວກັບການຈໍາລອງໂດຍ ກັບທຸກຄົນ ຮູບພາບທີ່ຮ້ອງຂໍ (ທັງຫນ້າ html ແລະອົງປະກອບເຊັ່ນ: ວິດີໂອຈາກ emulator OS, dump ການຈະລາຈອນເຄືອຂ່າຍ, ບົດລາຍງານໃນ json, ແລະຕົວຢ່າງຕົວມັນເອງຢູ່ໃນບ່ອນເກັບມ້ຽນທີ່ມີການປ້ອງກັນລະຫັດຜ່ານ). ພວກເຮົາກໍາລັງຊອກຫາທີ່ສໍາຄັນໃນຄໍາຕອບ - summary_report ສໍາລັບການດາວໂຫຼດບົດລາຍງານຕໍ່ໄປ.

2. pdf - ເອ​ກະ​ສານ​ກ່ຽວ​ກັບ emulation ໃນ​ ຫນຶ່ງ ຮູບ​ພາບ​, ທີ່​ຈໍາ​ນວນ​ຫຼາຍ​ແມ່ນ​ເຮັດ​ໃຫ້​ເຄຍ​ຊີນ​ກັບ​ການ​ໄດ້​ຮັບ​ໂດຍ​ຜ່ານ Smart Console​. ພວກເຮົາກໍາລັງຊອກຫາທີ່ສໍາຄັນໃນຄໍາຕອບ - pdf_report ສໍາລັບການດາວໂຫຼດບົດລາຍງານຕໍ່ໄປ.

3. xml - ເອ​ກະ​ສານ​ກ່ຽວ​ກັບ emulation ໃນ​ ຫນຶ່ງ ຮູບພາບ, ສະດວກສໍາລັບການແຍກຕົວກໍານົດການຕໍ່ມາໃນບົດລາຍງານ. ພວກເຮົາກໍາລັງຊອກຫາທີ່ສໍາຄັນໃນຄໍາຕອບ - xml_report ສໍາລັບການດາວໂຫຼດບົດລາຍງານຕໍ່ໄປ.

4. tar - .tar.gz ຮວບຮວມມີບົດລາຍງານກ່ຽວກັບການຈໍາລອງໃນ ຫນຶ່ງ ຮູບພາບທີ່ຮ້ອງຂໍ (ທັງຫນ້າ html ແລະອົງປະກອບເຊັ່ນ: ວິດີໂອຈາກ emulator OS, dump ການຈະລາຈອນເຄືອຂ່າຍ, ບົດລາຍງານໃນ json, ແລະຕົວຢ່າງຕົວມັນເອງຢູ່ໃນບ່ອນເກັບມ້ຽນທີ່ມີການປ້ອງກັນລະຫັດຜ່ານ). ພວກເຮົາກໍາລັງຊອກຫາທີ່ສໍາຄັນໃນຄໍາຕອບ - full_report ສໍາລັບການດາວໂຫຼດບົດລາຍງານຕໍ່ໄປ.

ສິ່ງທີ່ຢູ່ໃນບົດລາຍງານສະຫຼຸບ

keys full_report, pdf_report, xml_report ຢູ່ໃນວັດຈະນານຸກົມສຳລັບແຕ່ລະ OS

{
  "response": [
    {
      "status": {
        "code": 1001,
        "label": "FOUND",
        "message": "The request has been fully answered."
      },
      "sha256": "9e6f07d03b37db0d3902bde4e239687a9e3d650e8c368188c7095750e24ad2d5",
      "file_type": "html",
      "file_name": "",
      "features": [
        "te"
      ],
      "te": {
        "trust": 10,
        "images": [
          {
            "report": {
              "verdict": "malicious",
              "full_report": "8d18067e-b24d-4103-8469-0117cd25eea9",
              "pdf_report": "05848b2a-4cfd-494d-b949-6cfe15d0dc0b",
              "xml_report": "ecb17c9d-8607-4904-af49-0970722dd5c8"
            },
            "status": "found",
            "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
            "revision": 1
          },
          {
            "report": {
              "verdict": "malicious",
              "full_report": "d7c27012-8e0c-4c7e-8472-46cc895d9185",
              "pdf_report": "488e850c-7c96-4da9-9bc9-7195506afe03",
              "xml_report": "e5a3a78d-c8f0-4044-84c2-39dc80ddaea2"
            },
            "status": "found",
            "id": "6c453c9b-20f7-471a-956c-3198a868dc92",
            "revision": 1
          }
        ],
        "score": -2147483648,
        "combined_verdict": "malicious",
        "severity": 4,
        "confidence": 3,
        "status": {
          "code": 1001,
          "label": "FOUND",
          "message": "The request has been fully answered."
        }
      }
    }
  ]
}

ແຕ່ທີ່ສໍາຄັນ summary_report - ມີຫນຶ່ງສໍາລັບການ emulation ໂດຍທົ່ວໄປ

{
  "response": [
    {
      "status": {
        "code": 1001,
        "label": "FOUND",
        "message": "The request has been fully answered."
      },
      "sha256": "d57eadb7b2f91eea66ea77a9e098d049c4ecebd5a4c70fb984688df08d1fa833",
      "file_type": "exe",
      "file_name": "",
      "features": [
        "te"
      ],
      "te": {
        "trust": 10,
        "images": [
          {
            "report": {
              "verdict": "malicious",
              "full_report": "c9a1767b-741e-49da-996f-7d632296cf9f",
              "xml_report": "cc4dbea9-518c-4e59-b6a3-4ea463ca384b"
            },
            "status": "found",
            "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
            "revision": 1
          },
          {
            "report": {
              "verdict": "malicious",
              "full_report": "ba520713-8c0b-4672-a12f-0b4a1575b913",
              "xml_report": "87bdb8ca-dc44-449d-a9ab-2d95e7fe2503"
            },
            "status": "found",
            "id": "6c453c9b-20f7-471a-956c-3198a868dc92",
            "revision": 1
          }
        ],
        "score": -2147483648,
        "combined_verdict": "malicious",
        "severity": 4,
        "confidence": 3,
        "summary_report": "7e7db12d-5df6-4e14-85f3-2c1e29cd3e34",
        "status": {
          "code": 1001,
          "label": "FOUND",
          "message": "The request has been fully answered."
        }
      }
    }
  ]
}

ທ່ານສາມາດຮ້ອງຂໍບົດລາຍງານ tar ແລະ xml ແລະ pdf ໃນເວລາດຽວກັນ, ທ່ານສາມາດຮ້ອງຂໍການສະຫຼຸບແລະ tar ແລະ xml. ມັນຈະບໍ່ສາມາດຮ້ອງຂໍບົດລາຍງານສະຫຼຸບແລະ pdf ໃນເວລາດຽວກັນ.

ຄີໃນພາກສະກັດ

ສໍາລັບການສະກັດເອົາໄພຂົ່ມຂູ່, ພຽງແຕ່ສອງກະແຈຖືກນໍາໃຊ້:

ວິທີການ — pdf (ປ່ຽນເປັນ pdf, ໃຊ້ໂດຍຄ່າເລີ່ມຕົ້ນ) ຫຼືສະອາດ (ລ້າງເນື້ອໃນທີ່ມີການເຄື່ອນໄຫວ).

extracted_parts_codes - ບັນຊີລາຍຊື່ຂອງລະຫັດສໍາລັບການຖອນເນື້ອໃນການເຄື່ອນໄຫວ, ນໍາໃຊ້ພຽງແຕ່ສໍາລັບວິທີການສະອາດ

ລະຫັດສໍາລັບການຖອນເນື້ອຫາອອກຈາກໄຟລ໌

ລະຫັດ

ລາຍລະອຽດ

1025

ວັດຖຸເຊື່ອມຕໍ່

1026

Macros ແລະລະຫັດ

1034

Hyperlinks ທີ່ລະອຽດອ່ອນ

1137

PDF GoToR ປະຕິບັດ

1139

ການປະຕິບັດການເປີດຕົວ PDF

1141

PDF URI ປະຕິບັດ

1142

ຄຳສັ່ງສຽງ PDF

1143

ການປະຕິບັດຮູບເງົາ PDF

1150

ການປະຕິບັດ JavaScript ຂອງ PDF

1151

PDF ສົ່ງແບບຟອມປະຕິບັດ

1018

ການສອບຖາມຖານຂໍ້ມູນ

1019

ວັດຖຸຝັງ

1021

ບັນທຶກຂໍ້ມູນໄວ

1017

ຄຸນສົມບັດແບບກຳນົດເອງ

1036

ຄຸນສົມບັດສະຖິຕິ

1037

ສັງລວມຄຸນສົມບັດ

ເພື່ອດາວໂຫລດສໍາເນົາທີ່ສະອາດ, ທ່ານຍັງຈະຕ້ອງເຮັດຄໍາຮ້ອງຂໍການສອບຖາມ (ເຊິ່ງຈະຖືກປຶກສາຫາລືຂ້າງລຸ່ມນີ້) ຫຼັງຈາກສອງສາມວິນາທີ, ລະບຸຈໍານວນ hash ຂອງໄຟລ໌ແລະອົງປະກອບການສະກັດຢູ່ໃນຂໍ້ຄວາມຄໍາຮ້ອງຂໍ. ທ່ານສາມາດເລືອກເອົາໄຟລ໌ທີ່ຖືກອະນາໄມໂດຍໃຊ້ id ຈາກການຕອບສະຫນອງຕໍ່ການສອບຖາມ - extracted_file_download_id . ອີກເທື່ອຫນຶ່ງ, ຊອກຫາລ່ວງຫນ້າເລັກນ້ອຍ, ຂ້າພະເຈົ້າໃຫ້ຕົວຢ່າງຂອງຄໍາຮ້ອງຂໍແລະການຕອບຄໍາຖາມເພື່ອຄົ້ນຫາ id ສໍາລັບການດາວໂຫຼດເອກະສານທີ່ຖືກລຶບລ້າງ.

ຄໍາຮ້ອງຂໍເພື່ອຄົ້ນຫາລະຫັດ extracted_file_download_id

{ "request":  [  

		{	
			"sha256": "9a346005ee8c9adb489072eb8b5b61699652962c17596de9c326ca68247a8876",
			"features": ["extraction"] , 
			"extraction": {
		        "method": "pdf"
            }
		}
	] 
}

ການ​ຕອບ​ສະ​ຫນອງ​ຕໍ່​ການ​ສອບ​ຖາມ (ເບິ່ງ​ສໍາ​ລັບ​ການ extracted_file_download_id key​)

{
    "response": [
        {
            "status": {
                "code": 1001,
                "label": "FOUND",
                "message": "The request has been fully answered."
            },
            "sha256": "9a346005ee8c9adb489072eb8b5b61699652962c17596de9c326ca68247a8876",
            "file_type": "",
            "file_name": "",
            "features": [
                "extraction"
            ],
            "extraction": {
                "method": "pdf",
                "extract_result": "CP_EXTRACT_RESULT_SUCCESS",
                "extracted_file_download_id": "b5f2b34e-3603-4627-9e0e-54665a531ab2",
                "output_file_name": "kp-20-xls.cleaned.xls.pdf",
                "time": "0.013",
                "extract_content": "Macros and Code",
                "extraction_data": {
                    "input_extension": "xls",
                    "input_real_extension": "xls",
                    "message": "OK",
                    "output_file_name": "kp-20-xls.cleaned.xls.pdf",
                    "protection_name": "Potential malicious content extracted",
                    "protection_type": "Conversion to PDF",
                    "protocol_version": "1.0",
                    "risk": 5.0,
                    "scrub_activity": "Active content was found - XLS file was converted to PDF",
                    "scrub_method": "Convert to PDF",
                    "scrub_result": 0.0,
                    "scrub_time": "0.013",
                    "scrubbed_content": "Macros and Code"
                },
                "tex_product": false,
                "status": {
                    "code": 1001,
                    "label": "FOUND",
                    "message": "The request has been fully answered."
                }
            }
        }
    ]
}

ຂໍ້ມູນທົ່ວໄປ

ໃນຫນຶ່ງການໂທ API, ທ່ານສາມາດສົ່ງພຽງແຕ່ຫນຶ່ງໄຟລ໌ສໍາລັບການຢັ້ງຢືນ.

ອົງປະກອບ av ບໍ່ຈໍາເປັນຕ້ອງມີສ່ວນເພີ່ມເຕີມທີ່ມີກະແຈ, ມັນພຽງພໍທີ່ຈະລະບຸມັນຢູ່ໃນວັດຈະນານຸກົມ ຄຸນ​ລັກ​ສະ​ນະ.

ການໂທ API Query

ວິ​ທີ​ການ​ນໍາ​ໃຊ້ -​ POST

ໂທ​ຫາ​ທີ່​ຢູ່ - https:///tecloud/api/v1/file/query

ກ່ອນທີ່ຈະສົ່ງໄຟລ໌ສໍາລັບການດາວໂຫຼດ (ການຮ້ອງຂໍການອັບໂຫລດ), ແນະນໍາໃຫ້ກວດເບິ່ງ cache sandbox (ຄໍາຮ້ອງຂໍການສອບຖາມ) ເພື່ອເພີ່ມປະສິດທິພາບການໂຫຼດໃນເຄື່ອງແມ່ຂ່າຍ API, ເນື່ອງຈາກວ່າເຄື່ອງແມ່ຂ່າຍ API ອາດຈະມີຂໍ້ມູນແລະຄໍາຕັດສິນຂອງໄຟລ໌ທີ່ດາວໂຫລດແລ້ວ. ການໂທປະກອບດ້ວຍສ່ວນຂໍ້ຄວາມເທົ່ານັ້ນ. ສ່ວນທີ່ຕ້ອງການຂອງການຮ້ອງຂໍແມ່ນຈໍານວນ sha1/sha256/md5 ຂອງໄຟລ໌. ໂດຍວິທີທາງການ, ທ່ານສາມາດໄດ້ຮັບມັນໃນການຕອບສະຫນອງຕໍ່ການຮ້ອງຂໍການອັບໂຫລດ.

ຕໍາ່ສຸດທີ່ຕ້ອງການສໍາລັບການສອບຖາມ

HTTP POST

https:///tecloud/api/v1/file/query

ສ່ວນຫົວ:

ການອະນຸຍາດ:

ຮ່າງກາຍ

{

"ຮ້ອງຂໍ": {

"sha256":

}

}

ຕົວຢ່າງຂອງການຕອບສະຫນອງຕໍ່ການຮ້ອງຂໍການອັບໂຫລດ, ບ່ອນທີ່ມີຈໍານວນ hash sha1/md5/sha256.

{
  "response": {
    "status": {
      "code": 1002,
      "label": "UPLOAD_SUCCESS",
      "message": "The file was uploaded successfully."
    },
    "sha1": "954b5a851993d49ef8b2412b44f213153bfbdb32",
    "md5": "ac29b7c26e7dcf6c6fdb13ac0efe98ec",
    "sha256": "313c0feb009356495b7f4a60e96737120beb30e1912c6d866218cee830aebd90",
    "file_type": "",
    "file_name": "kp-20-doc.doc",
    "features": [
      "te"
    ],
    "te": {
      "trust": 0,
      "images": [
        {
          "report": {
            "verdict": "unknown"
          },
          "status": "not_found",
          "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
          "revision": 1
        }
      ],
      "score": -2147483648,
      "status": {
        "code": 1002,
        "label": "UPLOAD_SUCCESS",
        "message": "The file was uploaded successfully."
      }
    }
  }
}

ຄໍາຮ້ອງຂໍການສອບຖາມ, ນອກເຫນືອໄປຈາກຈໍານວນ hash, ຄວນຈະເປັນຄືກັນກັບຄໍາຮ້ອງຂໍການອັບໂຫລດ (ຫຼືຖືກວາງແຜນໄວ້), ຫຼືແມ້ກະທັ້ງ "ແລ້ວ" (ມີຊ່ອງຂໍ້ມູນຫນ້ອຍລົງໃນຄໍາຮ້ອງຂໍການອັບໂຫລດ). ໃນກໍລະນີທີ່ຄໍາຮ້ອງຂໍການສອບຖາມມີຊ່ອງຂໍ້ມູນຫຼາຍກ່ວາຢູ່ໃນຄໍາຮ້ອງຂໍການອັບໂຫລດ, ທ່ານຈະບໍ່ໄດ້ຮັບຂໍ້ມູນທີ່ຈໍາເປັນທັງຫມົດໃນການຕອບສະຫນອງ.

ນີ້ແມ່ນຕົວຢ່າງຂອງການຕອບຄໍາຖາມທີ່ບໍ່ໄດ້ພົບເຫັນຂໍ້ມູນທີ່ຈໍາເປັນທັງຫມົດ

{
  "response": [
    {
      "status": {
        "code": 1006,
        "label": "PARTIALLY_FOUND",
        "message": "The request cannot be fully answered at this time."
      },
      "sha256": "313c0feb009356495b7f4a60e96737120beb30e1912c6d866218cee830aebd90",
      "file_type": "doc",
      "file_name": "",
      "features": [
        "te",
        "extraction"
      ],
      "te": {
        "trust": 10,
        "images": [
          {
            "report": {
              "verdict": "malicious",
              "pdf_report": "4e9cddaf-03a4-489f-aa03-3c18f8d57a52",
              "xml_report": "9c18018f-c761-4dea-9372-6a12fcb15170"
            },
            "status": "found",
            "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
            "revision": 1
          }
        ],
        "score": -2147483648,
        "combined_verdict": "malicious",
        "severity": 4,
        "confidence": 1,
        "status": {
          "code": 1001,
          "label": "FOUND",
          "message": "The request has been fully answered."
        }
      },
      "extraction": {
        "method": "pdf",
        "tex_product": false,
        "status": {
          "code": 1004,
          "label": "NOT_FOUND",
          "message": "Could not find the requested file. Please upload it."
        }
      }
    }
  ]
}

ເອົາໃຈໃສ່ກັບທົ່ງນາ ລະຫັດ и ປ້າຍ. ຊ່ອງຂໍ້ມູນເຫຼົ່ານີ້ປາກົດສາມເທື່ອໃນວັດຈະນານຸກົມສະຖານະ. ກ່ອນອື່ນພວກເຮົາເຫັນລະຫັດ “ລະຫັດ”: 1006 ແລະ “ປ້າຍກຳກັບ”: “PARTIALLY_FOUND”. ຕໍ່ໄປ, ກະແຈເຫຼົ່ານີ້ຖືກພົບເຫັນສໍາລັບແຕ່ລະອົງປະກອບທີ່ພວກເຮົາຮ້ອງຂໍ - te ແລະການສະກັດເອົາ. ແລະຖ້າສໍາລັບ te ມັນເປັນທີ່ຊັດເຈນວ່າຂໍ້ມູນໄດ້ຖືກພົບເຫັນ, ຫຼັງຈາກນັ້ນສໍາລັບການສະກັດເອົາບໍ່ມີຂໍ້ມູນ.

ນີ້ແມ່ນສິ່ງທີ່ການສອບຖາມເບິ່ງຄືກັບຕົວຢ່າງຂ້າງເທິງ

{ "request":  [  

		{	
			"sha256": {{sha256}},
			"features": ["te", "extraction"] , 
			"te": {
				"images": [
                    {
                        "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
                        "revision": 1
                    }
                ],
                "reports": [
                    "xml", "pdf"
                ]
            }
		}
	] 
}

ຖ້າທ່ານສົ່ງຄໍາຮ້ອງຂໍແບບສອບຖາມໂດຍບໍ່ມີອົງປະກອບການສະກັດເອົາ

{ "request":  [  

		{	
			"sha256": {{sha256}},
			"features": ["te"] , 
			"te": {
				"images": [
                    {
                        "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
                        "revision": 1
                    }
                ],
                "reports": [
                    "xml", "pdf"
                ]
            }
		}
	] 
}

ຈາກນັ້ນຄໍາຕອບຈະມີຂໍ້ມູນຄົບຖ້ວນ (“ລະຫັດ”: 1001, “ປ້າຍກຳກັບ”: “ພົບ”)

{
  "response": [
    {
      "status": {
        "code": 1001,
        "label": "FOUND",
        "message": "The request has been fully answered."
      },
      "sha256": "313c0feb009356495b7f4a60e96737120beb30e1912c6d866218cee830aebd90",
      "file_type": "doc",
      "file_name": "",
      "features": [
        "te"
      ],
      "te": {
        "trust": 10,
        "images": [
          {
            "report": {
              "verdict": "malicious",
              "pdf_report": "4e9cddaf-03a4-489f-aa03-3c18f8d57a52",
              "xml_report": "9c18018f-c761-4dea-9372-6a12fcb15170"
            },
            "status": "found",
            "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
            "revision": 1
          }
        ],
        "score": -2147483648,
        "combined_verdict": "malicious",
        "severity": 4,
        "confidence": 1,
        "status": {
          "code": 1001,
          "label": "FOUND",
          "message": "The request has been fully answered."
        }
      }
    }
  ]
}

ຖ້າບໍ່ມີຂໍ້ມູນຢູ່ໃນແຄດທັງຫມົດ, ຄໍາຕອບຈະເປັນ "ປ້າຍຊື່": "NOT_FOUND"

{
  "response": [
    {
      "status": {
        "code": 1004,
        "label": "NOT_FOUND",
        "message": "Could not find the requested file. Please upload it."
      },
      "sha256": "313c0feb009356495b7f4a60e96737120beb30e1912c6d866218cee830aebd91",
      "file_type": "",
      "file_name": "",
      "features": [
        "te"
      ],
      "te": {
        "trust": 0,
        "images": [
          {
            "report": {
              "verdict": "unknown"
            },
            "status": "not_found",
            "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
            "revision": 1
          }
        ],
        "score": -2147483648,
        "status": {
          "code": 1004,
          "label": "NOT_FOUND",
          "message": "Could not find the requested file. Please upload it."
        }
      }
    }
  ]
}

ໃນຫນຶ່ງການໂທ API, ທ່ານສາມາດສົ່ງຈໍານວນ hash ຫຼາຍໆຄັ້ງໃນເວລາດຽວກັນສໍາລັບການຢັ້ງຢືນ. ການຕອບສະ ໜອງ ຈະສົ່ງຄືນຂໍ້ມູນໃນຄໍາສັ່ງດຽວກັນກັບມັນຖືກສົ່ງໄປໃນຄໍາຮ້ອງຂໍ.

ຄໍາຖາມຕົວຢ່າງທີ່ມີຈໍານວນ sha256 ຫຼາຍ

{ "request":  [  

		{	
			"sha256": "b84531d3829bf6131655773a3863d6b16f6389b7f4036aef9b81c0cb60e7fd81"
        },
        		{	
			"sha256": "b84531d3829bf6131655773a3863d6b16f6389b7f4036aef9b81c0cb60e7fd82"
        }
	] 
}

ຕອບສະຫນອງຕໍ່ການສອບຖາມທີ່ມີຈໍານວນ sha256 ຫຼາຍ

{
  "response": [
    {
      "status": {
        "code": 1001,
        "label": "FOUND",
        "message": "The request has been fully answered."
      },
      "sha256": "b84531d3829bf6131655773a3863d6b16f6389b7f4036aef9b81c0cb60e7fd81",
      "file_type": "dll",
      "file_name": "",
      "features": [
        "te"
      ],
      "te": {
        "trust": 10,
        "images": [
          {
            "report": {
              "verdict": "malicious"
            },
            "status": "found",
            "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
            "revision": 1
          }
        ],
        "score": -2147483648,
        "combined_verdict": "malicious",
        "severity": 4,
        "confidence": 3,
        "status": {
          "code": 1001,
          "label": "FOUND",
          "message": "The request has been fully answered."
        }
      }
    },
    {
      "status": {
        "code": 1004,
        "label": "NOT_FOUND",
        "message": "Could not find the requested file. Please upload it."
      },
      "sha256": "b84531d3829bf6131655773a3863d6b16f6389b7f4036aef9b81c0cb60e7fd82",
      "file_type": "",
      "file_name": "",
      "features": [
        "te"
      ],
      "te": {
        "trust": 0,
        "images": [
          {
            "report": {
              "verdict": "unknown"
            },
            "status": "not_found",
            "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
            "revision": 1
          }
        ],
        "score": -2147483648,
        "status": {
          "code": 1004,
          "label": "NOT_FOUND",
          "message": "Could not find the requested file. Please upload it."
        }
      }
    }
  ]
}

ການຮ້ອງຂໍຈໍານວນ hash ຫຼາຍໆຄັ້ງໃນຄໍາຮ້ອງຂໍການສອບຖາມຍັງຈະມີຜົນກະທົບທີ່ເປັນປະໂຫຍດຕໍ່ການປະຕິບັດຂອງເຄື່ອງແມ່ຂ່າຍ API.

ດາວໂຫຼດ API ໂທ

ວິ​ທີ​ການ​ນໍາ​ໃຊ້ -​ POST (ອີງ​ຕາມ​ເອ​ກະ​ສານ​)​, GET ຍັງເຮັດວຽກ (ແລະອາດຈະເບິ່ງຄືວ່າມີເຫດຜົນຫຼາຍ)

ໂທ​ຫາ​ທີ່​ຢູ່ - https:///tecloud/api/v1/file/download?id=

header ຕ້ອງການລະຫັດ API ທີ່ຈະຜ່ານ, ເນື້ອໃນຂອງຄໍາຮ້ອງຂໍແມ່ນຫວ່າງເປົ່າ, id ການດາວໂຫຼດແມ່ນຜ່ານຢູ່ໃນທີ່ຢູ່ url.

ໃນການຕອບສະຫນອງຕໍ່ຄໍາຮ້ອງຂໍການສອບຖາມ, ຖ້າຫາກວ່າ emulation ສໍາເລັດແລະລາຍງານໄດ້ຖືກຮ້ອງຂໍໃນເວລາດາວໂຫຼດໄຟລ໌, id ສໍາລັບການດາວໂຫຼດບົດລາຍງານຈະເຫັນໄດ້. ຖ້າຕ້ອງການສໍາເນົາທີ່ສະອາດ, ທ່ານຄວນຊອກຫາ id ເພື່ອດາວໂຫລດເອກະສານທີ່ເຮັດຄວາມສະອາດ.

ໂດຍລວມແລ້ວ, ກະແຈໃນການຕອບຄໍາຖາມທີ່ປະກອບດ້ວຍຄ່າ id ສໍາລັບການໂຫຼດສາມາດເປັນ:

• summary_report

• full_report

• pdf_report

• xml_report

• extracted_file_download_id

ແນ່ນອນ, ເພື່ອໃຫ້ໄດ້ຮັບກະແຈເຫຼົ່ານີ້ເພື່ອຕອບສະຫນອງຄໍາຮ້ອງຂໍການສອບຖາມ, ພວກເຂົາຕ້ອງຖືກກໍານົດໄວ້ໃນຄໍາຮ້ອງຂໍ (ສໍາລັບບົດລາຍງານ) ຫຼືຈື່ຈໍາເຮັດຄໍາຮ້ອງຂໍໂດຍໃຊ້ຫນ້າທີ່ສະກັດເອົາ (ສໍາລັບເອກະສານທີ່ສະອາດ)

ການໂທ Quota API

ວິ​ທີ​ການ​ນໍາ​ໃຊ້ -​ POST

ໂທ​ຫາ​ທີ່​ຢູ່ - https:///tecloud/api/v1/file/quota

ເພື່ອກວດເບິ່ງໂຄຕ້າທີ່ຍັງເຫຼືອຢູ່ໃນຄລາວ, ໃຫ້ໃຊ້ຄິວຣີໂຄຕ້າ. ເນື້ອໃນການຮ້ອງຂໍແມ່ນຫວ່າງເປົ່າ.

ຕົວຢ່າງຄຳຕອບຕໍ່ກັບຄຳຮ້ອງຂໍໂຄຕ້າ

{
  "response": [
    {
      "remain_quota_hour": 1250,
      "remain_quota_month": 10000000,
      "assigned_quota_hour": 1250,
      "assigned_quota_month": 10000000,
      "hourly_quota_next_reset": "1599141600",
      "monthly_quota_next_reset": "1601510400",
      "quota_id": "TEST",
      "cloud_monthly_quota_period_start": "1421712300",
      "cloud_monthly_quota_usage_for_this_gw": 0,
      "cloud_hourly_quota_usage_for_this_gw": 0,
      "cloud_monthly_quota_usage_for_quota_id": 0,
      "cloud_hourly_quota_usage_for_quota_id": 0,
      "monthly_exceeded_quota": 0,
      "hourly_exceeded_quota": 0,
      "cloud_quota_max_allow_to_exceed_percentage": 1000,
      "pod_time_gmt": "1599138715",
      "quota_expiration": "0",
      "action": "ALLOW"
    }
  ]
}

API ປ້ອງກັນໄພຂົ່ມຂູ່ສຳລັບປະຕູຄວາມປອດໄພ

API ນີ້​ໄດ້​ຖືກ​ພັດ​ທະ​ນາ​ກ່ອນ​ທີ່​ຈະ API ການ​ປ້ອງ​ກັນ​ໄພ​ຂົ່ມ​ຂູ່​ແລະ​ມີ​ຈຸດ​ປະ​ສົງ​ສໍາ​ລັບ​ອຸ​ປະ​ກອນ​ທ້ອງ​ຖິ່ນ​ເທົ່າ​ນັ້ນ​. ສໍາລັບໃນປັດຈຸບັນມັນພຽງແຕ່ສາມາດເປັນປະໂຫຍດຖ້າຫາກວ່າທ່ານຕ້ອງການ API ການສະກັດໄພຂົ່ມຂູ່. ສໍາລັບການ Emulation ໄພຂົ່ມຂູ່ແມ່ນດີກວ່າທີ່ຈະໃຊ້ API ປ້ອງກັນໄພຂົ່ມຂູ່ປົກກະຕິ. ເພື່ອເປີດ TP API ສໍາລັບ SG ແລະຕັ້ງຄ່າລະຫັດ API ທີ່ທ່ານຕ້ອງການປະຕິບັດຕາມຂັ້ນຕອນຈາກ sk113599. ຂ້າພະເຈົ້າແນະນໍາໃຫ້ເອົາໃຈໃສ່ກັບຂັ້ນຕອນ 6b ແລະກວດເບິ່ງການເຂົ້າເຖິງຂອງຫນ້າ https://<IPAddressofSecurityGateway>/UserCheck/TPAPI ເນື່ອງຈາກວ່າໃນກໍລະນີຂອງຜົນໄດ້ຮັບທາງລົບ, ການຕັ້ງຄ່າເພີ່ມເຕີມບໍ່ມີຄວາມຫມາຍ. ການໂທ API ທັງໝົດຈະຖືກສົ່ງໄປຫາ url ນີ້. ປະເພດການໂທ (ອັບໂຫລດ/ສອບຖາມ) ແມ່ນຖືກຄວບຄຸມຢູ່ໃນປຸ່ມຕົວການໂທ − request_name. ກະແຈທີ່ຕ້ອງການຄືກັນ - api_key (ທ່ານຈໍາເປັນຕ້ອງຈື່ມັນໃນລະຫວ່າງຂະບວນການຕັ້ງຄ່າ) ແລະ protocol_version (ສະບັບປະຈຸບັນແມ່ນ 1.1). ທ່ານສາມາດຊອກຫາເອກະສານທີ່ເປັນທາງການສໍາລັບ API ນີ້ຢູ່ທີ່ sk137032. ຂໍ້ໄດ້ປຽບທີ່ກ່ຽວຂ້ອງລວມເຖິງຄວາມສາມາດໃນການສົ່ງໄຟລ໌ຫຼາຍຄັ້ງໃນເວລາດຽວກັນສໍາລັບການ emulation ເມື່ອໂຫລດພວກມັນ, ເພາະວ່າໄຟລ໌ຖືກສົ່ງເປັນຂໍ້ຄວາມ base64. ເພື່ອເຂົ້າລະຫັດ / ຖອດລະຫັດໄຟລ໌ໄປຫາ / ຈາກ base64 ທ່ານສາມາດນໍາໃຊ້ຕົວແປງອອນໄລນ໌ໃນ Postman ສໍາລັບຈຸດປະສົງການສາທິດ, ຕົວຢ່າງ - https://base64.guru. ສໍາລັບຈຸດປະສົງປະຕິບັດ, ທ່ານຄວນໃຊ້ວິທີການເຂົ້າລະຫັດແລະຖອດລະຫັດທີ່ສ້າງຂຶ້ນໃນເມື່ອຂຽນລະຫັດ.

ຕອນນີ້ໃຫ້ເຮົາມາເບິ່ງໜ້າທີ່ໃຫ້ລະອຽດ te и ການສະກັດເອົາ ໃນ API ນີ້.

ສໍາລັບອົງປະກອບ te ວັດຈະນານຸກົມສະຫນອງໃຫ້ te_options ໃນການຮ້ອງຂໍການອັບໂຫລດ/ການສອບຖາມ, ແລະກະແຈໃນຄຳຮ້ອງຂໍນີ້ແມ່ນກົງກັນກັບກະແຈ te ໃນ API ປ້ອງກັນໄພຂົ່ມຂູ່.

ການຮ້ອງຂໍຕົວຢ່າງສໍາລັບການ emulation ໄຟລ໌ໃນ Win10 ກັບບົດລາຍງານ

{
"request": [{
    "protocol_version": "1.1",
    "api_key": "<api_key>",
    "request_name": "UploadFile",
    "file_enc_data": "<base64_encoded_file>",
    "file_orig_name": "<filename>",
    "te_options": {
        "images": [
                {
                    "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
                    "revision": 1
                }
            ],
        "reports": ["summary", "xml"]
    }
    }
    ]
}

ສໍາລັບອົງປະກອບ ການສະກັດເອົາ ວັດຈະນານຸກົມສະຫນອງໃຫ້ scrub_options. ການຮ້ອງຂໍນີ້ລະບຸວິທີການທໍາຄວາມສະອາດ: ປ່ຽນເປັນ PDF, ລ້າງເນື້ອໃນທີ່ໃຊ້ວຽກ, ຫຼືເລືອກຮູບແບບທີ່ສອດຄ່ອງກັບໂປຣໄຟລ໌ການປ້ອງກັນໄພຂົ່ມຂູ່ (ຊື່ໂປຣໄຟລ໌ແມ່ນລະບຸໄວ້). ສິ່ງທີ່ດີກ່ຽວກັບການຕອບສະຫນອງຄໍາຮ້ອງຂໍ API ສະກັດສໍາລັບໄຟລ໌ແມ່ນທ່ານໄດ້ຮັບສໍາເນົາທີ່ສະອາດໃນການຕອບສະຫນອງຄໍາຮ້ອງຂໍນັ້ນເປັນສາຍເຂົ້າລະຫັດ base64 (ທ່ານບໍ່ຈໍາເປັນຕ້ອງເຮັດຄໍາຮ້ອງຂໍການສອບຖາມແລະຊອກຫາ id ເພື່ອດາວໂຫລດ. ເອກະສານ)

ຕົວຢ່າງຂອງຄໍາຮ້ອງຂໍລ້າງໄຟລ໌

    {
	"request": [{
		"protocol_version": "1.1",
		"api_key": "<API_KEY>",
		"request_name": "UploadFile",
		"file_enc_data": "<base64_encoded_file>",
		"file_orig_name": "hi.txt",
		"scrub_options": {
			"scrub_method": 2
		}
	}]
}

ຕອບ​ຄໍາ​ຮ້ອງ​ສະ​ຫມັກ​

{
	"response": [{
		"protocol_version": "1.1",
		"src_ip": "<IP_ADDRESS>",
		"scrub": {
			"file_enc_data": "<base64_encoded_converted_to_PDF_file>",
			"input_real_extension": "js",
			"message": "OK",
			"orig_file_url": "",
			"output_file_name": "hi.cleaned.pdf",
			"protection_name": "Extract potentially malicious content",
			"protection_type": "Conversion to PDF",
			"real_extension": "txt",
			"risk": 0,
			"scrub_activity": "TXT file was converted to PDF",
			"scrub_method": "Convert to PDF",
			"scrub_result": 0,
			"scrub_time": "0.011",
			"scrubbed_content": ""
		}
	}]
} 

ເຖິງວ່າຈະມີຄວາມຈິງທີ່ວ່າການຮ້ອງຂໍ API ຫນ້ອຍແມ່ນຕ້ອງການເພື່ອໃຫ້ໄດ້ສໍາເນົາທີ່ຖືກລຶບລ້າງ, ຂ້ອຍເຫັນວ່າທາງເລືອກນີ້ບໍ່ມັກແລະສະດວກກວ່າຄໍາຮ້ອງຂໍແບບຟອມຂໍ້ມູນທີ່ໃຊ້ໃນ. API ປ້ອງກັນໄພຂົ່ມຂູ່.

ຄໍເລັກຊັນນັກໄປສະນີ

ຂ້ອຍສ້າງຄໍເລັກຊັນໃນ Postman ສໍາລັບທັງ API ປ້ອງກັນໄພຂົ່ມຂູ່ ແລະ API ປ້ອງກັນໄພຂົ່ມຂູ່ສໍາລັບປະຕູຄວາມປອດໄພ, ເຊິ່ງເປັນຕົວແທນຂອງຄໍາຮ້ອງຂໍ API ທົ່ວໄປທີ່ສຸດ. ເພື່ອໃຫ້ server ip/url API ແລະ key ຈະຖືກປ່ຽນແທນໂດຍອັດຕະໂນມັດໃນຄໍາຮ້ອງຂໍ, ແລະຈໍານວນ sha256 hash ທີ່ຈະຈື່ໄວ້ຫຼັງຈາກການດາວໂຫລດໄຟລ໌, ສາມຕົວແປໄດ້ຖືກສ້າງຂື້ນພາຍໃນຄໍເລັກຊັນ (ທ່ານສາມາດຊອກຫາພວກມັນໄດ້ໂດຍການໄປທີ່ການຕັ້ງຄ່າການລວບລວມ. ແກ້ໄຂ -> ຕົວແປ): te_api (ຕ້ອງການ), api_key (ຕ້ອງຕື່ມໃສ່, ຍົກເວັ້ນເມື່ອໃຊ້ TP API ກັບອຸປະກອນທ້ອງຖິ່ນ), sha256 (ປ່ອຍໃຫ້ຫວ່າງ, ບໍ່ໄດ້ໃຊ້ໃນ TP API ສໍາລັບ SG).

ດາວໂຫລດຊຸດ Postman ສໍາລັບ API ປ້ອງກັນໄພຂົ່ມຂູ່

ດາວໂຫລດຊຸດ Postman ສໍາລັບການປ້ອງກັນໄພຂົ່ມຂູ່ສໍາລັບຄວາມປອດໄພ Gateway API

ຕົວຢ່າງການ ນຳ ໃຊ້

ຢູ່ໃນຊຸມຊົນ ກວດຫາຄູ່ scripts ລາຍລັກອັກສອນໃນ Python ໄດ້ຖືກນໍາສະເຫນີທີ່ກວດສອບໄຟລ໌ຈາກໄດເລກະທໍລີທີ່ຕ້ອງການໂດຍຜ່ານ TP API, ແລະ TP API ສໍາລັບ SG. ໂດຍຜ່ານການປະຕິສໍາພັນກັບ API ປ້ອງກັນໄພຂົ່ມຂູ່, ຄວາມສາມາດໃນການສະແກນໄຟລ໌ຂອງທ່ານໄດ້ຖືກຂະຫຍາຍຢ່າງຫຼວງຫຼາຍ, ນັບຕັ້ງແຕ່ຕອນນີ້ທ່ານສາມາດສະແກນໄຟລ໌ໃນຫຼາຍເວທີໃນເວລາດຽວກັນ (ກວດເບິ່ງໃນ VirusTotal API, ແລະຫຼັງຈາກນັ້ນຢູ່ໃນ checkpoint sandbox), ແລະໄດ້ຮັບໄຟລ໌ບໍ່ພຽງແຕ່ຈາກການຈະລາຈອນເຄືອຂ່າຍ, ແຕ່ຍັງເອົາພວກເຂົາຈາກໄດເຄືອຂ່າຍໃດໆແລະ, ຕົວຢ່າງເຊັ່ນ, ລະບົບ CRM.

ແຫຼ່ງຂໍ້ມູນ: www.habr.com