Configuring the REST Protection Forward Proxy in eperi sEcure Platform

Configure the eperi sEcure AnyApp REST-based in eperi sEcure Platform.

Procedure

  1. Access the eperi sEcure Admin Console and select the Appstab
  2. In the Apps tab, click +New in the upper right corner:
    Figure 1: Admin Console - New App
    New app - REST Protection Proxy
  3. In the Create App dialog, select REST Protection Forward Proxy as the app Type and provide an app Name of your choice. Then, click Submit.
    Figure 2: Configure App
    REST Protection Forward Proxy app configuration

    Disable Indexing: Activate to disable indexing (e.g. if you don't have Solr).

    Solr Collection Name: Enter the Solr collection name where your data will be indexed.

    REST Service Host: Enter here the hostname of the REST service you usually use

    REST Service Port: Enter here the port of the REST service you usually use

    Enable HTTPS: If you want to secure the communication channel between the proxy and the existing API endpoint via TLS, download the server certificate, import it into the eperi sEcure Platform truststore and activate this switch. See the eperi sEcure Platform Administrator Manual for details how to do this.

    Skip and log errors: In case of errors, log the problem and go on without complaint

    CAUTION: This can lead to unprotected clear text in the result!
  4. Select the Services tab and navigate to Proxies. Create a new Proxy by clicking on +New.
    Figure 3: Admin Console - New Proxy
    New Proxy - REST Protection Proxy
  5. In the Create Proxy dialog, provide a Name of your choice and select Forward as the proxy Type. Enter an available Port, then click Submit.
    Figure 4: Proxy configuration
    Proxy configuration

    TLS Enabled: If you want to secure the communication channel between client and proxy via TLS, download the eperi sEcure Platform certificate, import it into your client and activate this switch.

  6. Back to the proxy overview click Assign Apps.
    Figure 5: Assign Apps
    Assign App to Proxy
  7. In the pop-up select the REST Protection Example app created in step 3 and then click Assign.
    Figure 6: Assign App
    Assign App - REST Protection Example App
  8. Back to the proxy overview click the Start Button to start the proxy.
    Figure 7: Start Proxy
    Start Proxy

Results

If the Status Running is displayed, you have successfully started the proxy.
Note: Any change of the REST Protection Example App configuration requires a restart of the corresponding proxy in the Dashboard tab.

What to do next

Continue with egfca_rpp_configuring_rest_protection_endpoint.html.