ਏਪੀਆਈ ਦੁਆਰਾ ਚੈੱਕ ਪੁਆਇੰਟ ਸੈਂਡਬਲਾਸਟ ਨਾਲ ਗੱਲਬਾਤ

ਇਹ ਲੇਖ ਉਹਨਾਂ ਲਈ ਲਾਭਦਾਇਕ ਹੋਵੇਗਾ ਜੋ ਤਕਨਾਲੋਜੀ ਤੋਂ ਜਾਣੂ ਹਨ ਚੈੱਕ ਪੁਆਇੰਟ ਫਾਈਲ ਇਮੂਲੇਸ਼ਨ ਦੁਆਰਾ (ਧਮਕੀ ਇਮੂਲੇਸ਼ਨ) ਅਤੇ ਪ੍ਰੋਐਕਟਿਵ ਫਾਈਲ ਕਲੀਨਿੰਗ (ਧਮਕੀ ਕੱਢਣ) ਅਤੇ ਇਹਨਾਂ ਕੰਮਾਂ ਨੂੰ ਸਵੈਚਲਿਤ ਕਰਨ ਵੱਲ ਇੱਕ ਕਦਮ ਚੁੱਕਣਾ ਚਾਹੁੰਦਾ ਹੈ। ਚੈੱਕ ਪੁਆਇੰਟ ਹੈ ਧਮਕੀ ਰੋਕਥਾਮ API, ਜੋ ਕਿ ਕਲਾਉਡ ਅਤੇ ਲੋਕਲ ਡਿਵਾਈਸਾਂ 'ਤੇ ਚੱਲਦਾ ਹੈ, ਅਤੇ ਕਾਰਜਾਤਮਕ ਤੌਰ 'ਤੇ ਇਹ ਵੈੱਬ/smtp/ftp/smb/nfs ਟ੍ਰੈਫਿਕ ਸਟ੍ਰੀਮ ਵਿੱਚ ਫਾਈਲਾਂ ਦੀ ਜਾਂਚ ਕਰਨ ਦੇ ਸਮਾਨ ਹੈ. ਇਹ ਲੇਖ ਅੰਸ਼ਕ ਤੌਰ 'ਤੇ ਅਧਿਕਾਰਤ ਦਸਤਾਵੇਜ਼ਾਂ ਤੋਂ ਲੇਖਾਂ ਦੇ ਇੱਕ ਸਮੂਹ ਦੀ ਲੇਖਕ ਦੀ ਵਿਆਖਿਆ ਹੈ, ਪਰ ਮੇਰੇ ਆਪਣੇ ਓਪਰੇਟਿੰਗ ਅਨੁਭਵ ਅਤੇ ਮੇਰੀਆਂ ਆਪਣੀਆਂ ਉਦਾਹਰਣਾਂ ਦੇ ਅਧਾਰ 'ਤੇ ਹੈ। ਲੇਖ ਵਿੱਚ ਤੁਹਾਨੂੰ ਧਮਕੀ ਰੋਕਥਾਮ API ਦੇ ਨਾਲ ਕੰਮ ਕਰਨ ਲਈ ਲੇਖਕ ਦੇ ਪੋਸਟਮੈਨ ਸੰਗ੍ਰਹਿ ਵੀ ਮਿਲਣਗੇ।

ਮੂਲ ਸੰਖੇਪ

The Threat Prevention API ਤਿੰਨ ਮੁੱਖ ਭਾਗਾਂ ਨਾਲ ਕੰਮ ਕਰਦਾ ਹੈ, ਜਿਨ੍ਹਾਂ ਨੂੰ ਹੇਠ ਲਿਖੇ ਟੈਕਸਟ ਮੁੱਲਾਂ ਰਾਹੀਂ API ਵਿੱਚ ਬੁਲਾਇਆ ਜਾਂਦਾ ਹੈ:

av - ਐਂਟੀ-ਵਾਇਰਸ ਕੰਪੋਨੈਂਟ, ਜਾਣੇ-ਪਛਾਣੇ ਖਤਰਿਆਂ ਦੇ ਦਸਤਖਤ ਵਿਸ਼ਲੇਸ਼ਣ ਲਈ ਜ਼ਿੰਮੇਵਾਰ।

te - ਧਮਕੀ ਇਮੂਲੇਸ਼ਨ ਕੰਪੋਨੈਂਟ, ਸੈਂਡਬੌਕਸ ਵਿੱਚ ਫਾਈਲਾਂ ਦੀ ਜਾਂਚ ਕਰਨ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਹੈ, ਅਤੇ ਇਮੂਲੇਸ਼ਨ ਤੋਂ ਬਾਅਦ ਇੱਕ ਖਤਰਨਾਕ/ਸਾਊ ਫੈਸਲਾ ਕਰਨ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਹੈ।

ਕੱractionਣ - ਧਮਕੀ ਐਕਸਟਰੈਕਸ਼ਨ ਕੰਪੋਨੈਂਟ, ਦਫਤਰੀ ਦਸਤਾਵੇਜ਼ਾਂ ਨੂੰ ਤੇਜ਼ੀ ਨਾਲ ਉਪਭੋਗਤਾਵਾਂ/ਸਿਸਟਮ ਤੱਕ ਪਹੁੰਚਾਉਣ ਲਈ, ਇੱਕ ਸੁਰੱਖਿਅਤ ਰੂਪ ਵਿੱਚ (ਜਿਸ ਵਿੱਚ ਸਾਰੇ ਸੰਭਾਵੀ ਤੌਰ 'ਤੇ ਖਤਰਨਾਕ ਸਮੱਗਰੀ ਨੂੰ ਹਟਾ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ) ਵਿੱਚ ਬਦਲਣ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਹੈ।

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 ਗਲਤੀ ਮਿਲੇਗੀ।

ਸੈਂਡਬਲਾਸਟ 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)। ਏਪੀਆਈ ਕੁੰਜੀ ਨੂੰ ਚੈੱਕ ਪੁਆਇੰਟ ਪਾਰਟਨਰ ਜਾਂ ਕੰਪਨੀ ਦੇ ਸਥਾਨਕ ਦਫ਼ਤਰ ਨਾਲ ਸੰਪਰਕ ਕਰਕੇ 60 ਦਿਨਾਂ ਲਈ ਅਜ਼ਮਾਇਸ਼ ਲਾਇਸੰਸ ਵਜੋਂ ਪ੍ਰਾਪਤ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ।

ਸਥਾਨਕ ਡਿਵਾਈਸਾਂ 'ਤੇ, ਥ੍ਰੇਟ ਐਕਸਟਰੈਕਸ਼ਨ ਅਜੇ ਸਟੈਂਡਰਡ ਵਜੋਂ ਸਮਰਥਿਤ ਨਹੀਂ ਹੈ। ਧਮਕੀ ਰੋਕਥਾਮ API ਅਤੇ ਵਰਤਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ ਸੁਰੱਖਿਆ ਗੇਟਵੇ ਲਈ ਧਮਕੀ ਰੋਕਥਾਮ API (ਅਸੀਂ ਲੇਖ ਦੇ ਅੰਤ ਵਿੱਚ ਇਸ ਬਾਰੇ ਵਧੇਰੇ ਵਿਸਥਾਰ ਨਾਲ ਗੱਲ ਕਰਾਂਗੇ)।

ਸਥਾਨਕ ਡਿਵਾਈਸ ਕੋਟਾ ਬੇਨਤੀ ਦਾ ਸਮਰਥਨ ਨਹੀਂ ਕਰਦੇ ਹਨ।

ਨਹੀਂ ਤਾਂ, ਸਥਾਨਕ ਡਿਵਾਈਸਾਂ ਅਤੇ ਕਲਾਉਡ ਲਈ ਬੇਨਤੀਆਂ ਵਿੱਚ ਕੋਈ ਅੰਤਰ ਨਹੀਂ ਹੈ।

API ਕਾਲ ਅੱਪਲੋਡ ਕਰੋ

ਵਰਤੀ ਗਈ ਵਿਧੀ - ਪੋਸਟ

ਕਾਲ ਦਾ ਪਤਾ - https:///tecloud/api/v1/file/upload

ਬੇਨਤੀ ਵਿੱਚ ਦੋ ਭਾਗ ਹੁੰਦੇ ਹਨ (ਫਾਰਮ-ਡਾਟਾ): ਇਮੂਲੇਸ਼ਨ/ਸਫਾਈ ਲਈ ਇੱਕ ਫਾਈਲ ਅਤੇ ਟੈਕਸਟ ਦੇ ਨਾਲ ਇੱਕ ਬੇਨਤੀ ਬਾਡੀ।

ਟੈਕਸਟ ਬੇਨਤੀ ਖਾਲੀ ਨਹੀਂ ਹੋ ਸਕਦੀ, ਪਰ ਇਸ ਵਿੱਚ ਕੋਈ ਸੰਰਚਨਾ ਸ਼ਾਮਲ ਨਹੀਂ ਹੋ ਸਕਦੀ ਹੈ। ਬੇਨਤੀ ਦੇ ਸਫਲ ਹੋਣ ਲਈ, ਤੁਹਾਨੂੰ ਬੇਨਤੀ ਵਿੱਚ ਘੱਟੋ-ਘੱਟ ਹੇਠ ਲਿਖਿਆ ਟੈਕਸਟ ਭੇਜਣਾ ਚਾਹੀਦਾ ਹੈ:

ਅੱਪਲੋਡ ਬੇਨਤੀ ਲਈ ਘੱਟੋ-ਘੱਟ ਲੋੜੀਂਦਾ

HTTP ਪੋਸਟ

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

ਸਿਰਲੇਖ:

ਅਧਿਕਾਰ:

ਸਰੀਰ ਦੇ

{

"ਬੇਨਤੀ": {

}

}

ਫਾਇਲ

ਫਾਇਲ

ਇਸ ਸਥਿਤੀ ਵਿੱਚ, ਫਾਈਲ ਨੂੰ ਡਿਫੌਲਟ ਪੈਰਾਮੀਟਰਾਂ ਦੇ ਅਨੁਸਾਰ ਸੰਸਾਧਿਤ ਕੀਤਾ ਜਾਵੇਗਾ: ਕੰਪੋਨੈਂਟ - te, OS ਚਿੱਤਰ - Win XP ਅਤੇ Win 7, ਰਿਪੋਰਟ ਬਣਾਏ ਬਿਨਾਂ।

ਟੈਕਸਟ ਬੇਨਤੀ ਵਿੱਚ ਮੁੱਖ ਖੇਤਰਾਂ 'ਤੇ ਟਿੱਪਣੀਆਂ:

ਫਾਈਲ ਦਾ ਨਾਮ и file_type ਤੁਸੀਂ ਉਹਨਾਂ ਨੂੰ ਖਾਲੀ ਛੱਡ ਸਕਦੇ ਹੋ ਜਾਂ ਉਹਨਾਂ ਨੂੰ ਬਿਲਕੁਲ ਨਹੀਂ ਭੇਜ ਸਕਦੇ ਹੋ, ਕਿਉਂਕਿ ਇਹ ਇੱਕ ਫਾਈਲ ਅੱਪਲੋਡ ਕਰਨ ਵੇਲੇ ਖਾਸ ਤੌਰ 'ਤੇ ਉਪਯੋਗੀ ਜਾਣਕਾਰੀ ਨਹੀਂ ਹੈ। API ਜਵਾਬ ਵਿੱਚ, ਇਹ ਖੇਤਰ ਡਾਉਨਲੋਡ ਕੀਤੀ ਫਾਈਲ ਦੇ ਨਾਮ ਦੇ ਅਧਾਰ ਤੇ ਆਪਣੇ ਆਪ ਭਰੇ ਜਾਣਗੇ, ਅਤੇ ਕੈਸ਼ ਵਿੱਚ ਜਾਣਕਾਰੀ ਨੂੰ ਅਜੇ ਵੀ md5/sha1/sha256 ਹੈਸ਼ ਮਾਤਰਾਵਾਂ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਖੋਜਣਾ ਪਏਗਾ।

ਖਾਲੀ ਫਾਈਲ_ਨਾਮ ਅਤੇ ਫਾਈਲ_ਟਾਈਪ ਦੇ ਨਾਲ ਉਦਾਹਰਨ ਬੇਨਤੀ

{

"request": {

"file_name": "",

"file_type": "",

}

}

ਫੀਚਰ — ਇੱਕ ਸੂਚੀ ਜੋ ਸੈਂਡਬੌਕਸ ਵਿੱਚ ਪ੍ਰਕਿਰਿਆ ਕਰਨ ਵੇਲੇ ਲੋੜੀਂਦੀ ਕਾਰਜਕੁਸ਼ਲਤਾ ਨੂੰ ਦਰਸਾਉਂਦੀ ਹੈ - av (ਐਂਟੀ-ਵਾਇਰਸ), te (ਥ੍ਰੇਟ ਇਮੂਲੇਸ਼ਨ), ਐਕਸਟਰੈਕਸ਼ਨ (ਥ੍ਰੇਟ ਐਕਸਟਰੈਕਸ਼ਨ)। ਜੇਕਰ ਇਹ ਪੈਰਾਮੀਟਰ ਬਿਲਕੁਲ ਪਾਸ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾ ਹੈ, ਤਾਂ ਸਿਰਫ ਡਿਫਾਲਟ ਕੰਪੋਨੈਂਟ ਵਰਤਿਆ ਜਾਵੇਗਾ - te (ਖਤਰੇ ਦੀ ਇਮੂਲੇਸ਼ਨ)।

ਤਿੰਨ ਉਪਲਬਧ ਭਾਗਾਂ ਵਿੱਚ ਜਾਂਚ ਨੂੰ ਸਮਰੱਥ ਕਰਨ ਲਈ, ਤੁਹਾਨੂੰ API ਬੇਨਤੀ ਵਿੱਚ ਇਹਨਾਂ ਭਾਗਾਂ ਨੂੰ ਨਿਰਧਾਰਤ ਕਰਨ ਦੀ ਲੋੜ ਹੈ।

av, te ਅਤੇ ਐਕਸਟਰੈਕਸ਼ਨ ਦੀ ਜਾਂਚ ਕਰਨ ਵਾਲੀ ਬੇਨਤੀ ਦੀ ਉਦਾਹਰਨ

{ "request":  [  

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

te ਭਾਗ ਵਿੱਚ ਕੁੰਜੀਆਂ

ਚਿੱਤਰ — ਓਪਰੇਟਿੰਗ ਸਿਸਟਮਾਂ ਦੇ id ਅਤੇ ਸੰਸ਼ੋਧਨ ਨੰਬਰ ਦੇ ਨਾਲ ਸ਼ਬਦਕੋਸ਼ਾਂ ਵਾਲੀ ਇੱਕ ਸੂਚੀ ਜਿਸ ਵਿੱਚ ਜਾਂਚ ਕੀਤੀ ਜਾਵੇਗੀ। ID ਅਤੇ ਸੰਸ਼ੋਧਨ ਨੰਬਰ ਸਾਰੀਆਂ ਸਥਾਨਕ ਡਿਵਾਈਸਾਂ ਅਤੇ ਕਲਾਉਡ ਲਈ ਇੱਕੋ ਜਿਹੇ ਹਨ।

ਓਪਰੇਟਿੰਗ ਸਿਸਟਮਾਂ ਅਤੇ ਸੋਧਾਂ ਦੀ ਸੂਚੀ

ਉਪਲਬਧ OS ਚਿੱਤਰ ID

ਰੀਵਿਜ਼ਨ

ਚਿੱਤਰ OS ਅਤੇ ਐਪਲੀਕੇਸ਼ਨ

e50e99f3-5963-4573-af9e-e3f4750b55e2

1

Microsoft Windows: XP - 32bit SP3
ਦਫਤਰ: 2003, 2007
ਅਡੋਬ ਐਕਰੋਬੈਟ ਰੀਡਰ: 9.0
ਫਲੈਸ਼ ਪਲੇਅਰ 9r115 ਅਤੇ ActiveX 10.0
Java ਰਨਟਾਈਮ: 1.6.0u22

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

1

Microsoft Windows: 7 - 32 ਬਿੱਟ
ਦਫਤਰ: 2003, 2007
ਅਡੋਬ ਐਕਰੋਬੈਟ ਰੀਡਰ: 9.0
ਫਲੈਸ਼ ਪਲੇਅਰ: 10.2r152 (ਪਲੱਗਇਨ& ActiveX)
Java ਰਨਟਾਈਮ: 1.6.0u0

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

1

Microsoft Windows: 7 - 32 ਬਿੱਟ
ਦਫਤਰ: 2010
ਅਡੋਬ ਐਕਰੋਬੈਟ ਰੀਡਰ: 9.4
ਫਲੈਸ਼ ਪਲੇਅਰ: 11.0.1.152 (ਪਲੱਗਇਨ & ActiveX)
Java ਰਨਟਾਈਮ: 1.7.0u0

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

1

Microsoft Windows: 7 - 32 ਬਿੱਟ
ਦਫਤਰ: 2013
ਅਡੋਬ ਐਕਰੋਬੈਟ ਰੀਡਰ: 11.0
ਫਲੈਸ਼ ਪਲੇਅਰ: 15 (ਪਲੱਗਇਨ & ActiveX)
Java ਰਨਟਾਈਮ: 1.7.0u9

3ff3ddae-e7fd-4969-818c-d5f1a2be336d

1

Microsoft Windows: 7 - 64 ਬਿੱਟ
ਦਫਤਰ: 2013 (32 ਬਿੱਟ)
ਅਡੋਬ ਐਕਰੋਬੈਟ ਰੀਡਰ: 11.0.01
ਫਲੈਸ਼ ਪਲੇਅਰ: 13 (ਪਲੱਗਇਨ & ActiveX)
Java ਰਨਟਾਈਮ: 1.7.0u9

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

 

1 

Microsoft Windows: 8.1 - 64 ਬਿੱਟ
ਦਫਤਰ: 2013 (64 ਬਿੱਟ)
ਅਡੋਬ ਐਕਰੋਬੈਟ ਰੀਡਰ: 11.0.10
ਫਲੈਸ਼ ਪਲੇਅਰ: 18.0.0.160 (ਪਲੱਗਇਨ & ActiveX)
Java ਰਨਟਾਈਮ: 1.7.0u9

10b4a9c6-e414-425c-ae8b-fe4dd7b25244 

 

1

Microsoft Windows: 10
ਦਫਤਰ: ਪ੍ਰੋਫੈਸ਼ਨਲ ਪਲੱਸ 2016 en-us  
ਅਡੋਬ ਐਕਰੋਬੈਟ ਰੀਡਰ: DC 2015 MUI
ਫਲੈਸ਼ ਪਲੇਅਰ: 20 (ਪਲੱਗਇਨ & ActiveX)
Java ਰਨਟਾਈਮ: 1.7.0u9

ਜੇਕਰ ਚਿੱਤਰ ਕੁੰਜੀ ਬਿਲਕੁਲ ਵੀ ਨਿਰਧਾਰਤ ਨਹੀਂ ਕੀਤੀ ਗਈ ਹੈ, ਤਾਂ ਇਮੂਲੇਸ਼ਨ ਚੈਕ ਪੁਆਇੰਟ ਦੁਆਰਾ ਸਿਫ਼ਾਰਿਸ਼ ਕੀਤੇ ਚਿੱਤਰਾਂ ਵਿੱਚ ਹੋਵੇਗੀ (ਵਰਤਮਾਨ ਵਿੱਚ 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 ਰਿਪੋਰਟਾਂ ਦੀ ਬੇਨਤੀ ਕਰ ਸਕਦੇ ਹੋ, ਤੁਸੀਂ ਸੰਖੇਪ ਅਤੇ tar ਅਤੇ xml ਲਈ ਬੇਨਤੀ ਕਰ ਸਕਦੇ ਹੋ। ਇੱਕੋ ਸਮੇਂ ਸੰਖੇਪ ਰਿਪੋਰਟ ਅਤੇ ਪੀਡੀਐਫ ਦੀ ਬੇਨਤੀ ਕਰਨਾ ਸੰਭਵ ਨਹੀਂ ਹੋਵੇਗਾ।

ਐਕਸਟਰੈਕਸ਼ਨ ਸੈਕਸ਼ਨ ਵਿੱਚ ਕੁੰਜੀਆਂ

ਧਮਕੀ ਕੱਢਣ ਲਈ, ਸਿਰਫ ਦੋ ਕੁੰਜੀਆਂ ਵਰਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ:

ਢੰਗ ਹੈ - pdf (pdf ਵਿੱਚ ਬਦਲੋ, ਮੂਲ ਰੂਪ ਵਿੱਚ ਵਰਤੀ ਜਾਂਦੀ ਹੈ) ਜਾਂ ਸਾਫ਼ (ਕਿਰਿਆਸ਼ੀਲ ਸਮੱਗਰੀ ਨੂੰ ਸਾਫ਼ ਕਰਨਾ)।

extracted_parts_codes - ਕਿਰਿਆਸ਼ੀਲ ਸਮੱਗਰੀ ਨੂੰ ਹਟਾਉਣ ਲਈ ਕੋਡਾਂ ਦੀ ਸੂਚੀ, ਸਿਰਫ਼ ਸਾਫ਼ ਵਿਧੀ ਲਈ ਲਾਗੂ

ਫਾਈਲਾਂ ਤੋਂ ਸਮੱਗਰੀ ਨੂੰ ਹਟਾਉਣ ਲਈ ਕੋਡ

ਕੋਡ

ਵੇਰਵਾ

1025

ਲਿੰਕ ਕੀਤੀਆਂ ਵਸਤੂਆਂ

1026

ਮੈਕਰੋ ਅਤੇ ਕੋਡ

1034

ਸੰਵੇਦਨਸ਼ੀਲ ਹਾਈਪਰਲਿੰਕਸ

1137

PDF GoToR ਕਾਰਵਾਈਆਂ

1139

PDF ਲਾਂਚ ਕਾਰਵਾਈਆਂ

1141

PDF URI ਕਾਰਵਾਈਆਂ

1142

PDF ਸਾਊਂਡ ਐਕਸ਼ਨ

1143

PDF ਮੂਵੀ ਐਕਸ਼ਨ

1150

PDF JavaScript ਕਾਰਵਾਈਆਂ

1151

PDF ਸਪੁਰਦ ਕਰੋ ਫਾਰਮ ਕਾਰਵਾਈਆਂ

1018

ਡਾਟਾਬੇਸ ਸਵਾਲ

1019

ਏਮਬੇਡ ਕੀਤੀਆਂ ਵਸਤੂਆਂ

1021

ਫਾਸਟ ਸੇਵ ਡਾਟਾ

1017

ਕਸਟਮ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ

1036

ਅੰਕੜਾ ਵਿਸ਼ੇਸ਼ਤਾ

1037

ਸੰਖੇਪ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ

ਇੱਕ ਸਾਫ਼ ਕੀਤੀ ਕਾਪੀ ਨੂੰ ਡਾਊਨਲੋਡ ਕਰਨ ਲਈ, ਤੁਹਾਨੂੰ ਬੇਨਤੀ ਟੈਕਸਟ ਵਿੱਚ ਫਾਈਲ ਦੀ ਹੈਸ਼ ਮਾਤਰਾ ਅਤੇ ਐਕਸਟਰੈਕਸ਼ਨ ਕੰਪੋਨੈਂਟ ਨੂੰ ਨਿਸ਼ਚਿਤ ਕਰਦੇ ਹੋਏ, ਕੁਝ ਸਕਿੰਟਾਂ ਬਾਅਦ ਇੱਕ ਪੁੱਛਗਿੱਛ ਬੇਨਤੀ (ਜਿਸ ਬਾਰੇ ਹੇਠਾਂ ਚਰਚਾ ਕੀਤੀ ਜਾਵੇਗੀ) ਕਰਨ ਦੀ ਵੀ ਲੋੜ ਹੋਵੇਗੀ। ਤੁਸੀਂ ਪੁੱਛਗਿੱਛ ਦੇ ਜਵਾਬ ਤੋਂ ਆਈਡੀ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸਾਫ਼ ਕੀਤੀ ਫਾਈਲ ਨੂੰ ਚੁੱਕ ਸਕਦੇ ਹੋ - extracted_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” ਦੇਖਦੇ ਹਾਂ। ਅੱਗੇ, ਇਹ ਕੁੰਜੀਆਂ ਹਰੇਕ ਵਿਅਕਤੀਗਤ ਹਿੱਸੇ ਲਈ ਲੱਭੀਆਂ ਜਾਂਦੀਆਂ ਹਨ ਜਿਸਦੀ ਅਸੀਂ ਬੇਨਤੀ ਕੀਤੀ ਸੀ - te ਅਤੇ ਐਕਸਟਰੈਕਸ਼ਨ। ਅਤੇ ਜੇਕਰ ਇਹ ਸਪੱਸ਼ਟ ਹੈ ਕਿ ਡੇਟਾ ਲੱਭਿਆ ਗਿਆ ਹੈ, ਤਾਂ ਐਕਸਟਰੈਕਸ਼ਨ ਲਈ ਕੋਈ ਜਾਣਕਾਰੀ ਨਹੀਂ ਹੈ.

ਉਪਰੋਕਤ ਉਦਾਹਰਨ ਲਈ ਪੁੱਛਗਿੱਛ ਇਸ ਤਰ੍ਹਾਂ ਦੀ ਦਿਖਾਈ ਦਿੰਦੀ ਹੈ

{ "request":  [  

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

ਜੇਕਰ ਤੁਸੀਂ ਐਕਸਟਰੈਕਸ਼ਨ ਕੰਪੋਨੈਂਟ ਤੋਂ ਬਿਨਾਂ ਇੱਕ ਪੁੱਛਗਿੱਛ ਬੇਨਤੀ ਭੇਜਦੇ ਹੋ

{ "request":  [  

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

ਫਿਰ ਜਵਾਬ ਵਿੱਚ ਪੂਰੀ ਜਾਣਕਾਰੀ ਹੋਵੇਗੀ (“ਕੋਡ”: 1001, “ਲੇਬਲ”: “ਫਾਊਂਡ”)

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

ਜੇਕਰ ਕੈਸ਼ ਵਿੱਚ ਕੋਈ ਵੀ ਜਾਣਕਾਰੀ ਨਹੀਂ ਹੈ, ਤਾਂ ਜਵਾਬ "ਲੇਬਲ" ਹੋਵੇਗਾ: "NOT_FOUND"

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

ਇੱਕ API ਕਾਲ ਵਿੱਚ, ਤੁਸੀਂ ਤਸਦੀਕ ਲਈ ਇੱਕ ਵਾਰ ਵਿੱਚ ਕਈ ਹੈਸ਼ ਰਕਮਾਂ ਭੇਜ ਸਕਦੇ ਹੋ। ਜਵਾਬ ਉਸੇ ਕ੍ਰਮ ਵਿੱਚ ਡੇਟਾ ਵਾਪਸ ਕਰੇਗਾ ਜਿਵੇਂ ਕਿ ਇਹ ਬੇਨਤੀ ਵਿੱਚ ਭੇਜਿਆ ਗਿਆ ਸੀ।

ਕਈ 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 ਕਾਲ ਡਾਊਨਲੋਡ ਕਰੋ

ਵਰਤੀ ਗਈ ਵਿਧੀ - ਪੋਸਟ (ਦਸਤਾਵੇਜ਼ਾਂ ਅਨੁਸਾਰ), GET ਵੀ ਕੰਮ ਕਰਦਾ ਹੈ (ਅਤੇ ਵਧੇਰੇ ਤਰਕਪੂਰਨ ਲੱਗ ਸਕਦਾ ਹੈ)

ਕਾਲ ਦਾ ਪਤਾ - 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 ਦੀ ਵਰਤੋਂ ਕਰਨਾ ਬਿਹਤਰ ਹੈ। ਚਾਲੂ ਕਰਨ ਲਈ SG ਲਈ TP API ਅਤੇ API ਕੁੰਜੀ ਨੂੰ ਕੌਂਫਿਗਰ ਕਰੋ ਜਿਸ ਤੋਂ ਤੁਹਾਨੂੰ ਕਦਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰਨ ਦੀ ਲੋੜ ਹੈ ਸਕੈਕਸ NUMX. ਮੈਂ ਕਦਮ 6b ਵੱਲ ਧਿਆਨ ਦੇਣ ਅਤੇ ਪੰਨੇ ਦੀ ਪਹੁੰਚਯੋਗਤਾ ਦੀ ਜਾਂਚ ਕਰਨ ਦੀ ਸਿਫਾਰਸ਼ ਕਰਦਾ ਹਾਂ https://<IPAddressofSecurityGateway>/UserCheck/TPAPI ਕਿਉਂਕਿ ਇੱਕ ਨਕਾਰਾਤਮਕ ਨਤੀਜੇ ਦੇ ਮਾਮਲੇ ਵਿੱਚ, ਹੋਰ ਸੰਰਚਨਾ ਦਾ ਕੋਈ ਮਤਲਬ ਨਹੀਂ ਹੈ। ਸਾਰੀਆਂ API ਕਾਲਾਂ ਇਸ url 'ਤੇ ਭੇਜੀਆਂ ਜਾਣਗੀਆਂ। ਕਾਲ ਦੀ ਕਿਸਮ (ਅੱਪਲੋਡ/ਕਵੇਰੀ) ਨੂੰ ਕਾਲ ਬਾਡੀ ਕੁੰਜੀ - ਵਿੱਚ ਨਿਯੰਤ੍ਰਿਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਬੇਨਤੀ_ਨਾਮ. ਵੀ ਲੋੜੀਂਦੀਆਂ ਕੁੰਜੀਆਂ ਹਨ - api_key (ਤੁਹਾਨੂੰ ਸੰਰਚਨਾ ਪ੍ਰਕਿਰਿਆ ਦੇ ਦੌਰਾਨ ਇਸਨੂੰ ਯਾਦ ਰੱਖਣ ਦੀ ਲੋੜ ਹੈ) ਅਤੇ protocol_version (ਇਸ ਵੇਲੇ ਮੌਜੂਦਾ ਸੰਸਕਰਣ 1.1 ਹੈ)। ਤੁਸੀਂ ਇਸ API ਲਈ ਅਧਿਕਾਰਤ ਦਸਤਾਵੇਜ਼ ਇੱਥੇ ਲੱਭ ਸਕਦੇ ਹੋ ਸਕੈਕਸ NUMX. ਸੰਬੰਧਿਤ ਫਾਇਦਿਆਂ ਵਿੱਚ ਉਹਨਾਂ ਨੂੰ ਲੋਡ ਕਰਨ ਵੇਲੇ ਕਈ ਫਾਈਲਾਂ ਨੂੰ ਇਮੂਲੇਸ਼ਨ ਲਈ ਇੱਕ ਵਾਰ ਵਿੱਚ ਭੇਜਣ ਦੀ ਯੋਗਤਾ ਸ਼ਾਮਲ ਹੁੰਦੀ ਹੈ, ਕਿਉਂਕਿ ਫਾਈਲਾਂ ਨੂੰ ਬੇਸ 64 ਟੈਕਸਟ ਸਤਰ ਵਜੋਂ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ। ਬੇਸ64 ਤੋਂ/ਤੋਂ ਫਾਈਲਾਂ ਨੂੰ ਏਨਕੋਡ/ਡੀਕੋਡ ਕਰਨ ਲਈ ਤੁਸੀਂ ਪ੍ਰਦਰਸ਼ਨ ਦੇ ਉਦੇਸ਼ਾਂ ਲਈ ਪੋਸਟਮੈਨ ਵਿੱਚ ਇੱਕ ਔਨਲਾਈਨ ਕਨਵਰਟਰ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ, ਉਦਾਹਰਨ ਲਈ - https://base64.guru. ਵਿਹਾਰਕ ਉਦੇਸ਼ਾਂ ਲਈ, ਤੁਹਾਨੂੰ ਕੋਡ ਲਿਖਣ ਵੇਲੇ ਬਿਲਟ-ਇਨ ਏਨਕੋਡ ਅਤੇ ਡੀਕੋਡ ਵਿਧੀਆਂ ਦੀ ਵਰਤੋਂ ਕਰਨੀ ਚਾਹੀਦੀ ਹੈ।

ਆਉ ਹੁਣ ਫੰਕਸ਼ਨਾਂ 'ਤੇ ਡੂੰਘਾਈ ਨਾਲ ਵਿਚਾਰ ਕਰੀਏ te и ਕੱractionਣ ਇਸ 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"]
    }
    }
    ]
}

ਕੰਪੋਨੈਂਟ ਲਈ ਕੱractionਣ ਡਿਕਸ਼ਨਰੀ ਪ੍ਰਦਾਨ ਕੀਤੀ ਗਈ 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 (ਖਾਲੀ ਛੱਡੋ, SG ਲਈ TP API ਵਿੱਚ ਨਹੀਂ ਵਰਤਿਆ ਗਿਆ).

ਧਮਕੀ ਰੋਕਥਾਮ API ਲਈ ਪੋਸਟਮੈਨ ਸੰਗ੍ਰਹਿ ਨੂੰ ਡਾਊਨਲੋਡ ਕਰੋ

ਸੁਰੱਖਿਆ ਗੇਟਵੇ API ਲਈ ਖ਼ਤਰੇ ਦੀ ਰੋਕਥਾਮ ਲਈ ਪੋਸਟਮੈਨ ਸੰਗ੍ਰਹਿ ਨੂੰ ਡਾਊਨਲੋਡ ਕਰੋ

ਵਰਤੋਂ ਦੀਆਂ ਉਦਾਹਰਣਾਂ

ਸਮਾਜ ਵਿਚ ਸਾਥੀਆਂ ਦੀ ਜਾਂਚ ਕਰੋ ਪਾਈਥਨ ਵਿੱਚ ਲਿਖੀਆਂ ਸਕ੍ਰਿਪਟਾਂ ਪੇਸ਼ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ ਜੋ ਲੋੜੀਂਦੀ ਡਾਇਰੈਕਟਰੀ ਤੋਂ ਫਾਈਲਾਂ ਦੀ ਜਾਂਚ ਕਰਦੀਆਂ ਹਨ TP API, ਅਤੇ SG ਲਈ TP API. ਖਤਰੇ ਦੀ ਰੋਕਥਾਮ API ਦੇ ਨਾਲ ਗੱਲਬਾਤ ਰਾਹੀਂ, ਫਾਈਲਾਂ ਨੂੰ ਸਕੈਨ ਕਰਨ ਦੀ ਤੁਹਾਡੀ ਸਮਰੱਥਾ ਵਿੱਚ ਕਾਫ਼ੀ ਵਾਧਾ ਹੋਇਆ ਹੈ, ਕਿਉਂਕਿ ਹੁਣ ਤੁਸੀਂ ਇੱਕ ਵਾਰ ਵਿੱਚ ਕਈ ਪਲੇਟਫਾਰਮਾਂ ਵਿੱਚ ਫਾਈਲਾਂ ਨੂੰ ਸਕੈਨ ਕਰ ਸਕਦੇ ਹੋ (ਚੈੱਕ ਇਨ VirusTotal API, ਅਤੇ ਫਿਰ ਚੈੱਕ ਪੁਆਇੰਟ ਸੈਂਡਬੌਕਸ ਵਿੱਚ), ਅਤੇ ਨਾ ਸਿਰਫ਼ ਨੈੱਟਵਰਕ ਟ੍ਰੈਫਿਕ ਤੋਂ ਫਾਈਲਾਂ ਪ੍ਰਾਪਤ ਕਰੋ, ਸਗੋਂ ਉਹਨਾਂ ਨੂੰ ਕਿਸੇ ਵੀ ਨੈੱਟਵਰਕ ਡਰਾਈਵ ਅਤੇ, ਉਦਾਹਰਨ ਲਈ, CRM ਸਿਸਟਮਾਂ ਤੋਂ ਵੀ ਲਓ।

ਸਰੋਤ: www.habr.com