Cyber Guru 2.0 Help Center
Contact us
In this article
PurposeScopePrerequisitesProcedure
Home
Configuration and Company Management
Company Admin Manual
APIs/ Integrations

Data Extraction for Course Completion in Workday

Edited

Purpose

Cyber Guru offers the ability to acquire course completion information from the population present on the platform, through a REST API that returns a data set suitable for use by Workday.

The automation of data acquisition provided by Cyber Guru in Workday depends on the client's processes and architectures, and for this reason, it cannot be overseen by Cyber Guru.

This guideline contains the directives and parameters for invoking the service by the client.

Scope

The information applies to the Cyber Security Awareness platform Cyber Guru 2.0.

Prerequisites

  • The client must have the technological resources to call the REST API with a frequency

Procedure

Cyber Guru provides two REST APIs:

Get token: https://login.platform.cyberguru.eu/realms/{TENANT}/protocol/openid-connect/token

This API allows you to obtain an authorization token.

Call parameters (POST method):

  • client_id: ext-api

  • client_secret: <provided by Cyber Guru>

  • grant_types: client_credentials

Get course data: https://<...>/ext/training/work-day

which allows importing a subset of data from Cyber Guru to Workday.

To invoke the API, it is necessary to provide the token obtained from the previous API as a "Bearer token".

The API takes the following parameters as input (GET method):

  • start_date (Optional, format YYYY-MM-DD)

  • end_date (Optional, format YYYY-MM-DD)

  • lang (Optional)

The API returns the following attributes in JSON format:

Attribute

Description

Learning_Content_Reference

Name of the module in the specified language

Email

User's email

Registered_Date

Release date (format: YYYY-MM-DD) when the user started the course

Learning_Enrollment_Completion_Date

Date when the user completed the course for the first time (format YYYY-MM-DD)

Learning_Grade_Reference

'PASS'

Below is an example JSON 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 is available to support the client during the configuration and testing phase in a staging environment and, following a successful test outcome, in a production environment.

Disclaimer