Skip to main content

​
이 연동이 제공하는 데이터

KnowBe4는 인력, 교육 및 피싱 시뮬레이션 결과를 제공할 수 있습니다. 검토된 예시는 다음과 같습니다.
  • training.completed — 보안 교육을 완료함
  • training.past.due — 기한이 지난 교육이 있음
  • phishing.simulation.clicked — 시뮬레이션을 클릭하고 신고하지 않음
이 예시는 Living Security가 사용할 수 있는 정규화된 활동 유형을 보여줍니다. 연동 데이터가 신호가 되는 방식을 참조하십시오.

​
Living Security에 필요한 정보

범위(Scope): 구성할 항목이 없습니다. KnowBe4 Reporting API 토큰은 설계상 읽기 전용이며 범위가 지정되지 않습니다. 이 토큰은 사용자, 교육 등록 정보 및 피싱 보안 테스트 결과에 대한 읽기 권한을 부여하며, 이는 동기화가 읽는 데이터와 정확히 일치합니다. 필요한 역할: KnowBe4의 Account Admin(계정 관리자만 Account Settings → API에 액세스할 수 있습니다)

​
사전 요구 사항

  • Account Admin 역할로 KnowBe4 콘솔에 로그인해야 합니다. 계정 관리자만 Account Settings → API에 액세스하여 Reporting API를 활성화하고 토큰을 생성할 수 있습니다.

​
파트 A — KnowBe4에서

KnowBe4 관리자가 다음 단계를 완료합니다.
1

Reporting API 활성화 및 토큰 생성

  1. KnowBe4 콘솔에 로그인합니다.
  2. 오른쪽 상단의 계정 이름을 클릭하고 Account Settings를 선택합니다.
  3. 왼쪽 탐색 메뉴에서 API를 선택합니다.
  4. Reporting API가 활성화되어 있지 않으면 활성화한 다음 새 API 토큰을 생성합니다.
콘솔에서 용도를 입력하라는 메시지가 표시되면 토큰에 용도를 알 수 있는 설명(예: Living Security Platform)을 지정합니다.
KnowBe4는 API 토큰 값을 생성될 때 한 번만 표시합니다. 즉시 복사하여 비밀번호 보관소나 시크릿 관리자와 같은 안전한 위치에 저장하십시오. 복사하지 않고 페이지를 벗어난 경우 새 토큰을 생성해야 합니다.
Reporting API는 읽기 전용입니다. 이 API는 사용자, 교육 등록 정보 및 피싱 보안 테스트 결과를 제공하며, 이는 Living Security가 점수 산정 및 보고를 위해 수집하는 데이터입니다. 쓰기 권한은 필요하지 않습니다.
2

Allowed IP Addresses 목록에 Living Security 송신 IP 추가

KnowBe4에서는 Reporting API 액세스를 특정 소스 IP 주소 집합으로 제한할 수 있습니다. 이 설정은 토큰과 같은 위치에 있습니다.
  1. KnowBe4 콘솔에서 Account Settings → API → Allowed IP Addresses로 이동합니다.
  2. 각 Living Security 송신 IP 주소를 허용 목록에 추가합니다. 동일한 네 개의 주소가 모든 리전에 적용됩니다.
Allowed IP Addresses 목록이 구성되어 있으면 네트워크 계층에서 적용됩니다. 연결 대화 상자에서는 인증 시점에 성공하지만, Living Security 송신 IP가 허용 목록에 추가될 때까지 데이터 동기화는 실패합니다(네트워크 계층에서 차단되며, 일반적으로 403로 나타납니다). 이 목록에 주소를 하나라도 추가한 경우 Living Security 범위도 반드시 추가해야 합니다. 그렇지 않으면 토큰이 유효하더라도 요청이 거부됩니다.
Living Security의 송신 IP 주소는 인프라가 업데이트될 때 변경될 수 있으나, 이러한 변경은 드물게 발생합니다. 이전에 정상적으로 작동하던 데이터 동기화가 실패하기 시작하면 연동 송신 IP 주소 구성을 확인하고 Allowed IP Addresses 목록이 일치하는지 확인하십시오.
3

KnowBe4 서버 리전 확인

KnowBe4는 리전별 호스트에서 Reporting API를 제공합니다. 호스트 이름을 직접 입력하는 대신 연결 대화 상자에서 리전을 선택합니다.계정이 사용하는 리전을 확실히 모르는 경우 KnowBe4 콘솔 URL의 도메인을 확인하거나 KnowBe4 관리자에게 문의하십시오.
이 다섯 개 리전이 Living Security가 연결할 수 있는 리전입니다. KnowBe4 계정이 다른 서버(예: 미국 정부 인스턴스)에 있는 경우 연결을 시작하기 전에 Living Security 지원팀에 문의하십시오.

​
파트 B — Living Security Platform에서

프로그램 소유자가 이 단계를 완료하거나, 위임된 설정을 사용하는 경우 시스템 관리자가 완료합니다.
이제 KnowBe4에 연결되었습니다.

​
문제 해결

API 토큰이 유효하지 않거나 만료되었습니다. 토큰이 올바른지, 그리고 Account Settings → API에서 재생성되지 않았는지 확인하십시오.
토큰에 Reporting API 액세스 권한이 없거나, 요청 IP가 Allowed IP Addresses 목록에 없습니다. Reporting API가 활성화되어 있는지, 그리고 네 개의 Living Security 송신 IP 주소가 모두 허용 목록에 있는지 확인하십시오.
Reporting API에 아직 반환할 데이터가 없거나, 토큰의 계정이 Living Security가 수집하는 사용자와 캠페인을 볼 수 있는 권한이 없을 수 있습니다. 토큰이 Account Admin에 의해 생성되었는지 확인하십시오.