Hic articulus utilis erit illis qui technologiam noverunt reprehendo Point per aemulationem file (comminatio aemulatio) Et proactive file purgatio (comminatio Extraction) et gradum ad haec opera automating cupit. Reprehendo Point est quod tam in nube quam in figmentis locorum currit; officiatorie idem est ad reprimendas limas in tela/smtp/ftp/smb/nfs negotiationis fluminum. Hic articulus est partim interpretatio auctoris statuti articulorum ex documentis officialibus, sed in mea experientia operante et meis exemplis fundata. Etiam in articulo invenies collectiones Postman auctoris ad operandum cum comminatione praeventionis API.
Basic abbreviations
Minatio Praeventionis API laborat cum tribus partibus principalibus, quae in API vocantur per valores sequentes textus:
av - Anti-Virus componentis, author analysi notarum minarum subscriptionis.
te - Comminatio emulationis componentium, auctorum reprimendis lima in sandbox, et malitiosam / benignam sententiam post aemulationem faciens.
extractionem - Comminatio extractionis componentis, responsalis officii documentorum celeriter convertendi in formam tutam (in qua omnia potentia malitiosa removetur), ut cito eas usoribus/systematibus tradas.
API structuram et limites
Comminatio Praeventionis API tantum 4 petitiones adhibet upload, quaesitio, download et quota. In capite pro omnibus quattuor petitionibus debes transire API clavem modulo utente auctoritas. Primo aspectu, structura multo simplicior videri potest quam in sed numerus agrorum in egetationibus et petitionibus interrogationum ac structura harum petitionum satis implicata est. Hae officialiter comparari possunt cum periculis praeventionis profiles in porta / sandbox consilium securitatis.
In momento, sola versio minae Praeventionis API dimissa est - 1.0; Domicilium pro API vocat debet includere v1 in qua parte versionem denotare debes. Dissimile Management API, necesse est API versionem in Domicilio indicari, alioquin petitio exsecutioni mandari non potest.
Componente Anti-Virus, cum sine aliis componentibus (te, extractionis) appellatur, nunc tantum petitiones interrogationum cum md5 summis summarum sustinet. Comminatio aemulatio et comminatio extractio etiam summas sha1 et sha256 Nullam sumunt.
Magni momenti est ne in queries errare! Petitio exsecutioni mandari potest sine errore, sed non totaliter. Aliquantum prospicientes, inspiciamus quid fieri possit quando errores/typos in queries sunt.
Petitio cum typo cum verbo tradit(reportss)
{ "request": [
{
"sha256": {{sha256}},
"features": ["te"] ,
"te": {
"images": [
{
"id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
"revision": 1
}
],
reportss: ["tar", "pdf", "xml"]
}
}
]
}In responsione nullus error erit, sed notitia de relationibus omnino non erit
{
"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."
}
}
}
]
}Sed ad petitionem sine typo in relationibus clavem
{ "request": [
{
"sha256": {{sha256}},
"features": ["te"] ,
"te": {
"images": [
{
"id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
"revision": 1
}
],
reports: ["tar", "pdf", "xml"]
}
}
]
}Accipimus responsionem quae iam continet id pro downloading tradit
{
"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."
}
}
}
]
}Si clavem API exspiratam mittamus, 403 errorem in responsione accipiemus.
SandBlast API: in nube et in loci machinas
API petitiones mitti possunt ad Reprehendendum Point machinas quae periculum aemulationis componentis (ensis) paraverunt. Oratio pro petitionibus adhibenda est "ip/url machinae et portus 18194" (exempli gratia https://10.10.57.19:18194/tecloud/api/v1/file/query). Facere etiam debes ut consilium securitatis de fabrica huius nexus permittat. LICENTIA per API key ad loci machinas per defaltam off Auctoritas autem clavis petendi capitis mitti omnino non potest.
API petentibus CheckPoint nube mitterentur te.checkpoint.com (exempli gratia - https://te.checkpoint.com/tecloud/api/v1/file/query). API clavis obtineri potest ut licentia iudicii per 60 dies contingentes Reprehendo Point sociis aut loci officium societatis.
In machinis localibus, comminatio extractionis nondum ut norma fulta est. ac debet esse (de eo fusius in fine articuli loquemur).
Adinventiones locales numerum petitionem non sustinent.
Alioquin nullae sunt differentiae petitiones locorum machinae et nebulae.
Index API vocatio
Modus usus est STIPES
Inscriptio electronica voca - https:///tecloud/api/v1/file/upload
Petitio duabus partibus constat (form-data): fasciculus destinatus ad aemulationem/emundationem et petitionem corporis cum textu.
Petitio textus vacua esse non potest, sed figuram ullam continere non potest. Ut rogatio bene sit, saltem textum sequentem in percontatione mittendum est:
Minimum requisiti onerationis petitionem
HTTP Post
https:///tecloud/api/v1/file/upload
Capitis:
lICENTIA:
Corporis
{
"postulatio": {
}
}
file
file
Hoc in casu, tabella discursum erit secundum ambitum defaltam: component - te, OS imagines - Vincere XP ac vincite VII "sine fama.
Comments in pelagus campis in textu petitio:
file nomen и file_type Eos vestis relinquere potes vel omnino non mittere, cum hoc non sit in primis utiles informationes cum fasciculum imposuisti. In responsione API, hi agri in automatice fundatae erunt in nomine tabellae receptae, et notitia in cella adhuc quaerenda erit usura md5/sha1/sha256 copia detrahenda.
Exemplum petitio cum file_name et file_type in inanibus
{
"request": {
"file_name": "",
"file_type": "",
}
}features — elenchus qui necessariam functionem indicat cum in sandbox - av (Anti-Virus), te (Miniculatio Emulationis), extractionis (Threat Extraction). Si hic modulus omnino non transigitur, tantum defalta pars adhibebitur - te (minatio Emulationis).
Ut reprehendo in tribus quae in promptu sunt, necesse est ut haec elementa in API petitione definias.
Exemplum rogationis annotando in av, te et extractione
{ "request": [
{
"sha256": {{sha256}},
"features": ["av", "te", "extraction"]
}
]
}Claves in te sectione
images — index continens dictionarium cum id et revisionem numerorum systematum operantium in quibus perscriptio fiet. Numeri IDs et revisiones idem sunt omnibus machinis localibus et nebula.
Index systematum operandi et emendationes
Praesto OS imago ID
Revision
Imago OS et Application
e50e99f3-5963-4573-af9e-e3f4750b55e2
1
Fenestra Microsoft: XP - 32bit SP3
Officium: 2003, 2007
Adobe Acrobat Reader: 9.0
Flash player 9r115 and ActiveX 10.0
Java Runtime: 1.6.0u22
7e6fe36e-889e-4c25-8704-56378f0830df
1
Fenestra Microsoft: 7 - 32bit
Officium: 2003, 2007
Adobe Acrobat Reader: 9.0
Flash player: 10.2r152 (Plugin& ActiveX)
Java Runtime: 1.6.0u0
8d188031-1010-4466-828b-0cd13d4303ff
1
Fenestra Microsoft: 7 - 32bit
Officium: 2010
Adobe Acrobat Reader: 9.4
Flash player: 11.0.1.152 (Plugin & ActiveX)
Java Runtime: 1.7.0u0
5e5de275-a103-4f67-b55b-47532918fa59
1
Fenestra Microsoft: 7 - 32bit
Officium: 2013
Adobe Acrobat Reader: 11.0
Flash player: 15 (Plugin & ActiveX)
Java Runtime: 1.7.0u9
3ff3ddae-e7fd-4969-818c-d5f1a2be336d
1
Fenestra Microsoft: 7 - 64bit
Officium: 2013 (32bit)
Adobe Acrobat Reader: 11.0.01
Flash player: 13 (Plugin & ActiveX)
Java Runtime: 1.7.0u9
6c453c9b-20f7-471a-956c-3198a868dc92
1
Fenestra Microsoft: 8.1 - 64bit
Officium: 2013 (64bit)
Adobe Acrobat Reader: 11.0.10
Flash player: 18.0.0.160 (Plugin & ActiveX)
Java Runtime: 1.7.0u9
10b4a9c6-e414-425c-ae8b-fe4dd7b25244
1
Fenestra Microsoft: 10
Officium: Professio Plus 2016 en-us
Adobe Acrobat Reader: DC 2015 MUI
Flash player: 20 (Plugin & ActiveX)
Java Runtime: 1.7.0u9
Si imagines clavis omnino non specificatae, aemulatio fiet in imaginibus a Check Point commendatis (incurrente Vincere XP et Vincere 7). Hae imagines commendantur secundum considerationes optimae staterae perficiendi et rate capturae.
Reports — elenchum relationum quas petimus in casu malitiosae tabella evenit. Optiones sequentes praesto sunt:
-
summary - .tar.gz archivum continens relationem de aemulatione by omnia imagines petitae (utriusque paginae html et components ut video ab aemulo OS, TUBER negotiationis, relatio in json, et ipsum specimen in archivo tesserario conservato). Quaerimus clavem in responsum - summary_report ad subsequentem de fama downloading.
-
PDF - documentum de aemulatione in unus imaginem, quam multi per Smert Console recipere consueverunt. Quaerimus clavem in responsum - pdf_report ad subsequentem de fama downloading.
-
XML - documentum de aemulatione in unus imago, opportuna ad subsequentium parsing parametri in relatione. Quaerimus clavem in responsum - xml_report ad subsequentem de fama downloading.
-
multos bituminis - .tar.gz archivum continens relationem de aemulatione in unus imagines petitae (utriusque paginae html et components ut video ab aemulo OS, TUBER negotiationis, relatio in json, et ipsum specimen in archivo tesserario conservato). Quaerimus clavem in responsum - full_report ad subsequentem de fama downloading.
Quid intra summary fama?
Claves full_report, pdf_report, xml_report sunt in dictionario pro unoquoque 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."
}
}
}
]
}Sed in summary_report key - una est pro aemulatione in genere
{
"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."
}
}
}
]
}Rogare potes bitumen et xml et pdf nuntia simul, postulas summariam et bitumen et xml. Summam famam ac pdf simul exquirere licebit.
Claves in sectione extractionis
Ad minas extractionis duae tantum claves adhibentur;
ratio - pdf (converte ad pdf, ab usu defalta) vel munda (activa purgatio).
extracted_parts_codes - Index coderum ad contentum activum removendum, tantum ad methodum mundam applicabilis
Codes ad tollendum contentus de files
Codex
Description
1025
Coniuncta res
1026
Macros et Code
1034
Hyperlinks sensitivum
1137
PDF GoToR Actiones
1139
PDF Actiones Duc
1141
PDF URI Actiones
1142
PDF Sound Actiones
1143
PDF Actiones Movies
1150
PDF Actiones JavaScript
1151
PDF Submit Forma Actiones
1018
Database Queries
1019
Res embedded
1021
Fast Servo Data
1017
More Properties
1036
Statistica Properties
1037
Summarium Properties
Ad exemplum purgatum detrahendum, etiam requisitionem (de qua infra dicetur) postulare debebis, paucis secundis, denotans quantitatem limae et extractionem componentem in textu rogationis. Documentum purgatum colligere potes utendo id ex responsione ad query - extractum_file_download_id. Iterum, paulum prospicientes, exempla petendi et responsionem interrogationis praebeo ut id quaerendi documentum purgatum deprimendum sit.
Postulatio quaesita est ut quaeramus clavis extractum_file_download_id
{ "request": [
{
"sha256": "9a346005ee8c9adb489072eb8b5b61699652962c17596de9c326ca68247a8876",
"features": ["extraction"] ,
"extraction": {
"method": "pdf"
}
}
]
}Responsio quaesiti (visi clavis 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."
}
}
}
]
}Overview
In una API vocatio, unum tantum fasciculum ad verificationem mittere potes.
Pars av componentis sectionem additam cum clavibus non requirit, satis est eam in dictionario denotare features.
Query API call
Modus usus est STIPES
Inscriptio electronica voca - https:///tecloud/api/v1/file/query
Priusquam limam electronicam mittat (precatio oneris) opportunum est ut cinematographicam sandbox (quaestio postulatio) reprimat ut onus in API servo optimize, quandoquidem API server notitia et iudicium in tabula recepta iam habere potest. Vocatio tantum consistit in textu ex parte. Rogationis pars requiritur sha1/sha256/md5 Nullam moles tabellae est. Obiter in responsione ad postulationem onerationis percipere potes.
Minimum requisiti ad quaestionem
HTTP Post
https:///tecloud/api/v1/file/query
Capitis:
lICENTIA:
Corporis
{
"postulatio": {
"sha256":
}
}
Exemplum responsionis ad petitionem onerationis, ubi sha1/md5/sha256 Nullam quantitates visibiles sunt
{
"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."
}
}
}
}Investigatio postulatio, praeter Nullam quantitatem, specimen idem esse debet ac postulatio onerationis (vel iam esse destinata), vel etiam "iam" (pauciora continent agri in petitione interrogationis quam in rogatione onerati). In casu ubi petitio interrogationis plures agros continet quam in petitione onerationis, omnes notitias requisitas responsionis non recipies.
En exemplum responsionis ad quaesitum ubi non requiritur data inventa
{
"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."
}
}
}
]
}Attendite ad agros Code и label. Hi agri dictionarii status ter apparent. Primum videmus clavem globalem "codice": 1006 et "label": "PARTIALLY_FOUND". Deinde hae claves inveniuntur pro singulis componentibus quas petimus - te et extractionem. Et si per te patet notitia inventa, tunc nulla est notitia extrahendi.
Hoc est quod quaesitum videbatur, exempli causa
{ "request": [
{
"sha256": {{sha256}},
"features": ["te", "extraction"] ,
"te": {
"images": [
{
"id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
"revision": 1
}
],
"reports": [
"xml", "pdf"
]
}
}
]
}Si mittas petitionem quaesitum sine extractione component
{ "request": [
{
"sha256": {{sha256}},
"features": ["te"] ,
"te": {
"images": [
{
"id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
"revision": 1
}
],
"reports": [
"xml", "pdf"
]
}
}
]
}Tunc responsum notitias integras continebit ("code": MI, "pittacium": "inventus")
{
"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."
}
}
}
]
}Si nulla notitia in cella omnino est, responsio "titulus" erit: "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."
}
}
}
]
}Uno API vocato, plures hash moles statim ad verificationem mittere potes. Data responsio ad eundem ordinem redibit, quo in petitione missus est.
Exemplum interrogationis cum pluribus sha256 amounts
{ "request": [
{
"sha256": "b84531d3829bf6131655773a3863d6b16f6389b7f4036aef9b81c0cb60e7fd81"
},
{
"sha256": "b84531d3829bf6131655773a3863d6b16f6389b7f4036aef9b81c0cb60e7fd82"
}
]
}Responde quaesitum est cum multa sha256 amounts
{
"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."
}
}
}
]
}Plures pecuniae summas rogantes statim in inquisitione quaesita etiam in API server observantia effectum habebunt.
Download API vocatio
Modus usus est STIPES (Iuxta documenta); aDEPTO etiam opera (ut magis logica videatur)
Inscriptio electronica voca - https:///tecloud/api/v1/file/download?id=
Header requirit API clavis ut feratur, corpus petitionis vacuum est, id quod in domicilio electronicum praemittitur.
Propter quaesitum requisitum, si aemulatio perficitur et relationes rogatae sunt cum tabellam dempserint, id ad relationes extrahendas visibile erit. Si exemplum purgatum petitur, id quaerere debes ut documentum mundatum deprimas.
In summa, claves in responsione ad interrogationem continentem valorem id onerandi esse possunt:
-
summary_report
-
full_report
-
pdf_report
-
xml_report
-
extracted_file_download_id
Utique, ut has claves accipiant in responsione ad instantiam interrogationis, debent in petitione definiri (pro relationibus) vel rogare meminerint functionem extractionem utendo (per documenta purgata)
Quota API call
Modus usus est STIPES
Inscriptio electronica voca - https:///tecloud/api/v1/file/quota
Ad rehqua quota in nube sisto, utere numerum quaesitum. Corpus inanis est petitio.
Exemplum responsio ad petitionem 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"
}
]
}Comminatio Praeventionis API ad Securitatis Gateway
Hoc API ante denuntiationem praeventionis API elaboratum est et solum ad machinas locales destinatur. Nunc enim utile solum esse potest si minae Extraction API eges. Pro comminatione aemulationis melius uti API comminatio iusto praeventionis. Ad conversus in TP API pro SG et configurare API clavem debes sequi gradus a . Commendo operam ut 6b accedas et inspicias accessibilitatem paginae https://<IPAddressofSecurityGateway>/UserCheck/TPAPI quia in casu negativo, ulterior figuratio non facit sensum. Omnes API vocati mittentur ad hunc url. Vocatio generis (inscriptionis/quaestio) in vocationem corporis key regulatur request_name. Etiam requiritur claves sunt - api_key (Opus est in configuratione processus meminisse) et protocol_version (Scriptum current version est 1.1). Potes invenire documenta publica huius API at . Commoda relativa includunt facultatem plures tabellas simul mittendi ad aemulationem cum eas onerandas, cum fasciculi chordae textui base64 mittuntur. Ad encode/decode fasciculos ad/e base64s uti potes converter in Postman ad proposita demonstrationis, exempli gratia - . Ad usum practicum, constructis in encode et decode methodis uti debes cum codice scripto.
Nunc propius inspiciamus ad munera te и extractionem in hac API.
Nam component te dictionary provisum te_options in upload/quaestionis petitiones, et claves in hac petitione cum te clavium in . .
Exemplum petitio pro file aemulatio in Win10 cum tradit
{
"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"]
}
}
]
}Nam component extractionem dictionary provisum scrub_options. Haec petitio modum purgationis designat: convertendi ad PDF, in promptu activo manifesta, vel modum elige secundum cum profile Minatio Praeventionis (profile nomen indicatur). Magna res est de petitioni API extractioni respondendi pro tabella est te exemplum purgatum in responsione ad petitionem illi quasi chordae encryptatae base64 (non opus est petitionem interrogationis facere et id spectare ut illam deprimas. documentum)
Exemplum petitionis documentum purgare
{
"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
}
}]
}Respondeo ad petitionem
{
"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": ""
}
}]
} Quamvis pauciores petitiones API ad exemplar purgatum obtinendum requirantur, hanc optionem minus potiorem et opportunam invenio quam postulatio in forma data. .
Postman Collections
Collectiones in Postman creavi pro API et comminatione praeventionis et denuntiatio praeventionis API pro porta Securitatis, quae petitiones communissimas API repraesentant. Ut servo ip/url API et clavis in petitiones automatice substituendae sint, et sha256 Nullam quantitatem memorandi post tabellam receptam, tres variabiles intra collectiones creatae sunt (eas invenire potes eundo ad unctiones collectiones. Edit -> Variables); te_api (requiritur), api_key (requiritur ut impleatur, nisi cum TP API cum machinis localibus utens), sha256 (vacua relinquo, non in TP API pro SG adhibita).
exempla ex usu
In conventu scripta Pythone scripta exhibentur quae fasciculi reprehendo ex desiderato indice via autem . Per commercium cum comminatione praeventionis API, facultas tua ad lustranda lima signanter dilatatur, quia nunc lima in pluribus suggestis simul scandere potes (reprehendo in ac deinde in sandbox perscriptio), et lima non solum a retis commercii, sed etiam a retis quaslibet agitet, exempli gratia, CRM systemata.
Source: www.habr.com