Estrazione classifiche Utenti e Team API

Scopo

Cyber Guru offre la possibilità di acquisire le classifiche degli utenti e dei team presenti in piattaforma mediante una REST API che restituisce i dati in formato JSON, pronti per essere integrati in dashboard, portali o sistemi di reportistica del cliente.
L’automazione dell’acquisizione dei dati 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.

Ambito

Le informazioni si applicano alla piattaforma di Cyber Security Awareness Cyber Guru 2.0.

Prerequisiti

• Il cliente deve disporre delle risorse tecnologiche per poter chiamare REST API.

Procedura

Cyber Guru mette a disposizione due REST API:

Get token:

URL: 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 Cyber Guru)
• grant_type : client_credentials

Get rankings:

URL: https://<host>/ext/report/rankings

Consente di ottenere le classifiche degli utenti e dei team della company. Per invocare l’API è necessario fornire il token ottenuto in precedenza come Bearer token.
L’API prende in ingresso i seguenti parametri (metodo GET):

Esempi di response

Classifica utenti della company (type = 0):

{
  "accounts": [
    { "position": "1", "firstname": "Mario", "lastname": "Rossi", "team": "Sales EMEA", "points": "36" },
    { "position": "2", "firstname": "Alessandro", "lastname": "Bianchi", "team": "IT Operations", "points": "32" }
  ]
}

Classifica team della company (type = 1):

{
  "teams": [
    { "position": "1", "team": "Sales EMEA", "members": "23", "points": "31" },
    { "position": "2", "team": "IT Operations", "members": "34", "points": "26" }
  ]
}

Classifica utenti di uno specifico team (type = 2, es. team = IT Operations):

{
  "accounts": [
    { "position": "1", "firstname": "Mario", "lastname": "Bianchi", "team": "IT Operations", "points": "36" },
    { "position": "2", "firstname": "Ciccio", "lastname": "Verdi", "team": "IT Operations", "points": "32" }
  ]
}

Response con paginazione:

Quando vengono utilizzati i parametri limit e page, la response include un oggetto pagination con le seguenti informazioni:

Errori

Cyber Guru è a disposizione per supportare il cliente nella fase di configurazione e di test su ambiente di staging e, a valle dell’esito positivo, in ambiente di produzione.