4.2. 인증을 위한 구성 요소 범위 프록시 구성
Authentication Operator 리소스에서 spec.proxy 필드를 설정하여 인증 스택에 대한 구성 요소 범위 프록시를 구성할 수 있습니다.
사전 요구 사항
- 클러스터 관리자 권한이 있어야 합니다.
-
OpenShift CLI(
oc)가 설치되어 있습니다. -
jqCLI 툴을 설치했습니다. -
AuthenticationComponentProxy기능 게이트는TechPreviewNoUpgrade또는DevPreviewNoUpgrade기능 세트를 적용하여 활성화됩니다. 자세한 내용은 "기능 게이트를 사용하여 기능 활성화"를 참조하십시오. - 클러스터 노드에서 액세스할 수 있는 작동 중인 HTTP 또는 HTTPS 프록시 서버가 있어야 합니다.
절차
선택 사항: 프록시에 사용자 정의 CA 인증서가 필요한 경우 CA 번들이 포함된
openshift-config네임스페이스에 구성 맵을 생성합니다.다음 콘텐츠를 사용하여
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여야 합니다.
다음 명령을 실행하여 구성 맵을 생성합니다.
$ 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 인증서 파일의 경로를 지정합니다.
다음 명령을 실행하여 프록시 구성을 추가하도록
AuthenticationOperator 리소스를 편집합니다.$ oc edit authentication.operator.openshift.io cluster프록시 설정으로
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 구성 맵을 생성하지 않은 경우 이 블록을 생략합니다.
- 파일을 저장하여 변경 사항을 적용합니다.
검증
다음 명령을 실행하여 구성이 수락되었는지 확인합니다.
$ 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 10mAVAILABLE열에True가 표시되고DEGRADED열에False가 표시됩니다.선택 사항: 다음 명령을 실행하여 프록시를 통해 인증을 테스트합니다.
$ oc login
프록시 URL을 변경하면 OAuth 서버 재배포가 트리거됩니다. 단일 노드 OpenShift Container Platform 배포 시 간단한 인증 중단이 발생합니다. trustedCA 구성 맵 콘텐츠에 대한 업데이트는 재배포 없이 핫로드됩니다.
프록시가 잘못 구성되면 OAuth 서버가 ID 공급자에 도달하지 못하도록 모든 사용자를 클러스터 외부에서 잠글 수 있습니다. 복구하려면 OAuth를 바이패스하는 kubeadmin 자격 증명 또는 클라이언트 인증서 인증을 사용하여 로그인하고 프록시 구성을 수정합니다.