4.2. 인증을 위한 구성 요소 범위 프록시 구성


Authentication Operator 리소스에서 spec.proxy 필드를 설정하여 인증 스택에 대한 구성 요소 범위 프록시를 구성할 수 있습니다.

사전 요구 사항

  • 클러스터 관리자 권한이 있어야 합니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.
  • jq CLI 툴을 설치했습니다.
  • AuthenticationComponentProxy 기능 게이트는 TechPreviewNoUpgrade 또는 DevPreviewNoUpgrade 기능 세트를 적용하여 활성화됩니다. 자세한 내용은 "기능 게이트를 사용하여 기능 활성화"를 참조하십시오.
  • 클러스터 노드에서 액세스할 수 있는 작동 중인 HTTP 또는 HTTPS 프록시 서버가 있어야 합니다.

절차

  1. 선택 사항: 프록시에 사용자 정의 CA 인증서가 필요한 경우 CA 번들이 포함된 openshift-config 네임스페이스에 구성 맵을 생성합니다.

    1. 다음 콘텐츠를 사용하여 auth-proxy-ca-bundle.yaml 이라는 파일을 생성합니다.

      apiVersion: v1
      kind: ConfigMap
      metadata:
        name: auth-proxy-ca-bundle
        namespace: openshift-config
      data:
        ca-bundle.crt: |
          -----BEGIN CERTIFICATE-----
          <PEM_encoded_CA_certificate>
          -----END CERTIFICATE-----
      name
      구성 맵 이름을 지정합니다. spec.proxy.trustedCA.name 필드에서 이 이름을 사용합니다.
      네임스페이스
      네임스페이스를 지정합니다. openshift-config 여야 합니다.
      ca-bundle.crt
      Privacy-Enhanced mail (PEM) 인코딩 CA 인증서 번들을 지정합니다. 키는 ca-bundle.crt 여야 합니다.
    2. 다음 명령을 실행하여 구성 맵을 생성합니다.

      $ oc create -f auth-proxy-ca-bundle.yaml

      또는 CA 인증서 파일이 이미 있는 경우 다음 명령을 실행하여 구성 맵을 직접 생성할 수 있습니다.

      $ oc create configmap auth-proxy-ca-bundle \
        --from-file=ca-bundle.crt=<path_to_ca_certificate> \
        -n openshift-config
      <path_to_ca_certificate>
      PEM 인코딩 CA 인증서 파일의 경로를 지정합니다.
  2. 다음 명령을 실행하여 프록시 구성을 추가하도록 Authentication Operator 리소스를 편집합니다.

    $ oc edit authentication.operator.openshift.io cluster
  3. 프록시 설정으로 spec.proxy 필드를 추가합니다.

    apiVersion: operator.openshift.io/v1
    kind: Authentication
    metadata:
      name: cluster
    spec:
      managementState: Managed
      proxy:
        httpProxy: "http://proxy.example.com:3128"
        httpsProxy: "http://proxy.example.com:3128"
        noProxy:
          - ".example.com"
          - "idp.internal.example.com"
        trustedCA:
          name: "auth-proxy-ca-bundle"
    httpProxy
    HTTP 요청에 대한 프록시 URL을 지정합니다. httpProxy 또는 httpsProxy 중 하나 이상이 필요합니다.
    httpsProxy
    HTTPS 요청에 대한 프록시 URL을 지정합니다. httpProxy 또는 httpsProxy 중 하나 이상이 필요합니다.
    noProxy
    프록시를 바이패스하는 호스트 이름, 도메인, CIDR 범위 또는 IP 주소를 지정합니다. cluster-internal 기본값(.cluster.local,.svc,127.0.0.1, Kubernetes API 서비스 IP 및 localhost)이 자동으로 추가됩니다. 최대 64개의 항목입니다.
    trustedCA
    ca-bundle.crt 키 아래에 프록시 CA 번들이 포함된 openshift-config 의 구성 맵 이름을 지정합니다. 프록시에서 TLS 인터셉션 또는 개인 CA를 사용하는 경우에만 필요합니다. 1단계에서 CA 구성 맵을 생성하지 않은 경우 이 블록을 생략합니다.
  4. 파일을 저장하여 변경 사항을 적용합니다.

검증

  • 다음 명령을 실행하여 구성이 수락되었는지 확인합니다.

    $ oc get authentication.operator.openshift.io cluster -o jsonpath='{.spec.proxy}' | jq .

    출력 예

    {
      "httpProxy": "http://proxy.example.com:3128",
      "httpsProxy": "http://proxy.example.com:3128",
      "noProxy": [
        ".example.com",
        "idp.internal.example.com"
      ],
      "trustedCA": {
        "name": "auth-proxy-ca-bundle"
      }
    }

  • 다음 명령을 실행하여 인증 운영자가 오류를 보고하지 않는지 확인합니다.

    $ oc get clusteroperator authentication

    출력 예

    NAME             VERSION   AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
    authentication   {product-version}.0     True        False         False      10m

    AVAILABLE 열에 True 가 표시되고 DEGRADED 열에 False 가 표시됩니다.

  • 선택 사항: 다음 명령을 실행하여 프록시를 통해 인증을 테스트합니다.

    $ oc login

프록시 URL을 변경하면 OAuth 서버 재배포가 트리거됩니다. 단일 노드 OpenShift Container Platform 배포 시 간단한 인증 중단이 발생합니다. trustedCA 구성 맵 콘텐츠에 대한 업데이트는 재배포 없이 핫로드됩니다.

주의

프록시가 잘못 구성되면 OAuth 서버가 ID 공급자에 도달하지 못하도록 모든 사용자를 클러스터 외부에서 잠글 수 있습니다. 복구하려면 OAuth를 바이패스하는 kubeadmin 자격 증명 또는 클라이언트 인증서 인증을 사용하여 로그인하고 프록시 구성을 수정합니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

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

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

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동