---
title: Constants
summary: API reference for Constants.
status: draft
owner: <owner>
last_reviewed: 2026-07-23
library: SAIF.Framework.Security.EnvironmentApi
reference_type: package
---

# Constants

`Constants` holds a single shared constant, `GlobalSection`, identifying the name of the global (non-custom) configuration section used throughout this library's configuration-key resolution logic.

## Purpose
- Provide the well-known section name that represents "global" (non-custom-section) configuration keys.

## Context
- Namespace: `SAIF.Framework.Security`
- Assembly/package: `SAIF.Framework.Security.EnvironmentApi`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| GlobalSection | `public const string GlobalSection = "global"` | The section name used to represent global (non-custom) configuration keys; underlies [BR-009](../../business-rules.md#br-009-global-section-is-the-sole-non-custom-section). |

## Behavioral notes
- `ConfigKey.IsCustomSection` compares a key's `Section` against `Constants.GlobalSection` (case-insensitively) to decide whether the key belongs to a custom section or the global section.
- `EnvironmentServiceBase` compares a resolved section name against `Constants.GlobalSection` when deciding how to route configuration lookups.

## Constraints and usage notes
- Always use `Constants.GlobalSection` rather than the literal string `"global"` when comparing or constructing global-section keys, to avoid case-sensitivity or typo mismatches.

> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.

## Sources
- SAIF.Framework.Security.EnvironmentApi\Services.Common\EnvironmentServiceBase.cs
- SAIF.Framework.Security.EnvironmentApi\Core\Contracts\Core\Configurations\ConfigurationSettings.cs