BQN 문서

REST API 참조는 다음에서 찾을 수 있습니다. BQN REST API 가이드에서 확인할 수 있습니다.

‍

REST 배포

‍

BQN 사용자 요금 정책과 사용자 요금 정책을 사용자 요금 정책에 할당하는 작업은 사용자 메트릭을 제공할 수 있는 REST API를 통해 수행할 수 있습니다. 물론 이를 위해서는 BQN이 사용자 데이터 트래픽의 IP 주소를 확인해야 합니다. 즉, 각 IP 주소에 대해 요금제 제한이 적용되기 때문에 사용자 과 BQN 사이에 NAT가 있을 수 없습니다. wires 가 올바르게 연결되는 것도 중요합니다(즉, 사용자 측면에 액세스 포트로 구성된 네트워크 포트가 연결되어야 합니다).

IPv4 및 IPv6 주소가 모두 지원됩니다. IPv6 주소의 경우, 동일한 서브넷의 모든 주소는 동일한 사용자 에 속하는 것으로 간주되므로 REST API는 서브넷 마스크(기본적으로 /64)를 적용합니다.

통합은 BQN 관리 인터페이스를 통해 플랜 정의를 제어하는 시스템(예: 청구 시스템)과 BQN 간에 이루어집니다. BQN은 REST API 서버 역할을 합니다. BQN은 관리 IP 주소(GUI에서 사용하는 것과 동일)를 사용하여 TCP 포트 3443(구성 가능)에서 수신 대기 중인 REST 메시지를 수신합니다.

‍

REST 정의 및 정책 선택

‍

REST API를 통해 다음과 같은 정책 작업이 가능합니다:

• 요금 제어 정책(구독 요금제)을 만듭니다.
• 사용자 에 요금제를 할당합니다.
• 사용량, 최대 속도, 지연 시간, 재전송, 활성/생성된 플로우, 혼잡한 트래픽 및 최대 속도, DPI 정보 등 최대 3개월 동안 사용자 메트릭을 확인할 수 있습니다.
• 시간 및 볼륨 할당량을 관리합니다.

다음 다이어그램은 여러 정책이 만들어지고 나중에 각 정책이 만들어지는 예를 보여 줍니다 사용자 이러한 정책 중 하나가 할당되어 있습니다.

정책과 사용자 연결을 모두 만들고, 나열하고, 수정하고, 삭제하는 작업이 있습니다.

REST API에 대한 자세한 설명은 BQN REST API 가이드에서 자세히 설명되어 있으며, 여기에는 가능한 모든 요청에 대한 정의가 포함되어 있습니다.

‍

REST 구성

‍

BQN에서 REST 구성

‍

1. BQN에서 REST API를 활성화하려면 구성->RADIUS/REST/Billing->REST API로 이동하여 Rest API를 켜짐으로 전환합니다.

2. 2. 모든 REST 클라이언트의 IP 주소를 BQN 구성에 추가합니다. GUI에서 구성->RADIUS/REST/Billing->REST API로 이동하여 클라이언트 추가...를 클릭합니다.

3. 비밀번호와 함께 REST 사용자를 BQN 구성에 추가합니다. GUI에서 구성->RADIUS/REST/Billing->REST API로 이동하여 사용자 추가...를 클릭합니다.

‍

‍

REST 클라이언트 확인

REST API 통합을 사용하려면 청구 시스템과 같이 BQN과 상호 작용하는 요소에서 API를 프로그래밍해야 합니다. BQN REST 구성이 올바른지 테스트하기 위해 curl Linux 유틸리티를 사용하여 REST 메시지를 수동으로 보낼 수 있습니다.

예를 들어, my_rest_policy_1라는 정책을 만들고 사용자 IP 10.10.1.232 포함:

curl -i -k -m 20 -u myuser:mypassword -X POST https://192.168.0.121:3443/api/v1/policies/rate/my_rest_policy_1 -H"Content-Type: application/json" --data '{"rateLimitDownlink": {"rate": 1000,"burstRate": 2000}, "rateLimitUplink": {"rate":500, "burstRate": 1000}}'

REST API 확인

‍

일단 정책과 사용자 연결이 생성되면 Status->Policies->Rate Policies 테이블에 REST에서 오는 정책이 표시됩니다. 예를 들어 다음 표에는 프로비저닝된 세 가지 정책이 나와 있습니다 사용자 또한 활성 상태(트래픽 포함):

REST 정책이 있는 사용자 목록을 보려면 상태->사용자->사용자 속성을 선택합니다. 다음 예는 10개의 사용자 및 관련 정책을 보여줍니다:

‍

BQN에서 디지털 인증서가 필요한 경우

‍

때때로 REST 클라이언트에서 액세스의 유효성을 검사하기 위해 특정 디지털 인증서가 필요한 경우가 있습니다.

BQN 유닉스 셸에 루트로 로그인합니다.

다음 디렉터리를 찾습니다:

 
/bqn/root/etc/ssl/certs
/bqn/root/etc/ssl/private

‍

디렉터리가 종료되지 않으면 디렉터리를 만듭니다:

bqn:~ # mkdir -p /bqn/root/etc/ssl/certs/
bqn:~ # mkdir -p /bqn/root/etc/ssl/private/
bqn:~ # chmod 700 /bqn/root/etc/ssl/private/

‍

다음 파일에 인증서와 해당 키를 복사합니다:

 
/bqn/root/etc/ssl/certs/bqn.crt
/bqn/root/etc/ssl/private/bqn.key

(scp를 사용하여 이전에 인증서 파일을 BQN 서버로 전송할 수 있습니다).

‍

변경 사항을 적용하려면 관리->재부팅에서 BQN 서버를 재부팅합니다.