6.4 Configuring Oracle REST Data Services

Configuring Oracle REST Data Services requires that you copy the images directory, run a configuration to configure RESTful Services, configure static files support, and secure Oracle REST data service.

How to configure RESTful Services in a new installation is discussed in the following section.

• Copying the Images Directory
  Whether you are loading a new installation or upgrading from a previous release, you must copy the images directory from the top level of the apex\images directory, for example C:\TEMP, to the location used by your Oracle REST Data Services installation.
• Validating the Oracle REST Data Services Installation
  In a new installation or upgrade of Oracle Application Express, you must validate the Oracle REST Data Services installation.
• Configuring Static File Support
  For configuring static files, you must run apex_rest_config.sql after a new installation of Oracle Application Express.
• Securing Oracle REST Data Service
  In a configuration for Oracle Application Express, Oracle recommends setting the parameter security.requestValidationFunction to wwv_flow_epg_include_modules.authorize.

6.4.1 Copying the Images Directory

Whether you are loading a new installation or upgrading from a previous release, you must copy the images directory from the top level of the apex\images directory, for example C:\TEMP, to the location used by your Oracle REST Data Services installation.

During an upgrade, you overwrite your existing images directory. Before you begin the upgrade, to ensure that you can revert to the previous version, Oracle recommends that you create a copy of your existing images directory for Oracle Application Express, indicating the release number of the images (for example, images_5_1).

See Also:

Oracle REST Data Services Installation, Configuration, and Development Guide

6.4.2 Validating the Oracle REST Data Services Installation

In a new installation or upgrade of Oracle Application Express, you must validate the Oracle REST Data Services installation.

For validating the Oracle REST Data Services installation in a new installation or upgrade of Oracle Application Express, run the following :

java -jar ords.war validate [--database <dbname>]

See Also:

Oracle REST Data Services Installation, Configuration, and Development Guide

6.4.3 Configuring Static File Support

For configuring static files, you must run apex_rest_config.sql after a new installation of Oracle Application Express.

Oracle Application Express enables application developers to include static files with their applications. Static files can be associated with a workspace, an application, a plug-in, or an application theme. When using Oracle REST Data Services as your web listener, static files are served using RESTful service module built into Oracle Application Express. Therefore, you must run apex_rest_config.sql after a new installation of Oracle Application Express.

See Also:

"Configuring Oracle REST Data Services"

6.4.4 Securing Oracle REST Data Service

In a configuration for Oracle Application Express, Oracle recommends setting the parameter security.requestValidationFunction to wwv_flow_epg_include_modules.authorize.

Set parameter security.requestValidationFunction to wwv_flow_epg_include_modules.authorize activates the white list of callable procedures which ships with Oracle Application Express and prohibits calls to other procedures.

See Also:

Oracle Application Express App Builder User’s Guide