Using the standalone Config Editor

Refer to the 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 Configuration environments to select. Optional.

-

optional

PROD

configActivationTimeoutMilliseconds

The configuration activation timeout in milliseconds
(see Configuration activation timeout or 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.