11장. MicroShift 인증 및 보안 구성
11.1. 사용자 정의 인증 기관 구성 링크 복사링크가 클립보드에 복사되었습니다!
MicroShift 기본 API 서버 인증서를 CA(인증 기관)에서 발급한 사용자 지정 서버 인증서로 교체하여 외부 클라이언트와의 연결을 허용하고 암호화할 수 있습니다.
11.1.1. MicroShift API 서버의 사용자 정의 인증 기관 사용 링크 복사링크가 클립보드에 복사되었습니다!
외부 클라이언트가 MicroShift API 서버를 확인하고 암호화된 연결을 유지하려면 기본 내부 인증서를 신뢰할 수 있는 CA(인증 기관)에서 발급한 사용자 지정 서버 인증서로 교체할 수 있습니다.
기본적으로 노드 외부의 클라이언트는 MicroShift-issued API 서버 인증서를 확인할 수 없습니다. 네트워크 전체에서 보안 액세스를 보장하려면 인증서 위치 및 관련 도메인 이름으로 구성 파일을 업데이트해야 합니다.
다음 단계에서는 MicroShift에서 API 서버 인증서 구성을 사용자 정의하는 워크플로를 보여줍니다.
- 인증서와 키를 호스트 운영 체제의 기본 디렉터리에 복사합니다. root 액세스 권한이 있는 파일에만 액세스할 수 있는지 확인합니다.
MicroShift
/etc/microshift/config.yaml구성 파일에 인증서 이름과 FQDN(정규 정규화된 도메인 이름)을 지정하여 각 사용자 정의 CA의 MicroShift 구성을 업데이트합니다.각 인증서 구성에는 다음 값이 포함될 수 있습니다.
- 인증서 파일 위치는 필수 값입니다.
API 서버 DNS 및 IP 주소 또는 IP 주소 범위를 포함하는 일반적인 단일 이름입니다.
작은 정보대부분의 경우 MicroShift는 사용자가 지정하는 IP 주소 또는 범위를 포함하는 사용자 정의 CA에 대한 새
kubeconfig파일을 생성합니다. 예외는 IP 주소에 대한 와일드카드를 지정하는 경우입니다. 이 경우 MicroShift는 서버의 공용 IP 주소를 사용하여kubeconfig파일을 생성합니다. 와일드카드를 사용하려면 특정 세부 정보로kubeconfig파일을 업데이트해야 합니다.- API 서버 DNS 및 IP 주소 또는 와일드카드 인증서를 포함하는 여러 SAN(주체 대체 이름)입니다.
- 각 인증서에 대한 추가 DNS 이름을 나열할 수 있습니다.
-
MicroShift 서비스를 다시 시작한 후 생성된
kubeconfig파일을 클라이언트에 복사해야 합니다. 클라이언트 시스템에서 추가 CA를 구성합니다. 예를 들어 RHEL(Red Hat Enterprise Linux) 신뢰 저장소에서 CA 번들을 업데이트할 수 있습니다.
중요사용자 정의 서버 인증서는 호스트 운영 체제의 trust 루트에 구성된 CA 데이터에 대해 검증해야 합니다. 자세한 내용은 "시스템 전체 신뢰 저장소"를 참조하십시오.
인증서와 키는 호스트의 지정된 파일 위치에서 읽습니다. 클라이언트에서 구성을 테스트하고 검증할 수 있습니다.
- 검증에 실패하면 MicroShift는 사용자 정의 구성을 건너뛰고 기본 인증서를 사용하여 시작합니다. 우선 순위는 서비스를 중단 없이 유지하는 것입니다. 서비스가 시작될 때 MicroShift는 오류를 기록합니다. 일반적인 오류에는 만료된 인증서, 누락된 파일 또는 잘못된 IP 주소가 포함됩니다.
- 외부 서버 인증서는 자동으로 갱신되지 않습니다. 외부 인증서를 수동으로 교체해야 합니다.
11.1.2. 사용자 정의 인증 기관 구성 링크 복사링크가 클립보드에 복사되었습니다!
사용자 정의 인증 기관(CA)을 사용하여 외부에서 생성된 인증서 및 도메인 이름을 구성하려면 MicroShift /etc/microshift/config.yaml 구성 파일에 추가합니다. 호스트 운영 체제 신뢰 루트도 구성해야 합니다.
외부로 생성된 kubeconfig 파일은 /var/lib/microshift/resources/kubeadmin/<hostname>/kubeconfig 디렉터리에 생성됩니다. 외부에서 생성된 구성 외에도 localhost 를 사용해야 하는 경우 기본 위치에 원래 kubeconfig 파일을 유지합니다. localhost kubeconfig 파일은 자체 서명된 인증 기관을 사용합니다.
사전 요구 사항
-
OpenShift CLI(
oc)가 설치되어 있어야 합니다. - 노드에 대한 root 액세스 권한이 있어야 합니다.
- 인증 기관에서 사용자 정의 인증서를 발급했습니다.
-
MicroShift
/etc/microshift/config.yaml설정 파일이 있습니다.
절차
- MicroShift 호스트의 신뢰 루트에 추가할 사용자 정의 인증서를 복사합니다. 인증서 및 개인 키에 MicroShift만 액세스할 수 있는지 확인합니다.
필요한 각 사용자 정의 CA의 경우 다음 예제를 사용하여
namedCertificates라는apiServer섹션을/etc/microshift/config.yamlMicroShift 구성 파일에 추가합니다.apiServer: namedCertificates: - certPath: ~/certs/api_fqdn_1.crt keyPath: ~/certs/api_fqdn_1.key - certPath: ~/certs/api_fqdn_2.crt keyPath: ~/certs/api_fqdn_2.key names: - api_fqdn_1 - *.apps.external.com다음과 같습니다.
apiServer.namedCertificates.certPath- 인증서의 전체 경로를 추가합니다.
apiServer.namedCertificates.keyPath- 인증서 키에 전체 경로를 추가합니다.
apiServer.namedCertificates.names- 선택 사항: 명시적 DNS 이름 목록을 추가합니다. 선행 와일드카드가 허용됩니다. 나열된 이름이 없으면 암시적 이름이 인증서에서 추출됩니다.
MicroShift를 다시 시작하여 다음 명령을 실행하여 인증서를 적용합니다.
$ systemctl microshift restart-
시스템이 다시 시작되고 사용자 지정 서버를 적용할 때까지 몇 분 정도 기다립니다. 새
kubeconfig파일은/var/lib/microshift/resources/kubeadmin/디렉터리에 생성됩니다. -
kubeconfig파일을 클라이언트에 복사합니다. IP 주소에 와일드카드를 지정한 경우kubeconfig를 업데이트하여 서버의 공용 IP 주소를 제거하고 해당 IP 주소를 사용하려는 특정 와일드카드 범위로 바꿉니다. 클라이언트에서 다음 단계를 수행합니다.
다음 명령을 실행하여 사용할
kubeconfig를 지정합니다.$ export KUBECONFIG=~/custom-kubeconfigs/kubeconfig복사된
kubeconfig파일의 위치를 경로로 사용합니다.다음 명령을 사용하여 인증서가 적용되는지 확인합니다.
$ oc --certificate-authority ~/certs/ca.ca get node출력 예
oc get node NAME STATUS ROLES AGE VERSION dhcp-1-235-195.arm.example.com Ready control-plane,master,worker 76m v1.36.3다음 명령을 실행하여 새 CA 파일을 $KUBECONFIG 환경 변수에 추가합니다.
$ oc config set clusters.microshift.certificate-authority /tmp/certificate-authority-data-new.crt다음 명령을 실행하여 새
kubeconfig파일에 새 CA가 포함되어 있는지 확인합니다.$ oc config view --flatten외부에서 생성된
kubeconfig파일의 예apiVersion: v1 clusters: - cluster: certificate-authority: /tmp/certificate-authority-data-new.crt server: https://api.ci-ln-k0gim2b-76ef8.aws-2.ci.openshift.org:6443 name: ci-ln-k0gim2b-76ef8 contexts: - context: cluster: ci-ln-k0gim2b-76ef8 user: name: current-context: kind: Config preferences: {}다음과 같습니다.
clusters.cluster.certificate-authority-
certificate-authority-data섹션은 외부에서 생성된kubeconfig파일에 존재하지 않습니다. 이전에 사용된oc config set명령을 사용하여 추가됩니다.
다음 명령을 실행하여 사용자 지정 API 서버 인증 기관의
subject및issuer를 확인합니다.$ curl --cacert /tmp/caCert.pem https://${fqdn_name}:6443/healthz -v출력 예
Server certificate: subject: CN=kas-test-cert_server start date: Mar 12 11:39:46 2024 GMT expire date: Mar 12 11:39:46 2025 GMT subjectAltName: host "dhcp-1-235-3.arm.eng.rdu2.redhat.com" matched cert's "dhcp-1-235-3.arm.eng.rdu2.redhat.com" issuer: CN=kas-test-cert_ca SSL certificate verify ok.중요생성된
kubeconfig파일의certificate-authority-data를 새rootCA로 교체하거나 운영 체제의 신뢰 루트에certificate-authority-data를 추가합니다. 두 가지 방법을 모두 사용하지 마십시오.운영 체제의 신뢰 루트에 추가 CA를 구성합니다. 예를 들어 클라이언트 시스템의 RHEL 클라이언트 신뢰 저장소에서 다음을 수행합니다. 시스템 전체 신뢰 저장소.
- CA가 포함된 구성으로 인증서 번들을 업데이트하는 것이 좋습니다.
-
인증서 번들을 구성하지 않으려면
oc login localhost:8443 --certificate-authority=/path/to/cert.crt명령을 대신 사용할 수 있지만 이 방법은 권장되지 않습니다.
11.1.3. 사용자 정의 인증서 예약 이름 값 링크 복사링크가 클립보드에 복사되었습니다!
인증서 문제로 인해 MicroShift가 인증서를 동적으로 무시하고 오류를 기록합니다. 다음과 같은 이유로 문제가 발생할 수 있습니다.
- 인증서 파일이 디스크에 존재하지 않거나 읽을 수 없습니다.
- 인증서를 작성할 수 없습니다.
-
인증서는 SAN(
SubjectAlternativeNames) 필드의 내부 인증서 IP 주소 또는 DNS 이름을 재정의합니다. SAN을 구성할 때 예약된 이름을 사용하지 마십시오.
| address | 유형 | 댓글 |
|---|---|---|
|
| DNS | |
|
| IP 주소 | |
|
| IP 주소 | 노드 네트워크 |
|
| IP 주소 | 서비스 네트워크 |
| 169.254.169.2/29 | IP 주소 | br-ex 네트워크 |
|
| DNS | |
|
| DNS | |
|
| DNS |
11.1.4. 사용자 정의 인증서 문제 해결 링크 복사링크가 클립보드에 복사되었습니다!
사용자 정의 인증서 구현 문제를 해결하려면 다음 단계를 수행할 수 있습니다.
절차
MicroShift에서 인증서가
kube-apiserver에서 제공되었는지 확인하고 다음 명령을 실행하여 인증서 경로가--tls-sni-cert-keyFLAG에 추가되었는지 확인합니다.$ journalctl -u microshift -b0 | grep tls-sni-cert-key출력 예
Jan 24 14:53:00 localhost.localdomain microshift[45313]: kube-apiserver I0124 14:53:00.649099 45313 flags.go:64] FLAG: --tls-sni-cert-key="[/home/eslutsky/dev/certs/server.crt,/home/eslutsky/dev/certs/server.key;/var/lib/microshift/certs/kube-apiserver-external-signer/kube-external-serving/server.crt,/var/lib/microshift/certs/kube-apiserver-external-signer/kube-external-serving/server.key;/var/lib/microshift/certs/kube-apiserver-localhost-signer/kube-apiserver-localhost-serving/server.crt,/var/lib/microshift/certs/kube-apiserver-localhost-signer/kube-apiserver-localhost-serving/server.key;/var/lib/microshift/certs/kube-apiserver-service-network-signer/kube-apiserver-service-network-serving/server.crt,/var/lib/microshift/certs/kube-apiserver-service-network-signer/kube-apiserver-service-network-serving/server.key클라이언트에서 다음 명령을 실행하여
kube-apiserver가 올바른 인증서를 제공하고 있는지 확인합니다.$ openssl s_client -connect <SNI_ADDRESS>:6443 -showcerts | openssl x509 -text -noout -in - | grep -C 1 "Alternative\|CN"
11.1.5. 사용자 정의 인증서 정리 및 다시 생성 링크 복사링크가 클립보드에 복사되었습니다!
MicroShift 서비스를 중지하고 사용자 지정 인증서를 정리한 후 사용자 지정 인증서를 다시 생성하여 시스템에서 최신 인증서 데이터를 사용하도록 할 수 있습니다.
절차
MicroShift 서비스를 중지하고 다음 명령을 실행하여 사용자 지정 인증서를 정리합니다.
$ sudo microshift-cleanup-data --cert출력 예
Stopping MicroShift services Removing MicroShift certificates MicroShift service was stopped Cleanup succeeded다음 명령을 실행하여 MicroShift 서비스를 다시 시작하여 사용자 정의 인증서를 다시 생성합니다.
$ sudo systemctl start microshift