7장. Security Profiles Operator


7.1. Security Profiles Operator 개요

OpenShift Container Platform Security Profiles Operator(SPO)를 사용하면 seccomp 및 SELinux 프로필을 사용자 정의 리소스로 정의하고 네임스페이스의 모든 노드에서 동기화된 상태로 유지할 수 있습니다.

SPO는 seccomp 및 SELinux 프로필 사용자 정의 리소스를 각 노드에 배포하고 프로필이 변경될 때 최신 상태로 유지합니다. 정책을 Pod에 바인딩하고 워크로드를 기록할 수도 있습니다. 로그 보강 기능 활성화, Webhook 및 메트릭 구성, 프로필을 단일 네임스페이스로 제한, oc exec,oc rsh 및 oc debug 세션 중 클러스터 사용자와 상호 작용하는 고급 감사 로깅과 같은 고급 감사 로깅은 추가 리소스를 참조하십시오.

7.2. Security Profiles Operator 릴리스 노트

Security Profiles Operator는 보안 컴퓨팅(seccomp) 및 SELinux 프로필을 사용자 정의 리소스로 정의하여 지정된 네임스페이스의 모든 노드에 프로필을 동기화할 수 있습니다.

이 릴리스 노트에서는 OpenShift Container Platform의 Security Profiles Operator 개발을 추적합니다.

7.2.1. OpenShift Security Profiles Operator 0.10.1 릴리스 노트

OpenShift Security Profiles Operator 0.10.1을 사용할 수 있습니다. stable 업데이트 채널에서는 Security Profiles Operator에 대한 업데이트를 추적하고 수신합니다. 다음의 Red Hat 버그 수정 권고 (RHBA)를 사용할 수 있습니다.

7.2.1.1. 새로운 기능 및 개선 사항

  • 이번 릴리스에서는 Security Profiles Operator에서 ubi9/ubi-minimal-pqc 를 기본 이미지로 사용합니다. 이러한 변경으로 OpenSSL을 통한 PQC(Post-Quantum Cryptography) 지원을 활성화하고 키 교환 중에 TLS 끝점이 ML-KEM을 제공하는 데 도움이 됩니다. (CMP-4572)
  • 이번 업데이트에서는 기본 기본 이미지의 업그레이드된 종속 항목이 포함되어 있습니다.

7.2.2. Security Profiles Operator 0.10.0 릴리스 정보

Security Profiles Operator 0.10.0 릴리스 노트.

Security Profiles Operator 0.10.0: RHSA -2026:2852 - OpenShift Security Profiles Operator 업데이트에 다음 RHSA (Red Hat SecurityAdvisory)를 사용할 수 있습니다.

7.2.2.1. 버그 수정

  • 경우에 따라 OpenShift Container Platform 버전 4.20과 함께 Security Profiles Operator (SPO) 0.9.0을 사용하면 SPO에서 프로필 기록 리소스를 생성했지만 워크로드가 실패했습니다. 워크로드가 실패하면 Operator를 실행하는 데 필요한 컨테이너가 생성되지 않았습니다. SPO의 0.10.0 릴리스를 사용하면 프로파일 레코드 리소스가 안정적으로 생성되므로 Operator를 실행하는 데 필요한 컨테이너가 안정적으로 생성됩니다(CMP-3537).
  • SPO(Security Profiles Operator) 버전 0.9.0의 경우 spod Pod가 fsmount:fscontext:proc/: 오류 메시지와 함께 실행되지 않는 경우 마운트 id: 작업이 허용되지 않습니다. 버전 0.10.0이 릴리스되면서 spod Pod가 안정적으로 실행됩니다. CMP-4007.
  • SPO 0.9.0 이하의 릴리스에서는 selinux 사용 구문에 버그가 있었습니다. 이 SPO 릴리스에서는 < policyName>_.process 에서 < policyName>.process 로 변경됩니다. 새 구문은 _ 를 생략합니다. 이제 설명서의 예제에 이 업데이트된 사용법이 표시됩니다. CMP-4104

7.2.2.2. 새로운 기능 및 개선 사항

  • SPO v0.10.0이 릴리스되면서 Operator는 이제 RHCOS(Red Hat Enterprise Linux CoreOS) 10 컨테이너를 지원합니다. CMP-4033
  • 이번 Security Profiles Operator 릴리스에서 Advanced Audit Logging Framework는 GA(General Availability) 기능으로 사용할 수 있습니다. 고급 감사 로깅 프레임워크는 감사 JSON 로그 Enricher를 사용하여 oc rsh,oc exec, oc debug 명령을 포함하여 RHCOS(Red Hat Enterprise Linux CoreOS) 컨테이너에서 터미널 기반 명령 활동을 캡처하고 기록합니다. 자세한 내용은 고급 감사 로깅 프레임워크 를 참조하십시오.

7.2.3. Security Profiles Operator 0.9.0 릴리스 노트

Security Profiles Operator 0.9.0 릴리스 노트.

Security Profiles Operator 0.9.0에서 다음 버그 수정 권고 (RHBA)를 사용할 수 있습니다. RHBA-2025:15655 - OpenShift Security Profiles Operator 업데이트

이번 업데이트에서는 보안 프로필을 네임스페이스 리소스가 아닌 클러스터 전체 리소스로 관리합니다. Security Profiles Operator를 0.8.6 이후 버전으로 업데이트하려면 수동 마이그레이션이 필요합니다. 마이그레이션 지침은 Security Profiles Operator 0.9.0 업데이트 마이그레이션 가이드를 참조하십시오.

7.2.3.1. 버그 수정

  • 이번 업데이트 이전에는 semanage 구성 파일을 구문 분석하는 동안 오류로 인해 spod Pod가 시작되고 CrashLoopBackOff 상태가 될 수 있었습니다. OpenShift Container Platform 4.19부터 RHEL 9 이미지 이름 지정 규칙을 변경하면 이 문제가 발생합니다. (OCPBUGS-55829)
  • 이번 업데이트 이전에는 조정기 유형 불일치 오류로 인해 Security Profiles Operator가 새 추가된 노드에 RawSelinuxProfile 을 적용하지 못했습니다. 이번 업데이트를 통해 Operator는 이제 RawSelinuxProfile 오브젝트를 올바르게 처리하고 예상대로 모든 노드에 정책을 적용합니다. (OCPBUGS-33718)

7.2.4. Security Profiles Operator 0.8.6 릴리스 노트

Security Profiles Operator 0.8.6 릴리스 노트.

Security Profiles Operator 0.8.6에서 다음 Red Hat 버그 수정 권고 (RHBA)를 사용할 수 있습니다.

이번 업데이트에서는 기본 기본 이미지의 업그레이드된 종속 항목이 포함되어 있습니다.

7.2.5. Security Profiles Operator 0.8.5 릴리스 노트

Security Profiles Operator 0.8.5 릴리스 노트.

Security Profiles Operator 0.8.5에서 다음 Red Hat 버그 수정 권고 (RHBA)를 사용할 수 있습니다.

7.2.5.1. 버그 수정

  • 웹 콘솔에서 Security Profiles Operator를 설치하려고 할 때 네임스페이스에 Operator 권장 클러스터 모니터링을 활성화하는 옵션을 사용할 수 없었습니다. 이번 업데이트를 통해 네임스페이스에서 Operator-recommend 클러스터 모니터링을 활성화할 수 있습니다. (OCPBUGS-37794)
  • 이번 업데이트 이전에는 OperatorHub에 Security Profiles Operator가 간헐적으로 표시되지 않아 웹 콘솔을 통해 Operator를 설치하도록 제한된 액세스 권한이 발생했습니다. 이번 업데이트를 통해 OperatorHub에 Security Profiles Operator가 표시됩니다.

7.2.6. Security Profiles Operator 0.8.4 릴리스 노트

Security Profiles Operator 0.8.4 릴리스 노트.

다음의 Red Hat 버그 수정 권고 (RHBA)는 Security Profiles Operator 0.8.4에서 사용할 수 있습니다.

이번 업데이트에서는 기본 종속 항목의 CVE를 해결합니다.

7.2.6.1. 새로운 기능 및 개선 사항

7.2.7. Security Profiles Operator 0.8.2 릴리스 노트

Security Profiles Operator 0.8.2 릴리스 노트.

Security Profiles Operator 0.8.2:에 대해 다음 Red Hat 버그 수정 권고 (RHBA)를 사용할 수 있습니다.

7.2.7.1. 버그 수정

  • 이번 업데이트 이전에는 SELinuxProfile 오브젝트가 동일한 네임스페이스의 사용자 지정 속성을 상속하지 않았습니다. 이번 업데이트를 통해 SELinuxProfile 오브젝트 속성은 예상과 동일한 네임스페이스에서 상속됩니다. (OCPBUGS-17164)
  • 이번 업데이트 이전에는 생성 프로세스 중에 RawSELinuxProfile 오브젝트가 중단되어 Installed 상태에 도달하지 못했습니다. 이번 업데이트를 통해 Operator는 RawSELinuxProfile 오브젝트를 성공적으로 생성합니다. (OCPBUGS-19744)
  • 이번 업데이트 이전에는 enableLogEnricher 를 true 로 패치하면 seccompProfile log-enricher-trace Pod가 Pending 상태로 유지됩니다. 이번 업데이트를 통해 log-enricher-trace Pod가 예상대로 설치된 상태에 도달합니다. (OCPBUGS-22182)
  • 이번 업데이트 이전에는 Security Profiles Operator에서 높은 카디널리티 메트릭을 생성했기 때문에 Prometheus Pod에서 많은 양의 메모리를 사용합니다. 이번 업데이트를 통해 Security Profiles Operator 네임스페이스에 다음 메트릭이 더 이상 적용되지 않습니다.

    • rest_client_request_duration_seconds
    • rest_client_request_size_bytes
    • rest_client_response_size_bytes

      (OCPBUGS-22406)

7.2.8. Security Profiles Operator 0.8.0의 릴리스 노트

Security Profiles Operator 0.8.0의 릴리스 노트.

Security Profiles Operator 0.8.0에 대해 다음 Red Hat 버그 수정 권고 (RHBA)를 사용할 수 있습니다.

7.2.8.1. 버그 수정

  • 이번 업데이트 이전에는 연결이 끊긴 클러스터에 Security Profiles Operator를 설치하는 동안 SHA 재레이블 문제로 인해 제공된 보안 해시 알고리즘(SHAs)이 잘못되었습니다. 이번 업데이트를 통해 연결이 끊긴 환경에서 보안 해시 알고리즘이 일관되게 작동합니다. (OCPBUGS-14404)

7.2.9. Security Profiles Operator Cryostat.1 릴리스 노트

Security Profiles Operator Cryostat.1 릴리스 노트

Security Profiles Operator Cryostat.1에 대해 다음 RHSA(Red Hat Security Advisory)를 사용할 수 있습니다.

7.2.9.1. 새로운 기능 및 개선 사항

  • SPO(Security Profiles Operator)는 이제 RHEL 8 및 9 기반 RHCOS(Red Hat Enterprise Linux CoreOS) 시스템에 적합한 selinuxd 이미지를 자동으로 선택합니다.

    중요

    연결이 끊긴 환경의 이미지를 미러링하는 사용자는 Security Profiles Operator에서 제공하는 selinuxd 이미지를 모두 미러링해야 합니다.

  • 이제 spod 데몬 내부에서 메모리 최적화를 활성화할 수 있습니다. 자세한 내용은 spod 데몬에서 메모리 최적화 활성화를 참조하십시오.

    참고

    SPO 메모리 최적화는 기본적으로 활성화되어 있지 않습니다.

  • 이제 데몬 리소스 요구 사항을 구성할 수 있습니다. 자세한 내용은 데몬 리소스 요구 사항 사용자 지정을 참조하십시오.
  • 이제 spod 구성에서 우선순위 클래스 이름을 구성할 수 있습니다. 자세한 내용은 spod 데몬 Pod의 사용자 정의 우선순위 클래스 이름 설정을 참조하십시오.

7.2.9.2. 사용되지 않거나 삭제된 기능

  • 기본 nginx-1.19.1 seccomp 프로필이 이제 Security Profiles Operator 배포에서 제거됩니다.

7.2.9.3. 버그 수정

  • 이번 업데이트 이전에는 SCC(Security Profiles Operator) SELinux 정책이 컨테이너 템플릿의 하위 수준 정책 정의를 상속하지 않았습니다. net_container 와 같은 다른 템플릿을 선택한 경우 컨테이너 템플릿에만 존재하는 하위 수준 정책 정의가 필요하기 때문에 정책이 작동하지 않습니다. 이 문제는 SPO SELinux 정책이 SPO 사용자 지정 형식에서 CIL(Common Intermediate Language) 형식으로 SELinux 정책을 변환하려고 할 때 발생했습니다. 이번 업데이트를 통해 컨테이너 템플릿은 SPO에서 CIL로의 변환이 필요한 모든 SELinux 정책에 추가됩니다. 또한 SPO SELinux 정책은 지원되는 모든 정책 템플릿에서 하위 수준 정책 정의를 상속할 수 있습니다. (OCPBUGS-12879)

7.2.9.4. 알려진 문제

  • Security Profiles Operator를 설치 제거할 때 MutatingWebhookConfiguration 오브젝트는 삭제되지 않으며 수동으로 제거해야 합니다. 이 문제를 해결하려면 Security Profiles Operator를 설치 제거한 후 MutatingWebhookConfiguration 오브젝트를 삭제합니다. 이러한 단계는 Security Profiles Operator 설치 제거를 참조하십시오. (OCPBUGS-4687)

7.2.10. Security Profiles Operator 0.5.2 릴리스 노트

Security Profiles Operator 0.5.2 릴리스 노트.

다음의 Red Hat 버그 수정 권고 (RHBA)는 Security Profiles Operator 0.5.2에서 사용할 수 있습니다.

이번 업데이트에서는 기본 종속성의 CVE를 해결합니다.

7.2.10.1. 알려진 문제

  • Security Profiles Operator를 설치 제거할 때 MutatingWebhookConfiguration 오브젝트는 삭제되지 않으며 수동으로 제거해야 합니다. 이 문제를 해결하려면 Security Profiles Operator를 설치 제거한 후 MutatingWebhookConfiguration 오브젝트를 삭제합니다. 이러한 단계는 Security Profiles Operator 설치 제거를 참조하십시오. (OCPBUGS-4687)

7.2.11. Security Profiles Operator 0.5.0 릴리스 노트

Security Profiles Operator 0.5.0의 릴리스 노트입니다.

Security Profiles Operator 0.5.0은 다음 Red Hat 버그 수정 권고 (RHBA)를 사용할 수 있습니다.

7.2.11.1. 알려진 문제

  • Security Profiles Operator를 설치 제거할 때 MutatingWebhookConfiguration 오브젝트는 삭제되지 않으며 수동으로 제거해야 합니다. 이 문제를 해결하려면 Security Profiles Operator를 설치 제거한 후 MutatingWebhookConfiguration 오브젝트를 삭제합니다. 이러한 단계는 Security Profiles Operator 설치 제거를 참조하십시오. (OCPBUGS-4687)

7.3. Security Profiles Operator 지원

Security Profiles Operator는 "Rolling Stream" Operator입니다. 즉, OpenShift Container Platform 릴리스의 비동기식으로 업데이트를 사용할 수 있습니다.

7.3.1. 지원 받기

Red Hat은 문제를 해결하고 OpenShift Container Platform을 최대한 활용할 수 있도록 다양한 지원 채널을 제공합니다.

Red Hat 고객 포털에서 다음을 수행할 수 있습니다.

  • Red Hat 제품에 대한 기사 및 솔루션에 대한 Red Hat 지식베이스를 검색하거나 살펴보십시오.
  • Red Hat 지원에 지원 케이스 제출.
  • 다른 제품 설명서에 액세스 가능합니다.

클러스터 문제를 식별하기 위해 OpenShift Cluster Manager 에서 Red Hat Lightspeed를 사용할 수 있습니다. Red Hat Lightspeed는 문제에 대한 세부 정보와 가능한 경우 문제 해결 방법에 대한 정보를 제공합니다.

개선 사항을 제안하거나 오류를 보고하려면 섹션 이름 및 OpenShift Container Platform 버전과 같은 특정 세부 정보를 제공합니다.

7.4. Security Profiles Operator 이해

OpenShift Container Platform 관리자는 Security Profiles Operator를 사용하여 클러스터에서 향상된 보안 조치를 정의할 수 있습니다.

중요

Security Profiles Operator는 RHCOS(Red Hat Enterprise Linux CoreOS) 작업자 노드만 지원합니다. RHEL(Red Hat Enterprise Linux) 노드는 지원되지 않습니다.

7.4.1. 보안 프로필 정보

보안 프로필은 노드에서 수행할 수 있는 컨테이너를 제한하므로 클러스터의 워크로드 공격 면적을 줄일 수 있습니다.

seccomp 보안 프로필은 프로세스에서 수행할 수 있는 syscall을 나열합니다. 권한은 SELinux보다 광범위하므로 사용자는 쓰기 와 같은 운영 체제 전체에서 작업을 제한할 수 있습니다.

SELinux 보안 프로필은 시스템의 프로세스, 애플리케이션 또는 파일의 액세스 및 사용을 제한하는 레이블 기반 시스템을 제공합니다. 환경의 모든 파일에는 권한을 정의하는 레이블이 있습니다. SELinux 프로필은 디렉터리와 같은 지정된 구조 내에서 액세스를 정의할 수 있습니다.

7.5. Security Profiles Operator 활성화

Security Profiles Operator를 사용하려면 먼저 Operator가 클러스터에 배포되었는지 확인해야 합니다.

중요

이 Operator가 제대로 작동하려면 모든 클러스터 노드에 동일한 릴리스 버전이 있어야 합니다. 예를 들어 RHCOS를 실행하는 노드의 경우 모든 노드에 동일한 RHCOS 버전이 있어야합니다.

중요

Security Profiles Operator는 RHCOS(Red Hat Enterprise Linux CoreOS) 작업자 노드만 지원합니다. RHEL(Red Hat Enterprise Linux) 노드는 지원되지 않습니다.

중요

Security Profiles Operator는 x86_64 및 ppc64le 아키텍처를 지원합니다.

7.5.1. Security Profiles Operator 설치

OpenShift Container Platform 웹 콘솔을 사용하여 Security Profiles Operator를 설치할 수 있습니다. 이렇게 하면 기본적으로 Security Profiles Operator가 openshift-security-profiles 네임스페이스에 설치됩니다. OpenShift Container Platform 웹 콘솔을 사용하여 올바른 설치를 확인할 수도 있습니다.

사전 요구 사항

  • cluster-admin 권한이 있는 사용자로 웹 콘솔에 액세스할 수 있어야 합니다.

프로세스

  1. OpenShift Container Platform 웹 콘솔에서 Ecosystem Software Catalog 로 이동합니다.
  2. Security Profiles Operator를 검색한 다음 설치를 클릭합니다.
  3. 기본 설치 모드 및 네임스페이스 를 계속 선택하여 Operator가 openshift-security-profiles 네임스페이스에 설치되도록 합니다.
  4. 설치를 클릭합니다.

검증

설치에 성공했는지 확인하려면 다음을 수행하십시오.

  1. 에코시스템 설치된 Operator 페이지로 이동합니다.
  2. Security Profiles Operator가 openshift-security-profiles 네임스페이스에 설치되어 있고 해당 상태가 Succeeded 인지 확인합니다.

Operator가 성공적으로 설치되지 않은 경우 다음을 수행하십시오.

  1. Ecosystem Installed Operators 페이지로 이동하여 Status 열에 오류 또는 실패가 있는지 검사합니다.
  2. 워크로드 Pod 페이지로 이동하여 openshift-security-profiles 프로젝트에서 문제를 보고하는 Pod의 로그를 확인합니다.

7.5.2. CLI를 사용하여 Security Profiles Operator 설치

명령줄 인터페이스를 사용하여 OpenShift Container Platform Security Profiles Operator를 설치할 수 있습니다.

사전 요구 사항

  • cluster-admin 권한이 있어야 합니다.

프로세스

  1. Namespace 오브젝트를 정의합니다.

    예: namespace-object.yaml

    apiVersion: v1
    kind: Namespace
    metadata:
        name: openshift-security-profiles
    labels:
      openshift.io/cluster-monitoring: "true"

  2. Namespace 오브젝트를 생성합니다.

    $ oc create -f namespace-object.yaml
  3. OperatorGroup 오브젝트를 정의합니다.

    예: operator-group-object.yaml

    apiVersion: operators.coreos.com/v1
    kind: OperatorGroup
    metadata:
      name: security-profiles-operator
      namespace: openshift-security-profiles

  4. OperatorGroup 개체를 생성합니다.

    $ oc create -f operator-group-object.yaml
  5. Subscription 오브젝트를 정의합니다.

    예: subscription-object.yaml

    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: security-profiles-operator-sub
      namespace: openshift-security-profiles
    spec:
      channel: release-alpha-rhel-8
      installPlanApproval: Automatic
      name: security-profiles-operator
      source: redhat-operators
      sourceNamespace: openshift-marketplace

  6. Subscription 오브젝트를 생성합니다.

    $ oc create -f subscription-object.yaml
    참고

    글로벌 스케줄러 기능을 설정하고 defaultNodeSelector 를 활성화하는 경우 네임스페이스를 수동으로 생성하고 openshift-security-profiles 네임스페이스의 주석을 업데이트하거나 openshift.io/node-selector: "" 를 사용하여 Security Profiles Operator가 설치된 네임스페이스를 업데이트해야 합니다. 이렇게 하면 기본 노드 선택기가 제거되고 배포 실패가 발생하지 않습니다.

검증

  1. 다음 CSV 파일을 검사하여 설치에 성공했는지 확인합니다.

    $ oc get csv -n openshift-security-profiles
  2. 다음 명령을 실행하여 Security Profiles Operator가 작동하는지 확인합니다.

    $ oc get deploy -n openshift-security-profiles

7.5.3. 로깅 상세 정보 표시 구성

Security Profiles Operator는 기본 로깅 상세 정보 표시 수준을 0 으로 지원하며 1 의 향상된 상세 정보 표시 수준을 지원합니다.

프로세스

  • 향상된 로깅 상세 정보를 활성화하려면 다음 명령을 실행하여 spod 구성을 패치하고 값을 조정합니다.

    $ oc -n openshift-security-profiles patch spod \
        spod --type=merge -p '{"spec":{"verbosity":1}}'

    출력 예

    securityprofilesoperatordaemon.security-profiles-operator.x-k8s.io/spod patched

7.6. seccomp 프로필 관리

seccomp 프로필을 생성 및 관리하고 워크로드에 바인딩합니다.

중요

Security Profiles Operator는 RHCOS(Red Hat Enterprise Linux CoreOS) 작업자 노드만 지원합니다. RHEL(Red Hat Enterprise Linux) 노드는 지원되지 않습니다.

7.6.1. seccomp 프로필 생성

SeccompProfile 오브젝트를 사용하여 seccomp 프로필을 생성합니다.

seccompProfile 오브젝트는 컨테이너 내에서 syscall을 제한하여 애플리케이션 액세스를 제한할 수 있습니다.

프로세스

  1. 다음 명령을 실행하여 프로젝트를 생성합니다.

    $ oc new-project my-namespace
  2. SeccompProfile 오브젝트를 생성합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1beta1
    kind: SeccompProfile
    metadata:
      name: profile1
    spec:
      defaultAction: SCMP_ACT_LOG

    seccomp 프로필은 /var/lib/kubelet/seccomp/operator/<namespace>/<name>.json 에 저장됩니다.

    init 컨테이너는 Security Profiles Operator의 루트 디렉터리를 생성하여 root 그룹 또는 사용자 ID 권한 없이 Operator를 실행합니다. rootless 프로필 스토리지 /var/lib/openshift-security-profiles 에서 kubelet 루트 루트 /var/lib/kubelet/seccomp/operator 내부의 기본 seccomp 루트 경로에 대한 심볼릭 링크가 생성됩니다.

7.6.2. Pod에 seccomp 프로필 적용

워크로드에 기록된 또는 사용자 지정 seccomp 프로필을 적용하려면 보안 컨텍스트에서 프로필을 참조하는 Pod를 생성합니다.

프로세스

  1. securityContext 를 정의하는 Pod 오브젝트를 생성합니다.

    apiVersion: v1
    kind: Pod
    metadata:
      name: test-pod
    spec:
      securityContext:
        runAsNonRoot: true
        seccompProfile:
          type: Localhost
          localhostProfile: operator/profile1.json
      containers:
        - name: test-container
          image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21
          securityContext:
            allowPrivilegeEscalation: false
            capabilities:
              drop: [ALL]
  2. 다음 명령을 실행하여 seccompProfile.localhostProfile 속성의 프로필 경로를 확인합니다.

    $ oc get seccompprofile profile1 --output wide

    출력 예

    NAME       STATUS     AGE   SECCOMPPROFILE.LOCALHOSTPROFILE
    profile1   Installed  14s   operator/profile1.json

  3. 다음 명령을 실행하여 localhost 프로필의 경로를 확인합니다.

    $ oc get sp profile1 --output=jsonpath='{.status.localhostProfile}'

    출력 예

    operator/profile1.json

  4. localhostProfile 출력을 패치 파일에 적용합니다.

    spec:
      template:
        spec:
          securityContext:
            seccompProfile:
              type: Localhost
              localhostProfile: operator/profile1.json
  5. 다음 명령을 실행하여 Deployment 오브젝트와 같은 다른 워크로드에 프로필을 적용합니다.

    $ oc -n my-namespace patch deployment myapp --patch-file patch.yaml --type=merge

    출력 예

    deployment.apps/myapp patched

검증

  • 다음 명령을 실행하여 프로필이 올바르게 적용되었는지 확인합니다.

    $ oc -n my-namespace get deployment myapp --output=jsonpath='{.spec.template.spec.securityContext}' | jq .

    출력 예

    {
      "seccompProfile": {
        "localhostProfile": "operator/profile1.json",
        "type": "localhost"
      }
    }

7.6.2.1. ProfileBindings를 사용하여 프로필에 워크로드를 바인딩

ProfileBinding 리소스를 사용하여 보안 프로필을 컨테이너의 SecurityContext 에 바인딩할 수 있습니다.

프로세스

  1. quay.io/security-profiles-operator/test-nginx-unprivileged:1.21 이미지를 사용하는 Pod를 SeccompProfile 프로필 예제에 바인딩하려면 Pod 및 SeccompProfile 오브젝트를 사용하여 동일한 네임스페이스에 ProfileBinding 오브젝트를 생성합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1alpha1
    kind: ProfileBinding
    metadata:
      namespace: my-namespace
      name: nginx-binding
    spec:
      profileRef:
        kind: SeccompProfile
        name: profile
      image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21

    다음과 같습니다.

    spec.profileRef.kind
    프로필의 종류를 지정합니다.
    spec.profileRef.name
    프로필 이름을 지정합니다.
    spec.image
    이미지 특성의 와일드카드를 사용하여 기본 보안 프로필을 활성화할 수 있습니다. image: "*"
    중요

    image: "*" 와일드카드 속성을 사용하면 모든 새 Pod가 지정된 네임스페이스의 기본 보안 프로필로 바인딩됩니다.

  2. 다음 명령을 실행하여 enable-binding=true 로 네임스페이스에 레이블을 지정합니다.

    $ oc label ns my-namespace spo.x-k8s.io/enable-binding=true
  3. test-pod.yaml 이라는 Pod를 정의합니다.

    apiVersion: v1
    kind: Pod
    metadata:
      name: test-pod
    spec:
      containers:
      - name: test-container
        image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21
  4. Pod를 생성합니다.

    $ oc create -f test-pod.yaml
    참고

    Pod가 이미 존재하는 경우 바인딩이 제대로 작동하려면 Pod를 다시 생성해야 합니다.

검증

  • 다음 명령을 실행하여 Pod가 ProfileBinding 을 상속하는지 확인합니다.

    $ oc get pod test-pod -o jsonpath='{.spec.containers[*].securityContext.seccompProfile}'

    출력 예

    {"localhostProfile":"operator/profile.json","type":"Localhost"}

7.6.3. 워크로드의 프로필 기록

Security Profiles Operator는 ProfileRecording 오브젝트를 사용하여 시스템 호출을 기록하여 애플리케이션에 대한 기준 프로필을 생성할 수 있습니다.

seccomp 프로필 기록에 로그 강화기를 사용하는 경우 로그 강화 기능이 활성화되었는지 확인합니다. 자세한 내용은 추가 리소스 를 참조하십시오.

참고

privileged: true security context restraints가 있는 컨테이너는 로그 기반 기록을 방지합니다. 권한 있는 컨테이너는 seccomp 정책의 영향을 받지 않으며 로그 기반 레코딩은 특수 seccomp 프로필을 사용하여 이벤트를 기록합니다.

절차

  1. 다음 명령을 실행하여 프로젝트를 생성합니다.

    $ oc new-project my-namespace
  2. 다음 명령을 실행하여 enable-recording=true 로 네임스페이스에 레이블을 지정합니다.

    $ oc label ns my-namespace spo.x-k8s.io/enable-recording=true
  3. recorder: logs 변수를 포함하는 ProfileRecording 오브젝트를 생성합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1alpha1
    kind: ProfileRecording
    metadata:
      namespace: my-namespace
      name: test-recording
    spec:
      kind: SeccompProfile
      recorder: logs
      podSelector:
        matchLabels:
          app: my-app
  4. 기록할 워크로드를 생성합니다.

    apiVersion: v1
    kind: Pod
    metadata:
      namespace: my-namespace
      name: my-pod
      labels:
        app: my-app
    spec:
      securityContext:
        runAsNonRoot: true
        seccompProfile:
          type: RuntimeDefault
      containers:
        - name: nginx
          image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21
          ports:
            - containerPort: 8080
          securityContext:
            allowPrivilegeEscalation: false
            capabilities:
              drop: [ALL]
        - name: redis
          image: quay.io/security-profiles-operator/redis:6.2.1
          securityContext:
            allowPrivilegeEscalation: false
            capabilities:
              drop: [ALL]
  5. 다음 명령을 입력하여 Pod가 Running 상태인지 확인합니다.

    $ oc -n my-namespace get pods

    출력 예

    NAME     READY   STATUS    RESTARTS   AGE
    my-pod   2/2     Running   0          18s

  6. 강화자가 해당 컨테이너에 대한 감사 로그를 수신하는지 확인합니다.

    $ oc -n openshift-security-profiles logs --since=1m --selector name=spod -c log-enricher

    출력 예

    I0523 14:19:08.747313  430694 enricher.go:445] log-enricher "msg"="audit" "container"="redis" "executable"="/usr/local/bin/redis-server" "namespace"="my-namespace" "node"="xiyuan-23-5g2q9-worker-eastus2-6rpgf" "pid"=656802 "pod"="my-pod" "syscallID"=0 "syscallName"="read" "timestamp"="1684851548.745:207179" "type"="seccomp"

검증

  1. Pod를 제거합니다.

    $ oc -n my-namespace delete pod my-pod
  2. Security Profiles Operator가 두 seccomp 프로필을 조정하는지 확인합니다.

    $ oc get seccompprofiles -lspo.x-k8s.io/recording-id=test-recording

    seccomp 프로필 출력 예

    NAME                   STATUS      AGE
    test-recording-nginx   Installed   2m48s
    test-recording-redis   Installed   2m48s

7.6.3.1. 컨테이너별 프로필 인스턴스 병합

ReplicaSet 또는 Deployment 를 사용하여 애플리케이션을 배포할 때 기록된 하나의 프로필을 재사용하려면 각 컨테이너에 대해 별도의 프로필을 유지하는 대신 컨테이너별 프로필 인스턴스를 단일 프로필에 병합하도록 Security Profiles Operator를 구성합니다.

프로세스

  1. mergeStrategy: containers 변수를 포함하도록 ProfileRecording 오브젝트를 편집합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1alpha1
    kind: ProfileRecording
    metadata:
      # The name of the Recording is the same as the resulting SeccompProfile CRD
      # after reconciliation.
      name: test-recording
      namespace: my-namespace
    spec:
      kind: SeccompProfile
      recorder: logs
      mergeStrategy: containers
      podSelector:
        matchLabels:
          app: sp-record
  2. 다음 명령을 실행하여 네임스페이스에 레이블을 지정합니다.

    $ oc label ns my-namespace security.openshift.io/scc.podSecurityLabelSync=false pod-security.kubernetes.io/enforce=privileged pod-security.kubernetes.io/audit=privileged pod-security.kubernetes.io/warn=privileged --overwrite=true
  3. 다음 YAML을 사용하여 워크로드를 생성합니다.

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: nginx-deploy
      namespace: my-namespace
    spec:
      replicas: 3
      selector:
        matchLabels:
          app: sp-record
      template:
        metadata:
          labels:
            app: sp-record
        spec:
          serviceAccountName: spo-record-sa
          containers:
          - name: nginx-record
            image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21
            ports:
            - containerPort: 8080
  4. 개별 프로필을 기록하려면 다음 명령을 실행하여 배포를 삭제합니다.

    $ oc delete deployment nginx-deploy -n my-namespace
  5. 프로필을 병합하려면 다음 명령을 실행하여 프로필 레코딩을 삭제합니다.

    $ oc delete profilerecording test-recording -n my-namespace
  6. 병합 작업을 시작하고 결과 프로필을 생성하려면 다음 명령을 실행합니다.

    $ oc get seccompprofiles -lspo.x-k8s.io/recording-id=test-recording -n my-namespace

    seccomp 프로필 출력 예

    NAME                          STATUS       AGE
    test-recording-nginx-record   Installed    55s

  7. 컨테이너에서 사용하는 권한을 보려면 다음 명령을 실행합니다.

    $ oc get seccompprofiles test-recording-nginx-record -o yaml

7.7. Managing SELinux profiles

RHCOS 노드에서 액세스할 수 있는 네임스페이스된 워크로드를 제어하려면 Security Profiles Operator를 사용하여 SELinux 프로필을 생성하고 Pod에 바인딩하고 실행 중인 애플리케이션의 정책을 기록합니다.

중요

Security Profiles Operator는 RHCOS(Red Hat Enterprise Linux CoreOS) 작업자 노드만 지원합니다. RHEL(Red Hat Enterprise Linux) 노드는 지원되지 않습니다.

7.7.1. SELinux 프로필 생성

SelinuxProfile 오브젝트를 사용하여 SELinux 프로필을 생성합니다.

SelinuxProfile 오브젝트에는 보안 강화 및 가독성을 개선할 수 있는 몇 가지 기능이 있습니다.

  • 현재 네임스페이스 또는 시스템 전체 프로필로 상속할 프로필을 제한합니다. 일반적으로 시스템에 설치된 프로필이 많이 있지만 클러스터 워크로드에서 하위 집합만 사용해야 하므로 상속 가능한 시스템 프로필은 spec.selinuxOptions.allowedSystemProfiles 의 spod 인스턴스에 나열됩니다.
  • 권한, 클래스 및 라벨에 대한 기본 검증을 수행합니다.
  • 정책을 사용하여 프로세스를 설명하는 새 키워드 @self 를 추가합니다. 이를 통해 정책 사용이 이름과 네임스페이스를 기반으로 하므로 워크로드와 네임스페이스 간에 정책을 쉽게 재사용할 수 있습니다.
  • SELinux CIL 언어로 직접 프로필을 작성하는 것과 비교하여 보안 강화 및 가독성 향상을 위한 기능을 추가합니다.

프로세스

  1. 다음 명령을 실행하여 프로젝트를 생성합니다.

    $ oc new-project nginx-deploy
  2. 다음 SelinuxProfile 오브젝트를 생성하여 권한이 없는 워크로드에 사용할 수 있는 정책을 생성합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1alpha2
    kind: SelinuxProfile
    metadata:
      name: nginx-secure
    spec:
      allow:
        '@self':
          tcp_socket:
          - listen
        http_cache_port_t:
          tcp_socket:
          - name_bind
        node_t:
          tcp_socket:
          - node_bind
      inherit:
      - kind: System
        name: container
  3. 다음 명령을 실행하여 selinuxd 가 정책을 설치할 때까지 기다립니다.

    $ oc wait --for=condition=ready selinuxprofile nginx-secure

    출력 예

    selinuxprofile.security-profiles-operator.x-k8s.io/nginx-secure condition met

    정책은 Security Profiles Operator가 소유한 컨테이너의 emptyDir 에 배치됩니다. 정책은 /etc/selinux.d/<name>_<namespace>.cil 의 CIL(Common Intermediate Language) 형식으로 저장됩니다.

  4. 다음 명령을 실행하여 Pod에 액세스합니다.

    $ oc -n openshift-security-profiles rsh -c selinuxd ds/spod

검증

  1. 다음 명령을 실행하여 cat 로 파일 내용을 확인합니다.

    $ cat /etc/selinux.d/nginx-secure.cil

    출력 예

    (block nginx-secure
    (blockinherit container)
    (allow process nginx-secure.process ( tcp_socket ( listen )))
    (allow process http_cache_port_t ( tcp_socket ( name_bind )))
    (allow process node_t ( tcp_socket ( node_bind )))
    )

  2. 다음 명령을 실행하여 정책이 설치되었는지 확인합니다.

    $ semodule -l | grep nginx-secure

    출력 예

    nginx-secure

7.7.2. Pod에 SELinux 프로필 적용

워크로드에 기록되거나 사용자 지정 SELinux 프로필을 적용하려면 보안 컨텍스트에서 프로필을 참조하는 Pod를 생성합니다.

SELinux 프로필의 경우 권한 있는 워크로드를 허용하려면 네임스페이스에 라벨을 지정해야 합니다.

절차

  1. 다음 명령을 실행하여 scc.podSecurityLabelSync=false 레이블을 nginx-deploy 네임스페이스에 적용합니다.

    $ oc label ns nginx-deploy security.openshift.io/scc.podSecurityLabelSync=false
  2. 다음 명령을 실행하여 nginx-deploy 네임스페이스에 privileged 레이블을 적용합니다.

    $ oc label ns nginx-deploy --overwrite=true pod-security.kubernetes.io/enforce=privileged
  3. 다음 명령을 실행하여 SELinux 프로필 사용 문자열을 가져옵니다.

    $ oc get selinuxprofile.security-profiles-operator.x-k8s.io/nginx-secure -ojsonpath='{.status.usage}'

    출력 예

    nginx-secure.process

  4. .spec.containers[].securityContext.seLinuxOptions 속성의 워크로드 매니페스트에 출력 문자열을 적용합니다.

    apiVersion: v1
    kind: Pod
    metadata:
      name: nginx-secure
      namespace: nginx-deploy
    spec:
      securityContext:
        runAsNonRoot: true
        seccompProfile:
          type: RuntimeDefault
      containers:
        - image: nginxinc/nginx-unprivileged:1.21
          name: nginx
          securityContext:
            allowPrivilegeEscalation: false
            capabilities:
              drop: [ALL]
            seLinuxOptions:
              # NOTE: This uses an appropriate SELinux type
              type: nginx-secure.process
    중요

    워크로드를 생성하기 전에 SELinux 유형이 있어야 합니다.

7.7.2.1. SELinux 로그 정책 적용

정책 위반 또는 AVC 거부를 로깅하려면 SElinuxProfile 프로필을 허용 으로 설정합니다.

중요

이 절차에서는 로깅 정책을 정의합니다. 시행 정책을 설정하지 않습니다.

절차

  • SElinuxProfile 에 permissive: true 추가 :

    apiVersion: security-profiles-operator.x-k8s.io/v1alpha2
    kind: SelinuxProfile
    metadata:
      name: nginx-secure
    spec:
      permissive: true

7.7.2.2. ProfileBindings를 사용하여 프로필에 워크로드를 바인딩

ProfileBinding 리소스를 사용하여 보안 프로필을 컨테이너의 SecurityContext 에 바인딩할 수 있습니다.

절차

  1. quay.io/security-profiles-operator/test-nginx-unprivileged:1.21 이미지를 사용하는 Pod를 SelinuxProfile 프로필 예제에 바인딩하려면 Pod 및 SelinuxProfile 오브젝트를 사용하여 동일한 네임스페이스에 ProfileBinding 오브젝트를 생성합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1alpha1
    kind: ProfileBinding
    metadata:
      namespace: my-namespace
      name: nginx-binding
    spec:
      profileRef:
        kind: SelinuxProfile
        name: profile
      image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21

    다음과 같습니다.

    spec.profileRef.kind
    프로필의 종류를 지정합니다.
    spec.profileRef.name
    프로필 이름을 지정합니다.
    spec.image
    이미지 특성의 와일드카드를 사용하여 기본 보안 프로필을 활성화할 수 있습니다. image: "*"
    중요

    image: "*" 와일드카드 속성을 사용하면 모든 새 Pod가 지정된 네임스페이스의 기본 보안 프로필로 바인딩됩니다.

  2. 다음 명령을 실행하여 enable-binding=true 로 네임스페이스에 레이블을 지정합니다.

    $ oc label ns my-namespace spo.x-k8s.io/enable-binding=true
  3. test-pod.yaml 이라는 Pod를 정의합니다.

    apiVersion: v1
    kind: Pod
    metadata:
      name: test-pod
    spec:
      containers:
      - name: test-container
        image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21
  4. Pod를 생성합니다.

    $ oc create -f test-pod.yaml
    참고

    Pod가 이미 존재하는 경우 바인딩이 제대로 작동하려면 Pod를 다시 생성해야 합니다.

검증

  • 다음 명령을 실행하여 Pod가 ProfileBinding 을 상속하는지 확인합니다.

    $ oc get pod test-pod -o jsonpath='{.spec.containers[*].securityContext.seLinuxOptions.type}'

    출력 예

    profile.process

7.7.2.3. 컨트롤러 및 SecurityContextConstraints 복제

배포 또는 데몬 세트와 같은 컨트롤러를 복제하기 위해 SELinux 정책을 배포하여 해당 컨트롤러에서 생성하는 Pod에서 사용자 지정 SELinux 정책을 사용할 수 있도록 합니다.

컨트롤러에서 생성하는 Pod는 워크로드를 생성하는 사용자의 ID로 실행되지 않습니다. ServiceAccount 를 선택하지 않으면 Pod에서 사용자 정의 보안 정책을 허용하지 않는 restricted SCC( SecurityContextConstraints ) 오브젝트를 사용할 수 있습니다.

절차

  1. 다음 명령을 실행하여 프로젝트를 생성합니다.

    $ oc new-project nginx-secure
  2. 다음 RoleBinding 오브젝트를 생성하여 nginx-secure 네임스페이스에서 SELinux 정책을 사용할 수 있습니다.

    kind: RoleBinding
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
      name: spo-nginx
      namespace: nginx-secure
    subjects:
    - kind: ServiceAccount
      name: spo-deploy-test
    roleRef:
      kind: Role
      name: spo-nginx
      apiGroup: rbac.authorization.k8s.io
  3. Role 오브젝트를 생성합니다.

    apiVersion: rbac.authorization.k8s.io/v1
    kind: Role
    metadata:
      creationTimestamp: null
      name: spo-nginx
      namespace: nginx-secure
    rules:
    - apiGroups:
      - security.openshift.io
      resources:
      - securitycontextconstraints
      resourceNames:
      - privileged
      verbs:
      - use
  4. ServiceAccount 오브젝트를 생성합니다.

    apiVersion: v1
    kind: ServiceAccount
    metadata:
      creationTimestamp: null
      name: spo-deploy-test
      namespace: nginx-secure
  5. Deployment 오브젝트를 생성합니다.

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: selinux-test
      namespace: nginx-secure
      metadata:
        labels:
          app: selinux-test
    spec:
      replicas: 3
      selector:
        matchLabels:
          app: selinux-test
      template:
        metadata:
          labels:
            app: selinux-test
        spec:
          serviceAccountName: spo-deploy-test
          securityContext:
            seLinuxOptions:
              type: nginx-secure.process
          containers:
          - name: nginx-unpriv
            image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21
            ports:
            - containerPort: 8080

    배포를 생성하기 전에 spec.template.spec.securityContext.seLinuxOptions.type 이 있어야 합니다.

    참고

    SELinux 유형은 워크로드에 지정되지 않으며 SCC에서 처리합니다. 배포 및 ReplicaSet 을 통해 Pod를 생성하면 Pod가 적절한 프로필과 함께 실행됩니다.

    올바른 서비스 계정에서만 SCC를 사용할 수 있는지 확인합니다. 자세한 내용은 추가 리소스를 참조하십시오.

7.7.3. 워크로드의 프로필 기록

Security Profiles Operator는 ProfileRecording 오브젝트를 사용하여 시스템 호출을 기록하여 애플리케이션에 대한 기준 프로필을 생성할 수 있습니다.

SELinux 프로필을 기록하는 데 로그 강화기를 사용하는 경우 로그 강화 기능이 활성화되었는지 확인합니다. 자세한 내용은 추가 리소스 를 참조하십시오.

참고

privileged: true security context restraints가 있는 컨테이너는 로그 기반 기록을 방지합니다. 권한 있는 컨테이너는 SELinux 정책의 영향을 받지 않으며 로그 기반 기록에서는 특수 SELinux 프로필을 사용하여 이벤트를 기록합니다.

절차

  1. 다음 명령을 실행하여 프로젝트를 생성합니다.

    $ oc new-project my-namespace
  2. 다음 명령을 실행하여 enable-recording=true 로 네임스페이스에 레이블을 지정합니다.

    $ oc label ns my-namespace spo.x-k8s.io/enable-recording=true
  3. recorder: logs 변수를 포함하는 ProfileRecording 오브젝트를 생성합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1alpha1
    kind: ProfileRecording
    metadata:
      namespace: my-namespace
      name: test-recording
    spec:
      kind: SelinuxProfile
      recorder: logs
      podSelector:
        matchLabels:
          app: my-app
  4. 기록할 워크로드를 생성합니다.

    apiVersion: v1
    kind: Pod
    metadata:
      namespace: my-namespace
      name: my-pod
      labels:
        app: my-app
    spec:
      securityContext:
        runAsNonRoot: true
        seccompProfile:
          type: RuntimeDefault
      containers:
        - name: nginx
          image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21
          ports:
            - containerPort: 8080
          securityContext:
            allowPrivilegeEscalation: false
            capabilities:
              drop: [ALL]
        - name: redis
          image: quay.io/security-profiles-operator/redis:6.2.1
          securityContext:
            allowPrivilegeEscalation: false
            capabilities:
              drop: [ALL]
  5. 다음 명령을 입력하여 Pod가 Running 상태인지 확인합니다.

    $ oc -n my-namespace get pods

    출력 예

    NAME     READY   STATUS    RESTARTS   AGE
    my-pod   2/2     Running   0          18s

  6. 강화자가 해당 컨테이너에 대한 감사 로그를 수신하는지 확인합니다.

    $ oc -n openshift-security-profiles logs --since=1m --selector name=spod -c log-enricher

    출력 예

    I0517 13:55:36.383187  348295 enricher.go:376] log-enricher "msg"="audit" "container"="redis" "namespace"="my-namespace" "node"="ip-10-0-189-53.us-east-2.compute.internal" "perm"="name_bind" "pod"="my-pod" "profile"="test-recording_redis_6kmrb_1684331729" "scontext"="system_u:system_r:selinuxrecording.process:s0:c4,c27" "tclass"="tcp_socket" "tcontext"="system_u:object_r:redis_port_t:s0" "timestamp"="1684331735.105:273965" "type"="selinux"

검증

  1. Pod를 제거합니다.

    $ oc -n my-namespace delete pod my-pod
  2. Security Profiles Operator가 다음 두 SELinux 프로필을 조정하는지 확인합니다.

    $ oc get selinuxprofiles -lspo.x-k8s.io/recording-id=test-recording

    SELinux 프로필 출력 예

    NAME                   USAGE                                 STATE
    test-recording-nginx   test-recording-nginx.process   Installed
    test-recording-redis   test-recording-redis.process   Installed

7.7.3.1. 컨테이너별 프로필 인스턴스 병합

ReplicaSet 또는 Deployment 를 사용하여 애플리케이션을 배포할 때 기록된 하나의 프로필을 재사용하려면 각 컨테이너에 대해 별도의 프로필을 유지하는 대신 컨테이너별 프로필 인스턴스를 단일 프로필에 병합하도록 Security Profiles Operator를 구성합니다.

절차

  1. mergeStrategy: containers 변수를 포함하도록 ProfileRecording 오브젝트를 편집합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1alpha1
    kind: ProfileRecording
    metadata:
      # The name of the Recording is the same as the resulting SelinuxProfile CRD
      # after reconciliation.
      name: test-recording
      namespace: my-namespace
    spec:
      kind: SelinuxProfile
      recorder: logs
      mergeStrategy: containers
      podSelector:
        matchLabels:
          app: sp-record
  2. 다음 명령을 실행하여 네임스페이스에 레이블을 지정합니다.

    $ oc label ns my-namespace security.openshift.io/scc.podSecurityLabelSync=false pod-security.kubernetes.io/enforce=privileged pod-security.kubernetes.io/audit=privileged pod-security.kubernetes.io/warn=privileged --overwrite=true
  3. 다음 YAML을 사용하여 워크로드를 생성합니다.

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: nginx-deploy
      namespace: my-namespace
    spec:
      replicas: 3
      selector:
        matchLabels:
          app: sp-record
      template:
        metadata:
          labels:
            app: sp-record
        spec:
          serviceAccountName: spo-record-sa
          containers:
          - name: nginx-record
            image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21
            ports:
            - containerPort: 8080
  4. 개별 프로필을 기록하려면 다음 명령을 실행하여 배포를 삭제합니다.

    $ oc delete deployment nginx-deploy -n my-namespace
  5. 프로필을 병합하려면 다음 명령을 실행하여 프로필 레코딩을 삭제합니다.

    $ oc delete profilerecording test-recording -n my-namespace
  6. 병합 작업을 시작하고 결과 프로필을 생성하려면 다음 명령을 실행합니다.

    $ oc get selinuxprofiles -lspo.x-k8s.io/recording-id=test-recording -n my-namespace

    SELinux 프로필 출력 예

    NAME                          USAGE                            STATE
    test-recording-nginx-record   test-recording-nginx-record.process   Installed

  7. 컨테이너에서 사용하는 권한을 보려면 다음 명령을 실행합니다.

    $ oc get selinuxprofiles test-recording-nginx-record -o yaml

7.7.3.2. seLinuxContext 정보: RunAsAny

SELinux 정책을 기록하기 위해 Webhook에서 허용 SELinux 유형을 삽입하므로 Pod는 기록 중에 AVC 거부를 기록합니다.

SELinux 유형은 pod를 허용 모드로 실행하고 모든 AVC 거부를 audit.log 에 기록합니다. 기본적으로 워크로드는 사용자 지정 SELinux 정책으로 실행할 수 없지만 자동으로 생성된 유형을 사용합니다.

워크로드를 기록하려면 Webhook에서 허용 SELinux 유형을 삽입할 수 있는 SCC를 사용할 수 있는 권한이 있는 서비스 계정을 사용해야 합니다. 권한 있는 SCC에는 seLinuxContext: RunAsAny 가 포함되어 있습니다.

또한 권한이 있는 Pod 보안 표준에서만 사용자 정의 SELinux 정책을 사용할 수 있으므로 클러스터가 Pod Security Admission을 활성화하는 경우 pod-security.kubernetes.io/enforce: privileged 로 네임스페이스에 라벨을 지정해야 합니다.

7.8. Advanced Security Profiles Operator 작업

고급 Security Profiles Operator 작업을 사용하여 메트릭을 활성화하거나 Webhook를 구성하거나 syscall을 제한할 수 있습니다.

7.8.1. seccomp 프로필에서 허용되는 syscalls 제한

Security Profiles Operator는 기본적으로 seccomp 프로필 의 syscall 을 제한하지 않습니다. spod 구성에서 허용된 syscall 목록을 정의할 수 있습니다.

중요

Operator는 허용된 목록에 정의된 syscall의 하위 집합이 있는 seccomp 프로필만 설치합니다. 이 규칙 세트를 준수하지 않는 모든 프로필이 거부됩니다.

spod 구성에서 허용되는 syscall 목록이 수정되면 Operator는 준수하지 않는 이미 설치된 프로필을 확인하고 자동으로 제거합니다.

프로세스

  • allowedSyscalls 목록을 정의하려면 다음 명령을 실행하여 spec 매개변수를 조정합니다.

    $ oc -n openshift-security-profiles patch spod spod --type merge \
        -p '{"spec":{"allowedSyscalls": ["exit", "exit_group", "futex", "nanosleep"]}}'

7.8.2. 컨테이너 런타임의 기본 syscall

baseProfileName 속성을 사용하여 지정된 런타임에서 컨테이너를 시작하는 데 필요한 최소 syscall 을 설정할 수 있습니다.

프로세스

  • SeccompProfile kind 오브젝트를 편집하고 baseProfileName: runc-v1.0.0 을 spec 필드에 추가합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1beta1
    kind: SeccompProfile
    metadata:
      name: example-name
    spec:
      defaultAction: SCMP_ACT_ERRNO
      baseProfileName: runc-v1.0.0
      syscalls:
        - action: SCMP_ACT_ALLOW
          names:
            - exit_group

7.8.3. spod 데몬에서 메모리 최적화 활성화

spod 데몬 프로세스 내에서 실행 중인 컨트롤러는 프로파일 레코딩이 활성화된 경우 클러스터에서 사용 가능한 모든 Pod를 감시합니다. 이로 인해 대규모 클러스터에서 메모리 사용량이 매우 높아져 spod 데몬이 메모리가 부족하거나 충돌할 수 있습니다.

충돌을 방지하기 위해 spod 데몬은 프로파일 레코딩용으로 레이블이 지정된 Pod만 캐시 메모리에 로드하도록 구성할 수 있습니다.

참고

SPO 메모리 최적화는 기본적으로 활성화되어 있지 않습니다.

프로세스

  1. 다음 명령을 실행하여 메모리 최적화를 활성화합니다.

    $ oc -n openshift-security-profiles patch spod spod --type=merge -p '{"spec":{"enableMemoryOptimization":true}}'
  2. Pod의 보안 프로필을 기록하려면 Pod에 spo.x-k8s.io/enable-recording: "true" 로 레이블이 지정되어야 합니다.

    apiVersion: v1
    kind: Pod
    metadata:
      name: my-recording-pod
      labels:
        spo.x-k8s.io/enable-recording: "true"
    # ...

7.8.4. 데몬 리소스 요구 사항 사용자 정의

데몬 컨테이너의 기본 리소스 요구 사항은 spod 구성의 daemonResourceRequirements 필드를 사용하여 조정할 수 있습니다.

프로세스

  • 데몬 컨테이너의 메모리 및 cpu 요청 및 제한을 지정하려면 다음 명령을 실행합니다.

    $ oc -n openshift-security-profiles patch spod spod --type merge -p \
        '{"spec":{"daemonResourceRequirements": { \
        "requests": {"memory": "256Mi", "cpu": "250m"}, \
        "limits": {"memory": "512Mi", "cpu": "500m"}}}}'

7.8.5. spod 데몬 Pod의 사용자 정의 우선순위 클래스 이름 설정

spod 데몬 Pod의 기본 우선순위 클래스 이름은 system-node-critical 로 설정됩니다. priorityClassName 필드에 값을 설정하여 사용자 정의 우선순위 클래스 이름을 spod 구성에 구성할 수 있습니다.

프로세스

  • 다음 명령을 실행하여 우선순위 클래스 이름을 구성합니다.

    $ oc -n openshift-security-profiles patch spod spod --type=merge -p '{"spec":{"priorityClassName":"my-priority-class"}}'

    출력 예

    securityprofilesoperatordaemon.openshift-security-profiles.x-k8s.io/spod patched

7.8.6. 메트릭 사용

openshift-security-profiles 네임스페이스는 kube-rbac-proxy 컨테이너에서 보안되는 메트릭 끝점을 제공합니다. 모든 메트릭은 openshift-security-profiles 네임스페이스 내에서 메트릭 서비스에 의해 노출됩니다.

Security Profiles Operator에는 클러스터 역할 및 해당 바인딩 spo-metrics-client 가 포함되어 클러스터 내에서 지표를 검색합니다. 다음 두 가지 메트릭 경로를 사용할 수 있습니다.

  • metrics.openshift-security-profiles/metrics: 컨트롤러 런타임 지표의 경우
  • metrics.openshift-security-profiles/metrics-spod: Operator 데몬 지표의 경우

프로세스

  1. 메트릭 서비스의 상태를 보려면 다음 명령을 실행합니다.

    $ oc get svc/metrics -n openshift-security-profiles

    출력 예

    NAME      TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGE
    metrics   ClusterIP   10.0.0.228   <none>        443/TCP   43s

  2. 지표를 검색하려면 다음 명령을 실행하여 openshift-security-profiles 네임스페이스에서 기본 ServiceAccount 토큰을 사용하여 서비스 끝점을 쿼리합니다.

    $ oc run --rm -i --restart=Never --image=registry.fedoraproject.org/fedora-minimal:latest \
        -n openshift-security-profiles metrics-test -- bash -c \
        'curl -ks -H "Authorization: Bearer $(cat /var/run/secrets/kubernetes.io/serviceaccount/token)" https://metrics.openshift-security-profiles/metrics-spod'

    출력 예

    # HELP security_profiles_operator_seccomp_profile_total Counter about seccomp profile operations.
    # TYPE security_profiles_operator_seccomp_profile_total counter
    security_profiles_operator_seccomp_profile_total{operation="delete"} 1
    security_profiles_operator_seccomp_profile_total{operation="update"} 2

  3. 다른 네임스페이스에서 지표를 검색하려면 다음 명령을 실행하여 ServiceAccount 를 spo-metrics-client ClusterRoleBinding 에 연결합니다.

    $ oc get clusterrolebinding spo-metrics-client -o wide

    출력 예

    NAME                 ROLE                             AGE   USERS   GROUPS   SERVICEACCOUNTS
    spo-metrics-client   ClusterRole/spo-metrics-client   35m                    openshift-security-profiles/default

7.8.6.1. controller-runtime metrics

controller-runtime 메트릭 및 DaemonSet 끝점 metrics-spod 는 기본 지표 세트를 제공합니다. 추가 메트릭은 데몬에서 제공하며 항상 security_profiles_operator_ 접두사가 붙습니다.

표 7.1. 사용 가능한 controller-runtime 메트릭
메트릭 키가능한 레이블유형목적

seccomp_profile_total

operation={delete,update}

카운터

seccomp 프로필 작업의 양입니다.

seccomp_profile_audit_total

노드,네임스페이스,Pod,컨테이너,실행 가능,syscall

카운터

seccomp 프로필 감사 작업의 양입니다. 로그를 더 강화해야 합니다.

seccomp_profile_bpf_total

node, mount_namespace, profile

카운터

seccomp 프로필 bpf 작업의 양입니다. bpf 레코더를 활성화해야 합니다.

seccomp_profile_error_total

reason={ SeccompNotSupportedOnNode, InvalidSeccompProfile, CannotSaveSeccompProfile, CannotRemoveSeccompProfile, CannotRemoveSeccompProfile, CannotUpdateSeccompProfile, CannotUpdateNodeStatus }

카운터

seccomp 프로필 오류의 양입니다.

selinux_profile_total

operation={delete,update}

카운터

SELinux 프로필 작업의 양입니다.

selinux_profile_audit_total

노드,네임스페이스,Pod,컨테이너,실행 가능,scontext,tcontext

카운터

SELinux 프로필 감사 작업의 양입니다. 로그를 더 강화해야 합니다.

selinux_profile_error_total

reason={ CannotSaveSelinuxPolicy, CannotUpdatePolicyStatus, CannotRemoveSelinuxPolicy, CannotContactSelinuxd, CannotWritePolicyFile, CannotGetPolicyStatus }

카운터

SELinux 프로필 오류 수입니다.

7.8.7. 로그 강화 사용

Security Profiles Operator에는 기본적으로 비활성화되어 있는 로그 보강 기능이 포함되어 있습니다. 로그 강화 컨테이너는 호스트 PID 네임스페이스(hostPID)에서 권한 있는 권한으로 실행되므로 로컬 노드에서 감사 로그를 읽을 수 있습니다.

중요

로그 보강자는 호스트 프로세스를 읽을 수 있는 권한이 있어야 합니다.

절차

  1. 다음 명령을 실행하여 spod 구성을 패치하여 로그 강화를 활성화합니다.

    $ oc -n openshift-security-profiles patch spod spod \
        --type=merge -p '{"spec":{"enableLogEnricher":true}}'

    출력 예

    securityprofilesoperatordaemon.security-profiles-operator.x-k8s.io/spod patched

    참고

    Security Profiles Operator는 spod 데몬 세트를 자동으로 다시 배포합니다.

  2. 다음 명령을 실행하여 감사 로그를 확인합니다.

    $ oc -n openshift-security-profiles logs -f ds/spod log-enricher

    출력 예

    I0623 12:51:04.257814 1854764 deleg.go:130] setup "msg"="starting component: log-enricher"  "buildDate"="1980-01-01T00:00:00Z" "compiler"="gc" "gitCommit"="unknown" "gitTreeState"="clean" "goVersion"="go1.16.2" "platform"="linux/amd64" "version"="0.4.0-dev"
    I0623 12:51:04.257890 1854764 enricher.go:44] log-enricher "msg"="Starting log-enricher on node: 127.0.0.1"
    I0623 12:51:04.257898 1854764 enricher.go:46] log-enricher "msg"="Connecting to local GRPC server"
    I0623 12:51:04.258061 1854764 enricher.go:69] log-enricher "msg"="Reading from file /var/log/audit/audit.log"
    2021/06/23 12:51:04 Seeked /var/log/audit/audit.log - &{Offset:0 Whence:2}

7.8.7.1. 애플리케이션을 추적하려면 로그 강화기를 사용합니다.

Security Profiles Operator 로그를 사용하여 애플리케이션을 추적할 수 있습니다.

절차

  1. 애플리케이션을 추적하려면 SeccompProfile 로깅 프로필을 생성합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1beta1
    kind: SeccompProfile
    metadata:
      name: log
    spec:
      defaultAction: SCMP_ACT_LOG
  2. 프로필을 사용할 Pod 오브젝트를 생성합니다.

    apiVersion: v1
    kind: Pod
    metadata:
      name: log-pod
      namespace: default
    spec:
      securityContext:
        runAsNonRoot: true
        seccompProfile:
          type: Localhost
          localhostProfile: operator/log.json
      containers:
      - name: log-container
        image: quay.io/security-profiles-operator/test-nginx-unprivileged:1.21
        securityContext:
          allowPrivilegeEscalation: false
          capabilities:
            drop: [ALL]
  3. 다음 명령을 실행하여 로그 강화 출력을 검사합니다.

    $ oc -n openshift-security-profiles logs -f ds/spod log-enricher

    출력 예

    …
    I0623 12:59:11.479869 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=3 "syscallName"="close" "timestamp"="1624453150.205:1061" "type"="seccomp"
    I0623 12:59:11.487323 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=157 "syscallName"="prctl" "timestamp"="1624453150.205:1062" "type"="seccomp"
    I0623 12:59:11.492157 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=157 "syscallName"="prctl" "timestamp"="1624453150.205:1063" "type"="seccomp"
    …
    I0623 12:59:20.258523 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/usr/sbin/nginx" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=12 "syscallName"="brk" "timestamp"="1624453150.235:2873" "type"="seccomp"
    I0623 12:59:20.263349 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/usr/sbin/nginx" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=21 "syscallName"="access" "timestamp"="1624453150.235:2874" "type"="seccomp"
    I0623 12:59:20.354091 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/usr/sbin/nginx" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=257 "syscallName"="openat" "timestamp"="1624453150.235:2875" "type"="seccomp"
    I0623 12:59:20.358844 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/usr/sbin/nginx" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=5 "syscallName"="fstat" "timestamp"="1624453150.235:2876" "type"="seccomp"
    I0623 12:59:20.363510 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/usr/sbin/nginx" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=9 "syscallName"="mmap" "timestamp"="1624453150.235:2877" "type"="seccomp"
    I0623 12:59:20.454127 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/usr/sbin/nginx" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=3 "syscallName"="close" "timestamp"="1624453150.235:2878" "type"="seccomp"
    I0623 12:59:20.458654 1854764 enricher.go:111] log-enricher "msg"="audit"  "container"="log-container" "executable"="/usr/sbin/nginx" "namespace"="default" "node"="127.0.0.1" "pid"=1905792 "pod"="log-pod" "syscallID"=257 "syscallName"="openat" "timestamp"="1624453150.235:2879" "type"="seccomp"
    …

7.8.8. Webhook 구성

선택한 네임스페이스 또는 오브젝트로 제한하거나 Webhook가 실패하는 경우 요청을 계속할 수 있도록 프로필 바인딩 및 기록에 대한 Webhook를 구성합니다. 프로필 바인딩 및 레코딩 오브젝트 구성은 MutatingWebhookConfiguration CR이며 Security Profiles Operator에서 관리합니다.

Webhook 구성을 변경하려면 spod 사용자 정의 리소스에서 webhookOptions 필드를 편집합니다. failurePolicy,namespaceSelector 및 objectSelector 변수를 수정하여 Webhook를 soft-fail로 설정하거나 네임스페이스의 하위 집합으로 제한할 수 있습니다. Webhook가 실패하면 다른 네임스페이스 또는 리소스가 영향을 받지 않습니다.

절차

  1. 다음 패치 파일을 생성하여 spo-record=true 로 레이블이 지정된 Pod만 기록하도록 recording.spo.io 웹 후크 구성을 설정합니다.

    spec:
      webhookOptions:
        - name: recording.spo.io
          objectSelector:
            matchExpressions:
              - key: spo-record
                operator: In
                values:
                  - "true"
  2. 다음 명령을 실행하여 spod/spod 인스턴스를 패치합니다.

    $ oc -n openshift-security-profiles patch spod \
        spod -p $(cat /tmp/spod-wh.patch) --type=merge
  3. 결과 MutatingWebhookConfiguration 오브젝트를 보려면 다음 명령을 실행합니다.

    $ oc get MutatingWebhookConfiguration \
        spo-mutating-webhook-configuration -oyaml

7.9. 고급 감사 로깅 프레임워크

OpenShift Container Platform Security Profiles Operator (SPO)의 고급 감사 로깅 프레임워크를 사용하면 oc exec,oc rsh 및 oc debug 세션 중에 클러스터 사용자와 작업의 상관 관계를 유지할 수 있습니다.

SPO 0.10.0의 고급 감사 로깅 프레임워크는 RHCOS(Red Hat Enterprise Linux CoreOS) 컨테이너의 활동을 호스팅 클러스터로 다시 기록하고 JSON 줄 형식으로 자세한 로그를 생성합니다.

7.9.1. 고급 감사 로깅 프레임워크의 이점

kubectl exec,oc exec,oc rsh 및 oc debug 명령은 사용자 인증 세부 정보를 컨테이너의 exec 세션에 전달하지 않으므로 호스트의 작업으로 인한 Kubernetes 사용자 작업의 상관 관계가 어렵습니다. SPO의 감사 로거는 Kubernetes API 서버의 요청 UID를 환경 변수로 세션에 삽입하는 변경 웹 후크를 사용하여 이를 처리합니다. 새 exec 세션을 시작하기 위한 요청을 포함하여 API 서버에 대한 모든 요청에는 요청 UID가 있습니다. 그런 다음 이 요청 UID는 Advanced Audit Logging Framework에 의해 기록됩니다. 요청 ID는 API 서버 감사 로그와의 상관 관계를 유지하여 노드 내에서 감사 추적을 제공하는 데 사용됩니다.

이제 SPO에 고급 감사 로깅 프레임워크가 추가되어 두 가지 사용 사례가 있습니다.

  • Pod 감사
  • 노드 감사

권한 있는 seccompProfile 구성을 사용하는 것은 노드 감사의 경우에만 필요합니다.

참고

Security Profiles Operator는 사용 중인 OpenShift Container Platform 버전에 적합한 RHCOS(Red Hat Enterprise Linux CoreOS) 작업자 노드만 지원합니다.

RHEL(Red Hat Enterprise Linux) 노드는 지원되지 않습니다.

7.9.2. 성능 고려 사항

광범위한 로깅을 위해 seccomp 프로필을 사용하는 성능 비용을 고려해야 합니다. SPO는 주로 프로세스 생성만 로깅하고 비동기적으로 처리함으로써 이러한 영향을 최소화하도록 설계되었습니다. 이 접근 방식은 로깅이 노드에서 병목 상태가 되지 않도록 하는 데 도움이 됩니다.

고급 감사 로깅 기능은 eBPF를 추가 데이터 소스로 사용합니다. eBPF를 이러한 유형의 로깅의 기본 데이터 소스로 사용할 수 있지만 해당 기능은 현재 Operator 내에서 구성 가능한 기능은 아닙니다. 대부분의 사용 사례에서 기본 비동기 프로세스 생성 중심 로깅 접근 방식은 보안 가시성과 클러스터 성능 간의 균형을 유지할 수 있습니다.

7.9.3. 고급 감사 로깅 프레임워크의 사전 요구 사항

고급 감사 로깅 프레임워크를 활성화하기 전에 다음 요구 사항이 충족되었는지 확인합니다.

Security Profiles Operator 버전 0.10.0 이상이 설치되어 있습니다. 고급 감사 로깅 프레임워크에는 Security Profiles Operator 버전 0.10.0 이상이 필요합니다.

노드 디버깅 세션의 경우:

  • oc debug node 세션을 감사하려면 CRI-O 버전 1.33 이상이 필요합니다. OpenShift Container Platform 4.20 이상에서 사용할 수 있습니다.
  • 권한 있는 컨테이너에 seccompProfile 을 적용하려면 --privileged-seccomp-profile 플래그를 CRI-O에서 구성해야 합니다.
  • 고급 감사 로깅 프레임워크와 함께 사용되는 지원되는 Linux는 OpenShift Container Platform 4.20 이상의 컨테이너에서 실행되는 RHCOS(Red Hat Enterprise Linux CoreOS)입니다.

CRI-O 런타임을 사용하는 경우 seccompProfile 이 권한 있는 컨테이너에 적용되도록 구성해야 합니다. CRI-O 런타임 구성에 다음 플래그를 추가합니다. --privileged-seccomp-profile=/var/lib/kubelet/seccomp/operator/profile1.json. 이는 고급 감사 로깅 설치 및 사용 단계에서 자세히 설명합니다. --privileged-seccomp-profile 플래그는 OpenShift Container Platform 4.20 이상에서 사용할 수 있습니다.

0.9.0 이전 버전의 SPO를 사용하는 경우 버전 0.9.0 또는 0.10.0을 설치하려면 마이그레이션 절차를 수행해야 합니다. 마이그레이션 절차는 클러스터 범위 리소스에서 작동하도록 SPO를 변환합니다.

SPO 버전 0.10.0을 처음 설치할 때는 마이그레이션이 필요하지 않습니다. 또한 현재 SPO 0.9.0에 있는 경우 마이그레이션이 필요하지 않으며 SPO 0.10.0으로 직접 업그레이드할 수 있습니다.

중요

현재 SPO를 실행하는 경우 0.9.0 이전 버전의 SPO에서 0.9.0 또는 0.10.0으로 직접 업그레이드하지 마십시오. 클러스터 수준에서 작업을 수행하려면 마이그레이션 절차를 수행해야 합니다.

이러한 변경을 통해 작업자 노드 내부의 이벤트의 고급 감사 로깅을 수행할 수 있습니다.

SPO가 etcd 노드에서 작동하지 않기 때문에 이 기능은 제어 노드에 제공되지 않습니다.

7.9.4. 감사 JSON 로그 강화기

SPO 고급 감사 로깅 프레임워크는 감사 JSON 로그에 의해 활성화됩니다. 로그 강화 기능과 유사하게 감사 JSON 로그는 auditd (/var/log/audit/audit.log) 또는 syslog (/var/log/syslog) 데몬을 감시하고 JSON 줄 형식으로 새 감사 로그를 생성합니다.

각 JSON 행에는 다음이 포함됩니다.

  • 타임 스탬프: 활동이 발생했을 때 표준 ISO 형식으로 표시됩니다.
  • 실행 가능 이름: 실행된 프로그램의 이름입니다(bash,ls).
  • Linux 명령줄 인수(cmdline): 프로그램이 시작될 때 제공되는 추가 명령(ls -l /home)
  • 사용자 및 그룹 ID(UID/GID): 프로그램을 실행한 시스템 사용자의 식별 번호입니다.
  • 시스템 호출(syscall): 프로세스가 수행한 시스템 호출 목록(syscall)

이 로그 형식 및 구성은 Kubernetes가 감사 로그를 기록하는 방법과 유사합니다. 이 기능은 다음에 유용합니다.

  • Pod 내에서 수행하는 사용자 및 자동화된 프로세스 확인.
  • 누군가가 kubectl exec 와 같은 명령을 사용하여 실행중인 컨테이너를 입력하고 명령 또는 스크립트를 실행할 때 추적하십시오.
  • 사용자가 다양한 툴을 실행할 수 있는 디버그 컨테이너의 활동 모니터링.

7.9.5. Kubernetes API 로그와 고급 감사 로깅 출력 비교

고급 감사 로깅 값을 이해하려면 Kubernetes API 서버 감사 로그와 고급 감사 로깅 출력을 비교합니다.

Kubernetes API 서버 감사 로그

{
  "kind": "Event",
  "apiVersion": "audit.k8s.io/v1",
  "level": "Metadata",
  "auditID": "4d434cd4-xxxx-xxxx-xxxx-2d9aa46292ce",
  "stage": "ResponseComplete",
  "requestURI": "/api/v1/namespaces/test-namespace/pods/test-pod/exec?command=sh&command=-c&command=touch+/tmp/testfile.txt&container=nginx",
  "verb": "create",
  "user": {
    "username": "kube:admin",
    "groups": ["system:cluster-admins", "system:authenticated"]
  },
  "sourceIPs": ["xxx.xxx.xxx.xxx"],
  "userAgent": "oc/4.19.0 (linux/amd64)",
  "objectRef": {
    "resource": "pods",
    "namespace": "test-namespace",
    "name": "test-pod",
    "subresource": "exec"
  },
  "responseStatus": {
    "code": 101
  },
  "requestReceivedTimestamp": "2026-02-16T14:01:06.056518Z",
  "annotations": {
    "authorization.k8s.io/decision": "allow",
    "authorization.k8s.io/reason": "RBAC: allowed by ClusterRoleBinding...",
    "execmetadata.spo.io/SPO_EXEC_REQUEST_UID": "aec3e0e1-xxxx-xxxx-xxxx-a7c58241f1a9"
  }
}

correlation 키는 위의 파일의 마지막 행에 있는 SPO_EXEC_REQUEST_UID 입니다.

고급 감사 로깅 출력

{
  "auditID": "d586679d-xxxx-xxxx-xxxx-9dc8ab273065",
  "cmdLine": "touch /tmp/testfile.txt ",		// Linux command with arguments
  "executable": "/bin/dash",
  "gid": 0,
  "node": {
    "name": "worker-1"
  },
  "pid": 144968,
  "requestUID": "aec3e0e1-xxxx-xxxx-xxxx-a7c58241f1a9", // Correlation key
  "resource": {
    "container": "nginx",
    "namespace": "test-namespace",
    "pod": "test-pod"
  },
  "syscalls": ["execve"],
  "timestamp": "2026-02-16T14:01:07.000Z",
  "uid": 0,
  "version": "spo/v1_alpha"
}

7.9.6. 고급 감사 로깅 활성화

고급 감사 로깅을 활성화하려면 감사 JSON 로그를 구성하고 사용자 활동에만 필터 세트를 지정합니다.

절차

  1. 다음 명령을 실행하여 JSON 강화를 활성화합니다.

    # kubectl -n openshift-security-profiles patch spod spod --type=merge -p '{"spec":{"enableJsonEnricher":true}}'

    SPOD Pod에서 올바른 재시작이 있는지 모니터링하고 모든 SPOD Pod에 Running 이 표시될 때까지 기다립니다.

  2. 다음 명령을 사용하여 변경 사항의 애플리케이션에 대해 Pod를 확인합니다.

    $ oc get pods -n openshift-security-profiles -l name=spod -w

    계속하기 전에 모든 SPOD Pod가 Running 이 표시될 때까지 기다립니다.

    참고

    각 구성 변경으로 인해 SPOD Pod가 다시 시작됩니다. 패치를 적용한 후 모든 SPOD Pod가 Running 상태로 돌아갈 때까지 기다린 후 계속합니다.

    감사 JSON 로그 강화기는 eBPF를 추가 데이터 소스로 사용합니다. /var/log/audit/audit.log 에서 auditd 로그를 처리하는 동안 향상된 기능을 통해 /proc/<pid > 디렉토리에서 임시 데이터를 가져옵니다. 경합 조건으로 인해 이러한 파일을 읽기 전에 삭제할 수 있습니다. 데이터 완전성을 보장하기 위해 강화자는 /proc/<pid>에서 찾을 수 없을 때마다 eBPF에서 필요한 정보를 다시 가져옵니다.

7.9.7. 감사 JSON 로그 Enricher 구성

감사 JSON Log Enricher를 구성하여 감사 로그 간격, 대상 및 파일 경로를 설정하여 고급 감사 로깅 레코드가 스케줄에 기록되고 수집 및 검토할 수 있는 위치에 설정합니다.

참고

각 구성 변경으로 인해 SPOD Pod가 다시 시작됩니다. 패치를 적용한 후 모든 SPOD Pod가 Running 상태로 돌아갈 때까지 기다린 후 계속합니다.

감사 로그 간격을 설정하면 auditLogIntervalSeconds 옵션을 사용하여 감사 로그가 생성되는 빈도가 결정됩니다.

절차

  1. 다음 명령을 사용하여 감사 로그 간격을 30초로 구성합니다.

    # kubectl -n openshift-security-profiles patch spod spod --type=merge -p '{"spec":{"enableJsonEnricher":true,"verbosity":0,"jsonEnricherOptions":{"auditLogIntervalSeconds":30}}}'

    계속하기 전에 모든 SPOD Pod가 Running 이 표시될 때까지 기다립니다. 기본적으로 감사 로그는 JSON 줄 형식의 표준 출력으로 이동합니다. 대신 파일로 보낼 수 있습니다.

    로그 파일을 노드에 저장하도록 Security Profiles Operator를 구성합니다. security-profiles-operator-profile configmap 을 두 개의 키로 업데이트합니다. 이 예제 YAML에서는 두 키를 모두 사용하여 /tmp/logs 에 호스트 경로 볼륨을 설정합니다.

  2. 다음 콘텐츠가 포함된 patch-volume-source.json 과 같은 파일을 생성합니다.

    {
      "data": {
        "json-enricher-log-volume-mount-path": "/tmp/logs",
        "json-enricher-log-volume-source.json": "{\"hostPath\": {\"path\": \"/tmp/logs\",\"type\": \"DirectoryOrCreate\"}}"
      }
    }
    • JSON -enricher-log-volume-source.json: 로그가 저장되는 볼륨 유형(예: 호스트 경로 및 빈 디렉터리)을 정의합니다. 이 값은 corev1.VolumeSource 오브젝트를 나타내는 JSON 문자열이어야 합니다.
    • JSON-enricher-log-volume-mount-path: 로그 파일이 생성되는 디렉터리 경로를 지정합니다.
  3. 다음 명령을 실행하여 파일 내용을 확인합니다.

    $ cat patch-volume-source.json
  4. 다음 명령을 사용하여 security-profiles-operator-profile configmap 을 업데이트합니다.

    # kubectl patch configmap security-profiles-operator-profile -n openshift-security-profiles --patch-file patch-volume-source.json

    계속하기 전에 모든 SPOD Pod가 Running 이 표시될 때까지 기다립니다.

  5. 다음 명령을 실행하여 파일 이름을 포함하여 감사 로그 파일의 전체 경로로 JSON 로그를 보강하여 감사 로그 파일 경로를 설정합니다.

    # kubectl -n openshift-security-profiles patch spod spod --type=merge -p '{"spec":{"enableJsonEnricher":true,"verbosity":0,"jsonEnricherOptions":{"auditLogPath":"/tmp/logs/audit1.log"}}}'

    계속하기 전에 모든 SPOD Pod가 Running 이 표시될 때까지 기다립니다.

7.9.8. 감사 로그 파일 미세 조정 및 교체

파일에 대한 감사 로깅의 경우 파일 크기와 각 파일이 유지되는 시간을 관리할 수 있습니다. 이러한 옵션은 Kubernetes API 서버 로그 설정 과 유사합니다.

절차

  1. JSON 로그 강화 옵션의 패치를 적용하여 이러한 설정을 구성합니다.

    # kubectl -n openshift-security-profiles patch spod spod --type=merge -p '{"spec":{"enableJsonEnricher":true,"verbosity":0,"jsonEnricherOptions":{"auditLogPath":"/tmp/logs/audit1.log","auditLogMaxSize":500,"auditLogMaxBackups":2,"auditLogMaxAge":10}}}'

    계속하기 전에 모든 SPOD Pod가 Running 이 표시될 때까지 기다립니다.

    • auditLogMaxSize: 로그 파일이 순환되기 전에 연결할 수 있는 최대 크기(MB)입니다(새 파일이 시작됨).
    • auditLogMaxBackups: 유지할 오래된 순환된 로그 파일의 최대 수입니다. 제한 없이 0으로 설정합니다.
    • auditLogMaxAge: 이전 로그 파일을 보관할 최대 일 수입니다.
  2. 디버깅에 도움이 되도록 JSON 로그 강화 컨테이너의 로깅 수준을 높입니다. 값이 0 이면 최소 로그가 설정됩니다. 값이 1 이면 더 자세한 로그를 설정합니다. 이 두 수준 중 하나를 선택하고 다음 명령을 사용하여 수준 중 하나를 활성화할 수 있습니다.

    # kubectl -n openshift-security-profiles patch spod spod --type=merge -p '{"spec":{"enableJsonEnricher":true, "verbosity": 1}}'

    계속하기 전에 모든 SPOD Pod가 Running 이 표시될 때까지 기다립니다.

7.9.9. 특정 Pod의 고급 감사 로그

단일 Pod의 활동을 로깅하려면 execve 와 같은 특정 syscall을 로깅하는 SeccompProfile 을 생성하고 대상 네임스페이스의 Pod에 프로필을 적용하는 ProfileBinding 을 생성합니다. SeccompProfile 은 클러스터 전체에 적용됩니다. ProfileBinding 은 해당 네임스페이스의 워크로드에 적용됩니다.

OpenShift Container Platform 4.20 및 CRI-O 1.33부터 권한이 있는 컨테이너에 SeccompProfile 을 적용할 수 있습니다. 권한 있는 디버깅 Pod도 프로필에서 적용하도록 --privileged-seccomp-profile 플래그를 CRI-O 런타임 구성에 추가합니다.

프로필을 네임스페이스에 바인딩하여 워크로드에 적용합니다. 그러면 해당 네임스페이스의 새 Pod가 프로필을 자동으로 수신합니다.

절차

  1. 다음 콘텐츠를 사용하여 profile1.yaml 과 같은 파일을 생성합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1beta1
    kind: SeccompProfile
    metadata:
      name: profile1
      namespace: openshift-security-profiles
    spec:
      defaultAction: SCMP_ACT_ALLOW
      syscalls:
      - action: SCMP_ACT_LOG
        names:
          - execve
          - clone
          - getpid

    이 프로필은 모든 일반 작업(defaultAction: SCMP_ACT_ALLOW)을 허용합니다. 특히 프로세스에서 새 프로그램(execve)을 실행하려고 할 때 로그를 기록하거나 새 프로세스(복제)를 생성하거나 자체 프로세스 ID(getpid)를 가져옵니다. 이러한 작업은 종종 Pod 내에서 사용자 상호 작용을 나타냅니다.

  2. 다음 명령을 실행하여 이 SeccompProfile 을 클러스터에 적용합니다.

    # kubectl apply -f profile1.yaml
    참고

    Security Profiles Operator는 privileged SeccompProfile 을 사용해야 합니다.

  3. 다음 YAML을 포함하는 image_sec_comp.yaml 이라는 파일을 생성합니다.

    apiVersion: security-profiles-operator.x-k8s.io/v1alpha1
    kind: ProfileBinding
    metadata:
      namespace: default
      name: all-pod-binding
    spec:
      profileRef:
        kind: SeccompProfile
        name: profile1
      image: "*"
  4. 다음 명령을 실행하여 바인딩을 적용합니다.

    # kubectl apply -f image_sec_comp.yaml
  5. 다음 명령을 실행하여 바인딩을 활성화하려면 네임스페이스에 레이블을 지정합니다.

    # kubectl label ns default spo.x-k8s.io/enable-binding=true
  6. 다음 Pod 정의가 포함된 my-pod.yaml 과 같은 파일을 생성합니다.

    apiVersion: v1
    kind: Pod
    metadata:
      name: my-pod
      labels:
        app: my-app
    spec:
      securityContext:
        seccompProfile:
          type: Localhost
          localhostProfile: operator/profile1.json
      containers:
        - name: nginx
          image: quay.io/security-profiles-operator/test-nginx:1.19.1
    • type: Localhost 는 클러스터에 정의된 프로필을 사용하고 있음을 의미합니다.
    • localhostProfile: operator/profile1.json 은 Pod에 사용자가 생성한 profile1 프로필을 사용하도록 지시합니다. operator/ 경로는 Security Profiles Operator가 이러한 프로필을 저장하는 위치입니다.
  7. 다음 명령을 실행하여 포드 정의를 적용합니다.

    # kubectl apply -f my-pod.yaml
  8. 다음 명령을 실행하여 Pod에서 쉘을 엽니다.

    # kubectl exec -it my-pod -- /bin/sh
  9. 다음 명령을 실행하여 Pod에 빈 파일을 생성합니다.

    # touch /tmp/audittest/demo-file
  10. 다음 명령을 실행하여 고급 감사 로그를 스트리밍합니다.

    # kubectl -n openshift-security-profiles logs --since=1m --selector name=spod -c json-enricher --max-log-requests 6 -f
  11. 다음 명령을 실행하여 Pod가 실행되는 노드를 확인합니다.

    # kubectl get pod my-pod -o wide

    auditLogPath 필드에 지정된 감사 로그 파일은 Pod가 실행 중인 노드의 파일 시스템에 작성됩니다. 감사 로그를 검사하려면 노드에 액세스하여 구성된 경로(예: /tmp/logs/audit1.log )에서 파일을 엽니다.

  12. 다음 명령을 실행하여 노드에 액세스합니다.

    $ sudo ssh core@<node_name>
  13. 다음 명령을 실행하여 감사 로그를 확인합니다.

    $ cat /tmp/logs/audit1.log

    출력 예

    {
    "auditID": "a1b2c3d4-e5f6-7890-abcd-111111111111",
    "cmdLine": "mkdir /tmp/audittest ",
    "executable": "/bin/bash",
    "gid": 0,
    "node": {"name": "worker-1"},
    "pid": 27184,
    "requestUID": "f011c4a3-b20e-44ed-bb91-23e03ae31b3e",
    "resource": {
    "container": "nginx",
    "namespace": "default",
    "pod": "my-pod"
    },
    "syscalls": ["getpid", "execve"],
    "timestamp": "2026-02-16T06:34:53.000Z",
    "uid": 0,
    "version": "spo/v1_alpha"
    }
    {
    "auditID": "a1b2c3d4-e5f6-7890-abcd-222222222222",
    "cmdLine": "touch /tmp/audittest/demo-file ",
    "executable": "/bin/bash",
    "gid": 0,
    "node": {"name": "worker-1"},
    "pid": 27274,
    "requestUID": "f011c4a3-b20e-44ed-bb91-23e03ae31b3e",
    "resource": {
    "container": "nginx",
    "namespace": "default",
    "pod": "my-pod"
    },
    "syscalls": ["getpid", "execve"],
    "timestamp": "2026-02-16T06:35:02.000Z",
    "uid": 0,
    "version": "spo/v1_alpha"
    }

7.9.10. 감사 로그 모니터링

Pod 로그를 스트리밍하거나 노드에서 감사 로그 파일을 읽고 json-enricher 컨테이너에서 고급 감사 로그를 모니터링하여 고급 감사 로깅이 세션 활동을 캡처하는지 확인할 수 있습니다.

감사 로그 파일은 auditLogPath 필드에 지정되며 Pod가 실행 중인 노드의 파일 시스템에 기록됩니다. 감사 로그를 검사하려면 노드에 액세스하여 구성된 경로(예: /tmp/logs/audit1.log )에서 파일을 엽니다.

절차

  1. 다음 명령을 사용하여 고급 감사 로그를 스트리밍합니다.

    # kubectl -n openshift-security-profiles logs --since=1m --selector name=spod -c json-enricher --max-log-requests 6 -f
  2. 다음 명령을 사용하여 Pod가 예약된 노드를 식별합니다.

    # kubectl get pod my-pod -o wide
  3. 다음 명령을 사용하여 노드에 액세스합니다.

    $ sudo ssh core@<node_name>
  4. 다음 명령을 사용하여 감사 로그를 확인합니다.

    $ cat /tmp/logs/audit1.log

    출력 예

    {
    "auditID": "a1b2c3d4-e5f6-7890-abcd-111111111111",
    "cmdLine": "mkdir /tmp/audittest ",
    "executable": "/bin/bash",
    "gid": 0,
    "node": {"name": "worker-1"},
    "pid": 27184,
    "requestUID": "f011c4a3-b20e-44ed-bb91-23e03ae31b3e",
    "resource": {
    "container": "nginx",
    "namespace": "default",
    "pod": "my-pod"
    },
    "syscalls": ["getpid", "execve"],
    "timestamp": "2026-02-16T06:34:53.000Z",
    "uid": 0,
    "version": "spo/v1_alpha"
    }
    {
    "auditID": "a1b2c3d4-e5f6-7890-abcd-222222222222",
    "cmdLine": "touch /tmp/audittest/demo-file ",
    "executable": "/bin/bash",
    "gid": 0,
    "node": {"name": "worker-1"},
    "pid": 27274,
    "requestUID": "f011c4a3-b20e-44ed-bb91-23e03ae31b3e",
    "resource": {
    "container": "nginx",
    "namespace": "default",
    "pod": "my-pod"
    },
    "syscalls": ["getpid", "execve"],
    "timestamp": "2026-02-16T06:35:02.000Z",
    "uid": 0,
    "version": "spo/v1_alpha"
    }

7.9.11. 감사 노드 디버깅 세션

CRI-O에서 권한이 있는 seccomp 프로필을 활성화하여 Advanced Audit Logging이 kubectl debug 및 oc debug node sessions의 활동을 기록할 수 있도록 합니다.

CRI-O 런타임을 사용하는 경우 CRI-O 런타임 구성에 --privileged-seccomp-profile=/var/lib/kubelet/seccomp/operator/profile1.json 플래그를 추가하여 권한 있는 컨테이너에서 seccomp 프로필을 허용하도록 구성해야 합니다.

참고

--privileged-seccomp-profile 플래그는 OpenShift Container Platform 4.20 이상 및 CRI-O 버전 1.33 이상에서 사용할 수 있습니다.

절차

  1. 다음 명령을 사용하여 대상 노드에 SSH를 실행합니다.

    # ssh core@<node_ip_address>
  2. 파일이 있는지 확인합니다.

    # ls /var/lib/kubelet/seccomp/operator/

    출력 예

    # kubelet-config.json  profile1.json

  3. 다음 명령을 사용하여 kubelet 을 중지합니다.

    # systemctl stop kubelet
  4. 명령을 사용하여 CRI-O를 중지합니다.

    # systemctl stop crio
  5. 다음 명령을 사용하여 CRI-O 옵션을 설정합니다.

    # echo "CRIO_CONFIG_OPTIONS --privileged-seccomp-profile=/var/lib/kubelet/seccomp/operator/profile1.json" > /etc/sysconfig/crio
  6. 이제 다음 명령을 사용하여 kubelet을 다시 시작합니다.

    # systemctl start kubelet
  7. 다음 명령을 사용하여 CRI-O를 다시 시작하십시오.

    # systemctl start crio
  8. kubectl 디버그 세션을 감사하려면 다음 명령을 실행합니다.

    # kubectl debug node/<node_name> -it --image=ubuntu -- bash

    디버깅 정보를 위해 컨테이너에서 파일을 생성합니다.

  9. 다음 명령을 사용하여 host로 chroot 를 실행합니다.

    # chroot /host
  10. 다음 명령을 사용하여 /tmp 디렉토리로 이동합니다.

    # cd /tmp
  11. 다음 명령을 사용하여 demonodedebug 라는 빈 파일을 생성합니다.

    # touch demonodedebug
  12. 명령을 사용하여 노드를 종료합니다.

    # exit
  13. 로그를 모니터링하려면 다음 명령을 사용하여 노드에 SSH로 연결합니다.

    $ sudo ssh core@<node_name>
  14. 다음 명령을 사용하여 감사 로그를 확인합니다.

    $ cat /tmp/logs/audit1.log

    출력 예

    {
      "auditID": "edce381a-998d-4f3f-99d8-d0c4d0c8a613",
      "cmdLine": "touch demonodedebug",
      "executable": "/usr/bin/bash",
      "gid": 0,
      "node": {"name": "worker-1"},
      "pid": 99086,
      "resource": {
        "container": "container-00",
        "namespace": "openshift-security-profiles",
        "pod": "worker-1-debug"
      },
      "syscalls": ["execve", "getpid"],
      "timestamp": "2026-02-12T13:50:11.000Z",
      "uid": 0,
      "version": "spo/v1_alpha"
    }

7.9.12. Kubernetes 감사 로그와 상호 작용

SID(Security Profiles Operator) 로그의 requestUID 를 사용하여 해당 API 서버 로그 항목을 찾아 세션을 시작한 사람을 확인합니다.

절차

  1. 다음 명령을 실행하여 Pod를 시작합니다.

    $ oc exec my-pod -c nginx -- sh -c "touch /tmp/testfile.txt"
  2. Pod가 실행 중인 노드를 확인합니다.

    $ NODE=$(oc get pod my-pod -o jsonpath='{.spec.nodeName}')
  3. 노드에 액세스하고 다음 명령을 사용하여 JSON 보강된 감사 로그를 확인합니다.

    # oc debug node/$NODE
    # chroot /host
    # grep "testfile" /tmp/logs/audit1.log | jq .

7.9.13. 감사 JSON 로그 Enricher 출력

exec 세션의 경우 감사 JSON Log Enricher는 SPO_EXEC_REQUEST_UID 주입과 Pod에서 실행된 명령의 두 항목을 기록합니다. 공유 UID 값과 일치하여 항목을 연결합니다.

  1. 첫 번째 목록은 컨테이너 런타임 래퍼입니다.

    {
      "auditID": "062e2bd2-xxxx-xxxx-xxxx-57fb39d65a99",
      "cmdLine": "env SPO_EXEC_REQUEST_UID=aec3e0e1-xxxx-xxxx-xxxx-a7c58241f1a9 sh -c touch /tmp/testfile.txt ",
      "executable": "/usr/bin/crun",
      "pid": 144966,
      "requestUID": "aec3e0e1-xxxx-xxxx-xxxx-a7c58241f1a9",
      "resource": {
        "container": "nginx",
        "namespace": "default",
        "pod": "my-pod"
      },
      "node": {
        "name": "worker-1"
      },
      "syscalls": ["execve", "getpid", "clone"],
      "timestamp": "2026-02-16T14:01:07.000Z"
    }
  2. 두 번째 목록은 실행된 실제 명령입니다.

    {
      "auditID": "d586679d-xxxx-xxxx-xxxx-9dc8ab273065",
      "cmdLine": "touch /tmp/testfile.txt ",
      "executable": "/bin/dash",
      "pid": 144968,
      "requestUID": "aec3e0e1-xxxx-xxxx-xxxx-a7c58241f1a9", // Correlation key
      "resource": {
        "container": "nginx",
        "namespace": "default",
        "pod": "my-pod"
      },
      "node": {
        "name": "worker-1"
      },
      "syscalls": ["execve"],
      "timestamp": "2026-02-16T14:01:07.000Z"
    }
  3. 다음 명령과 함께 requestUID 를 사용하여 Kubernetes API 감사 로그를 검색할 수 있습니다.

    $ oc adm node-logs --role=master --path=kube-apiserver/audit.log | grep request_UID

7.9.14. Kubernetes API 감사 로그 출력

Kubernetes API 감사 로그 출력은 YAML입니다. 고급 감사 로깅 출력을 검색하기 위한 상관 관계 키를 제공하는 SPO_EXEC_REQUEST_UID 필드가 포함되어 있습니다.

{
  "kind": "Event",
  "apiVersion": "audit.k8s.io/v1",
  "level": "Metadata",
  "auditID": "4d434cd4-xxxx-xxxx-xxxx-2d9aa46292ce",
  "stage": "ResponseComplete",
  "requestURI": "/api/v1/namespaces/test-namespace/pods/test-pod/exec?command=sh&command=-c&command=touch+/tmp/testfile.txt&container=nginx",
  "verb": "create",
  "user": {
    "username": "kube:admin",
    "groups": ["system:cluster-admins", "system:authenticated"]
  },
  "sourceIPs": ["xxx.xxx.xxx.xxx"],
  "userAgent": "oc/4.19.0 (linux/amd64)",
  "objectRef": {
    "resource": "pods",
    "namespace": "default",
    "name": "my-pod",
    "subresource": "exec"
  },
  "responseStatus": {
    "code": 101
  },
  "requestReceivedTimestamp": "2026-02-16T14:01:06.056518Z",
  "annotations": {
    "authorization.k8s.io/decision": "allow",
    "authorization.k8s.io/reason": "RBAC: allowed by ClusterRoleBinding...",
    "execmetadata.spo.io/SPO_EXEC_REQUEST_UID": "aec3e0e1-xxxx-xxxx-xxxx-a7c58241f1a9"
}

이 예제의 마지막 필드인 SPO_EXEC_REQUEST_UID 는 상관 관계 키입니다.

7.9.15. 상관관계 키

로그 간에 상관 관계 키를 일치시켜 전체 감사 추적을 빌드할 수 있습니다. 감사 JSON Enricher 로그의 requestUID 필드는 Kubernetes API 감사 로그의 annotations.execmetadata.spo.io/SPO_EXEC_REQUEST_UID 주석과 일치합니다.

예를 들어 API 감사 로그는 kube:admin 이 명령을 실행했음을 표시할 수 있으며 SPO JSON Enricher 로그는 /tmp/testfile.txt 와 같은 시스템 수준 작업을 표시할 수 있습니다.

aec3e0e1-xxxx-xxxx-xxxx-a7c58241f1a9

7.9.16. API 서버 감사 로그와 비교

기본적으로 kubectl exec 명령을 사용하여 Pod 또는 컨테이너에 액세스할 때 Kubernetes는 사용자의 인증 세부 정보를 해당 세션 환경에 전달하지 않습니다.

즉 감사 JSON 로그 보강자는 exec 명령에 감사 정보를 제공할 수 없습니다. 표시된 UID 또는 GID 는 시스템 사용자에게 매핑됩니다. 대부분의 경우 이 사용자는 root 사용자입니다.

이를 해결하기 위해 감사 JSON 로그는 변경 웹 후크(execmetadata.spo.io 및 nodedebuggingpod.spo.io)를 사용합니다. Webhook에서 exec requestUID 를 exec 세션에 환경 변수로 삽입합니다. 관리자가 API 서버에서 감사 로깅을 활성화하면 Webhook에서 SPO_EXEC_REQUEST_UID 감사 주석을 추가합니다. API 서버 감사 로그에는 이 정보가 포함되어 있습니다. 이 요청 ID는 특히 requestUID 필드 내에서 감사 JSON 로그 강화기에서 생성된 JSON 행에서도 사용할 수 있습니다.

기본적으로 감사 JSON 로그 강화가 활성화된 모든 네임스페이스에 대해 이러한 Webhook가 활성화됩니다. 이 Webhook의 범위를 줄이기 위해 특정 네임스페이스에 대해 비활성화하면 됩니다.

프로세스

  1. 다음 명령을 실행하여 spod 보안 프로필을 편집합니다.

    $ oc edit spod spod -n openshift-security-profiles
  2. spec 에 webhookOptions 를 추가합니다. spec 섹션을 찾고 다음 webhookOptions 블록을 추가하여 Webhook가 특정 네임스페이스에 적용되도록 지시합니다.

    spec:
      webhookOptions:
        - name: execmetadata.spo.io # or nodedebuggingpod.spo.io
          namespaceSelector:
          #...add rules

    변경 사항을 저장하면 Operator에서 변경 웹 후크를 재구성하여 요청 세부 정보를 클러스터 전체에서 oc exec 세션으로 전달할 수 있습니다.

7.9.17. 변경 웹 후크 사용

고급 감사 로깅이 클러스터 사용자와 oc exec,oc rsh, oc debug 세션의 작업과 상관 관계를 유지할 수 있도록 변경 웹 후크를 사용합니다.

변경 웹 후크는 SPO_EXEC_REQUEST_UID 환경 변수를 exec 요청에 삽입합니다. 컨테이너가 해당 이름으로 변수를 이미 정의하면 삽입된 값이 exec 세션에 대해 재정의됩니다.

kubectl debug node/<node_name >을 사용하는 경우 nodedebuggingpod.spo.io 웹 후크는 SPO_EXEC_REQUEST_UID 를 디버그 Pod에 삽입합니다.

7.9.17.1. 디버그 Pod

이 Webhook는 주로 kubectl 디버그 Pod를 kubectl 클라이언트에 의해 추가된 app.kubernetes.io/managed-by: kubectl-debug 로 식별합니다. 이 레이블은 OpenShift Container Platform의 oc debug 가 debug.openshift.io/managed-by: oc-debug 를 사용하는 방법과 같이 다양한 Kubernetes 클라이언트 구현에 따라 달라질 수 있으므로 웹 후크가 모든 관련 디버그 Pod를 캡처하도록 추가 webhookOptions 를 구성해야 할 수 있습니다.

예를 들어 oc debug pod를 추가하려면 다음 yaml 을 사용합니다.

# ... (rest of your spod configuration)
spec:
  webhookOptions:
    - name: nodedebuggingpodmetada.spo.io
      objectSelector:
        matchLabels: # Use matchLabels for exact matching
          debug.openshift.io/managed-by: "oc-debug"
# ... (other webhook rule details such as rules, clientConfig, etc.)

7.9.18. 고급 감사 로깅 비활성화

테스트 Pod, seccompProfile, JSON Log Enricher를 삭제하고 모든 spod Pod 옵션을 재설정하여 고급 감사 로깅을 비활성화하고 모든 구성을 되돌릴 수 있습니다.

프로세스

  1. 다음 명령을 사용하여 테스트 Pod를 삭제합니다.

    oc delete pod my-pod
  2. 다음 명령을 사용하여 seccompProfile 을 삭제합니다.

    oc delete seccompprofile profile1 -n openshift-security-profiles
  3. JSON Log Enricher를 비활성화하고 모든 옵션을 재설정합니다.

    oc patch spod spod -n openshift-security-profiles --type merge -p '{ "spec": { "enableJsonEnricher": false, "jsonEnricherOptions": { "auditLogPath": "", "auditLogMaxSize": 0, "auditLogMaxBackups": 0, "auditLogMaxAge": 0, "auditLogIntervalSeconds": 0 } }}'
  4. spod Pod가 다시 시작될 때까지 기다립니다. 다음 명령을 실행하여 확인합니다.

    oc get pods -n openshift-security-profiles -l name=spod -w

    모든 spod Pod가 Running 이 표시될 때까지 기다립니다.

  5. 다음 명령을 사용하여 ConfigMap 볼륨 패치를 되돌립니다.

    oc patch configmap security-profiles-operator-profile -n openshift-security-profiles --type merge -p '{"data":{"patch-volume-source.json":""}}'
  6. 구성이 성공적으로 업데이트되었는지 확인합니다.

    oc get spod spod -n openshift-security-profiles -o jsonpath='{.spec.enableJsonEnricher}'

    예상 출력:

    false

7.10. Security Profiles Operator 문제 해결

Security Profiles Operator의 문제를 해결하여 문제를 진단하거나 버그 보고서에 정보를 제공합니다.

7.10.1. seccomp 프로필 검사

손상된 seccomp 프로필로 인해 워크로드가 손상될 수 있습니다. 다른 워크로드가 경로 /var/lib/kubelet/seccomp/operator 의 일부를 매핑할 수 없으므로 사용자가 시스템을 악용할 수 없는지 확인합니다.

절차

  1. 다음 명령을 실행하여 프로필이 조정되었는지 확인합니다.

    $ oc -n openshift-security-profiles logs openshift-security-profiles-<id>

    출력 예

    I1019 19:34:14.942464       1 main.go:90] setup "msg"="starting openshift-security-profiles"  "buildDate"="2020-10-19T19:31:24Z" "compiler"="gc" "gitCommit"="a3ef0e1ea6405092268c18f240b62015c247dd9d" "gitTreeState"="dirty" "goVersion"="go1.15.1" "platform"="linux/amd64" "version"="0.2.0-dev"
    I1019 19:34:15.348389       1 listener.go:44] controller-runtime/metrics "msg"="metrics server is starting to listen"  "addr"=":8080"
    I1019 19:34:15.349076       1 main.go:126] setup "msg"="starting manager"
    I1019 19:34:15.349449       1 internal.go:391] controller-runtime/manager "msg"="starting metrics server"  "path"="/metrics"
    I1019 19:34:15.350201       1 controller.go:142] controller "msg"="Starting EventSource" "controller"="profile" "reconcilerGroup"="security-profiles-operator.x-k8s.io" "reconcilerKind"="SeccompProfile" "source"={"Type":{"metadata":{"creationTimestamp":null},"spec":{"defaultAction":""}}}
    I1019 19:34:15.450674       1 controller.go:149] controller "msg"="Starting Controller" "controller"="profile" "reconcilerGroup"="security-profiles-operator.x-k8s.io" "reconcilerKind"="SeccompProfile"
    I1019 19:34:15.450757       1 controller.go:176] controller "msg"="Starting workers" "controller"="profile" "reconcilerGroup"="security-profiles-operator.x-k8s.io" "reconcilerKind"="SeccompProfile" "worker count"=1
    I1019 19:34:15.453102       1 profile.go:148] profile "msg"="Reconciled profile from SeccompProfile" "namespace"="openshift-security-profiles" "profile"="nginx-1.19.1" "name"="nginx-1.19.1" "resource version"="728"
    I1019 19:34:15.453618       1 profile.go:148] profile "msg"="Reconciled profile from SeccompProfile" "namespace"="openshift-security-profiles" "profile"="openshift-security-profiles" "name"="openshift-security-profiles" "resource version"="729"

  2. 다음 명령을 실행하여 seccomp 프로필이 올바른 경로에 저장되었는지 확인합니다.

    $ oc exec -t -n openshift-security-profiles openshift-security-profiles-<id> \
        -- ls /var/lib/kubelet/seccomp/operator/my-namespace/my-workload

    출력 예

    profile-block.json
    profile-complain.json

7.11. Security Profiles Operator 설치 제거

OpenShift Container Platform 웹 콘솔을 사용하여 클러스터에서 Security Profiles Operator를 제거할 수 있습니다.

7.11.1. 웹 콘솔을 사용하여 Security Profiles Operator 설치 제거

Security Profiles Operator를 제거하려면 먼저 seccomp 및 SELinux 프로필을 삭제해야 합니다. 프로필이 제거되면 openshift-security-profiles 프로젝트를 삭제하여 Operator 및 해당 네임스페이스를 제거할 수 있습니다.

사전 요구 사항

  • cluster-admin 권한이 있는 사용자로 웹 콘솔에 액세스할 수 있습니다.
  • Security Profiles Operator가 설치되어 있습니다.

절차

  1. 에코시스템 설치된 Operator 페이지로 이동합니다.
  2. 모든 seccomp 프로필, SELinux 프로필 및 Webhook 구성을 삭제합니다.
  3. 관리 에코시스템 설치된 Operator 페이지로 전환합니다.
  4. Security Profiles Operator 항목에서 옵션 메뉴 kebab 를 클릭합니다.
  5. Operator 설치 제거를 선택합니다.
  6. 홈 프로젝트 페이지로 전환합니다.
  7. security profiles을 검색합니다.
  8. openshift-security-profiles 프로젝트 옆에 있는 옵션 메뉴 kebab 를 클릭합니다.
  9. Delete Project 를 선택합니다.

    1. 대화 상자에 openshift-security-profiles 를 입력합니다.
    2. 삭제를 클릭합니다.
  10. 다음 명령을 실행하여 MutatingWebhookConfiguration 오브젝트를 삭제합니다.

    $ oc delete MutatingWebhookConfiguration spo-mutating-webhook-configuration
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동