LCOS FX Configuration

The required parameters of the API for UF Add-ins can be read out as follows:

  1. Log in to the web interface of the LANCOM R&S Unified Firewall.
  2. Open the Developer Tools in your browser (usually F12) and switch to the Network tab.
  3. Perform desired configuration locally and record it in Dev-Tools.
  4. Copy payload from request with status 201.

API for UF Add-ins

Including the API as a variable to simplify calls to the following methods.

var ufApi = config.getUfApi();

LANCOM R&S Unified Firewall configurations consist of entities and singletons.

  • Entities: Entities are configurations where multiple entries can be made (e.g. network-connections).

  • Singletons: A singleton is a configuration that exists only once in the Unfied firewall (e.g. device name).

Methods of the API for UF Add-ins

  • ufAPI.raw: Raw API Requests are the general way how the API for UF Add-ins can be addressed. Various methods can be used to create, edit and delete configurations. Furthermore, it is possible to query configuration values.

    • Example:
      ufAPI.raw({ method: PUT|POST|GET|DELETE , uri: URI, body: { key: value, key: value, key: value }, failOnError: true|false })
      

Auxiliary methods:

The following methods simplify RAW requests:

  • ufAPI.lookup/ufAPI.lookupField: Various requests require the query of a UUID or a name field in the firewall configuration. The ufAPI.lookup method can be used to retrieve the UUID for required parameters (for example, Ethernet interfaces).

    • Example:

      ufAPI.lookup("Entity", { key: value });
      

      Parameters that do not have a UUID (e.g. routing table) are queried with the ufAPI.lookup.Field method.

    • Example:

      ufAPI.lookupField("Singleton", { key: value });
      
  • ufAPI.createObject: The ufAPI.createObject method is used to configure entities (e.g. network connections).

    • Example:
      ufAPI.createObject("Entity", { key: value, key: value, key: value });
      
  • ufAPI.modifyObject/ufAPI.modifySettings: The ufAPI.modifyObject method can be used to edit configurations of entities (e.g. network connections).

    • Example:
      ufAPI.modifyObject("Entity", ufAPI.lookup, { key: value, key: value, key: value });
      

    To customize singletons (e.g. firewall device name), the ufAPI.ModifySettings method is used.

    • Example:
      ufAPI.modifySettings("Singleton", { key: value });
      

results matching ""

    No results matching ""