Path / URL Permissions

Note: You do not need to restart PopChart Server after changing path and URL permissions.

This screen allows you to edit the path.xml file, which controls read and write permissions for PopChart Server.

More exactly, this file controls which server-side directories PopChart Server can read appearance files from and save images to. It also controls valid callback domains for appearance files and graph data. In order for PopChart Server to read any appearance or data file, PopChart Server must have permission to read from the location where that file is stored.

Note: By default, the only URL you can read data or appearance files from is the machine that PopChart Server is running on. The only server-side directories that PopChart Server can read from are those in its document root (usually chart_root).

For a more detailed explanation of PopChart Server security, refer to "Setting Path Permissions" in Chapter 3 of the PopChart Server User Guide.

For the complete path.xml document specification, refer to Chapter 10, "Path Settings."

To add permission to read from a specified URL

1. Copy the following text (which also appears in the Administration console) and paste it immediately above the last line:

<Map Name="MyAppServer" Path="appservername.mycompany.com" Action="allowDomain"/>

2. Replace MyAppServer (the value of the Name attribute) with the name you wish to give to this mapping.

This name is for descriptive purposes only, and is entirely up to you. In fact, this step is entirely optional.

3. Replace appservername.mycompany.com (the value of the Path attribute) with the name or IP address of the host that you want to allow PopChart Server to read from.

This will allows PopChart Server to read any file that comes from the specified host. For example, if we specify www.mycoolstats.com, we could read from sources such as http://www.mycoolstats.com/data/110899.html, http://www.mycoolstats.com/renderer?name=bar&apfile=26, etc.

You can also use wildcards. For instance, *.corda.com would allow any host in the corda.com domain (www.corda.com, popchart.corda.com, etc.). Similarly, 10.0.*.* would allow PopChart Server to read from any IP address that begins with 10.0.

4. Click Apply to apply your changes. You do not need to restart PopChart Server.

To add permission to read from a specified local path

1. Copy the following text and paste it immediately above the last line:

<Map Name="Read" Path="./path" Action="Load"/>

Note: This text is different from the text that appears in the Administration Console.

2. Replace Read (the value of the Name attribute) with the name you wish to give to this mapping.

This name is for descriptive purposes only, and is entirely up to you. In fact, this step is entirely optional.

3. Replace ./path (the value of the Path attribute) with the local path that you want to allow PopChart Server to read from.

If you precede the path with ./, it will be assumed to be relative to the document root. Otherwise, it will be assumed to be an absolute path accessible to the machine that PopChart Server is running on. You can also put a wildcard at the end of a path to indicate that PopChart Server can also read form any of its subdirectories.

For example, if you set this value to F:\InetPub\mydata\*, you are giving PopChart Server permission to read anything from the F:\InetPub\mydata directory, as well as any of its subdirectories. If you set this value to ./data, you are giving PopChart Server permission to read from the data directory in the document root, but none of its subdirectories.

4. Click Apply to apply your changes. You do not need to restart PopChart Server.