virtual-wildcard-path[=file-system-path]
Parameters:
- virtual-wildcard-path
- A path that will be matched against the path specified in the HTTP request. This can contain wildcards as described below.
On Windows, slashes or backslashes can be used as path separators.
- file-system-path
- Optional: The path in the filesystem which the initial non-wildcard part of the virtual path is mapped to. If this is omitted, the
filesystem path is the same as the virtual path. In this case, omit the
= character.
The available wildcards are:
- *
- Matches any number of any characters except the path separator
/ (UNIX) or
\ on (Windows).
- **
- Matches any number of any characters. This can be interpreted as "include subdirectories".
Properties:
- Default:
- None; at least one entry under
[Allowed Paths] must be configured to use RFA's native file access feature.
- Values:
- A list of virtual path, usually with wildcards, and each optionally with a filesystem path. Requests containing a path which
matches one or more of the allowed paths are permitted to proceed, further security checks might apply. If more than one virtual
path matches, the best match will determine which filesystem path the request will be mapped to.
Comments:
Entries under
[Allowed Paths] affect RFA access to normal filesystem files. They do not affect spool, dataset, or COBOL file service operations.
By default, no paths are allowed; so to use RFA to retrieve, alter, or create normal files on the remote system, you must
configure at least one allowed-path element.
It is common to end a virtual path with
* or possibly an expression such as
*.txt to indicate it matches all or some files in the target directory. End a virtual path with
**, for example
**.dat to include subdirectories.
The filesystem-path part of each element is optional, but
Micro Focus recommends using it, to provide an abstraction that lets you relocate the target files without changing clients, and to hide
information about the filesystem.
Example:
[Allowed paths]
/reports/*.txt=/home/app/output
/docs/reference/**=/opt/refdocs/public