Skip to main content

​
Ce oferă această integrare

KnowBe4 poate furniza rezultate privind forța de muncă, instruirea și simulările de phishing. Exemplele analizate includ:
  • training.completed — finalizează instruirea în domeniul securității
  • training.past.due — are instruiri restante
  • phishing.simulation.clicked — a făcut clic pe o simulare fără a o raporta
Aceste exemple ilustrează tipurile de activitate normalizată pe care Living Security le poate utiliza. Consultați cum devin datele de integrare semnale.

​
De ce are nevoie Living Security

Domenii de acces (scopes): Nu este nimic de configurat — tokenurile KnowBe4 Reporting API sunt din construcție doar pentru citire și nu au domenii de acces. Tokenul oferă acces de citire la utilizatori, înscrieri la instruire și rezultatele testelor de securitate de tip phishing, adică exact ceea ce citește sincronizarea. Rol necesar: Account Admin în KnowBe4 (doar administratorii contului pot accesa Account Settings → API)

​
Cerințe preliminare

  • Trebuie să fiți autentificat în consola KnowBe4 cu rolul Account Admin. Doar administratorii contului pot accesa Account Settings → API pentru a activa Reporting API și a genera tokenuri.

​
Partea A — În KnowBe4

Administratorul dvs. KnowBe4 efectuează acești pași.
1

Activați Reporting API și generați un token

  1. Autentificați-vă în consola KnowBe4.
  2. Faceți clic pe numele contului dvs. din colțul din dreapta sus și selectați Account Settings.
  3. În navigarea din stânga, selectați API.
  4. Activați Reporting API dacă nu este deja activat, apoi generați un nou token API.
Dacă consola vă solicită acest lucru, atribuiți tokenului un scop descriptiv (de exemplu, Living Security Platform).
KnowBe4 afișează valoarea tokenului API o singură dată, în momentul generării. Copiați-l imediat și stocați-l într-o locație sigură (de exemplu, un seif de parole sau un manager de secrete). Dacă părăsiți pagina fără a-l copia, va trebui să generați un token nou.
Reporting API este doar pentru citire. Expune utilizatorii, înscrierile la instruire și rezultatele testelor de securitate de tip phishing — datele pe care Living Security le preia pentru scorare și raportare. Nu este necesar accesul de scriere.
2

Adăugați adresele IP de ieșire Living Security în lista Allowed IP Addresses

KnowBe4 vă permite să restricționați accesul la Reporting API la un anumit set de adrese IP sursă. Această setare se află în același loc cu tokenul:
  1. În consola KnowBe4, accesați Account Settings → API → Allowed IP Addresses.
  2. Adăugați fiecare adresă IP de ieșire Living Security în lista de permisiuni. Aceleași patru adrese se aplică în toate regiunile.
Dacă lista Allowed IP Addresses este configurată, aceasta este aplicată la nivelul rețelei. Dialogul de conectare va reuși la momentul autentificării, dar sincronizările de date vor eșua (fiind blocate la nivelul rețelei, de obicei cu afișarea unui 403) până când adresele IP de ieșire Living Security sunt adăugate în lista de permisiuni. Dacă adăugați orice adresă în această listă, trebuie să adăugați și intervalele Living Security, altfel solicitările noastre vor fi respinse, chiar dacă tokenul dvs. este valid.
Adresele IP de ieșire ale Living Security se pot modifica atunci când infrastructura este actualizată, deși astfel de modificări sunt rare. Dacă sincronizările de date încep să eșueze după ce au funcționat anterior, consultați Configurarea adreselor IP de ieșire pentru integrări și verificați dacă lista Allowed IP Addresses corespunde.
3

Identificați regiunea serverului KnowBe4

KnowBe4 oferă Reporting API dintr-un host specific fiecărei regiuni. Regiunea se selectează în dialogul de conectare, fără a introduce un nume de host:Dacă nu știți sigur ce regiune utilizează contul dvs., verificați domeniul din adresa URL a consolei KnowBe4 sau contactați administratorul KnowBe4.
Aceste cinci regiuni sunt cele la care Living Security poate ajunge. Dacă contul dvs. KnowBe4 se află pe alt server (de exemplu, o instanță US Government), contactați asistența Living Security înainte de a începe conectarea.

​
Partea B — În Living Security Platform

Proprietarul programului efectuează acest pas, sau administratorul de sistem dacă se utilizează configurarea delegată.
Acum sunteți conectat la KnowBe4.

​
Depanare

Tokenul API este invalid sau a expirat. Verificați dacă tokenul este corect și dacă nu a fost regenerat în Account Settings → API.
Fie tokenul nu are acces la Reporting API, fie adresa IP a solicitării nu se află în lista Allowed IP Addresses. Verificați dacă Reporting API este activat și dacă toate cele patru adrese IP de ieșire Living Security se află în lista de permisiuni.
Este posibil ca Reporting API să nu aibă încă date de returnat sau ca contul tokenului să nu aibă vizibilitate asupra utilizatorilor și campaniilor pe care Living Security le preia. Verificați dacă tokenul a fost generat de un Account Admin.