Ka whai hua tenei tuhinga ki te hunga e mohio ana ki te hangarau Tirohia Point mā te whai i te kōnae (Whakawhanaunga Whakawehi) me te horoi i nga konae mahi (Tangohanga Whakawehi) me te hiahia ki te whai huarahi ki te whakaaunoa i enei mahi. Kei a Check Point , e rere ana i roto i te kapua me nga taputapu o te rohe, a he rite tonu ki te tirotiro i nga konae kei roto i nga awa hokohoko tukutuku/smtp/ftp/smb/nfs. Ko tenei tuhinga tetahi waahanga o te whakamaoritanga a te kaituhi mo te huinga tuhinga mai i nga tuhinga whaimana, engari i runga i taku ake wheako whakahaere me aku ake tauira. I roto ano i te tuhinga ka kitea e koe nga kohinga Kaituhi a te Kaituhi mo te mahi tahi me te API Whakamatamata.
Nga whakapotonga taketake
E toru nga waahanga matua e kiia ana i roto i te API na roto i nga uara kuputuhi e whai ake nei:
av — Waahanga Anti-Virus, te kawenga mo te tātari hainatanga o nga riri e mohiotia ana.
te - Waehanga Whakamaamana, he kawenga mo te tirotiro i nga konae kei roto i te pouaka kirikiri, me te whakatau i te whakatau kino i muri i te peehi.
tangohanga - Waehanga Tangotanga Whakawehi, he kawenga mo te huri tere i nga tuhinga tari ki te ahua haumaru (ka whakakorehia nga ihirangi kino katoa), kia tere ai te tuku ki nga kaiwhakamahi/pnaha.
Hanganga API me nga here matua
E 4 noa nga tono e whakamahia ana e te API Aukati − tuku, uiui, tango me te motunga. I roto i te pane mo nga tono e wha ka hiahia koe ki te tuku i te matua API ma te whakamahi i te tawhā whakamanatanga. I te tuatahi o te titiro, he ahua ngawari ake te hanganga i te roto , engari ko te maha o nga mara i roto i te tukunga ake me nga tono patai me te hanganga o enei tono he tino uaua. Ka taea te whakatauritehia enei ki nga whakaaturanga Whakamatamata i roto i te kaupapa here haumarutanga kuaha/pouaka kirikiri.
I tenei wa, ko te putanga anake o te API Whakamatamata kua tukuna - 1.0; me whakauru te URL mo nga waea API. v1 i roto i te waahanga e hiahia ana koe ki te tautuhi i te putanga. Kaore i rite ki te API Whakahaere, he mea tika ki te tohu i te putanga API i roto i te URL, ki te kore e tukuna te tono.
Ko te wahanga Anti-Virus, ina karangahia kaore he waahanga (te, tangohanga), kei te tautoko noa i nga tono patai me nga moni hash md5. Kei te tautoko hoki te Whakatairanga Whakawehi me te Tangohanga Whakawehi i nga moni hash sha1 me sha256.
He mea nui kia kaua e pohehe i nga patai! Ka taea te tono me te kore he, engari kaore i te tino. Ma te titiro whakamua, me titiro ki nga mea ka puta ina he hapa/typo i roto i nga patai.
Tonoa he hapa me te kupu purongo(nga purongo)
{ "request": [
{
"sha256": {{sha256}},
"features": ["te"] ,
"te": {
"images": [
{
"id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
"revision": 1
}
],
reportss: ["tar", "pdf", "xml"]
}
}
]
}Karekau he hapa o te whakautu, engari karekau he korero mo nga purongo
{
"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."
}
}
}
]
}Engari mo te tono kaore he hapa i roto i te kii purongo
{ "request": [
{
"sha256": {{sha256}},
"features": ["te"] ,
"te": {
"images": [
{
"id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
"revision": 1
}
],
reports: ["tar", "pdf", "xml"]
}
}
]
}Ka whiwhi urupare kei roto i a maatau he id mo te tango i nga purongo
{
"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."
}
}
}
]
}Mena ka tukuna e matou he matua API kua he / kua pau, ka whiwhi matou i te hapa 403 hei whakautu.
SandBlast API: i te kapua me nga taputapu o te rohe
Ka taea te tuku atu nga tono API ki nga taputapu Tirotiro e whai ana i te waahanga Whakamaamaa (mata) kua whakahohea. Hei wahitau mo nga tono, me whakamahi koe i te ip/url o te taputapu me te tauranga 18194 (hei tauira, https://10.10.57.19:18194/tecloud/api/v1/file/uira). Me whakarite ano e te kaupapa here haumaru i runga i te taputapu ka taea tenei hononga. Whakaaetanga ma te matua API i runga i nga taputapu rohe ma te taunoa atu me te kī Whakamana i roto i nga pane tono kaore pea e tukuna.
Me tukuna nga tono API ki te kapua Takitaki te.checkpoint.com (hei tauira - https://te.checkpoint.com/tecloud/api/v1/file/uira). Ka taea te whiwhi i te taviri API hei raihana whakamatautau mo nga ra 60 ma te whakapiri atu ki nga hoa o te Check Point, ki te tari a-rohe ranei o te kamupene.
I runga i nga taputapu o te rohe, kaore ano te Whakamatau Tangohanga e tautokohia hei paerewa. a me whakamahi (ka korerohia e maatau mo nga korero i te mutunga o te tuhinga).
Kaore nga taputapu a-rohe e tautoko i te tono motunga.
Ki te kore, kaore he rereketanga i waenga i nga tono ki nga taputapu o te rohe me te kapua.
Tukua te waea API
Tikanga whakamahia − POST
Wāhitau waea - https:///tecloud/api/v1/file/upload
E rua nga wahanga o te tono (puka-raraunga): he konae hei tauira/horoi me te tinana tono me nga tuhinga.
Ko te tono kuputuhi e kore e noho putua, engari kaore pea he whirihoranga. Kia angitu ai te tono, me tuku e koe nga kupu e whai ake nei i roto i te tono:
Te iti e hiahiatia ana mo te tono tukuake
HTTP POST
https:///tecloud/api/v1/file/upload
Pane:
Whakaaetanga:
Body
{
"tono": {
}
}
kōnae
kōnae
I tenei keehi, ka tukatukahia te konae kia rite ki nga tawhā taunoa: wae - te, whakaahua OS - Win XP me Win 7, me te kore e whakaputa purongo.
Nga korero mo nga mara matua o te tono kupu:
ingoa ingoa и momo_kōnae Ka taea e koe te waiho kia watea, kaua ranei e tukuna, na te mea ehara tenei i nga korero tino whai hua ina tukuna he konae. I roto i te whakautu API, ka whakakiia aunoa enei mara i runga i te ingoa o te konae kua tangohia, me rapu tonu nga korero kei roto i te keteroki ma te whakamahi i nga moni hash md5/sha1/sha256.
He tauira tono me te ingoa_oaoa me te momo_kei
{
"request": {
"file_name": "",
"file_type": "",
}
}āhuatanga — he rarangi e whakaatu ana i nga mahi e tika ana i te wa e tukatuka ana i te pouaka kirikiri - av (Anti-Virus), te (Threat Emulation), tangohanga (Threat Extraction). Ki te kore e paahitia tenei tawhā, katahi ka whakamahia te wae taunoa - te (Threat Emulation).
Kia taea ai te tirotiro i nga waahanga e toru e waatea ana, me tohu e koe enei waahanga ki te tono API.
He tauira o te tono me te tirotiro i te av, te me te tangohanga
{ "request": [
{
"sha256": {{sha256}},
"features": ["av", "te", "extraction"]
}
]
}Kī i roto i te wāhanga te
whakapakoko — he rarangi kei roto nga papakupu me te id me te nama whakahou o nga punaha whakahaere ka mahia te haki. He rite tonu nga ID me nga nama whakahou mo nga taputapu katoa o te rohe me te kapua.
Te rarangi o nga punaha whakahaere me nga whakahoutanga
Kei te waatea te ID Whakaahua OS
Whakahōunga
Whakaahua OS me te Taupānga
e50e99f3-5963-4573-af9e-e3f4750b55e2
1
Microsoft Windows: XP - 32bit SP3
Office: 2003, 2007
Adobe Acrobat Reader: 9.0
Flash Player 9r115 a HoheX 10.0
Wā Whakahaere Java: 1.6.0U22
7e6fe36e-889e-4c25-8704-56378f0830df
1
Microsoft Windows: 7 - 32bit
Office: 2003, 2007
Adobe Acrobat Reader: 9.0
Pūpāpāho Kohiko: 10.2r152 (monomai& HoheX)
Wā Whakahaere Java: 1.6.0U0
8d188031-1010-4466-828b-0cd13d4303ff
1
Microsoft Windows: 7 - 32bit
Office: 2010
Adobe Acrobat Reader: 9.4
Pūpāpāho Kohiko: 11.0.1.152 (monomai & HoheX)
Wā Whakahaere Java: 1.7.0U0
5e5de275-a103-4f67-b55b-47532918fa59
1
Microsoft Windows: 7 - 32bit
Office: 2013
Adobe Acrobat Reader: 11.0
Pūpāpāho Kohiko: 15 (monomai & HoheX)
Wā Whakahaere Java: 1.7.0U9
3ff3ddae-e7fd-4969-818c-d5f1a2be336d
1
Microsoft Windows: 7 - 64bit
Office: 2013 (32bit)
Adobe Acrobat Reader: 11.0.01
Pūpāpāho Kohiko: 13 (monomai & HoheX)
Wā Whakahaere Java: 1.7.0U9
6c453c9b-20f7-471a-956c-3198a868dc92
1
Microsoft Windows: 8.1 - 64bit
Office: 2013 (64bit)
Adobe Acrobat Reader: 11.0.10
Pūpāpāho Kohiko: 18.0.0.160 (monomai & HoheX)
Wā Whakahaere Java: 1.7.0U9
10b4a9c6-e414-425c-ae8b-fe4dd7b25244
1
Microsoft Windows: 10
Office: Ngaio Plus 2016 en-us
Adobe Acrobat Reader: DC 2015 MUI
Pūpāpāho Kohiko: 20 (monomai & HoheX)
Wā Whakahaere Java: 1.7.0U9
Mena karekau te kii atahanga i tohua, katahi ka mahia nga whakaahua i roto i nga whakaahua e taunakihia ana e Check Point (Wina XP me Win 7 inaianei). Ka tūtohuhia enei whakaahua i runga i nga whakaaro mo te toenga pai o te mahinga me te reeti hopu.
pūrongo — he rarangi o nga purongo ka tono matou mena ka puta he kino te konae. Kei te waatea nga whiringa e whai ake nei:
-
whakarāpopototanga - .tar.gz pūranga kei roto he purongo mo te tauira a ki te katoa i tono whakaahua (he wharangi html me nga waahanga penei i te ataata mai i te emulator OS, he putunga hokohoko whatunga, he ripoata i roto i te json, me te tauira ano kei roto i te puranga tiaki-kupuhipa). Kei te rapu matou mo te matua o te whakautu - summary_report mo te tangohanga ake o te purongo.
-
pdf - tuhinga mo te peehi i roto kotahi he ahua, he maha nga tangata e waia ana ki te whiwhi ma te Smart Console. Kei te rapu matou mo te matua o te whakautu - pdf_report mo te tangohanga ake o te purongo.
-
xml - tuhinga mo te peehi i roto kotahi atahanga, he watea mo te wetewete i nga tawhā i roto i te purongo. Kei te rapu matou mo te matua o te whakautu - xml_report mo te tangohanga ake o te purongo.
-
tar - .tar.gz pūranga kei roto he purongo mo te tauira i roto kotahi i tono whakaahua (he wharangi html me nga waahanga penei i te ataata mai i te emulator OS, he putunga hokohoko whatunga, he ripoata i roto i te json, me te tauira ano kei roto i te puranga tiaki-kupuhipa). Kei te rapu matou mo te matua o te whakautu - purongo_katoa mo te tangohanga ake o te purongo.
He aha kei roto i te ripoata whakarāpopototanga
Ko nga taviri full_report, pdf_report, xml_report kei roto i te papakupu mo ia 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."
}
}
}
]
}Engari ko te matua whakarāpopoto_pūrongo - he kotahi hei tauira i te nuinga
{
"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."
}
}
}
]
}Ka taea e koe te tono tar me te xml me te pdf ripoata i te wa ano, ka taea e koe te tono whakarapopototanga me te tar me te xml. Kare e taea te tono he ripoata whakarāpopoto me te pdf i te wa ano.
Kī i te wāhanga tangohanga
Mo te tangohanga riri, e rua noa nga taviri e whakamahia ana:
tikanga — pdf (hurihia ki te pdf, whakamahia taunoa) ma ranei (te horoi i nga ihirangi hohe).
tangohia_waehere_waehere - rarangi o nga waehere mo te tango i nga ihirangi hohe, e tika ana mo te tikanga ma
Waehere mo te tango ihirangi mai i nga konae
Code
Whakaahuatanga
1025
Nga mea hono
1026
Tonotono me te Waehere
1034
Honongaitua tairongo
1137
Nga Mahi PDF GoToR
1139
Nga Mahi Whakarewa PDF
1141
Nga Mahi URI PDF
1142
Nga Mahi Oro PDF
1143
Nga Mahi Kiriata PDF
1150
Nga Mahi JavaScript PDF
1151
PDF Tuku Puka Mahi
1018
Uiui Raraunga Raraunga
1019
Nga mea kua mau
1021
Tere Tiaki Raraunga
1017
Nga Tikanga Ritenga
1036
Nga Taonga Tauanga
1037
Ahuatanga Whakarāpopoto
Hei tango i tetahi kape kua horoia, me tono patai ano koe (ka korerohia i raro nei) i muri i etahi hēkona, me te tohu i te nui o te hash o te konae me te waahanga tangohanga i roto i te tuhinga tono. Ka taea e koe te tiki i te konae kua horoia ma te whakamahi i te id mai i te whakautu ki te patai - extracted_file_download_id. Ano ano, ka titiro whakamua iti, ka hoatu e ahau etahi tauira o te tono me te whakautu patai ki te rapu i te id mo te tango i tetahi tuhinga kua whakakorehia.
Tono patai ki te rapu mo te kii extracted_file_download_id
{ "request": [
{
"sha256": "9a346005ee8c9adb489072eb8b5b61699652962c17596de9c326ca68247a8876",
"features": ["extraction"] ,
"extraction": {
"method": "pdf"
}
}
]
}Whakautu ki te patai (titiro mo 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."
}
}
}
]
}Nga korero whānui
I roto i te piiraa API kotahi, ka taea e koe te tuku kotahi noa te konae hei manatoko.
Ko te waahanga av kaore e hiahiatia he waahanga taapiri me nga taviri, he nui ki te tohu i roto i te papakupu āhuatanga.
Uiui waea API
Tikanga whakamahia − POST
Wāhitau waea - https:///tecloud/api/v1/file/query
I mua i te tuku i tetahi konae mo te tango (tono tuku ake), he mea tika kia tirohia te keteroki pouaka kirikiri (tono patai) kia pai ai te utaina ki runga i te tūmau API, na te mea kei te kaimau API nga korero me te whakatau mo te konae kua tangohia. Ko te waea he waahanga kuputuhi anake. Ko te waahanga e hiahiatia ana o te tono ko te nui o te hash sha1/sha256/md5 o te konae. Ma te ara, ka taea e koe te tiki i roto i te whakautu ki te tono tukuake.
Te iti e hiahiatia ana mo te patai
HTTP POST
https:///tecloud/api/v1/file/query
Pane:
Whakaaetanga:
Body
{
"tono": {
"sha256":
}
}
He tauira o te whakautu ki te tono tukuake, ka kitea nga moni 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."
}
}
}
}Ko te tono patai, i tua atu i te nui o te hash, me rite tonu ki te tono tukuake i mua (kei te whakamaheretia ranei), ara "kua" ranei (he iti ake nga mara i roto i te tono patai atu i te tono tuku). Mēnā he nui ake ngā āpure i roto i te tono uiui i te tono tukuake, kare koe e whiwhi i nga korero e hiahiatia ana i roto i te whakautu.
Anei tetahi tauira o te whakautu ki tetahi patai kaore i kitea nga raraunga e hiahiatia ana
{
"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."
}
}
}
]
}Kia tupato ki nga mara waehere и tapanga. E toru nga wa ka puta enei mara ki nga papakupu mana. Tuatahi ka kite tatou i te "waehere" matua o te ao: 1006 me te "tapanga": "PARTIALLY_FOUND". I muri mai, ka kitea enei ki mo ia waahanga takitahi i tonohia e matou - te me te tangohanga. A ki te mea mo te marama kua kitea nga raraunga, karekau he korero mo te tangohanga.
Koinei te ahua o te patai mo te tauira i runga ake nei
{ "request": [
{
"sha256": {{sha256}},
"features": ["te", "extraction"] ,
"te": {
"images": [
{
"id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
"revision": 1
}
],
"reports": [
"xml", "pdf"
]
}
}
]
}Mena ka tukuna he tono patai kaore he waahanga tangohanga
{ "request": [
{
"sha256": {{sha256}},
"features": ["te"] ,
"te": {
"images": [
{
"id": "10b4a9c6-e414-425c-ae8b-fe4dd7b25244",
"revision": 1
}
],
"reports": [
"xml", "pdf"
]
}
}
]
}Na kei roto i te whakautu nga korero katoa ("waehere": 1001, "tapanga": "KIRIHIA")
{
"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."
}
}
}
]
}Mena karekau he korero i roto i te keteroki katoa, katahi ka "tapanga" te whakautu: "KORE_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."
}
}
}
]
}I roto i te piiraa API kotahi, ka taea e koe te tuku i nga moni hash i te wa kotahi mo te manatoko. Ko te whakautu ka whakahoki raraunga i roto i te raupapa rite i tukuna i roto i te tono.
He tauira tono patai me te maha o nga moni sha256
{ "request": [
{
"sha256": "b84531d3829bf6131655773a3863d6b16f6389b7f4036aef9b81c0cb60e7fd81"
},
{
"sha256": "b84531d3829bf6131655773a3863d6b16f6389b7f4036aef9b81c0cb60e7fd82"
}
]
}Whakautu ki tetahi patai me nga moni sha256 maha
{
"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."
}
}
}
]
}Ko te tono i nga moni hash i te wa kotahi i roto i te tono patai ka whai painga ano ki te mahinga o te tūmau API.
Tikiake waea API
Tikanga whakamahia − POST (e ai ki nga tuhinga), GET ka mahi hoki (a he ahua arorau ake pea)
Wāhitau waea - https:///tecloud/api/v1/file/download?id=
Ko te pane e hiahia ana kia tukuna te kii API, ka noho kau te tinana o te tono, ka tukuna te id tikiake ki te wahitau URL.
Hei whakautu ki te tono patai, mena kua oti te tauira me te tono purongo i te wa e tango ana i te konae, ka kitea te id mo te tango purongo. Mena ka tonohia he kape kua horoia, me rapu koe mo te id hei tango i te tuhinga kua horoia.
Katoa, ko nga ki o te whakautu ki te patai kei roto te uara id mo te uta ka taea:
-
summary_report
-
purongo_katoa
-
pdf_report
-
xml_report
-
extracted_file_download_id
Ko te tikanga, kia whiwhi ai i enei taviri hei whakautu ki te tono patai, me tohu i roto i te tono (mo nga purongo) me mahara ranei ki te tono ma te whakamahi i te mahi tangohanga (mo nga tuhinga kua horoia)
Waea API morahi
Tikanga whakamahia − POST
Wāhitau waea - https:///tecloud/api/v1/file/quota
Hei taki i te toenga roherohenga i te kapua, whakamahia te patai motunga. Kei te putua te tinana tono.
Tauira whakautu ki te tono motunga
{
"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 Whakamatamata mo te Waahi Haumarutanga
I whakawhanakehia tenei API i mua i te API Aukati Whakawehi, a ko te tikanga mo nga taputapu rohe anake. Inaianei ka whai hua noa mena ka hiahia koe ki te API Tangohanga Whakawehi. Mo te Whakatairanga Whakawehi he pai ake te whakamahi i te API Whakatikatika Whakawehi. Hei whakakā TP API mo SG me te whirihora i te matua API me whai koe i nga hikoinga mai . Ka tūtohu ahau kia aro ki te taahiraa 6b me te tirotiro i te urunga o te wharangi https://<IPAddressofSecurityGateway>/UserCheck/TPAPI na te mea ka puta he hua kino, kaore he tikanga o etahi atu whirihoranga. Ka tukuna nga waea API katoa ki tenei url. Ko te momo waea (tuku ake/uiui) kua whakaritea i roto i te matua waea waea − tono_ingoa. Ko nga taviri hoki e hiahiatia ana - api_key (me mahara koe i roto i te tukanga whirihoranga) me kawa_putanga (Ko te putanga o naianei ko 1.1). Ka kitea e koe nga tuhinga mana mo tenei API i . Ko nga painga whai hua ko te kaha ki te tuku i nga konae maha i te wa kotahi hei tauira i te wa e utaina ana, na te mea ka tukuna nga konae hei aho kuputuhi base64. Hei whakawaehere/ wetewete i nga konae ki/mai i te base64 ka taea e koe te whakamahi i te kaitahuri ipurangi ki te Poutāpeta mo nga kaupapa whakaatu, hei tauira - . Mo nga kaupapa whaitake, me whakamahi koe i nga tikanga whakauru me te wetewete i te wa e tuhi ana i te waehere.
Inaianei me ata titiro ki nga mahi te и tangohanga i roto i tenei API.
Mo te waahanga te papakupu kua whakaratohia te_kōwhiringa i roto i nga tono tukuake/uiui, a ko nga ki o tenei tono ka tino rite ki nga taviri kei roto .
He tauira tono mo te whai i te konae i Win10 me nga purongo
{
"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"]
}
}
]
}Mo te waahanga tangohanga papakupu kua whakaratohia scrub_options. Ko tenei tono e tohu ana i te tikanga horoi: huri ki te PDF, maamaa nga ihirangi hohe, kowhiria ranei he aratau kia rite ki te tohu Whakatupato (kua tohua te ingoa kōtaha). Ko te mea pai mo te whakautu ki te tono API tangohanga mo tetahi konae ka whiwhi koe i tetahi kape kua horoia i roto i te whakautu ki taua tono hei aho whakamunatia base64 (kaore koe e hiahia ki te tono patai me te rapu i te id hei tango i te tuhinga)
He tauira o te tono ki te whakakore i tetahi konae
{
"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
}
}]
}Whakautu ki tetahi tono
{
"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": ""
}
}]
} Ahakoa te mea he iti ake nga tono API e hiahiatia ana kia whiwhi kape kua whakakorehia, ka kite ahau he iti ake te pai me te watea i tenei waahanga i te tono puka-raraunga i whakamahia i .
Kohinga Poutapeta
I waihangahia e ahau nga kohinga ki te Kaituku Poutāpeta mo te API Aukati Whakamatamata me te API Whakatikatika mo te Waahi Haumarutanga, e tohu ana i nga tono API tino noa. Kia taea ai te whakakapi aunoa i te ip/url API me te matua ki roto i nga tono, ka maumahara te nui o te hash sha256 i muri i te tango i te konae, e toru nga taurangi kua hangaia i roto i nga kohinga (ka kitea e koe ma te haere ki nga tautuhinga kohinga. Whakatika -> Taurangi): te_api (hiahia), api_key (me whakakīhia, engari i te whakamahi i te TP API me nga taputapu rohe), sha256 (waiho kau, kaua e whakamahia ki te TP API mo SG).
Tauira Whakamahi
I roto i te hapori Ko nga tuhinga kua tuhia ki te Python ka whakaatuhia hei tirotiro i nga konae mai i te raarangi e hiahiatia ana ma , a . Na roto i te taunekeneke me te API Aukati Whakamatamata, kua tino whakawhänuihia to kaha ki te matawai i nga konae, na te mea ka taea e koe te matawai i nga konae ki nga papaaho maha i te wa kotahi (tirohia mai , a ka i roto i te pouaka kirikiri Tirotiro), ka whiwhi i nga konae mai i te hokohoko whatunga anake, engari ka tangohia ano mai i nga puku whatunga me, hei tauira, nga punaha CRM.
Source: will.com