Server security options

arangod provides a variety of options to make a setup more secure. Administrators can use these options to limit access to certain ArangoDBserver functionality as well as providing the leakage of information aboutthe environment that a server is running in.

General security options

The following security options are available:

  • —server.hardenIf this option is set to true and authentication is enabled, non-admin userswill be denied access to the following REST APIs:

    • /_admin/log
    • /_admin/log/level
    • /_admin/status
    • /_admin/statistics
    • /_admin/statistics-description
    • /_api/engine/statsAdditionally, no version details will be revealed by the version REST API at /_api/version.

The default value for this option is false.

JavaScript security options

arangod has several options that allow you to make your installation moresecure when it comes to running application code in it. Below you will find an overview of the relevant options.

Blacklist and whitelists

Several options exists to restrict JavaScript application code functionality to just certain allowed subsets. Which subset of functionality is availablecan be controlled via blacklisting and whitelisting access to individual components.

The set theory for these lists works as follow:

  • Only a blacklist is specified:Everything is allowed except a set of items matching the blacklist.
  • Only a whitelist is specified:Everything is disallowed except the set of items matching the whitelist.
  • Both whitelist and blacklist are specified:Everything is disallowed except the set of items matching the whitelist.From this whitelisted set, subsets can be forbidden again using the blacklist.

Values for blacklist and whitelist options need to be specified as ECMAScript regular expressions.Each option can be used multiple times. When specifying more than one pattern, these patterns will be combined with a logical or to the actual patternArangoDB will use.

These patterns and how they are applied can be observed by enabling —log.level SECURITY=debug in the arangod or arangosh log output.

Combining patterns

The security option to observe the behavior of the pattern matching most easilyis the masquerading of the startup options:

  1. --javascript.startup-options-whitelist "^server\."
  2. --javascript.startup-options-whitelist "^log\."
  3. --javascript.startup-options-blacklist "^javascript\."
  4. --javascript.startup-options-blacklist "^endpoint$"

These sets will resolve internally to the following regular expressions:

  1. --javascript.startup-options-whitelist = "^server\.|^log\."
  2. --javascript.startup-options-blacklist = "^javascript\.|endpoint"

Invoking an arangosh with these options will hide the blacklisted commandlineoptions from the output of:

  1. require('internal').options()

… and an exception will be thrown when trying to access items that are maskedin the same way as if they weren’t there in first place.

File access

In contrast to other areas, access to directories and files from JavaScriptoperations is only controlled via a whitelist, which can be specified via thestartup option —javascript.files-whitelist. Thus any files or directoriesnot matching the whitelist will be inaccessible from JavaScript filesystemfunctions.

For example, when using the following startup options

  1. --javascript.files-whitelist "^/etc/required/"
  2. --javascript.files-whitelist "^/etc/mtab/"
  3. --javascript.files-whitelist "^/etc/issue$"

The file /etc/issue will be allowed to accessed and all files in the directories/etc/required and /etc/mtab plus their subdirectories will be accessible,while access to files in any other directories will be disallowed from JavaScript operations, with the following exceptions:

  • ArangoDB’s temporary directory: JavaScript code is given access to thisdirectory for storing temporary files. The temporary directory location can be specified explicitly via the —temp.path option at startup. If the option is not specified, ArangoDB will automatically use a subdirectory of the system’s temporary directory.
  • ArangoDB’s own JavaScript code, shipped with the ArangoDB release packages.Files in this directory and its subdirectories will be readable for JavaScriptcode running in ArangoDB. The exact path can be specified by the startup option —javascript.startup-directory.

Endpoint access

The endpoint black/white listing limits access to external HTTP resources. In contrast to the URLs specified in the JavaScript code, the filters haveto be specified in the ArangoDB endpoints notation:

  • http:// => tcp://
  • https:// => ssl://
  • no protocol will match http and https.

Filtering is done on the protocol, hostname / IP address, and the port.

Specifying arangodb.org will match:

Specifying ssl://arangodb.org will match:

Specifying ssl://arangodb.org:443 will match:

Specifying tcp://arangodb.org will match:

This can be tried out using a whitelist - all non matches will be blocked:

  1. arangosh --javascript.endpoints-whitelist ssl://arangodb.org
  2. 127.0.0.1:8529@_system> require('internal').download('https://arangodb.org:4444')
  3. <whitelist permitted, error on trying to connect>
  4. 127.0.0.1:8529@_system> require('internal').download('http://arangodb.org')
  5. JavaScript exception: ArangoError 11: not allowed to connect to this endpoint

Options for blacklisting and whitelisting

The following options are available for blacklisting and whitelisting accessto dedicated functionality for application code:

  • —javascript.startup-options-[whitelist|blacklist]:These options control which startup options will be exposed to JavaScript code, following above rules for blacklists and whitelists.

  • —javascript.environment-variables-[whitelist|blacklist]:These options control which environment variables will be exposed to JavaScriptcode, following above rules for blacklists and whitelists.

  • —javascript.endpoints-[whitelist|blacklist]:These options control which endpoints can be used from within the @arangodb/requestJavaScript module.Endpoint values are passed into the filter in a normalized format startingwith either of the prefixes tcp://, ssl://, unix:// or srv://.Note that for HTTP/SSL-based endpoints the port number will be included too,and that the endpoint can be specified either as an IP address or host namefrom application code.

  • —javascript.files-whitelist:This option controls which filesystem paths can be accessed from JavaScript code.

Additional JavaScript security options

In addition to the blacklisting and whitelisting security options, the followingextra options are available for locking down JavaScript access to server functionality:

  • —javascript.allow-port-testing:If set to true, this option enables the testPort JavaScript function in theinternal module. The default value is false.

  • —javascript.allow-external-process-control:If set to true, this option allows the execution and control of external processesfrom JavaScript code via the functions from the internal module:

    • executeExternal
    • executeExternalAndWait
    • getExternalSpawned
    • killExternal
    • suspendExternal
    • continueExternal
    • statusExternal

  • —javascript.harden:If set to true, this setting will deactivate the following JavaScript functionsfrom the internal module, which may leak information about the environment:

    • getPid()
    • logLevel()The default value is false.

Security options for managing Foxx applications

The following options are available for controlling the installation of Foxx applicationsin an ArangoDB server:

  • —foxx.api:If set to false, this option disables the Foxx management API, which will make itimpossible to install and uninstall Foxx applications. Setting the option to falsewill also deactivate the “Services” section in the web interface. The default value is true, meaning that Foxx apps can be installed and uninstalled.

  • —foxx.store:If set to false, this option disables the Foxx app store in ArangoDB’s web interface,which will also prevent ArangoDB and its web interface from making calls to the main Foxx application Github repository atgithub.com/arangodb/foxx-apps.The default value is true.