BQN 문서

사용자 할당량

시간 및 볼륨 할당량은 사용자 IP 주소에 연결할 수 있습니다. 할당량이 모두 소진되면 사용자 IP 주소가 제한됩니다(기본적으로 트래픽이 차단됨). 시간 할당량과 볼륨 할당량을 동시에 IP 주소에 연결할 수 있으며, 이 경우 할당량 중 하나라도 소진되면 제한이 발생합니다.

할당량은 IP 주소에 할당됩니다. 사용자 에서 IP 주소를 새 주소로 변경하는 경우 REST API를 통해 프로비저닝될 때까지 새 IP 주소에는 할당량이 연결되지 않습니다.

시간 할당량은 일정 기간 동안 액세스 권한을 부여합니다. 시간 할당량을 정의하는 방법에는 두 가지가 있습니다:

• 절대 시간으로. 예를 들어, 05/23/2023(2023년 5월 ^23일)입니다.
• 현재 날짜의 연장(예: 지금부터 15일 후)입니다.

볼륨 할당량은 트래픽 양에 대한 액세스 권한을 부여합니다. 시간 할당량을 정의하는 방법에는 두 가지가 있습니다:

• 절대적인 양으로. 예를 들어 10GB입니다.
• 용량 확장(예: 기존 10GB에 5GB 추가).

‍

 할당량 일반 구성

할당량 동작의 일반적인 측면을 구성하려면 상태->사용자->사용자 할당량으로 이동하여 고급 할당량 매개변수를 확장하세요.

‍

사용자 초기 할당량 상태는 할당량이 할당되지 않은 IP 주소에 대해 수행할 작업을 정의합니다:

• 사용 안 함(기본값)으로 설정하면 트래픽이 제한 없이 허용됩니다.
• 차단됨으로 설정하면 유효한 할당량이 할당될 때까지 트래픽이 차단됩니다.

리디렉션 URL 필드는 할당량 소진으로 인해 IP 주소가 차단된 경우(캡티브 포털) HTTP 트래픽을 리디렉션할 사이트를 지정합니다. IPv4 트래픽을 리디렉션하는 필드와 IPv6 트래픽을 리디렉션하는 필드가 하나씩 있습니다. 동일한 캡티브 포털이 IPv4와 IPv6 모두에 사용되는 경우 두 필드에 동일한 URL이 있을 수 있습니다.

• 필드가 비어 있으면 리디렉션이 시도되지 않습니다.
• URL을 지정하면 HTTP 트래픽의 해당 IP 버전에 대해 해당 URL로 리디렉션이 시도됩니다.

최신 브라우저는 보안상의 이유로 리디렉션 시도로부터 보호되므로 HTTPS 리디렉션은 지원되지 않습니다.

HTTP 리디렉션만 지원되지만 트래픽을 리디렉션하는 사이트는 HTTPS일 수 있으며, 실제로 그렇게 하는 경우가 많습니다(이전 스크린샷에서 사용된 URL은 https://my-captive-portal.com).

HTTP 리디렉션을 사용하는 경우 리디렉션 사이트(및 관련 DNS 쿼리)로의 트래픽을 허용하는 정책이 필요합니다. 자세한 내용은 캡티브 포털 정책 섹션을 참조하세요.

‍

사용자 IP에 할당량 연결

할당량을 사용자 IP 주소에 연결하려면 상태->사용자->사용자 할당량으로 이동합니다. 새 할당량 추가를클릭합니다 사용자.. . 구성->사용자 할당량->사용자 할당량에서도 액세스할 수 있습니다.

다음 예에서는 시간 할당량을 절대 시간으로 정의합니다:

‍

현재 날짜와 시간을 기준으로 시간 할당량을 정의할 수도 있습니다(예제에서는 +1개월):

볼륨 할당량을 정의하려면 먼저 절대값(예제에서는 20GB)을 정의합니다:

볼륨 할당량이 생성되면 할당량을 편집하고 이 양만큼 제한을 늘림 (다음 예제에서는 5GB) 옵션을 사용하여 할당량을 확장할 수 있습니다:

‍

‍

현재 사용량 필드에는 이미 사용된 할당량에 대한 정보가 표시됩니다. 오른쪽 하단의 원형 차트가 이를 그래픽으로 보여줍니다.

시간 및 볼륨 할당량이 공존할 수 있으며, 이 경우 두 가지 중 하나가 모두 소진되면 사용자 트래픽이 제한됩니다.

시간 제한 제거 또는 볼륨 제한 제거 버튼을 각각 눌러 할당량을 편집하고 시간 또는 볼륨 구성 요소를 제거할 수도 있습니다.

할당량 상태 확인

‍

상태->사용자->사용자 할당량에는 할당량이 표시되며, 볼륨 할당량의 경우 이미 소비된 양이 표시됩니다.

앞의 예에서는 볼륨 할당량 3개와 시간 할당량 2개가 있습니다(월은 일 앞에 주어지므로 9/29/2023은 2023년 9월 ^{29일입니다}). 볼륨 할당량의 경우 이미 소비한 볼륨도 표시됩니다(예: 10.0.0.3의 할당량은 15GB이며 20MB를 소비함).

‍

할당량 소진 시 속도 저하

‍

기본적으로 할당량이 모두 소진되면 트래픽이 완전히 차단되지만, 할당량을 다시 채우지 않는 동안에는 트래픽을 느린 속도로 제한할 수 있습니다.

다음 예제에서는 흐름 기본 정책을 변경하여 할당량이 모두 소진되면 트래픽 속도를 늦춥니다:

‍

캡티브 포털 정책

할당량 일반 구성 섹션에서 할당량이 소진될 때 캡티브 포털로 리디렉션을 정의하는 방법을 살펴보았습니다. 캡티브 포털을 구현하려면 해당 포털에 대한 트래픽에 할당량이 적용되지 않아야 하며, 이는 플로우 정책을 사용하여 구현됩니다.

다음 예제에서는 두 개의 트래픽 카테고리가 할당량 제어에서 벗어나야 합니다(정책 흐름-할당 없음):

• 포로 포털로 이동하는 트래픽.
• 일부 특정 DNS 서버에 대한 트래픽(캡티브 포털 URL을 확인하는 데 사용).

‍

할당량 소진의 영향을 받지 않는 정책은 할당량 전환이 꺼짐으로 설정되어 있습니다:

‍

REST API를 사용하여 할당량 관리

GUI 외에도 BQN REST API를 사용하여 시간 및 볼륨 할당량을 관리할 수 있습니다.

자세한 내용은 REST API 참조를 참조 하세요.

‍

시간 할당량

시간 할당량을 정의하는 방법에는 두 가지가 있습니다:

• 절대 시간: 1970년 1월 1일 자정(협정 세계시(UTC)) 이후 경과한 시간(초)으로 정의되는 POSIX 시간입니다. 예를 들어 1672531200 는 UTC 일요일 1월 1일 20230:00:00입니다. 절대 시간은 UTC이므로 할당량을 설정할 때 현지 시간을 UTC로 변환하세요.
• 현재 시간을 기준으로 초 단위로 표시: 예를 들어 3600초 할당량은 지금부터 한 시간 후에 소진됩니다.

‍

1시간의 시간 할당량을 사용하도록 설정합니다:

curl -k -u myuser:mypassword -X POST https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"quota": {"timeRemaining": 3600}}'

‍

지금부터 2시간으로 할당량을 연장합니다:

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"quota": {"timeRemaining": 7200}}'

‍

할당량을 제거하여 사용자 에 더 이상 시간 할당량이 적용되지 않도록 하려면 다음과 같이 하세요:

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"quota": {"time": null}}'

‍

볼륨 할당량

볼륨 할당량은 몇 킬로바이트의 트래픽에 대한 액세스 권한을 부여합니다. BQN 규칙에 따르면 1K바이트는 1000바이트입니다.

‍

1GB 볼륨 할당량을 사용하려면 다음과 같이 하세요:

curl -k -u myuser:mypassword -X POST https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"quota": {"volume": 1000000}}'

‍

500MB를 추가하여 할당량을 확장합니다:

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"quota": {"volumeIncrement": 500000}}'

‍

할당량을 제거하여 사용자 에 더 이상 볼륨 할당량이 적용되지 않도록 합니다:

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"quota": {"volume": null}}'

‍

볼륨 및 시간 할당량을 동시에 관리하기

‍

1GB 볼륨 할당량과 1개월(먼저 발생하는 것)을 사용하도록 설정합니다:

curl -k -u myuser:mypassword -X POST https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"quota": {"volume": 1000000, "timeRemaining": 2678400}}'

‍

시간 할당량은 변경하지 않고 볼륨 할당량을 500MB 단위로 확장합니다:

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"quota": {"volumeIncrement": 500000}}'

‍

두 할당량을 모두 제거하여 사용자 에 더 이상 할당량이 적용되지 않도록 합니다:

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"quota": {"volume": null, "time": null}}'

‍

할당량 상태 확인

REST API를 통해 할당량 상태를 확인할 수도 있습니다:

curl -k -u myuser:mypassword -X GET https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35

{
  "subscriberIp": "10.0.0.35",
  "quota" : {
    "volume" : 1000000000,
    "volumeConsumed" : 647474875
    "time" : 1676628377,
    "timeRemaining" : 5364849
  },
  "policyRate" : ""
}

RADIUS에서 관리되는 할당량

RADIUS 프록시 배포의 BQN은 볼륨 및 시간 할당량을 처리할 수 있습니다. 자세한 내용은 RADIUS 챕터로 이동하세요.