Configuration (ACS)

ACS Configuration lets operators review and edit ACS configuration parameters. Each entry contains a key, value, default value, legal values list, and description.

When to use it

Use ACS Configuration when you need to:

  • review current ACS configuration parameters,

  • search for a specific parameter by key or description,

  • change a configuration parameter value,

  • restore a parameter to its default value,

  • export a configuration snapshot before changes,

  • import updated configuration with a dry-run preview,

  • filter entries by change status or legal values presence.

Prerequisites

Before working with ACS Configuration:

  • Confirm you are logged into the correct environment.

  • Confirm your permissions:

    • VIEWER — browse configuration and Export.

    • EDITOR / ADMIN — edit values and Import.

VIEWER accounts run in read-only mode. Write actions (Edit/Import) are blocked.

Fields

Field Type Required Validation

Config Key

String

Yes

Unique; URL-encoded; often uses dot-separated prefix notation (e.g., acs.session.timeout)

Value

String (nullable)

No

An empty value is interpreted as null; cron expressions are validated when applicable

Default Value

String

No

System-provided default; used for change detection and reset

Legal Values

String list

No

Allowed values for the parameter (if defined)

Description

String

No

Purpose and usage of the parameter

Available operations

  • Browse and search — view entries with filtering by change status and legal values presence.

  • Edit — change the value of a configuration parameter.

  • Set null — clear a value to set it to null.

  • Reset to default — restore a parameter to its default value.

  • Batch update — apply multiple changes via import.

  • Grouped view — entries are grouped by category/prefix for easier navigation.

  • Import — upload an XML file (dry-run required before apply).

  • Export — download all entries as acs_configuration.xml.

Configuration entry structure

Each entry contains:

Key

Unique configuration parameter key (e.g., acs.session.timeout). Displayed in monospace font.

Value

Current parameter value. If the value differs from default, the entry is marked as Changed.

Default Value

Default value for the parameter. Used to reset changed values.

Legal Values

List of allowed values for the parameter (if defined). Helps when choosing a correct value.

Description

Description of the parameter’s purpose and usage.

Browse and search

Browse entries

  1. Open ACS Configuration.

  2. (Optional) Click Refresh to load the latest snapshot.

  3. Review the configuration entries table.

Search parameters

Use the search field to filter entries:

  1. Enter text in the search field.

  2. Search is performed across key, value, default value, legal values, and description.

  3. The list automatically filters as you type.

Filter entries

Use the Filters button to access advanced filters:

Changed Status

  • All — show all entries.

  • Changed only — show only changed entries (value differs from default).

  • Default only — show only entries with default values.

Validation

  • All — show all entries.

  • Has legal values — show only entries with defined legal values.

  • No validation — show entries without legal values.

To reset all filters, click Reset filters.

Edit entries (EDITOR/ADMIN)

Open an entry

  1. Click on a row in the table to open entry details.

  2. The modal displays:

    • Parameter key.

    • Current value.

    • Default value.

    • List of legal values (if any).

    • Parameter description.

    • Metadata (Created/Updated timestamps and authors).

Change value

  1. In the opened modal, click Edit.

  2. Update the value in the text field.

  3. If legal values are defined, ensure the new value matches the constraints.

  4. Click Save.

Expected outcomes:

  • On success, the entry updates and the modal closes.

  • If the new value differs from default, the entry is marked as Changed.

Set null value

  1. In the opened modal, click Edit.

  2. Clear the text field (leave empty).

  3. Click Save.

An empty value is interpreted as null. This is different from an empty string.

Export configuration

Export downloads an XML file with all configuration entries.

  1. Click Export.

  2. Save the downloaded file.

What is exported:

  • Full set of ACS configuration parameters (not only the current page).

  • Format: XML.

For details, see: Export a Snapshot.

Import with dry-run (mandatory)

Import is a safe way to apply many changes at once. Always follow the workflow: export → dry-run → apply.

  1. Export a snapshot first (recommended): Export a Snapshot.

  2. Click Import.

  3. Select an XML file (max 10MB).

  4. Dry-run starts automatically after file selection.

  5. Review the dry-run preview:

    • Summary counts (to add / update / delete / skip).

    • Details per entry, grouped by status.

    • Errors and warnings.

  6. If warnings exist, check Allow warnings.

  7. Click Confirm import only when the preview matches your intent.

Import safety checklist

  1. Confirm you are in the correct environment.

  2. Confirm your selected context (for example, client type) matches the file.

  3. Export a snapshot before changes.

  4. Run Dry-run and review:

    • errors (must be resolved),

    • warnings (understand impact),

    • create/update/delete counts.

  5. If using REPLACE, confirm you accept deletions shown in the dry-run plan.

  6. Apply import and immediately verify by refreshing and re-opening the affected entries.

Export is a good starting point for preparing an import file. The import schema focuses on key and value; extra exported fields are ignored by the importer.

View changed entries after import

After import, you can quickly review changed entries:

  1. Use the Changed only filter in the filters menu.

  2. Or click View changes in the successful import dialog (if available).

Refresh snapshot

  1. Click Refresh to reload the current configuration snapshot.

  2. Use refresh after imports or after changes by other operators.

Typical workflow

  1. Navigate to the ACS dashboard and select ACS Configuration.

  2. Browse the configuration entries table; use search or filters to find specific parameters.

  3. Click on a row to open the entry detail modal showing key, value, default, legal values, and description.

  4. Click Edit in the modal to modify the value (ensure it matches legal values if defined).

  5. Click Save to persist the change. The entry is marked as Changed if it differs from the default.

  6. Use the Changed only filter to review all modified parameters.

  7. Export the configuration as XML before or after changes for backup.

Troubleshooting

I don’t see Edit/Import actions

You are likely signed in as VIEWER. Ask an administrator to grant EDITOR/ADMIN access.

Export doesn’t work in read-only mode

Some deployments may restrict export for VIEWER accounts. If clicking Export does nothing, request elevated access.

Save is disabled

Fix field validation errors. Ensure the value matches legal values (if defined).

Dry-run says the file is invalid

ACS Configuration import accepts only XML files (max 10MB). Use Export as the base, edit it, and re-upload.

Dry-run shows errors

Fix the reported issues in the file (e.g., invalid values or non-existent keys), then select the file again to re-run dry-run.

Import succeeds but the list doesn’t look updated

Close the import dialog, refresh the ACS Configuration page, and check again.

Related pages