Anwender
HilfeChangelogAdministratoren
Einrichtung BundIDWidget erstellenCSV-Mitarbeiter-ImportAnbindung Active DirectoryAnbindung d.velop documentsAnbindung Exchange ServerEinrichtung BesucherverwaltungAnbindung FormularserverAnbindung VirenscanUmstellung auf InfodiensteDienstleister
Webseiten-WidgetSuch- und GraphQL-APIPartner
Anbindung DMSEinbindung TerminvereinbarungAnbindung FormularserverOAuth2.0Anbindung optiGov Virenscan
Mit dem optiGov Virenscan-Service können Sie Dateien über einen API-Endpunkt auf Viren prüfen. Der Endpunkt steht unter der folgenden URL zur Verfügung:
https://virenscan.optigov.cloud/api/v1/scanDie Authentifizierung erfolgt über einen Bearer Token, der Ihnen nach Vertragsabschluss zur Verfügung gestellt wird.
Endpunkt-Details
URL | https://virenscan.optigov.cloud/api/v1/scan |
Methode | POST |
Authentifizierung | Bearer Token |
Header | Authorization: Bearer <Ihr_Token>
Content-Type: multipart/form-data |
Request Body | Die Datei, die gescannt werden soll, wird im multipart/form-data-Format übermittelt. |
Beispiel-Anfrage
curl -X POST "https://virenscan.optigov.cloud/api/v1/scan" \
-H "Authorization: Bearer <Ihr_Token>" \
-F "file=@/path/to/your/file"Antwort
Die Antwort des Servers wird in folgendem JSON-Format generiert:
{
"success": true,
"data": {
"file": {
"name": "<Dateiname>",
"size": "<Dateigröße>",
"type": "<Dateityp>",
"hash": {
"sah1": "<Dateihash>"
}
},
"scan": {
"ok": <true/false>,
"duration": "<Scan-Dauer>"
}
}
}Erläuterung der Felder
• success: Gibt an, ob die Anfrage erfolgreich verarbeitet wurde (true).
• data: Enthält die Details zur gescannten Datei und das Ergebnis des Scans.
• file: Informationen zur gescannten Datei:
• name: Der Name der Datei.
• size: Die Größe der Datei in Bytes.
• type: Der MIME-Typ der Datei.
• hash: Enthält den Hash der Datei.
• sah1: Der SHA1-Hashwert der Datei.
• scan: Details zum Scanvorgang:
• ok: Gibt an, ob der Scan erfolgreich war (true) oder ob eine Bedrohung erkannt wurde (false).
• duration: Die Dauer des Scans in Sekunden.
Nutzungslimit
Die Nutzung des Endpunkts ist monatlich begrenzt. Wir überwachen Ihre Nutzung und werden Sie kontaktieren, wenn das Limit überschritten wird. Es handelt sich um kein hartes Limit; die Nutzung kann bei Bedarf angepasst werden.
Testen des Services
Zum Testen des Services können Sie die EICAR-Testdatei verwenden, die speziell für die Prüfung von Antiviren-Programmen entwickelt wurde. Eine Beschreibung und Erstellungshinweise finden Sie hier: EICAR Test File.
Durch das Hochladen dieser Testdatei sollte der Service eine positive Antwort zurückgeben, um die Funktionsfähigkeit der Integration zu bestätigen.