Scopo
Cyber Guru offre la possibilità di acquisire informazioni di completamento corsi da parte della popolazione presente in piattaforma, mediante una REST API che restituisce un set di dati idoneo per essere utilizzato da Workday.
L’automazione dell’acquisizione dei dati forniti da Cyber Guru in Workday dipende da processi e architetture del cliente e per questo motivo non può essere presidiata da Cyber Guru.
La presente linea guida contiene le direttive e i parametri per l’invocazione del servizio da parte del cliente.
Ambito
Le informazioni si applicano alla piattaforma di Cyber Security Awareness Cyber Guru 2.0.
Prerequisiti
Il cliente deve avere le risorse tecnologiche per poter chiamare REST API con una frequenza
Procedura
Cyber Guru mette a disposizione due REST API :
Get token : https://login.platform.cyberguru.eu/realms/{TENANT}/protocol/openid-connect/token
Questa API consente di ottenere un token di autorizzazione.
Parametri di chiamata (metodo POST):
client_id : ext-api
client_secret : < fornito da Cyberguru>
grant_types : client_credentials
Get course data : https://<...>/ext/training/work-day
che consente di importare un subset di dati da Cyber Guru a Workday.
Per poter invocare l’API è necessario fornire il token ottenuto nella precedente API come "Bearer token".
L’API prende in ingresso i seguenti parametri (metodo GET):
start_date (Opzionale, format YYYY-MM-DD)
end_date (Opzionale, format YYYY-MM-DD)
lang (Opzionale)
L'API ritorna i seguenti attributi in formato json:
Attributo |
Descrizione |
Learning_Content_Reference |
Nome del modulo nella lingua specificata |
Email dell'utente |
|
Registered_Date |
Release date (formato: YYYY-MM-DD) in cui l'utente ha iniziato il corso |
Learning_Enrollment_Completion_Date |
Data in cui l'utente ha completato il corso la prima volta (formato YYYY-MM-DD) |
Learning_Grade_Reference |
'PASS' |
Di seguito il json di esempio della response:
{
"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 è a disposizione per supportare il cliente nella fase di configurazione e di test su un ambiente di staging e, a valle dell’esito positivo del test, in ambiente di produzione.