Zweck
Cyber Guru bietet die Möglichkeit, Kursabschlussinformationen der auf der Plattform vorhandenen Nutzer über eine REST-API zu erhalten, die einen Datensatz zurückgibt, der für die Nutzung durch Workday geeignet ist.
Die Automatisierung der Datenerfassung von Cyber Guru in Workday hängt von den Prozessen und Architekturen des Kunden ab und kann daher nicht von Cyber Guru überwacht werden.
Diese Richtlinie enthält die Anweisungen und Parameter für die Nutzung des Dienstes durch den Kunden.
Geltungsbereich
Die Informationen gelten für die Plattform Cyber Security Awareness Cyber Guru 2.0.
Voraussetzungen
Der Kunde muss über die technischen Ressourcen verfügen, um REST-APIs regelmäßig aufrufen zu können.
Verfahren
Cyber Guru stellt zwei REST-APIs zur Verfügung:
Token abrufen: https://login.platform.cyberguru.eu/realms/{TENANT}/protocol/openid-connect/token
Diese API ermöglicht es, ein Autorisierungstoken zu erhalten.
Aufrufparameter (POST-Methode):
client_id: ext-api
client_secret: < von Cyberguru bereitgestellt>
grant_types: client_credentials
Kursdaten abrufen: https://<...>/ext/training/work-day
Diese API ermöglicht es, einen Teil der Daten von Cyber Guru nach Workday zu importieren.
Um die API aufzurufen, muss das zuvor erhaltene Token als "Bearer Token" bereitgestellt werden.
Die API akzeptiert die folgenden Parameter (GET-Methode):
start_date (Optional, Format YYYY-MM-DD)
end_date (Optional, Format YYYY-MM-DD)
lang (Optional)
Die API gibt die folgenden Attribute im JSON-Format zurück:
Attribut |
Beschreibung |
Learning_Content_Reference |
Name des Moduls in der angegebenen Sprache |
Email des Nutzers |
|
Registered_Date |
Datum (Format: YYYY-MM-DD), an dem der Nutzer den Kurs begonnen hat |
Learning_Enrollment_Completion_Date |
Datum, an dem der Nutzer den Kurs erstmals abgeschlossen hat (Format YYYY-MM-DD) |
Learning_Grade_Reference |
'PASS' |
Nachfolgend ein Beispiel-JSON der Antwort:
{
"status": 200,
"data": [
{
"Learning_Content_Reference": "M01",
"Registered_Date": "2021-08-06",
"Learning_Enrollment_Completion_Date": "2024-03-05",
"Learning_Grade_Reference": "PASS",
"Email": "name-test-1@mymail.com"
},
{
"Learning_Content_Reference": "M02",
"Registered_Date": "2021-08-21",
"Learning_Enrollment_Completion_Date": "2024-03-05",
"Learning_Grade_Reference": "PASS",
"Email": "name-test-2@mymail.com"
},
{
"Learning_Content_Reference": "N04",
"Registered_Date": "2023/08/02",
"Learning_Enrollment_Completion_Date": "2024-03-20",
"Learning_Grade_Reference": "PASS",
"Email": "name-test-3@mymail.com"
},
{
"Learning_Content_Reference": "Q09",
"Registered_Date": "2021/08/21",
"Learning_Enrollment_Completion_Date": "2023-08-23",
"Learning_Grade_Reference": "PASS",
"Email": "name-test-4@mymail.com"
}
]
}Cyber Guru steht zur Verfügung, um den Kunden bei der Konfiguration und beim Testen in einer Staging-Umgebung zu unterstützen und nach erfolgreichem Test in der Produktionsumgebung.