# Security configuration statuses

Each repository that has a security configuration applied to it has a configuration status that reflects the current state of the relationship between the repository and the configuration.

A repository's configuration status tells you the current state of its relationship with the applied security configuration. That relationship can change over time—for example, when a repository admin overrides a setting, an admin enables enforcement, or an attachment fails. For more about how configurations and repositories interact, see [Aktivierung von Sicherheitsfunktionen in großem Maßstab](/de/code-security/concepts/security-at-scale/about-enabling-security-features-at-scale).

You can view configuration statuses in the repository table on your organization's security configurations settings page, or retrieve them with the REST API. For more information, see [Filtern von Repositories in Ihrer Organisation mithilfe der Repository-Tabelle](/de/code-security/how-tos/secure-at-scale/configure-organization-security/manage-your-coverage/filtering-repositories-in-your-organization-using-the-repository-table) and [Konfigurationen](/de/rest/code-security/configurations).

## Configuration status reference

The following table describes all configuration statuses, what causes each status, how each appears in the organization settings repository table, and the recommended action.

In the repository table, the "Configuration status" filter supports "Attached," "Removed," "Failed," "Enforced," and "Removed by enterprise." Repositories with a `detached` status appear as "No configuration" and are not filterable by configuration status in the UI. However, the REST API's `status` parameter does accept `detached` when listing repositories for an organization-level configuration.

| Status                  | Description                                                                                                                                                                                  | Cause                                                                                                                     | UI display                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Recommended action                                                                                                                                                                                                                                                                                                                    |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `attached`              | The configuration is actively applied. The repository inherits all settings from the configuration.                                                                                          | An organization or enterprise admin applied the configuration to the repository.                                          | The configuration name (for example, "My config")                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | No action needed.                                                                                                                                                                                                                                                                                                                     |
| `attaching`             | The configuration is being applied. This is a transient state.                                                                                                                               | An organization or enterprise admin just applied the configuration.                                                       | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-clock" aria-label="Applying" role="img"><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm7-3.25v2.992l2.028.812a.75.75 0 0 1-.557 1.392l-2.5-1A.751.751 0 0 1 7 8.25v-3.5a.75.75 0 0 1 1.5 0Z"></path></svg> Applying CONFIGURATION-NAME                                                                                                                                                                                                                                                                                                                                                                                                                                         | Wait for the operation to complete. If the status does not change, check for attachment failures.                                                                                                                                                                                                                                     |
| `updating`              | The configuration is being updated on the repository.                                                                                                                                        | An organization or enterprise admin changed a setting in the configuration.                                               | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-clock" aria-label="Updating" role="img"><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm7-3.25v2.992l2.028.812a.75.75 0 0 1-.557 1.392l-2.5-1A.751.751 0 0 1 7 8.25v-3.5a.75.75 0 0 1 1.5 0Z"></path></svg> Updating CONFIGURATION-NAME                                                                                                                                                                                                                                                                                                                                                                                                                                         | Wait for the update to complete.                                                                                                                                                                                                                                                                                                      |
| `enforced`              | The configuration is actively applied and enforced. Repository admins cannot change the enablement status of features controlled by the configuration.                                       | An organization or enterprise admin enabled enforcement on the configuration.                                             | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-shield" aria-label="Enforced" role="img"><path d="M7.467.133a1.748 1.748 0 0 1 1.066 0l5.25 1.68A1.75 1.75 0 0 1 15 3.48V7c0 1.566-.32 3.182-1.303 4.682-.983 1.498-2.585 2.813-5.032 3.855a1.697 1.697 0 0 1-1.33 0c-2.447-1.042-4.049-2.357-5.032-3.855C1.32 10.182 1 8.566 1 7V3.48a1.75 1.75 0 0 1 1.217-1.667Zm.61 1.429a.25.25 0 0 0-.153 0l-5.25 1.68a.25.25 0 0 0-.174.238V7c0 1.358.275 2.666 1.057 3.86.784 1.194 2.121 2.34 4.366 3.297a.196.196 0 0 0 .154 0c2.245-.956 3.582-2.104 4.366-3.298C13.225 9.666 13.5 8.36 13.5 7V3.48a.251.251 0 0 0-.174-.237l-5.25-1.68ZM8.75 4.75v3a.75.75 0 0 1-1.5 0v-3a.75.75 0 0 1 1.5 0ZM9 10.5a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Enforced CONFIGURATION-NAME | No action needed. For more information, see [Erzwingung der Sicherheitskonfiguration](/de/code-security/reference/security-at-scale/security-configuration-enforcement).                                                                                                                                                              |
| `removed`               | A repository-level setting was changed that conflicts with the configuration. The configuration is still associated with the repository, but the repository no longer inherits all settings. | A repository admin changed a security setting on an unenforced configuration.                                             | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-alert" aria-label="Removed" role="img"><path d="M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Removed CONFIGURATION-NAME                                                                                                                                                                                                                                                                                                                 | To restore the intended settings, re-apply the configuration in the "Advanced Security" page of the repository. To prevent future overrides, consider enabling enforcement.                                                                                                                                                           |
| `removed_by_enterprise` | An enterprise-level configuration change caused a conflict with the repository's settings.                                                                                                   | An enterprise admin changed a setting that conflicts with the organization-level configuration applied to the repository. | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-alert" aria-label="Removed" role="img"><path d="M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Removed CONFIGURATION-NAME                                                                                                                                                                                                                                                                                                                 | Coordinate with your enterprise admin to resolve the conflict. Re-apply the configuration at the organization or enterprise level.                                                                                                                                                                                                    |
| `failed`                | The configuration could not be attached to the repository.                                                                                                                                   | A conflict between existing repository settings and the configuration prevented attachment.                               | <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-alert" aria-label="Failed" role="img"><path d="M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z"></path></svg> Failed REASON                                                                                                                                                                                                                                                                                                                               | Filter by `config-status:failed` in the repository table, then follow the remediation guidance for the specific repository. For more information, see [Diagnose von Sicherheitskonfigurationsproblemen](/de/code-security/reference/security-at-scale/troubleshoot-security-configurations/diagnosing-security-configuration-issues). |
| `detached`              | No configuration is applied. The repository's security settings are managed individually.                                                                                                    | An organization admin detached the configuration, or the repository was never attached to a configuration.                | No configuration                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Apply a configuration if you want the repository to inherit centrally managed settings. For more information, see [Anwenden einer benutzerdefinierten Sicherheitskonfiguration](/de/code-security/securing-your-organization/enabling-security-features-in-your-organization/applying-a-custom-security-configuration).               |

## Understanding `removed` vs. `detached`

These statuses reflect different situations:

* **`removed`**: A repository admin changed a security setting that conflicts with an unenforced configuration. The configuration is still associated with the repository, but the repository no longer counts toward your organization's coverage metrics for that configuration. Re-applying the configuration restores the relationship.
* **`detached`**: The configuration is fully disconnected from the repository. The repository's existing security settings are unchanged, but no configuration manages them. To restore centrally managed settings, apply a new configuration.

To prevent repositories from reaching a `removed` status, enable enforcement on the configuration. For more information, see [Erzwingung der Sicherheitskonfiguration](/de/code-security/reference/security-at-scale/security-configuration-enforcement).

## Tracking configuration status changes with the audit log

Your organization's audit log records `repository_security_configuration` events whenever a configuration status changes. You can search for these events using the `action:repository_security_configuration` filter. For more information, see [Audit-Protokollereignisse für Ihre Organisation](/de/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/audit-log-events-for-your-organization#repository_security_configuration).

## Further reading

* [Aktivierung von Sicherheitsfunktionen in großem Maßstab](/de/code-security/concepts/security-at-scale/about-enabling-security-features-at-scale)
* [Erzwingung der Sicherheitskonfiguration](/de/code-security/reference/security-at-scale/security-configuration-enforcement)
* [Diagnose von Sicherheitskonfigurationsproblemen](/de/code-security/reference/security-at-scale/troubleshoot-security-configurations/diagnosing-security-configuration-issues)