Page History
Panel | ||||||
---|---|---|---|---|---|---|
In this section:
|
Info | ||
---|---|---|
| ||
Related articles: |
Add_workflow_for_techpubs AUTH1 UserResourceIdentifier{userKey=8a00a0c85b2726c2015b58aa779d0003, userName='null'} JIRAIDAUTH CHOR-5551 REV5 UserResourceIdentifier{userKey=8a00a0c85b2726c2015b58aa779d0003, userName='null'} REV6 UserResourceIdentifier{userKey=8a00a0c85b2726c2015b58aa779d0003, userName='null'} REV3 UserResourceIdentifier{userKey=8a00a0c86c120d6f016c429a5bea0025, userName='null'} REV1 UserResourceIdentifier{userKey=8a00a0c86a61778d016a7d0876df0017, userName='null'}
Overview
The
generates CDRs and logs what Ribbon Protect uses to identify bad actors (bad actors are identified as unwanted calls that attempt to threaten security, disrupt networks, perform fraudulent behavior, etc.). When Ribbon Protect suspects and identifies bad actors, the Spacevars 0 product
uses this data to block list and block these bad actors from entering your network. The REST API is used in addition to Ribbon Protect to enable bad actors to be block listed by the Spacevars 0 product
. When bad actors are identified by Ribbon Protect, they are reflected in the Spacevars 0 product
WebUI's "Bad Actors" table. Spacevars 0 product
supports block listing four types of bad actors: Spacevars 0 product
- Calling Number
- Called Number
- Source IPv4 Address
- Source IPv6 Address
The steps below are required to configure and display bad actors via Spacevars 0 company
. Spacevars 0 product
The maximum number of Bad Actor listed by product is as follows:
Maximum Number of Bad Actors
Product | Number of Bad Actors | ||||
---|---|---|---|---|---|
SBC 1000/2000 | 500 | ||||
Spacevars |
| 1000 |
Prerequisites
Create REST user in Spacevars0 product
0 | product |
---|
To use REST API, you must create a local user with REST access level.
Create a user in the
Spacevars | ||
---|---|---|
|
- Access the WebUI and login to the
.Spacevars 0 product - In the Web GUI, click the Settings tab.
In the left navigation pane, go to Security > Users > Local User Management.
Panel borderStyle none Caption 10 Figure Local Users Table Click the Create Local User (
) icon at the top of the Local User View page. The Create Local User screen appears.Panel borderStyle none Caption 0 Figure 1 Create Local User - Enter user name in the User Name field.
- Enter and confirm the user’s new password in Password and Confirm Password fields.
- From the Access Level drop down list, select REST.
Click OK. The REST user is created and the Local Users Table screen displays the newly created REST user.
AnchorCountrycode Countrycode
Configure Country Code via WebUI
Countrycode | |
Countrycode |
Through the WebUI, configure the country code the
resides in; the Spacevars 0 product
uses the country code to convert a PSTN Calling/Called Number to E.164 format and search for it in the internal data structures. Spacevars 0 product
Configure the Country Code via WebUI as follows:
- In the WebUI, click the Settings tab.
In the left navigation page, go to System > Node-Level Settings.
From the Country Code drop down list, select the applicable country.
Panel borderStyle none Caption 0 Figure 1 Configure Country CodeClick Apply.
Configure REST API to Create/Display/Delete "Bad Actors"
The commands listed in this section are used to create/display/delete bad actors from Ribbon Protect via REST API. After the bad actors are created, they can be viewed or displayed via REST API (alternatively, bad actors are viewed through the WebUI; see Display Bad Actors via SBC Edge WebUI). Configure REST API as follows:
- Access the REST API. The REST API is based on open standards; you can use any Web Development Programming Language or HTTP Client Library to access the API. Refer to API Requirements for more details.
- Execute the specific commands. Refer to REST API User's Guide.
Working with Protect Bad Actors via
Spacevars | ||
---|---|---|
|
The
WebUI displays the bad actors identified by Protect. Through the WebUI, you can view the bad actors and delete as necessary. Spacevars 0 product
AnchorDisplayBadActor DisplayBadActor
Display Bad Actors
DisplayBadActor | |
DisplayBadActor |
The
WebUI displays the bad actors identified by Protect. Spacevars 0 product
View bad actors as follows:
- Access the WebUI.
Click Settings > Security > Ribbon Protect Bad Actors.
Click the expand (
) next to the desired Bad Actor in which you want to view.Panel borderStyle none Caption 10 Figure Bad Actors Table Caption 10 Figure
Bad Actors Table - Field DefinitionsField Definition Actor Type The bad actor type Valid entries:
- Calling Number.
- Called Number.
- Source IPv4 Address.
- Source IPv6 Address.
Actor Data The valid data string according to actor type: Valid entries:
- Calling Number: Valid string in E164 format.
- Called Number: Valid string in E164 format
- Source IPv4: Validated for correct IPv4 format, Precedence falls between 1-1000, and only one occurrence.
- Source IPv6: Validated for correct IPv6 format, Precedence falls between 1-1000, and only one occurrence.
Precedence This field validates if the actor type is in correct format, according to the actor type: - Calling Number: Not applicable.
- Called Number: Not applicable
- Source IPv4: Range 1-1000
- Source IPv6: Range 1-1000
NOTE: For ActorType as Source IPv4 Address or Source IPv6 Address, the valid Precedence range is 1-1000. A Precedence value of 0 is used for all entries where Precedence is not applicable (i.e., callingnumber, callednumber type).
Primary Key Value set by the table entry.
Remove Bad Actors
Through the WebUI, you can delete bad actors identified by Protect and delete in the SBC WebUI, as necessary.
Delete bad actors as follows:
- Access the WebUI.
Click Settings > Security > Ribbon Protect Bad Actors.
- Select the checkbox next to the entry you wish to delete.
Caption 0 Figure 1 Delete Bad ActorsIn the left corner, click the Delete ( ) icon.
Panel borderStyle none