# セキュリティ構成の状態

security configurationが適用されている各リポジトリには、リポジトリと構成の間のリレーションシップの現在の状態を反映する構成状態があります。

リポジトリの構成状態は、適用された security configurationとの関係の現在の状態を示します。 その関係は時間の経過と同時に変化する可能性があります。たとえば、リポジトリ管理者が設定をオーバーライドした場合、管理者が適用を有効にした場合、添付ファイルが失敗した場合などです。 構成とリポジトリの対話方法の詳細については、 [大規模なセキュリティ機能の有効化](/ja/enterprise-server@3.22/code-security/concepts/security-at-scale/organization-security) を参照してください。

構成の状態は、組織の security configurations 設定ページのリポジトリ テーブルで表示することも、REST API を使用して取得することもできます。 詳細については、「[リポジトリ テーブルを使用した組織内のリポジトリのフィルター処理](/ja/enterprise-server@3.22/code-security/how-tos/secure-at-scale/configure-organization-security/manage-your-coverage/filter-repositories)」および「[Configurations](/ja/enterprise-server@3.22/rest/code-security/configurations)」を参照してください。

## 構成状態の参照

次の表では、すべての構成状態、各状態の原因、組織設定リポジトリ テーブルでのそれぞれの表示方法、および推奨されるアクションについて説明します。

リポジトリテーブルの \[構成状態] フィルターでは、\[アタッチ済み]、\[削除済み]、\[失敗]、\[適用済み]、\[エンタープライズによって削除済み] を使用できます。
`detached`状態のリポジトリは "構成なし" と表示され、UI の構成状態でフィルター処理できません。 ただし、REST API の `status` パラメーターは、組織レベルの構成のリポジトリを一覧表示するときに `detached` を受け入れます。

| 地位                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Description                                                                                                                                                                                                                                       | 原因                                              | UI の表示               | 推奨されるアクション                                                                                                                                                                                                                        |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `attached`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 構成がアクティブに適用されます。 リポジトリは、構成からすべての設定を継承します。                                                                                                                                                                                                         | 組織またはエンタープライズ管理者がリポジトリに構成を適用しました。               | 構成名 (例: "My config") | 対処は必要ありません。                                                                                                                                                                                                                       |
| `attaching`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 構成が適用されています。 これは一時的な状態です。                                                                                                                                                                                                                         | 組織またはエンタープライズ管理者が構成を適用したばかりです。                  |                      |                                                                                                                                                                                                                                   |
| <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> CONFIGURATION-NAME を適用しています                                                                                                                                                                                                                                                                                                                                                                                                                                     | 操作の完了を待ちます。 状態が変わらない場合は、添付ファイルのエラーを確認してください。                                                                                                                                                                                                      |                                                 |                      |                                                                                                                                                                                                                                   |
| `updating`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 構成はリポジトリで更新中です。                                                                                                                                                                                                                                   | 組織またはエンタープライズ管理者が構成の設定を変更しました。                  |                      |                                                                                                                                                                                                                                   |
| <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> CONFIGURATION-NAME を更新しています                                                                                                                                                                                                                                                                                                                                                                                                                                     | 更新が完了するまで待ちます。                                                                                                                                                                                                                                    |                                                 |                      |                                                                                                                                                                                                                                   |
| `enforced`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 構成は現在適用され、強制適用されています。 リポジトリ管理者は、構成によって制御される機能の有効化状態を変更できません。                                                                                                                                                                                      | 組織またはエンタープライズ管理者が構成の適用を有効にしました。                 |                      |                                                                                                                                                                                                                                   |
| <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 | 対処は必要ありません。 詳細については、「[セキュリティ構成の適用](/ja/enterprise-server@3.22/code-security/reference/security-at-scale/configuration-enforcement)」を参照してください。                                                                                                     |                                                 |                      |                                                                                                                                                                                                                                   |
| `removed`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 構成と競合するリポジトリ レベルの設定が変更されました。 構成は引き続きリポジトリに関連付けられていますが、リポジトリはすべての設定を継承しなくなりました。                                                                                                                                                                    | リポジトリ管理者が、強制されていない構成のセキュリティ設定を変更しました。           |                      |                                                                                                                                                                                                                                   |
| <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> CONFIGURATION-NAME を削除しました                                                                                                                                                                                                                                                                                                             | 目的の設定を復元するには、リポジトリの \[Advanced Security] ページで構成を再適用します。 今後のオーバーライドを防ぐには、適用を有効にすることを検討してください。                                                                                                                                                      |                                                 |                      |                                                                                                                                                                                                                                   |
| `removed_by_enterprise`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | エンタープライズ レベルの構成の変更により、リポジトリの設定と競合が発生しました。                                                                                                                                                                                                         | エンタープライズ管理者が、リポジトリに適用される組織レベルの構成と競合する設定を変更しました。 |                      |                                                                                                                                                                                                                                   |
| <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> CONFIGURATION-NAME を削除しました                                                                                                                                                                                                                                                                                                             | 競合を解決するには、エンタープライズ管理者と調整します。 組織レベルまたはエンタープライズ レベルで構成を再適用します。                                                                                                                                                                                      |                                                 |                      |                                                                                                                                                                                                                                   |
| `failed`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 構成をリポジトリにアタッチできませんでした。                                                                                                                                                                                                                            | 既存のリポジトリ設定と構成の間の競合により、添付ファイルが禁止されました。           |                      |                                                                                                                                                                                                                                   |
| <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> 失敗した理由                                                                                                                                                                                                                                                                                                                                  | リポジトリ テーブルの `config-status:failed` でフィルター処理し、特定のリポジトリの修復ガイダンスに従います。 詳細については、「[セキュリティ構成の問題の診断](/ja/enterprise-server@3.22/code-security/reference/security-at-scale/troubleshoot-security-configurations/configuration-issue-diagnosis)」を参照してください。 |                                                 |                      |                                                                                                                                                                                                                                   |
| `detached`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 構成は適用されません。 リポジトリのセキュリティ設定は個別に管理されます。                                                                                                                                                                                                             | 組織の管理者が構成をデタッチしたか、リポジトリが構成にアタッチされませんでした。        | 構成なし                 | リポジトリで一元管理された設定を継承する場合は、構成を適用します。 詳細については、「[カスタム セキュリティ構成の適用](/ja/enterprise-server@3.22/code-security/how-tos/secure-at-scale/configure-organization-security/establish-complete-coverage/apply-custom-configuration)」を参照してください。 |

## `removed`と`detached`を理解する

これらの状態は、さまざまな状況を反映しています。

* **`removed`**: リポジトリ管理者が、強制されていない構成と競合するセキュリティ設定を変更しました。 構成はまだリポジトリに関連付けられていますが、リポジトリは、その構成に対する組織のカバレッジ メトリックにカウントされなくなります。 構成を再適用すると、リレーションシップが復元されます。
* **`detached`**: 構成はリポジトリから完全に切断されます。 リポジトリの既存のセキュリティ設定は変更されませんが、管理される構成はありません。 一元管理された設定を復元するには、新しい構成を適用します。

リポジトリが `removed` 状態に達しないようにするには、構成の適用を有効にします。 詳細については、「[セキュリティ構成の適用](/ja/enterprise-server@3.22/code-security/reference/security-at-scale/configuration-enforcement)」を参照してください。

## 監査ログを使用した構成状態の変更の追跡

組織の監査ログは、構成状態が変更されるたびにイベント `repository_security_configuration` 記録します。 これらのイベントは、 `action:repository_security_configuration` フィルターを使用して検索できます。 詳細については、 [Organization の監査ログ イベント](/ja/enterprise-server@3.22/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/audit-log-events-for-your-organization) および [エンタープライズの監査ログの検索](/ja/enterprise-server@3.22/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise) を参照してください。

## 詳細については、次を参照してください。

* [大規模なセキュリティ機能の有効化](/ja/enterprise-server@3.22/code-security/concepts/security-at-scale/organization-security)
* [セキュリティ構成の適用](/ja/enterprise-server@3.22/code-security/reference/security-at-scale/configuration-enforcement)
* [セキュリティ構成の問題の診断](/ja/enterprise-server@3.22/code-security/reference/security-at-scale/troubleshoot-security-configurations/configuration-issue-diagnosis)