Page tree
Skip to end of metadata
Go to start of metadata

Configure Textbox.io Services. You can specify configuration for the Textbox.io server-side features using one of 2 options.

File based configuration

You can create an application.conf file and specify the settings as documented in the Configuring Textbox.io Services article with the following variations for Connections and WebSphere:

  1. On the drive/partition where WebSphere Application Server (WAS) is installed, create the text file

    Operating SystemPathNotes
    Linux/Unix/opt/ephox/application.conf 
    WindowsWAS_INSTALLATION_DRIVE:\opt\ephox\application.confWAS_INSTALLATION_DRIVE is the drive where Websphere Application Server is installed, e.g. "C", "D" or "E" etc



  2. Edit this file as shown in section "Create a configuration file" on the installing the server-side components page and the configure the enhanced media embed service page in the Textbox.io documentation. In the example below we have chosen to only include the free Youtube oEmbed endpoint as an example but normally you would list many more or use an Iframely account for the best experience.

    Example application.conf
    ephox {
      allowed-origins {
        origins = [
          "http://connections:9081",
          "https://connections:9444",
    
          "http://connections",
          "https://connections"
        ]
      }
      proxy {
        http.proxyHost = someproxy.internal.corp
        http.proxyPort = 8080
      }
      embed {
        custom = [
          # youtube
          {
            endpoint = "http://www.youtube.com/oembed"
            schemes = [
              "http://youtu.be/*",
              "https://youtu.be/*",
              "http://www.youtu.be/*",
              "https://www.youtu.be/*",
              "http://youtube.com/*",
              "https://youtube.com/*",
              "http://www.youtube.com/*",
              "https://www.youtube.com/*",
              "http://m.youtube.com/*",
              "https://m.youtube.com/*"
            ]
          }
    	  # Note, many other endpoints omitted here for brevity 
        ]
      }
    }
    
    
  3. When configuration is updated, please restart the EphoxTbioServices application via WebSphere Application Server.

JVM System properties based configuration

If the file-based mechanism is not appropriate, you can set JVM system settings for the configuration of the services.

Note that while it is possible to configure everything using system properties it is not recommended if you wish to use the Enhanced Media Embed service with free oEmbed endpoints as there are many configuration values required for a good experience.

The following steps describe the process for setting the configuration using JVM system properties.

  1. Find your JVM settings according to the version of Websphere that you are running. Use this page to do so: http://www-01.ibm.com/support/docview.wss?uid=swg21417365 

  2. Specify the domains where the editor is served from, and optionally other settings such as link caching and proxy configuration. For details, please review Server-Side Components - Installation and Setup for Textbox.io.

    Example JVM system properties
    -Dephox.allowed-origins.origins.0=http://connections 
    -Dhttp.proxyHost=someproxy.internal.corp 
    -Dhttp.proxyPort=8080
  3. When specifying the URL/s for the domains that will serve the Textbox.io editor, you may need to specify different combinations of the protocol, hostname and port based on the browsers you use. For more details, please review Server-Side Components - Installation and Setup for Textbox.io.
    If you need additional domains where the editor is served from, you need to specify additional allowed origins by repeating -Dephox.allowed-origins.origins.0=domain, replacing the “0” with an incrementing number for each domain that is added.

    Example JVM system properties
    -Dephox.allowed-origins.origins.1=http://connections.yourdomain
    -Dephox.allowed-origins.origins.2=http://connections:10039
    -Dephox.allowed-origins.origins.3=http://connections.yourdomain:10039
  • No labels