Skip to main content

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 大規模なセキュリティ機能の有効化について.

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 リポジトリ テーブルを使用した組織内のリポジトリのフィルター処理 and 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.

StatusDescriptionCauseUI displayRecommended action
attachedThe 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.
attachingThe configuration is being applied. This is a transient state.An organization or enterprise admin just applied the configuration. Applying CONFIGURATION-NAMEWait for the operation to complete. If the status does not change, check for attachment failures.
updatingThe configuration is being updated on the repository.An organization or enterprise admin changed a setting in the configuration. Updating CONFIGURATION-NAMEWait for the update to complete.
enforcedThe 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. Enforced CONFIGURATION-NAMENo action needed. For more information, see セキュリティ構成の適用.
removedA 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. Removed CONFIGURATION-NAMETo 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_enterpriseAn 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. Removed CONFIGURATION-NAMECoordinate with your enterprise admin to resolve the conflict. Re-apply the configuration at the organization or enterprise level.
failedThe configuration could not be attached to the repository.A conflict between existing repository settings and the configuration prevented attachment. Failed REASONFilter by config-status:failed in the repository table, then follow the remediation guidance for the specific repository. For more information, see Diagnosing security configuration issues.
detachedNo 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 configurationApply a configuration if you want the repository to inherit centrally managed settings. For more information, see カスタム セキュリティ構成の適用.

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 セキュリティ構成の適用.

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 Organization の監査ログ イベント and エンタープライズの監査ログの検索.

Further reading