Configuration

The FraudStopper configuration file is an XML document that controls the different elements of the FraudStopper software.

• <licenseFilename>: This is a standalone parameter to specify the name of the license file.
• <loaders>: This configuration group controls the fraudStopper loader settings.
• <smtp>: Configuration of the SMTP interface used by the Alarms and Reports Controllers.
• <snmp>: Configuration of the SNMP interface used by the Alarms and Reports Controllers.

License Filename

The default licenseFilename is conf/license.txt and can be overridden in the FraudStopper configuration file using the licenseFilename parameter.

<licenseFilename>dist/conf/license.txt</licenseFilename>

History

• history/max: The maximum number of days of data retained. This value also impacts the license count since users without calls within the history window are removed from the system and the license is returned to the pool.

<history max="180" />

Loaders

The loaders configuration group contain one or more loader groups.

Loader

Each loader group controls a new instance of a co.ecg.cdrprocessor.processors.CDRProcessor subclass.

There is one supported CDRProcessor(s) at this time:

• co.ecg.cdrprocessor.processors.BroadWorksCDRProcessor - BroadWorks CDR Processor. Verified with BroadWorks versions R14 through R21sp1.

More than one type and/or more than one of each type of loader may be specified.

• type: Specifies the full class name of the CDRProcessor instance to be used when processing CDRs by this loader.
• name: Specifies the name of the loader to be used to identify the source of CDRs within FraudStopper. This arbitrary value should be unique within the system. Once set, this value MUST NOT BE CHANGED without contacting ECG support.

<loaders>
    <loader type="co.ecg.cdrprocessor.processors.BroadWorksCDRProcessor" name="production">
    [...]
    </loader>
    <loader type="co.ecg.cdrprocessor.processors.BroadWorksCDRProcessor" name="lab">
    [...]
    </loader>
</loaders>

Loader parameters

Row Details

• rowDetails:

<rowDetails>
    <cdrRow type="header" length="1" />
    <cdrRow type="failover" length="45" />
    <cdrRow type="call" length="378" />
</rowDetails>

CDR Folders

• cdrFolders:

<cdrFolders>
    <folder>/mnt/frauddetectionCDRs/active</folder>
    <folder>/mnt/frauddetectionCDRs/current</folder>
</cdrFolders>

<loaders>
    <loader type="co.ecg.cdrprocessor.processors.BroadWorksCDRProcessor" name="production">
        <rowDetails>
            <cdrRow type="header" length="1" />
            <cdrRow type="failover" length="45" />
            <cdrRow type="call" length="378" />
        </rowDetails>
        <cdrFolders>
            <folder>/mnt/frauddetectionCDRs/archive</folder>
            <folder>/Users/jpuckett/frauddetectionCDRs/current</folder>
        </cdrFolders>
    </loader>
[...]
</loaders>

SMTP

The <smtp> configuration group configures the values related to outbound SMTP server connections used for Alarms and Nightly Reports.

• hostname: The hostname of the mail server that will relay outbound email messages for Alarms and Nightly Reports.
• tls/enabled: Enables or disables TLS support between FraudStopper and the outbound SMTP server. The default is disabled.
• port: The TCP port that will be used to connect to the outbound SMTP server. The default is 25.
• authentication/enabled: Enables or disables SMTP authentication. If enabled, the username and password must also be provided.
  • username: The username used for SMTP authentication for outbound SMTP connections.
  • password: The password to be used for SMTP authentication for outbound SMTP connections.
• fromAddress: The email address to be used in the From: header on Alarms and Reports sent via email.
  
• toAddresses: This configuration group defines a list of email addresses to be included when Alarms and Reports are sent by FraudStopper. More than one <toAddress> may be specified.
  • toAddress: Emails addresses to be used for outbound email.
• subject: The subject line prefix to be used for outbound email messages.

<smtp>
    <hostname>mail.e-c-group.com</hostname>
    <tls enabled="false" />
    <port>25</port>
    <authentication enabled="false">
        <username>fraud</username>
        <password>PASSWORD</password>
    </authentication>
    <fromAddress>fraud@serviceprovider.com</fromAddress>
    <toAddresses>
        <toAddress>operator@serviceprovider.com</toAddress>
        <toAddress>support@serviceprovider.com</toAddress>
    </toAddresses>
    <subject>[FRAUD - XXX]</subject>
</smtp>

SNMP

The configuration group configures the values related to Simple Network Management Protocol(SNMP) services used for polling and traps.

<snmp>
    <listener>
        <addresss>0.0.0.0/8001</addresss>
        <community>public</community>
    </listener>
</snmp>