Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

웹훅 주제

주니퍼 Mist™ 조직 및 사이트에서 제공되는 다양한 웹훅 주제를 검토합니다.

조직, 사이트 또는 두 수준 모두에서 웹후크를 사용하도록 설정한 후 메시지를 받을 토픽을 선택합니다.

다음 표를 사용하여 자세히 알아보십시오.

표 1: 조직 및 사이트 항목 모두
주제 목적 및 페이로드 세부 정보
경고(알람)

디바이스 및 인프라, Marvis 작업, 보안을 위해 사용자가 선택한 알람. 주니퍼 Mist 포털에서 경고를 찾으려면 왼쪽 메뉴에서 모니터링 > 경고 > 경고 구성을 선택합니다.

예제

  • 디바이스 및 인프라: 디바이스 다운, 디바이스 재시작, VPN 피어 다운, ARP 오류, DNS 오류.
  • Marvis: 케이블 결함, AP 상태 점검 실패, Wi-Fi 커버리지 불량, 포트 플랩핑, WAN 업링크 불량
  • 보안: KRACK 공격, TKIP ICV 공격, 불량 클라이언트, 불량 AP, 허니팟.

알람 유형에 따라 페이로드에는 조직 및 사이트의 ID, 이벤트 유형, 심각도, 집계 간격 동안 각 이벤트 유형 개수와 같은 세부 정보가 포함될 수 있습니다.

사용 가능한 경보를 확인하고 해당 페이로드의 예를 보려면 REST API 클라이언트에서 다음 API 호출을 실행합니다. GET /api/v1/const/alarm_defs
감사

모든 Mist 구성 변경이 이 주제를 트리거하는 주제입니다.

페이로드에는 관리자 이름 및 사용자 이름, 디바이스 ID, 변경 유형, 변경 타임스탬프와 같은 세부 정보가 포함됩니다.

클라이언트 정보

이 웹훅을 사용하여 무선 클라이언트 정보 이벤트를 가져옵니다.

페이로드에는 호스트 이름, IP 주소, MAC 주소, 조직 및 사이트 ID, IP 할당 타임스탬프와 같은 클라이언트에 대한 세부 정보가 포함됩니다.

클라이언트 참가

클라이언트 연결만 해당됩니다.

페이로드에는 조직 및 사이트의 ID와 같은 세부 정보가 포함됩니다. 클라이언트가 연결된 AP의 MAC 주소 및 이름; 및 연결에 대한 WLAN ID, 대역, SSID, RSSI 및 타임스탬프.
클라이언트 세션

클라이언트 세션 정보입니다.

페이로드에는 클라이언트가 로밍했거나 연결이 끊긴 AP의 MAC 주소 및 이름, WLAN ID, 대역, 장치 제품군("Mac", "iPhone", "Apple Watch"), 클라이언트 제조업체 및 모델, 연결 및 연결 해제에 대한 타임스탬프, 부동 시간, RSSI 및 종료 사유와 같은 세부 정보가 포함됩니다.
디바이스 이벤트

이 웹훅을 사용하여 액세스 포인트, 스위치 및 게이트웨이에 영향을 줄 수 있는 이벤트 목록을 가져옵니다. 이 주제에는 포트 업 또는 다운, AP 전원 변경 및 채널 변경과 같은 이벤트가 포함됩니다.

이 웹훅의 페이로드에는 조직 및 사이트의 ID, 디바이스의 MAC 주소 및 이름, 이벤트의 타임스탬프와 같은 세부 정보가 포함될 수 있지만 디바이스 이벤트의 정확한 유형에 따라 달라질 수 있습니다.

사용 가능한 알람을 확인하고 해당 페이로드의 예를 보려면 REST API 클라이언트에서 다음 API 호출을 실행합니다. GET /api/v1/const/device_events
디바이스 다운

디바이스의 연결이 끊겼다가 다시 연결되었다가 다시 시작됩니다.

페이로드에는 조직 및 사이트의 ID, 이벤트 유형, 디바이스의 MAC 주소 및 이름과 같은 세부 정보가 포함됩니다.

주니퍼 Mist 포털에서 구성 device-updowns 하려면 왼쪽 메뉴에서 > 경고 모니터링 > 경고 구성을 선택합니다. 여기에서 디바이스 유형 및 경고 임계값을 보다 세부적으로 제어할 수 있습니다.
mxedge-events 이 웹훅을 사용하면 주니퍼 Mist Edge 물리적 및 LACP 링크 상태와 같은 세부 정보를 포함하여 가능한 Mist Edge 이벤트 목록을 가져올 수 있습니다.
NAC 어카운팅 이 웹훅을 사용하여 가능한 모든 주니퍼 Mist 네트워크 액세스 제어(NAC) 계정 이벤트(ACCOUNTING_START, ACCOUNTING_STOP, ACCOUNTING_UPDATE) 목록을 가져올 수 있습니다.

페이로드에는 타임스탬프, AP, client_ip, SSID, 사용자 이름, client_type, client_mac, nas_vendor, site_id, rx_pkts 및 tx_pkts와 같은 세부 정보가 포함됩니다.

nac 이벤트

이 웹훅은 모든 주니퍼 Mist 네트워크 액세스 제어(NAC) 이벤트와 함께 트리거됩니다.

페이로드에는 auth_type, bssid, idp_role, random_mac, resp_attrs와 같은 세부 정보가 포함될 수 있지만 nac 이벤트 유형에 따라 달라질 수 있습니다.

웹훅 URL로 이동하는 ping 이벤트입니다.

페이로드에는 사이트 ID, 웹훅 ID 및 이름, 타임스탬프가 포함됩니다.
표 2: 사이트 전용 항목
주제 목적 및 페이로드 세부 정보
자산-원시 RSSI

더 이상 사용되지 않는 주제인 asset-raw를 대체합니다.

명명된 자산과 필터링된 자산에서 방출되는 패킷의 원시 데이터.

페이로드에는 조직, 사이트, 맵, AP, 안테나 및 자산의 ID와 같은 세부 정보가 포함됩니다. AP 위치; RSSI; 비콘 UUID 및 제조업체; 서비스 패킷; 그리고 데이터.

클라이언트 지연

사이트 수준의 모든 클라이언트 디바이스에서 집계된 DHCP, DNS 및 인증 지연 시간 정보. 지연 시간은 10분 간격으로 10분 동안 제공됩니다. API를 통해 폴링하는 대신 이 웹훅을 사용하여 네트워크 지연 시간 데이터를 수신하는 것이 좋습니다.

참고:

이 웹훅을 구독하려면 Marvis 구독이 필요합니다.

discovered-raw-rssi

패시브 BLE에서 방출되는 패킷의 원시 데이터.

페이로드에는 조직, 사이트, 맵, 보고 AP 및 안테나의 ID와 같은 세부 정보가 포함됩니다. MAC 주소; 자산/비콘의 자산 ID, 제조업체 및 UUID; 및 RSSI.
게스트 권한 부여

게스트 클라이언트가 WLAN에서 인증할 때 대한 데이터입니다.

페이로드에는 AP, auth_method, authorized_expiring_time, 이동통신사, 클라이언트, 회사, 이메일, 모바일, 이름, org_id, site_id, SMS 게이트웨이, sponsor_email, ssid 및 wlan_id와 같은 세부 정보가 포함됩니다.

위치

주니퍼 Mist SDK 클라이언트, 무선 클라이언트 및 자산에 대한 위치 데이터.

데이터에는 사이트 및 맵 ID, X 및 Y 좌표, 타임스탬프, 클라이언트 유형, 클라이언트 ID 또는 MAC 주소와 같은 세부 정보가 포함됩니다.

위치 자산

주니퍼 Mist 자산(BLE 클라이언트 디바이스)의 위치 데이터.

데이터에는 사이트 및 맵 ID, X 및 Y 좌표, 타임스탬프, 자산 유형, 자산의 MAC 주소와 같은 세부 정보가 포함됩니다.

위치 중심

Mist AP가 웹훅을 통해 centrak 서버로 전송하는 CenTrak 데이터.

데이터에는 X, Y 좌표, 타임스탬프, 사이트 ID 및 Wi-Fi 비콘 확장 정보가 포함됩니다. 알람 이벤트 유형에 따라 다른 필드가 표시됩니다.

위치 클라이언트

주니퍼 Mist SDK 클라이언트 및 무선 클라이언트의 위치 데이터.

데이터에는 사이트 및 맵 ID, X 및 Y 좌표, 타임스탬프, 클라이언트 유형, 클라이언트 MAC 주소와 같은 세부 정보가 포함됩니다.

위치 SDK

주니퍼 Mist SDK 클라이언트의 위치 데이터.

데이터에는 맵 ID, 클라이언트 유형, X 및 Y 좌표와 같은 세부 정보가 포함됩니다.

위치 실행 취소

클라이언트 디바이스가 네트워크에서 연결이 끊어지거나 지정된 위치에서 더 이상 감지되지 않는 경우 주니퍼 Mist SDK 클라이언트 또는 무선 클라이언트에 대한 위치 데이터입니다.

페이로드 데이터에는 맵 ID, X 및 Y 좌표, Wi-Fi 비콘 확장 정보 및 클라이언트 MAC 주소와 같은 세부 정보가 포함됩니다.

occupancy-alerts

구성된 점유 제한에 기반한 점유 상태입니다.

페이로드에는 조직, 사이트, 맵 및 영역의 ID와 같은 세부 정보가 포함됩니다. 이벤트("COMPLIANCE-VIOLATION" 또는 "COMPLIANCE-OK") 타임스탬프; 점유 제한; 그리고 현재 점유율.
RSSI 영역

액세스 포인트 근처의 장치.

이 주제는 AP가 수신한 RSSI가 구성 가능한 임계값을 초과하는 AP 주변의 영역에 들어가거나 나가는 디바이스에 대한 정보를 제공합니다. 각 AP에 대해 새 RSSI 영역을 생성하고 RSSI 영역 이름과 RSSI 영역 임계값을 포함할 수 있습니다.
sdk클라이언트-스캔-데이터 주니퍼 Mist SDK 클라이언트의 위치 데이터. 데이터에는 연결을 위한 대역, 채널, SSID, BSSID 및 RSSI와 같은 세부 정보가 포함됩니다. AP의 MAC 주소; 인접 AP 목록; 클라이언트가 마지막으로 표시된 타임스탬프; 그리고 스캔에 대한 타임스탬프를 입력합니다.
v비콘

가상 비콘 근처에 있는 장치.

이 항목은 구성된 vbeacon에 근접한 디바이스에 대한 정보를 제공합니다. 이 웹훅을 주니퍼 Mist SDK와 함께 사용하십시오.

와이파이 연결 원시

wifi-unconn-raw

연결된 디바이스와 연결되지 않은 디바이스에서 방출되는 패킷의 원시 데이터.

페이로드에는 조직, 사이트, 맵 및 보고 AP의 ID와 같은 세부 정보가 포함됩니다. AP의 위치 좌표; RSSI 및 밴드; Wi-Fi 비콘의 페이로드도 감지합니다. 클라이언트의 위치 데이터는 포함되지 않습니다.

클라이언트가 구역에 들어가거나 나갈 때 푸시되는 평면도의 가상 비콘에 대한 위치 데이터.

데이터에는 사이트, 맵 및 영역 ID, 타임스탬프, 트리거(시작 또는 종료), 클라이언트 유형(SDK 클라이언트, 무선 클라이언트 또는 자산), 클라이언트의 ID 또는 MAC 주소와 같은 세부 정보가 포함됩니다.