Cyber Guru 2.0 Help Center
In questo articolo
ScopoAmbitoPrerequisitiProcedura
Home
Configurazione e Gestione Company
Manuale Company Admin
API/ Integrazioni

Estrazione dati completamento corsi per Workday

Modificato

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

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.

Disclaimer