Passa al contenuto principale

Licenza

Recupero della licenza​

Richiesta​

Definizione​

GET /api/v1/license

  • Authorization richiesto

    Token di autenticazione con privilegi di lettura per la risorsa.

    Bearer {token}

Risposta​

Codici di stato​

Codice di statoMessaggio
200"License info"
403"Forbidden"

Corpo​

  • data.license.created string

    Data e ora in cui la licenza è stata creata.

  • data.license.customer_name string

    Nome dell'organizzazione a cui è intestata la licenza.

  • data.license.delay_expiry_days integer

    Numero di giorni aggiuntivi dopo la scadenza effettiva della licenza prima che il software venga disabilitato.

  • data.license.delay_max_uses_perc integer

    Numero di richieste mensili oltre il limite prima dell'interruzione del monitoraggio.

  • data.license.entitlements object

    Oggetto che contiene tutti i servizi del software e indica se l'istanza è abilitata all'utilizzo delle stesse.

  • data.license.expiry string

    Data e ora di scadenza della licenza.

  • data.license.id string

    Codice identificativo della licenza.

  • data.license.last_validated string

    Data e ora dell'ultima validazione della licenza.

  • data.license.max_machines integer

    Numero massimo di macchine su cui è possibile utilizzare l'istanza del software.

  • data.license.ordered_entitlements_keys array<string>

    Lista di tutte le caratteristiche del software gestite dalla licenza.

  • data.license.policy string

    Policy associata alla licenza.

  • data.license.status string

    Indica lo stato della licenza.

  • data.license.suspended boolean

    Indica se la licenza è stata sospesa.

  • data.license.updated string

    Data e ora dell'ultima modifica della licenza.

  • data.monthly_tx_counter integer

    Quante transazioni sono state analizzate durante il mese.

  • data.monthly_tx_limit_reached boolean

    Indica se il limite mensile di transazioni analizzate è stato raggiunto.

Inserimento della chiave di licenza​

Richiesta​

Definizione​

POST /api/v1/license

Header​

  • Authorization richiesto

    Token di autenticazione con privilegi di lettura per la risorsa.

    Bearer {token}

Corpo della richiesta​

{
  "license_key": "72xC94-xxxxx-278x8B-528A45-xxxxx-Vx"
}

Risposta​

Codici di stato​

Codice di statoMessaggio
200"License succesfully inserted"
400"Error inserting license key"
403"Forbidden"

Corpo​

{
  "data": {
    "license": {
      "created": "2023-11-17T09:20:30.783Z",
      "customer_name": "Test License",
      "delay_expiry_days": 10,
      "delay_max_uses_perc": 10,
      "entitlements": {
        "application_rules": {
          "is_limited": true,
          "max_uses": "unlimited",
          "name": "Protection - Application rules"
        },
        "audit_logs": {
            "is_limited": false,
            "max_uses": "null",
            "name": "Audit logs"
            },
        "detection_bac": {
          "is_limited": false,
          "max_uses": null,
          "name": "Detection - Broken Access Control"
        },
        "detection_iaaf": {
          "is_limited": false,
          "max_uses": null,
          "name": "Detection - Brute Force & Bot"
        },
        "detection_inj": {
          "is_limited": false,
          "max_uses": null,
          "name": "Detection - Injection"
        },
        "metrics_storage": {
          "is_limited": true,
          "max_uses": "unlimited",
          "name": "Metrics storage"
        },
        "monitored_hosts": {
          "is_limited": true,
          "max_uses": "unlimited",
          "name": "Monitored hosts"
        },
        "monitored_monthly_requests": {
          "is_limited": true,
          "max_uses": 900,
          "name": "Monitored monthly requests"
        },
        "network_rules": {
          "is_limited": true,
          "max_uses": "unlimited",
          "name": "Protection - Network rules"
        },
        "notification": {
          "is_limited": true,
          "max_uses": "unlimited",
          "name": "Notification"
        },
        "reports": {
          "is_limited": false,
          "max_uses": null,
          "name": "Reports"
        },
        "rules_automation": {
          "is_limited": false,
          "max_uses": null,
          "name": "Rules automation"
        },
        "traffic_storage": {
          "is_limited": true,
          "max_uses": "unlimited",
          "name": "Traffic storage"
        }
      },
      "expiry": "2040-01-16T09:20:30.785Z",
      "id": "xxxxx-1892-xxxx-a98e-xxxxxxxxxx",
      "key": "72xC94-xxxxx-278x8B-528A45-xxxxx-Vx",
      "last_validated": null,
      "max_cores": null,
      "max_machines": 1,
      "max_processes": null,
      "max_uses": null,
      "metadata": {},
      "ordered_entitlements_keys": [
        "monitored_monthly_requests",
        "monitored_hosts",
        "detection_inj",
        "detection_bac",
        "detection_iaaf",
        "traffic_storage",
        "metrics_storage",
        "network_rules",
        "application_rules",
        "notification",
        "rules_automation",
        "audit_logs",
        "reports"
      ],
      "policy": null,
      "status": "active",
      "suspended": false,
      "updated": "2023-12-05T09:52:08.473Z",
      "uses": null
    },
    "monthly_tx_counter": 0,
    "monthly_tx_limit_reached": false,
    "status": "active"
  },
  "message": "License succesfully inserted",
  "status": "ok"
}