Objectif
Cyber Guru offre la possibilité d'acquérir des informations sur l'achèvement des cours par la population présente sur la plateforme, via une API REST qui renvoie un ensemble de données adapté pour être utilisé par Workday.
L'automatisation de l'acquisition des données fournies par Cyber Guru dans Workday dépend des processus et des architectures du client et, pour cette raison, ne peut pas être supervisée par Cyber Guru.
Cette ligne directrice contient les directives et les paramètres pour l'invocation du service par le client.
Champ d'application
Les informations s'appliquent à la plateforme de sensibilisation à la cybersécurité Cyber Guru 2.0.
Prérequis
Le client doit disposer des ressources technologiques pour pouvoir appeler l'API REST à une fréquence
Procédure
Cyber Guru met à disposition deux API REST :
Obtenir un token : https://login.platform.cyberguru.eu/realms/{TENANT}/protocol/openid-connect/token
Cette API permet d'obtenir un token d'autorisation.
Paramètres d'appel (méthode POST) :
client_id : ext-api
client_secret : < fourni par Cyberguru>
grant_types : client_credentials
Obtenir les données de cours : https://<...>/ext/training/work-day
qui permet d'importer un sous-ensemble de données de Cyber Guru à Workday.
Pour pouvoir invoquer l'API, il est nécessaire de fournir le token obtenu dans l'API précédente comme "Bearer token".
L'API prend en entrée les paramètres suivants (méthode GET) :
start_date (Optionnel, format YYYY-MM-DD)
end_date (Optionnel, format YYYY-MM-DD)
lang (Optionnel)
L'API retourne les attributs suivants au format json :
Attribut |
Description |
Learning_Content_Reference |
Nom du module dans la langue spécifiée |
Email de l'utilisateur |
|
Registered_Date |
Date de début (format : YYYY-MM-DD) à laquelle l'utilisateur a commencé le cours |
Learning_Enrollment_Completion_Date |
Date à laquelle l'utilisateur a terminé le cours pour la première fois (format YYYY-MM-DD) |
Learning_Grade_Reference |
'PASS' |
Voici un exemple de réponse en json :
{
"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 est à disposition pour accompagner le client lors de la phase de configuration et de test sur un environnement de staging et, suite à un test concluant, en environnement de production.