# Estados de configuración de seguridad

Cada repositorio que tiene aplicado security configuration tiene un estado de configuración que refleja el estado actual de la relación entre el repositorio y la configuración.

El estado de configuración de un repositorio indica el estado actual de su relación con el aplicado security configuration. Esa relación puede cambiar con el tiempo; por ejemplo, cuando un administrador del repositorio anula una configuración, un administrador activa el cumplimiento o falla un archivo adjunto. Para obtener más información sobre cómo interactúan las configuraciones y los repositorios, consulte [Habilitación de características de seguridad a escala](/es/enterprise-cloud@latest/code-security/concepts/security-at-scale/organization-security).

Puede ver los estados de configuración en la tabla del repositorio en la página de configuración de la security configurations organización o recuperarlos con la API REST. Para obtener más información, vea [Filtrado de repositorios en la organización mediante la tabla de repositorios](/es/enterprise-cloud@latest/code-security/how-tos/secure-at-scale/configure-organization-security/manage-your-coverage/filter-repositories) y [Configuraciones](/es/enterprise-cloud@latest/rest/code-security/configurations).

## Referencia del estado de configuración

En la tabla siguiente se describen todos los estados de configuración, lo que provoca cada estado, cómo aparece cada uno en la tabla del repositorio de configuración de la organización y la acción recomendada.

En la tabla del repositorio, el filtro "Estado de configuración" admite "Vinculado", "Eliminado", "Error", "Aplicado" y "Eliminado por la empresa". Los repositorios con un `detached` estado aparecen como "Sin configuración" y no se pueden filtrar por estado de configuración en la interfaz de usuario. Sin embargo, el parámetro `status` de la API de REST sí acepta `detached` al listar repositorios para una configuración de nivel de organización.

| Situación                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Description                                                                                                                                                                                                                                                                                                                                                            | Causa                                                                                                                                              | Presentación de la interfaz de usuario                    | Acción recomendada                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `attached`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | La configuración se aplica activamente. El repositorio hereda todas las opciones de configuración.                                                                                                                                                                                                                                                                     | Una organización o administrador de empresa aplicó la configuración al repositorio.                                                                | Nombre de configuración (por ejemplo, "Mi configuración") | No es necesario realizar ninguna acción.                                                                                                                                                                                                                                                                                                                           |
| `attaching`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | La configuración se está aplicando. Se trata de un estado transitorio.                                                                                                                                                                                                                                                                                                 | Un administrador de organización o de empresa acaba de aplicar la configuración.                                                                   |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| <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> Aplicando CONFIGURATION-NAME                                                                                                                                                                                                                                                                                                                                                                                                                                        | Espere a que se complete la operación. Si el estado no cambia, compruebe si hay fallos en los archivos adjuntos.                                                                                                                                                                                                                                                       |                                                                                                                                                    |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| `updating`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | La configuración se está actualizando en el repositorio.                                                                                                                                                                                                                                                                                                               | Un administrador de organización o de empresa cambió una configuración en la configuración.                                                        |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| <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> Actualización de CONFIGURATION-NAME                                                                                                                                                                                                                                                                                                                                                                                                                                 | Espere a que se complete la actualización.                                                                                                                                                                                                                                                                                                                             |                                                                                                                                                    |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| `enforced`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | La configuración se está aplicando activamente y se hace cumplir. Los administradores del repositorio no pueden cambiar el estado de habilitación de las características controladas por la configuración.                                                                                                                                                             | Un administrador de la organización o de la empresa habilitó la aplicación obligatoria de la configuración.                                        |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| <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> CONFIGURATION-NAME aplicado | No es necesario realizar ninguna acción. Para obtener más información, vea [Cumplimiento de la configuración de seguridad](/es/enterprise-cloud@latest/code-security/reference/security-at-scale/configuration-enforcement).                                                                                                                                           |                                                                                                                                                    |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| `removed`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Se cambió una configuración de nivel de repositorio que entra en conflicto con la configuración. La configuración sigue asociada al repositorio, pero el repositorio ya no hereda todas las opciones.                                                                                                                                                                  | Un administrador del repositorio cambió una configuración de seguridad en una configuración no aplicada.                                           |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| <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> Se eliminó CONFIGURATION-NAME                                                                                                                                                                                                                                                                                                              | Para restaurar la configuración prevista, vuelva a aplicar la configuración en la página "Advanced Security" del repositorio. Para evitar anulaciones futuras, considere habilitar la aplicación obligatoria.                                                                                                                                                          |                                                                                                                                                    |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| `removed_by_enterprise`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Un cambio de configuración de nivel empresarial provocó un conflicto con la configuración del repositorio.                                                                                                                                                                                                                                                             | Un administrador de empresa cambió una configuración que entra en conflicto con la configuración de nivel de organización aplicada al repositorio. |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| <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> Se eliminó CONFIGURATION-NAME                                                                                                                                                                                                                                                                                                              | Coordinar con el administrador de la empresa para resolver el conflicto. Vuelva a aplicar la configuración en el nivel de organización o de empresa.                                                                                                                                                                                                                   |                                                                                                                                                    |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| `failed`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | No se pudo adjuntar la configuración al repositorio.                                                                                                                                                                                                                                                                                                                   | Un conflicto entre la configuración existente del repositorio y la configuración impidió la agregación.                                            |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| <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> Motivo del fallo                                                                                                                                                                                                                                                                                                                            | Filtre por `config-status:failed` en la tabla del repositorio y siga las instrucciones de corrección del repositorio específico. Para obtener más información, vea [Diagnóstico de problemas de configuración de seguridad](/es/enterprise-cloud@latest/code-security/reference/security-at-scale/troubleshoot-security-configurations/configuration-issue-diagnosis). |                                                                                                                                                    |                                                           |                                                                                                                                                                                                                                                                                                                                                                    |
| `detached`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | No se aplica ninguna configuración. La configuración de seguridad del repositorio se administra individualmente.                                                                                                                                                                                                                                                       | Un administrador de la organización desasoció la configuración o el repositorio nunca se adjuntó a una configuración.                              | Sin configuración                                         | Aplique una configuración si desea que el repositorio herede la configuración administrada centralmente. Para obtener más información, vea [Aplicación de una configuración de seguridad personalizada](/es/enterprise-cloud@latest/code-security/how-tos/secure-at-scale/configure-organization-security/establish-complete-coverage/apply-custom-configuration). |

## Comprender `removed` vs. `detached`

Estos estados reflejan diferentes situaciones:

* **`removed`**: un administrador del repositorio ha cambiado una configuración de seguridad que entra en conflicto con una configuración no aplicada. La configuración sigue asociada al repositorio, pero el repositorio ya no cuenta para las métricas de cobertura de su organización para esa configuración. Volver a aplicar la configuración restaura la relación.
* **`detached`**: la configuración está completamente desconectada del repositorio. La configuración de seguridad existente del repositorio no cambia, pero ninguna configuración las administra. Para restaurar la configuración administrada centralmente, aplique una nueva configuración.

Para evitar que los repositorios alcancen el estado `removed`, habilite el cumplimiento en la configuración. Para obtener más información, vea [Cumplimiento de la configuración de seguridad](/es/enterprise-cloud@latest/code-security/reference/security-at-scale/configuration-enforcement).

## Seguimiento de los cambios en el estado de la configuración con el registro de auditoría

El registro de auditoría de la organización registra `repository_security_configuration` eventos cada vez que cambia un estado de configuración. Puede buscar estos eventos mediante el `action:repository_security_configuration` filtro . Para obtener más información, consulte [Eventos de registro de auditoría para tu organización](/es/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/audit-log-events-for-your-organization) y [Búsqueda en el registro de auditoría de la empresa](/es/enterprise-cloud@latest/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise).

## Lectura adicional

* [Habilitación de características de seguridad a escala](/es/enterprise-cloud@latest/code-security/concepts/security-at-scale/organization-security)
* [Cumplimiento de la configuración de seguridad](/es/enterprise-cloud@latest/code-security/reference/security-at-scale/configuration-enforcement)
* [Diagnóstico de problemas de configuración de seguridad](/es/enterprise-cloud@latest/code-security/reference/security-at-scale/troubleshoot-security-configurations/configuration-issue-diagnosis)