API വഴി ചെക്ക് പോയിന്റ് സാൻഡ്ബ്ലാസ്റ്റുമായുള്ള ഇടപെടൽ

സാങ്കേതികവിദ്യയെക്കുറിച്ച് പരിചയമുള്ളവർക്ക് ഈ ലേഖനം ഉപയോഗപ്രദമാകും പോയിന്റ് പരിശോധിക്കുക ഫയൽ എമുലേഷൻ വഴി (ഭീഷണി അനുകരണം) കൂടാതെ സജീവമായ ഫയൽ ക്ലീനിംഗ് (ഭീഷണി എക്സ്ട്രാക്ഷൻ) കൂടാതെ ഈ ടാസ്ക്കുകൾ ഓട്ടോമേറ്റ് ചെയ്യുന്നതിലേക്ക് ഒരു ചുവടുവെപ്പ് നടത്താൻ ആഗ്രഹിക്കുന്നു. ചെക്ക് പോയിന്റ് ഉണ്ട് ഭീഷണി തടയൽ API, ഇത് ക്ലൗഡിലും പ്രാദേശിക ഉപകരണങ്ങളിലും പ്രവർത്തിക്കുന്നു, കൂടാതെ പ്രവർത്തനപരമായി ഇത് വെബ്/എസ്എംടിപി/എഫ്ടിപി/എസ്എംബി/എൻഎഫ്എസ് ട്രാഫിക് സ്ട്രീമുകളിലെ ഫയലുകൾ പരിശോധിക്കുന്നതിന് സമാനമാണ്. ഈ ലേഖനം ഭാഗികമായി ഔദ്യോഗിക ഡോക്യുമെന്റേഷനിൽ നിന്നുള്ള ഒരു കൂട്ടം ലേഖനങ്ങളുടെ രചയിതാവിന്റെ വ്യാഖ്യാനമാണ്, എന്നാൽ എന്റെ സ്വന്തം പ്രവർത്തന അനുഭവത്തെയും എന്റെ സ്വന്തം ഉദാഹരണങ്ങളെയും അടിസ്ഥാനമാക്കിയുള്ളതാണ്. ത്രെറ്റ് പ്രിവൻഷൻ എപിഐയിൽ പ്രവർത്തിക്കുന്നതിനുള്ള രചയിതാവിന്റെ പോസ്റ്റ്മാൻ ശേഖരങ്ങളും ലേഖനത്തിൽ നിങ്ങൾ കണ്ടെത്തും.

അടിസ്ഥാന ചുരുക്കങ്ങൾ

ത്രെറ്റ് പ്രിവൻഷൻ API മൂന്ന് പ്രധാന ഘടകങ്ങളുമായി പ്രവർത്തിക്കുന്നു, അവ ഇനിപ്പറയുന്ന ടെക്സ്റ്റ് മൂല്യങ്ങളിലൂടെ API-യിൽ വിളിക്കുന്നു:

av - അറിയപ്പെടുന്ന ഭീഷണികളുടെ ഒപ്പ് വിശകലനത്തിന് ഉത്തരവാദിയായ ആന്റി-വൈറസ് ഘടകം.

te - ത്രെറ്റ് എമുലേഷൻ ഘടകം, സാൻഡ്‌ബോക്‌സിലെ ഫയലുകൾ പരിശോധിക്കുന്നതിനും എമുലേഷനുശേഷം ക്ഷുദ്രകരമായ/അനുയോജ്യമായ വിധി ഉണ്ടാക്കുന്നതിനും ഉത്തരവാദിത്തമുണ്ട്.

വേർതിരിച്ചെടുക്കൽ - ത്രെറ്റ് എക്‌സ്‌ട്രാക്ഷൻ ഘടകം, ഓഫീസ് ഡോക്യുമെന്റുകൾ വേഗത്തിൽ ഉപയോക്താക്കൾക്ക്/സിസ്റ്റമുകളിലേക്ക് എത്തിക്കുന്നതിന് (ക്ഷുദ്രകരമായ എല്ലാ ഉള്ളടക്കങ്ങളും നീക്കം ചെയ്യപ്പെടുന്ന) ഒരു സുരക്ഷിത രൂപത്തിലേക്ക് പരിവർത്തനം ചെയ്യുന്നതിനുള്ള ഉത്തരവാദിത്തമാണ്.

API ഘടനയും പ്രധാന പരിമിതികളും

ത്രെറ്റ് പ്രിവൻഷൻ API 4 അഭ്യർത്ഥനകൾ മാത്രം ഉപയോഗിക്കുന്നു - അപ്‌ലോഡ് ചെയ്യുക, അന്വേഷിക്കുക, ഡൗൺലോഡ് ചെയ്യുക, ക്വാട്ട. നാല് അഭ്യർത്ഥനകൾക്കുമുള്ള തലക്കെട്ടിൽ നിങ്ങൾ പാരാമീറ്റർ ഉപയോഗിച്ച് API കീ നൽകേണ്ടതുണ്ട് അംഗീകാരം. ഒറ്റനോട്ടത്തിൽ, ഘടന ഉള്ളതിനേക്കാൾ വളരെ ലളിതമായി തോന്നാം മാനേജ്മെന്റ് API, എന്നാൽ അപ്‌ലോഡ്, അന്വേഷണ അഭ്യർത്ഥനകളിലെ ഫീൽഡുകളുടെ എണ്ണവും ഈ അഭ്യർത്ഥനകളുടെ ഘടനയും വളരെ സങ്കീർണ്ണമാണ്. ഒരു ഗേറ്റ്‌വേ/സാൻഡ്‌ബോക്‌സ് സുരക്ഷാ നയത്തിലെ ത്രെറ്റ് പ്രിവൻഷൻ പ്രൊഫൈലുകളുമായി ഇവയെ പ്രവർത്തനപരമായി താരതമ്യം ചെയ്യാം.

ഇപ്പോൾ, ത്രെറ്റ് പ്രിവൻഷൻ API-യുടെ ഒരേയൊരു പതിപ്പ് പുറത്തിറങ്ങി - 1.0; API കോളുകൾക്കുള്ള URL ഉൾപ്പെടുത്തിയിരിക്കണം v1 നിങ്ങൾ പതിപ്പ് വ്യക്തമാക്കേണ്ട ഭാഗത്ത്. മാനേജ്മെന്റ് API-യിൽ നിന്ന് വ്യത്യസ്തമായി, URL-ൽ API പതിപ്പ് സൂചിപ്പിക്കേണ്ടത് ആവശ്യമാണ്, അല്ലാത്തപക്ഷം അഭ്യർത്ഥന നടപ്പിലാക്കില്ല.

ആന്റി-വൈറസ് ഘടകം, മറ്റ് ഘടകങ്ങൾ (te, എക്സ്ട്രാക്ഷൻ) ഇല്ലാതെ വിളിക്കുമ്പോൾ, നിലവിൽ md5 ഹാഷ് തുകകളുള്ള അന്വേഷണ അഭ്യർത്ഥനകളെ മാത്രമേ പിന്തുണയ്ക്കൂ. ത്രെറ്റ് എമുലേഷനും ത്രെറ്റ് എക്‌സ്‌ട്രാക്ഷനും sha1, sha256 എന്നീ ഹാഷ് തുകകളെ പിന്തുണയ്ക്കുന്നു.

ചോദ്യങ്ങളിൽ തെറ്റുകൾ വരുത്താതിരിക്കുക എന്നത് വളരെ പ്രധാനമാണ്! അഭ്യർത്ഥന പിശകില്ലാതെ നടപ്പിലാക്കാൻ കഴിയും, പക്ഷേ പൂർണ്ണമായും അല്ല. കുറച്ച് മുന്നോട്ട് നോക്കുമ്പോൾ, ചോദ്യങ്ങളിൽ പിശകുകൾ/അക്ഷരത്തെറ്റുകൾ ഉണ്ടാകുമ്പോൾ എന്ത് സംഭവിക്കുമെന്ന് നോക്കാം.

റിപ്പോർട്ടുകൾ (റിപ്പോർട്ട്) എന്ന വാക്ക് ഉപയോഗിച്ച് അക്ഷരത്തെറ്റ് ഉപയോഗിച്ച് അഭ്യർത്ഥിക്കുക

{ "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."
        }
      }
    }
  ]
}

എന്നാൽ റിപ്പോർട്ടുകൾ കീയിൽ അക്ഷരത്തെറ്റില്ലാതെ ഒരു അഭ്യർത്ഥനയ്ക്കായി

{ "request":  [  

		{	
			"sha256": {{sha256}},
			"features": ["te"] , 
			"te": {
				"images": [
                    {
                        "id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
                        "revision": 1
                    }
                ],
                reports: ["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",
              "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 അഭ്യർത്ഥനകൾ അയയ്‌ക്കാൻ കഴിയും. അഭ്യർത്ഥനകൾക്കുള്ള വിലാസമെന്ന നിലയിൽ, നിങ്ങൾ ഉപകരണത്തിന്റെ ip/url ഉം പോർട്ട് 18194 ഉം ഉപയോഗിക്കേണ്ടതുണ്ട് (ഉദാഹരണത്തിന്, https://10.10.57.19:18194/tecloud/api/v1/file/query). ഉപകരണത്തിലെ സുരക്ഷാ നയം അത്തരമൊരു കണക്ഷൻ അനുവദിക്കുന്നുണ്ടെന്ന് ഉറപ്പാക്കുകയും വേണം. സ്ഥിരസ്ഥിതിയായി പ്രാദേശിക ഉപകരണങ്ങളിൽ API കീ വഴിയുള്ള അംഗീകാരം ഓഫ് കൂടാതെ അഭ്യർത്ഥന തലക്കെട്ടുകളിലെ അംഗീകാര കീ അയയ്‌ക്കാനിടയില്ല.

ചെക്ക്‌പോയിന്റ് ക്ലൗഡിലേക്കുള്ള API അഭ്യർത്ഥനകൾ അയയ്‌ക്കണം te.checkpoint.com (ഉദാഹരണത്തിന് - https://te.checkpoint.com/tecloud/api/v1/file/query). ചെക്ക് പോയിന്റ് പങ്കാളികളുമായോ കമ്പനിയുടെ പ്രാദേശിക ഓഫീസുമായോ ബന്ധപ്പെടുന്നതിലൂടെ API കീ 60 ദിവസത്തേക്ക് ട്രയൽ ലൈസൻസായി ലഭിക്കും.

പ്രാദേശിക ഉപകരണങ്ങളിൽ, ത്രെറ്റ് എക്‌സ്‌ട്രാക്ഷൻ സ്റ്റാൻഡേർഡായി ഇതുവരെ പിന്തുണയ്‌ക്കുന്നില്ല. ഭീഷണി തടയൽ API ഉപയോഗിക്കുകയും വേണം സുരക്ഷാ ഗേറ്റ്‌വേയ്‌ക്കായുള്ള ഭീഷണി തടയൽ API (ലേഖനത്തിന്റെ അവസാനം ഞങ്ങൾ അതിനെക്കുറിച്ച് കൂടുതൽ വിശദമായി സംസാരിക്കും).

പ്രാദേശിക ഉപകരണങ്ങൾ ക്വാട്ട അഭ്യർത്ഥനയെ പിന്തുണയ്ക്കുന്നില്ല.

അല്ലെങ്കിൽ, പ്രാദേശിക ഉപകരണങ്ങളിലേക്കുള്ള അഭ്യർത്ഥനകളും ക്ലൗഡിലേക്കുള്ള അഭ്യർത്ഥനകളും തമ്മിൽ വ്യത്യാസമില്ല.

API കോൾ അപ്‌ലോഡ് ചെയ്യുക

ഉപയോഗിച്ച രീതി - പോസ്റ്റ്

കോൾ വിലാസം - https:///tecloud/api/v1/file/upload

അഭ്യർത്ഥനയിൽ രണ്ട് ഭാഗങ്ങൾ അടങ്ങിയിരിക്കുന്നു (ഫോം-ഡാറ്റ): എമുലേഷൻ/ക്ലീനിംഗിനായി ഉദ്ദേശിച്ചിട്ടുള്ള ഒരു ഫയലും ടെക്‌സ്‌റ്റ് ഉള്ള ഒരു റിക്വസ്റ്റ് ബോഡിയും.

ടെക്‌സ്‌റ്റ് അഭ്യർത്ഥന ശൂന്യമായിരിക്കരുത്, പക്ഷേ അതിൽ കോൺഫിഗറേഷനൊന്നും അടങ്ങിയിരിക്കണമെന്നില്ല. അഭ്യർത്ഥന വിജയിക്കുന്നതിന്, അഭ്യർത്ഥനയിൽ നിങ്ങൾ ഇനിപ്പറയുന്ന വാചകമെങ്കിലും അയയ്ക്കണം:

ഒരു അപ്‌ലോഡ് അഭ്യർത്ഥനയ്ക്ക് ആവശ്യമായ ഏറ്റവും കുറഞ്ഞത്

HTTP പോസ്റ്റ്

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

തലക്കെട്ടുകൾ:

അംഗീകാരം:

ശരീരം

{

"അഭ്യർത്ഥന": {

}

}

ഫയല്

ഫയല്

ഈ സാഹചര്യത്തിൽ, സ്ഥിരസ്ഥിതി പാരാമീറ്ററുകൾക്ക് അനുസൃതമായി ഫയൽ പ്രോസസ്സ് ചെയ്യും: ഘടകം - te, OS ചിത്രങ്ങൾ - വിൻ എക്സ്പി, വിൻ 7, ഒരു റിപ്പോർട്ട് സൃഷ്ടിക്കാതെ.

ടെക്സ്റ്റ് അഭ്യർത്ഥനയിലെ പ്രധാന ഫീൽഡുകളെക്കുറിച്ചുള്ള അഭിപ്രായങ്ങൾ:

ഫയലിന്റെ പേര് и ഫയൽ_തരം ഒരു ഫയൽ അപ്‌ലോഡ് ചെയ്യുമ്പോൾ ഇത് പ്രത്യേകിച്ച് ഉപയോഗപ്രദമായ വിവരങ്ങളല്ലാത്തതിനാൽ നിങ്ങൾക്ക് അവ ശൂന്യമായി വിടുകയോ അയയ്‌ക്കുകയോ ചെയ്യാം. API പ്രതികരണത്തിൽ, ഡൗൺലോഡ് ചെയ്‌ത ഫയലിന്റെ പേരിനെ അടിസ്ഥാനമാക്കി ഈ ഫീൽഡുകൾ സ്വയമേവ പൂരിപ്പിക്കും, കൂടാതെ കാഷെയിലെ വിവരങ്ങൾ md5/sha1/sha256 ഹാഷ് തുകകൾ ഉപയോഗിച്ച് തിരയേണ്ടതുണ്ട്.

ശൂന്യമായ file_name, file_type എന്നിവയുള്ള ഉദാഹരണ അഭ്യർത്ഥന

{

"request": {

"file_name": "",

"file_type": "",

}

}

സവിശേഷതകൾ — സാൻഡ്ബോക്സിൽ പ്രോസസ്സ് ചെയ്യുമ്പോൾ ആവശ്യമായ പ്രവർത്തനക്ഷമത സൂചിപ്പിക്കുന്ന ഒരു ലിസ്റ്റ് - av (ആന്റി വൈറസ്), te (ഭീഷണി എമുലേഷൻ), എക്സ്ട്രാക്ഷൻ (ഭീഷണി എക്സ്ട്രാക്ഷൻ). ഈ പരാമീറ്റർ പാസ്സാക്കിയില്ലെങ്കിൽ, സ്ഥിരസ്ഥിതി ഘടകം മാത്രമേ ഉപയോഗിക്കൂ - te (ഭീഷണി എമുലേഷൻ).

ലഭ്യമായ മൂന്ന് ഘടകങ്ങളിൽ പരിശോധന പ്രവർത്തനക്ഷമമാക്കുന്നതിന്, API അഭ്യർത്ഥനയിൽ നിങ്ങൾ ഈ ഘടകങ്ങൾ വ്യക്തമാക്കേണ്ടതുണ്ട്.

av, te, എക്‌സ്‌ട്രാക്‌ഷൻ എന്നിവ പരിശോധിക്കുന്നതിനുള്ള ഒരു അഭ്യർത്ഥനയുടെ ഉദാഹരണം

{ "request":  [  

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

TE വിഭാഗത്തിലെ കീകൾ

ചിത്രങ്ങൾ — പരിശോധന നടത്തുന്ന ഓപ്പറേറ്റിംഗ് സിസ്റ്റങ്ങളുടെ ഐഡിയും റിവിഷൻ നമ്പറും ഉള്ള നിഘണ്ടുക്കൾ അടങ്ങിയ ഒരു ലിസ്റ്റ്. ഐഡികളും റിവിഷൻ നമ്പറുകളും എല്ലാ പ്രാദേശിക ഉപകരണങ്ങൾക്കും ക്ലൗഡിനും ഒരുപോലെയാണ്.

ഓപ്പറേറ്റിംഗ് സിസ്റ്റങ്ങളുടെയും പുനരവലോകനങ്ങളുടെയും പട്ടിക

OS ഇമേജ് ഐഡി ലഭ്യമാണ്

പുനരവലോകനം

ഇമേജ് ഒഎസും ആപ്ലിക്കേഷനും

e50e99f3-5963-4573-af9e-e3f4750b55e2

1

മൈക്രോസോഫ്റ്റ് വിൻഡോസ്: XP - 32bit SP3
ഓഫീസ്: 2003, 2007
അഡോബ് അക്രോബാറ്റ് റീഡർ: 9.0
ഫ്ലാഷ് പ്ലെയർ 9r115 ഒപ്പം ActiveX 10.0
ജാവ റൺടൈം: ക്സനുമ്ക്സുക്സനുമ്ക്സ

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

1

മൈക്രോസോഫ്റ്റ് വിൻഡോസ്: 7 - 32ബിറ്റ്
ഓഫീസ്: 2003, 2007
അഡോബ് അക്രോബാറ്റ് റീഡർ: 9.0
ഫ്ലാഷ് പ്ലെയർ: 10.2r152 (പ്ലഗിൻ& ActiveX)
ജാവ റൺടൈം: ക്സനുമ്ക്സുക്സനുമ്ക്സ

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

1

മൈക്രോസോഫ്റ്റ് വിൻഡോസ്: 7 - 32ബിറ്റ്
ഓഫീസ്: 2010
അഡോബ് അക്രോബാറ്റ് റീഡർ: 9.4
ഫ്ലാഷ് പ്ലെയർ: 11.0.1.152 (പ്ലഗിൻ & ActiveX)
ജാവ റൺടൈം: ക്സനുമ്ക്സുക്സനുമ്ക്സ

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

1

മൈക്രോസോഫ്റ്റ് വിൻഡോസ്: 7 - 32ബിറ്റ്
ഓഫീസ്: 2013
അഡോബ് അക്രോബാറ്റ് റീഡർ: 11.0
ഫ്ലാഷ് പ്ലെയർ: 15 (പ്ലഗിൻ & ActiveX)
ജാവ റൺടൈം: ക്സനുമ്ക്സുക്സനുമ്ക്സ

3ff3ddae-e7fd-4969-818c-d5f1a2be336d

1

മൈക്രോസോഫ്റ്റ് വിൻഡോസ്: 7 - 64ബിറ്റ്
ഓഫീസ്: 2013 (32ബിറ്റ്)
അഡോബ് അക്രോബാറ്റ് റീഡർ: 11.0.01
ഫ്ലാഷ് പ്ലെയർ: 13 (പ്ലഗിൻ & ActiveX)
ജാവ റൺടൈം: ക്സനുമ്ക്സുക്സനുമ്ക്സ

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

 

1 

മൈക്രോസോഫ്റ്റ് വിൻഡോസ്: 8.1 - 64ബിറ്റ്
ഓഫീസ്: 2013 (64ബിറ്റ്)
അഡോബ് അക്രോബാറ്റ് റീഡർ: 11.0.10
ഫ്ലാഷ് പ്ലെയർ: 18.0.0.160 (പ്ലഗിൻ & ActiveX)
ജാവ റൺടൈം: ക്സനുമ്ക്സുക്സനുമ്ക്സ

10b4a9c6-e414-425c-ae8b-fe4dd7b25244 

 

1

മൈക്രോസോഫ്റ്റ് വിൻഡോസ്: 10
ഓഫീസ്: പ്രൊഫഷണൽ പ്ലസ് 2016 en-us  
അഡോബ് അക്രോബാറ്റ് റീഡർ: DC 2015 MUI
ഫ്ലാഷ് പ്ലെയർ: 20 (പ്ലഗിൻ & ActiveX)
ജാവ റൺടൈം: ക്സനുമ്ക്സുക്സനുമ്ക്സ

ഇമേജുകളുടെ കീ പൂർണ്ണമായും വ്യക്തമാക്കിയിട്ടില്ലെങ്കിൽ, ചെക്ക് പോയിന്റ് ശുപാർശ ചെയ്യുന്ന ചിത്രങ്ങളിൽ അനുകരണം നടക്കും (നിലവിൽ Win XP, Win 7). പ്രകടനത്തിന്റെ മികച്ച ബാലൻസും ക്യാച്ച് റേറ്റും പരിഗണിച്ച് ഈ ചിത്രങ്ങൾ ശുപാർശ ചെയ്യുന്നു.

റിപ്പോർട്ടുകൾ — ഫയൽ ക്ഷുദ്രകരമാണെന്ന് തെളിഞ്ഞാൽ ഞങ്ങൾ അഭ്യർത്ഥിക്കുന്ന റിപ്പോർട്ടുകളുടെ ഒരു ലിസ്റ്റ്. ഇനിപ്പറയുന്ന ഓപ്ഷനുകൾ ലഭ്യമാണ്:

1. സംഗ്രഹം - .tar.gz ആർക്കൈവ് എമുലേഷനെക്കുറിച്ചുള്ള ഒരു റിപ്പോർട്ട് അടങ്ങിയതാണ് എല്ലാവർക്കും അഭ്യർത്ഥിച്ച ചിത്രങ്ങൾ (ഒരു html പേജും എമുലേറ്റർ OS-ൽ നിന്നുള്ള വീഡിയോ, ഒരു നെറ്റ്‌വർക്ക് ട്രാഫിക് ഡംപ്, json-ലെ ഒരു റിപ്പോർട്ട്, കൂടാതെ പാസ്‌വേഡ്-പരിരക്ഷിത ആർക്കൈവിലെ സാമ്പിൾ എന്നിവ പോലുള്ള ഘടകങ്ങളും). ഉത്തരത്തിലെ താക്കോൽ ഞങ്ങൾ തിരയുകയാണ് - സംഗ്രഹ_റിപ്പോർട്ട് റിപ്പോർട്ടിന്റെ തുടർന്നുള്ള ഡൗൺലോഡിനായി.

2. PDF - അനുകരണത്തെക്കുറിച്ചുള്ള പ്രമാണം ഒന്ന് സ്മാർട്ട് കൺസോൾ വഴി സ്വീകരിക്കാൻ പലരും ശീലിച്ച ചിത്രം. ഉത്തരത്തിലെ താക്കോൽ ഞങ്ങൾ തിരയുകയാണ് - pdf_report റിപ്പോർട്ടിന്റെ തുടർന്നുള്ള ഡൗൺലോഡിനായി.

3. XML - അനുകരണത്തെക്കുറിച്ചുള്ള പ്രമാണം ഒന്ന് ഇമേജ്, റിപ്പോർട്ടിലെ പാരാമീറ്ററുകളുടെ തുടർന്നുള്ള പാഴ്‌സിംഗിന് സൗകര്യപ്രദമാണ്. ഉത്തരത്തിലെ താക്കോൽ ഞങ്ങൾ തിരയുകയാണ് - xml_report റിപ്പോർട്ടിന്റെ തുടർന്നുള്ള ഡൗൺലോഡിനായി.

4. ടാർ - .tar.gz ആർക്കൈവിൽ അനുകരണത്തെക്കുറിച്ചുള്ള ഒരു റിപ്പോർട്ട് അടങ്ങിയിരിക്കുന്നു ഒന്ന് അഭ്യർത്ഥിച്ച ചിത്രങ്ങൾ (ഒരു html പേജും എമുലേറ്റർ OS-ൽ നിന്നുള്ള വീഡിയോ, ഒരു നെറ്റ്‌വർക്ക് ട്രാഫിക് ഡംപ്, json-ലെ ഒരു റിപ്പോർട്ട്, കൂടാതെ പാസ്‌വേഡ്-പരിരക്ഷിത ആർക്കൈവിലെ സാമ്പിൾ എന്നിവ പോലുള്ള ഘടകങ്ങളും). ഉത്തരത്തിലെ താക്കോൽ ഞങ്ങൾ തിരയുകയാണ് - പൂർണ്ണ_റിപ്പോർട്ട് റിപ്പോർട്ടിന്റെ തുടർന്നുള്ള ഡൗൺലോഡിനായി.

സംഗ്രഹ റിപ്പോർട്ടിനുള്ളിൽ എന്താണ് ഉള്ളത്

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."
        }
      }
    }
  ]
}

എന്നാൽ സംഗ്രഹ_റിപ്പോർട്ട് കീ - പൊതുവായി അനുകരണത്തിന് ഒരെണ്ണം ഉണ്ട്

{
  "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 റിപ്പോർട്ടുകൾ അഭ്യർത്ഥിക്കാം, നിങ്ങൾക്ക് സംഗ്രഹവും ടാറും xml ഉം അഭ്യർത്ഥിക്കാം. ഒരു സംഗ്രഹ റിപ്പോർട്ടും പിഡിഎഫും ഒരേ സമയം അഭ്യർത്ഥിക്കാൻ കഴിയില്ല.

എക്സ്ട്രാക്ഷൻ വിഭാഗത്തിലെ കീകൾ

ഭീഷണി വേർതിരിച്ചെടുക്കാൻ, രണ്ട് കീകൾ മാത്രമേ ഉപയോഗിക്കുന്നുള്ളൂ:

രീതി - പിഡിഎഫ് (പിഡിഎഫിലേക്ക് പരിവർത്തനം ചെയ്യുക, സ്ഥിരസ്ഥിതിയായി ഉപയോഗിക്കുന്നു) അല്ലെങ്കിൽ വൃത്തിയാക്കുക (സജീവമായ ഉള്ളടക്കം വൃത്തിയാക്കുന്നു).

extracted_parts_codes - സജീവമായ ഉള്ളടക്കം നീക്കം ചെയ്യുന്നതിനുള്ള കോഡുകളുടെ ലിസ്റ്റ്, ക്ലീൻ രീതിക്ക് മാത്രം ബാധകമാണ്

ഫയലുകളിൽ നിന്ന് ഉള്ളടക്കം നീക്കം ചെയ്യുന്നതിനുള്ള കോഡുകൾ

കോഡ്

വിവരണം

1025

ബന്ധിപ്പിച്ച വസ്തുക്കൾ

1026

മാക്രോകളും കോഡും

1034

സെൻസിറ്റീവ് ഹൈപ്പർലിങ്കുകൾ

1137

PDF GoToR പ്രവർത്തനങ്ങൾ

1139

PDF ലോഞ്ച് പ്രവർത്തനങ്ങൾ

1141

PDF URI പ്രവർത്തനങ്ങൾ

1142

PDF ശബ്ദ പ്രവർത്തനങ്ങൾ

1143

PDF മൂവി പ്രവർത്തനങ്ങൾ

1150

PDF ജാവാസ്ക്രിപ്റ്റ് പ്രവർത്തനങ്ങൾ

1151

PDF ഫോം പ്രവർത്തനങ്ങൾ സമർപ്പിക്കുക

1018

ഡാറ്റാബേസ് അന്വേഷണങ്ങൾ

1019

ഉൾച്ചേർത്ത വസ്തുക്കൾ

1021

ഡാറ്റ വേഗത്തിൽ സംരക്ഷിക്കുക

1017

കസ്റ്റം പ്രോപ്പർട്ടികൾ

1036

സ്റ്റാറ്റിസ്റ്റിക് പ്രോപ്പർട്ടികൾ

1037

സംഗ്രഹ പ്രോപ്പർട്ടികൾ

വൃത്തിയാക്കിയ ഒരു പകർപ്പ് ഡൗൺലോഡ് ചെയ്യുന്നതിന്, ഫയലിന്റെ ഹാഷ് തുകയും അഭ്യർത്ഥന വാചകത്തിലെ എക്‌സ്‌ട്രാക്ഷൻ ഘടകവും വ്യക്തമാക്കിക്കൊണ്ട് കുറച്ച് നിമിഷങ്ങൾക്ക് ശേഷം നിങ്ങൾ ഒരു അന്വേഷണ അഭ്യർത്ഥന നടത്തേണ്ടതുണ്ട് (അത് ചുവടെ ചർച്ചചെയ്യും). എക്‌സ്‌ട്രാക്‌റ്റഡ്_file_download_id എന്ന ചോദ്യത്തിനുള്ള പ്രതികരണത്തിൽ നിന്ന് ഐഡി ഉപയോഗിച്ച് വൃത്തിയാക്കിയ ഫയൽ നിങ്ങൾക്ക് എടുക്കാം. ഒരിക്കൽ കൂടി, അൽപ്പം മുന്നോട്ട് നോക്കുമ്പോൾ, മായ്‌ച്ച ഒരു ഡോക്യുമെന്റ് ഡൗൺലോഡ് ചെയ്യുന്നതിനുള്ള ഐഡി തിരയുന്നതിനുള്ള ഒരു അഭ്യർത്ഥനയുടെയും ചോദ്യ പ്രതികരണത്തിന്റെയും ഉദാഹരണങ്ങൾ ഞാൻ നൽകുന്നു.

Extracted_file_download_id കീ തിരയാനുള്ള അന്വേഷണ അഭ്യർത്ഥന

{ "request":  [  

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

ചോദ്യത്തിനുള്ള പ്രതികരണം (extracted_file_download_id കീ തിരയുക)

{
    "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 കോൾ

ഉപയോഗിച്ച രീതി - പോസ്റ്റ്

കോൾ വിലാസം - https:///tecloud/api/v1/file/query

ഡൗൺലോഡ് ചെയ്യുന്നതിനായി (അപ്‌ലോഡ് അഭ്യർത്ഥന) ഒരു ഫയൽ അയയ്‌ക്കുന്നതിന് മുമ്പ്, API സെർവറിലെ ലോഡ് ഒപ്റ്റിമൈസ് ചെയ്യുന്നതിനായി സാൻഡ്‌ബോക്‌സ് കാഷെ (അന്വേഷണ അഭ്യർത്ഥന) പരിശോധിക്കുന്നത് നല്ലതാണ്, കാരണം API സെർവറിന് ഇതിനകം തന്നെ ഡൗൺലോഡ് ചെയ്‌ത ഫയലിൽ വിവരങ്ങളും വിധിയും ഉണ്ടായിരിക്കാം. കോളിൽ ഒരു ടെക്സ്റ്റ് ഭാഗം മാത്രമേ അടങ്ങിയിട്ടുള്ളൂ. അഭ്യർത്ഥനയുടെ ആവശ്യമായ ഭാഗം ഫയലിന്റെ sha1/sha256/md5 ഹാഷ് തുകയാണ്. വഴിയിൽ, അപ്‌ലോഡ് അഭ്യർത്ഥനയ്ക്കുള്ള പ്രതികരണത്തിൽ നിങ്ങൾക്കത് ലഭിക്കും.

അന്വേഷണത്തിന് ആവശ്യമായ ഏറ്റവും കുറഞ്ഞത്

HTTP പോസ്റ്റ്

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

തലക്കെട്ടുകൾ:

അംഗീകാരം:

ശരീരം

{

"അഭ്യർത്ഥന": {

"sha256":

}

}

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."
      }
    }
  }
}

ചോദ്യ അഭ്യർത്ഥന, ഹാഷ് തുകയ്‌ക്ക് പുറമേ, അപ്‌ലോഡ് അഭ്യർത്ഥനയ്ക്ക് സമാനമായിരിക്കണം (അല്ലെങ്കിൽ ആസൂത്രണം ചെയ്തിട്ടുണ്ട്), അല്ലെങ്കിൽ "ഇതിനകം" (അപ്‌ലോഡ് അഭ്യർത്ഥനയിൽ ഉള്ളതിനേക്കാൾ കുറച്ച് ഫീൽഡുകൾ അന്വേഷണ അഭ്യർത്ഥനയിൽ അടങ്ങിയിരിക്കുന്നു). അപ്‌ലോഡ് അഭ്യർത്ഥനയിൽ ഉണ്ടായിരുന്നതിനേക്കാൾ കൂടുതൽ ഫീൽഡുകൾ അന്വേഷണ അഭ്യർത്ഥനയിൽ അടങ്ങിയിരിക്കുന്ന സാഹചര്യത്തിൽ, പ്രതികരണത്തിൽ ആവശ്യമായ എല്ലാ വിവരങ്ങളും നിങ്ങൾക്ക് ലഭിക്കില്ല.

ആവശ്യമായ എല്ലാ ഡാറ്റയും കണ്ടെത്താത്ത ഒരു ചോദ്യത്തിനുള്ള പ്രതികരണത്തിന്റെ ഒരു ഉദാഹരണം ഇതാ

{
  "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". അടുത്തതായി, ഞങ്ങൾ അഭ്യർത്ഥിച്ച ഓരോ വ്യക്തിഗത ഘടകത്തിനും ഈ കീകൾ കണ്ടെത്തി - ടെയും എക്‌സ്‌ട്രാക്‌ഷനും. കൂടാതെ, ഡാറ്റ കണ്ടെത്തിയതായി വ്യക്തമാണെങ്കിൽ, വേർതിരിച്ചെടുക്കുന്നതിന് ഒരു വിവരവുമില്ല.

മുകളിലുള്ള ഉദാഹരണത്തിനുള്ള ചോദ്യം ഇങ്ങനെയാണ്

{ "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 കോളിൽ, സ്ഥിരീകരണത്തിനായി നിങ്ങൾക്ക് ഒരേസമയം നിരവധി ഹാഷ് തുകകൾ അയയ്ക്കാനാകും. അഭ്യർത്ഥനയിൽ അയച്ച അതേ ക്രമത്തിൽ പ്രതികരണം ഡാറ്റ നൽകും.

നിരവധി 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."
        }
      }
    }
  ]
}

ഒരു അന്വേഷണ അഭ്യർത്ഥനയിൽ ഒരേസമയം നിരവധി ഹാഷ് തുകകൾ അഭ്യർത്ഥിക്കുന്നത് API സെർവറിന്റെ പ്രവർത്തനത്തെ ഗുണകരമായി ബാധിക്കും.

API കോൾ ഡൗൺലോഡ് ചെയ്യുക

ഉപയോഗിച്ച രീതി - പോസ്റ്റ് (ഡോക്യുമെന്റേഷൻ പ്രകാരം), നേടുക പ്രവർത്തിക്കുന്നു (കൂടുതൽ യുക്തിസഹമായി തോന്നാം)

കോൾ വിലാസം - https:///tecloud/api/v1/file/download?id=

തലക്കെട്ടിന് API കീ പാസ്സ് ചെയ്യേണ്ടതുണ്ട്, അഭ്യർത്ഥനയുടെ ബോഡി ശൂന്യമാണ്, ഡൗൺലോഡ് ഐഡി URL വിലാസത്തിൽ പാസ്സാക്കി.

ഒരു അന്വേഷണ അഭ്യർത്ഥനയ്ക്കുള്ള മറുപടിയായി, എമുലേഷൻ പൂർത്തിയാക്കുകയും ഫയൽ ഡൗൺലോഡ് ചെയ്യുമ്പോൾ റിപ്പോർട്ടുകൾ അഭ്യർത്ഥിക്കുകയും ചെയ്താൽ, റിപ്പോർട്ടുകൾ ഡൗൺലോഡ് ചെയ്യുന്നതിനുള്ള ഐഡി ദൃശ്യമാകും. വൃത്തിയാക്കിയ ഒരു പകർപ്പ് ആവശ്യപ്പെട്ടാൽ, വൃത്തിയാക്കിയ ഡോക്യുമെന്റ് ഡൗൺലോഡ് ചെയ്യാൻ നിങ്ങൾ ഐഡി നോക്കണം.

മൊത്തത്തിൽ, ലോഡുചെയ്യുന്നതിനുള്ള ഐഡി മൂല്യം അടങ്ങിയിരിക്കുന്ന ചോദ്യത്തിനുള്ള പ്രതികരണത്തിലെ കീകൾ:

• സംഗ്രഹ_റിപ്പോർട്ട്

• പൂർണ്ണ_റിപ്പോർട്ട്

• pdf_report

• xml_report

• extracted_file_download_id

തീർച്ചയായും, അന്വേഷണ അഭ്യർത്ഥനയ്ക്കുള്ള പ്രതികരണമായി ഈ കീകൾ ലഭിക്കുന്നതിന്, അവ അഭ്യർത്ഥനയിൽ (റിപ്പോർട്ടുകൾക്കായി) വ്യക്തമാക്കിയിരിക്കണം അല്ലെങ്കിൽ എക്‌സ്‌ട്രാക്ഷൻ ഫംഗ്‌ഷൻ ഉപയോഗിച്ച് ഒരു അഭ്യർത്ഥന നടത്താൻ ഓർമ്മിക്കുക (വൃത്തിയാക്കിയ പ്രമാണങ്ങൾക്ക്)

ക്വാട്ട API കോൾ

ഉപയോഗിച്ച രീതി - പോസ്റ്റ്

കോൾ വിലാസം - 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 ആവശ്യമെങ്കിൽ മാത്രമേ ഇപ്പോൾ ഇത് ഉപയോഗപ്രദമാകൂ. ത്രെറ്റ് എമുലേഷനായി സാധാരണ ത്രെറ്റ് പ്രിവൻഷൻ API ഉപയോഗിക്കുന്നതാണ് നല്ലത്. ഓണാക്കാൻ എസ്‌ജിക്കുള്ള ടിപി എപിഐ കൂടാതെ നിങ്ങൾ ഘട്ടങ്ങൾ പാലിക്കേണ്ട API കീ കോൺഫിഗർ ചെയ്യുക sk113599. ഘട്ടം 6b ശ്രദ്ധിക്കുകയും പേജിന്റെ പ്രവേശനക്ഷമത പരിശോധിക്കുകയും ചെയ്യാൻ ഞാൻ ശുപാർശ ചെയ്യുന്നു https://<IPAddressofSecurityGateway>/UserCheck/TPAPI കാരണം നെഗറ്റീവ് ഫലമുണ്ടെങ്കിൽ, കൂടുതൽ കോൺഫിഗറേഷൻ അർത്ഥമാക്കുന്നില്ല. എല്ലാ API കോളുകളും ഈ url-ലേക്ക് അയയ്ക്കും. കോൾ തരം (അപ്‌ലോഡ്/ചോദ്യം) കോൾ ബോഡി കീയിൽ നിയന്ത്രിക്കപ്പെടുന്നു - അഭ്യർത്ഥന_പേര്. കൂടാതെ ആവശ്യമായ കീകളും - api_key (കോൺഫിഗറേഷൻ പ്രക്രിയയിൽ നിങ്ങൾ ഇത് ഓർമ്മിക്കേണ്ടതുണ്ട്) കൂടാതെ പ്രോട്ടോക്കോൾ_പതിപ്പ് (നിലവിലെ പതിപ്പ് 1.1 ആണ്). ഈ API-യുടെ ഔദ്യോഗിക ഡോക്യുമെന്റേഷൻ നിങ്ങൾക്ക് ഇവിടെ കണ്ടെത്താം sk137032. ആപേക്ഷിക നേട്ടങ്ങളിൽ, ഫയലുകൾ ബേസ്64 ടെക്സ്റ്റ് സ്ട്രിംഗായി അയച്ചതിനാൽ, ലോഡുചെയ്യുമ്പോൾ അനുകരണത്തിനായി ഒരേസമയം നിരവധി ഫയലുകൾ അയയ്ക്കാനുള്ള കഴിവ് ഉൾപ്പെടുന്നു. ബേസ്64-ൽ നിന്ന്/ഇതിലേക്ക് ഫയലുകൾ എൻകോഡ്/ഡീകോഡ് ചെയ്യുന്നതിന്, ഡെമോൺസ്ട്രേഷൻ ആവശ്യങ്ങൾക്കായി നിങ്ങൾക്ക് പോസ്റ്റ്മാനിലെ ഒരു ഓൺലൈൻ കൺവെർട്ടർ ഉപയോഗിക്കാം, ഉദാഹരണത്തിന് - https://base64.guru. പ്രായോഗിക ആവശ്യങ്ങൾക്കായി, കോഡ് എഴുതുമ്പോൾ നിങ്ങൾ ബിൽറ്റ്-ഇൻ എൻകോഡ്, ഡീകോഡ് രീതികൾ ഉപയോഗിക്കണം.

ഇപ്പോൾ നമുക്ക് ഫംഗ്ഷനുകൾ കൂടുതൽ വിശദമായി പരിശോധിക്കാം te и വേർതിരിച്ചെടുക്കൽ ഈ API-യിൽ.

ഘടകത്തിന് te നിഘണ്ടു നൽകിയിരിക്കുന്നു te_options അപ്‌ലോഡ്/അന്വേഷണ അഭ്യർത്ഥനകളിൽ, ഈ അഭ്യർത്ഥനയിലെ കീകൾ te കീകളുമായി പൂർണ്ണമായും യോജിക്കുന്നു ഭീഷണി തടയൽ API.

റിപ്പോർട്ടുകൾക്കൊപ്പം 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 അഭ്യർത്ഥനയോട് പ്രതികരിക്കുന്നതിലെ മഹത്തായ കാര്യം, ആ അഭ്യർത്ഥനയുടെ പ്രതികരണത്തിൽ ഒരു ബേസ്64 എൻക്രിപ്റ്റ് ചെയ്ത സ്‌ട്രിംഗായി നിങ്ങൾക്ക് വൃത്തിയാക്കിയ ഒരു പകർപ്പ് ലഭിക്കും എന്നതാണ് (നിങ്ങൾ ഒരു അന്വേഷണ അഭ്യർത്ഥന നടത്തേണ്ടതില്ല, ഡൗൺലോഡ് ചെയ്യുന്നതിന് ഐഡി നോക്കേണ്ടതില്ല. പ്രമാണം)

ഒരു ഫയൽ മായ്‌ക്കാനുള്ള അഭ്യർത്ഥനയുടെ ഉദാഹരണം

    {
	"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.

പോസ്റ്റ്മാൻ ശേഖരങ്ങൾ

ഏറ്റവും സാധാരണമായ API അഭ്യർത്ഥനകളെ പ്രതിനിധീകരിക്കുന്ന സുരക്ഷാ ഗേറ്റ്‌വേയ്‌ക്കായുള്ള ഭീഷണി തടയൽ API, ഭീഷണി തടയൽ API എന്നിവയ്‌ക്കായി ഞാൻ പോസ്റ്റ്‌മാനിൽ ശേഖരങ്ങൾ സൃഷ്ടിച്ചു. സെർവർ ip/url API, കീ എന്നിവ സ്വയമേവ അഭ്യർത്ഥനകളായി മാറ്റിസ്ഥാപിക്കുന്നതിനും ഫയൽ ഡൗൺലോഡ് ചെയ്‌തതിനുശേഷം sha256 ഹാഷ് തുക ഓർമ്മിക്കുന്നതിനും വേണ്ടി, ശേഖരങ്ങൾക്കുള്ളിൽ മൂന്ന് വേരിയബിളുകൾ സൃഷ്‌ടിച്ചിട്ടുണ്ട് (ശേഖരണ ക്രമീകരണങ്ങളിലേക്ക് പോയി നിങ്ങൾക്ക് അവ കണ്ടെത്താനാകും. എഡിറ്റ് -> വേരിയബിളുകൾ): te_api (ആവശ്യമാണ്), api_key (പ്രാദേശിക ഉപകരണങ്ങളിൽ TP API ഉപയോഗിക്കുമ്പോൾ ഒഴികെ പൂരിപ്പിക്കേണ്ടത് ആവശ്യമാണ്), sha256 (ശൂന്യമായി വിടുക, എസ്‌ജിക്ക് ടിപി എപിഐയിൽ ഉപയോഗിക്കില്ല).

ഭീഷണി തടയൽ API-നായി പോസ്റ്റ്മാൻ ശേഖരം ഡൗൺലോഡ് ചെയ്യുക

സുരക്ഷാ ഗേറ്റ്‌വേ API-യ്‌ക്കായുള്ള ഭീഷണി തടയുന്നതിനുള്ള പോസ്റ്റ്മാൻ ശേഖരം ഡൗൺലോഡ് ചെയ്യുക

ഉപയോഗ ഉദാഹരണങ്ങൾ

സമൂഹത്തിൽ ഇണകളെ പരിശോധിക്കുക പൈത്തണിൽ എഴുതിയ സ്ക്രിപ്റ്റുകൾ അവതരിപ്പിക്കുന്നു, അത് വഴി ആവശ്യമുള്ള ഡയറക്ടറിയിൽ നിന്ന് ഫയലുകൾ പരിശോധിക്കുന്നു TP API, ഒപ്പം എസ്‌ജിക്കുള്ള ടിപി എപിഐ. ഭീഷണി തടയൽ API-യുമായുള്ള ആശയവിനിമയത്തിലൂടെ, ഫയലുകൾ സ്കാൻ ചെയ്യാനുള്ള നിങ്ങളുടെ കഴിവ് ഗണ്യമായി വികസിക്കുന്നു, കാരണം ഇപ്പോൾ നിങ്ങൾക്ക് ഒരേസമയം നിരവധി പ്ലാറ്റ്ഫോമുകളിൽ ഫയലുകൾ സ്കാൻ ചെയ്യാൻ കഴിയും (ചെക്ക് ഇൻ ചെയ്യുന്നു VirusTotal API, തുടർന്ന് ചെക്ക് പോയിന്റ് സാൻഡ്‌ബോക്‌സിൽ), കൂടാതെ നെറ്റ്‌വർക്ക് ട്രാഫിക്കിൽ നിന്ന് മാത്രമല്ല ഫയലുകൾ സ്വീകരിക്കുക, മാത്രമല്ല ഏതെങ്കിലും നെറ്റ്‌വർക്ക് ഡ്രൈവുകളിൽ നിന്നും, ഉദാഹരണത്തിന്, CRM സിസ്റ്റങ്ങളിൽ നിന്നും അവ എടുക്കുക.

അവലംബം: www.habr.com