Usage
9.4.10.1. Using the standalone Config Editor

Refer to the 9.4. IAM Config Editor (UI) for a general introduction.

In this section, we describe the specialties of the Standalone Config Editor.

The Standalone Config Editor can be used in two modes:

  • 1.
    "Editor-only Mode": for creating and modifying configurations - as "pure editor".
  • 2.
    "Instance Editor Mode": manage the configuration of one or more Airlock IAM instances.

Editor-only mode

In this mode, the Standalone Config Editor can:

  • create new configuration files
  • existing configuration files can be uploaded
  • after editing, the configuration file is downloaded

Instance editor mode

In this mode, the Standalone Config Editor can:

  • open configuration of one or more IAM instances
  • manage configuration of one or more IAM instances (working copies, templates, etc.)
  • upload and download configuration files
  • save and activate changes

Note that this mode is only available if the Config Editor has file system access to the instance's directories of an Airlock IAM installation.

The Standalone Config Editor needs to know, where the managed instance's files are.

This can be done by:

  • Using GET-parameters in the URL (see table below)
  • Using the settings dialog (click on 19236397.png)
URL Parameter Name
Description
Default Value
Status
Example
installationDir
The full path to the Airlock IAM configuration root directory.
-
mandatory
/home/airlock/iam
instanceName
Name of the instance to be configured.
-
mandatory
auth
env
The 9.1. Configuration environments to select. Optional.
-
optional
PROD
configActivationTimeoutMilliseconds
The configuration activation timeout in milliseconds
(see 9.4.8. Configuration activation timeout or 9.4.9. Configuration activation internals for details).
10000
optional
20000

Example URL

http://localhost:8080/airlock-config-editor/editConfig?installationDir=/opt/ergon/airlock&instanceName=test

Note that the variant with the GET parameters makes it especially suitable for bookmarking the links and managing multiple instances with only one Standalone Config Editor.