22장. 클라우드 공급자 인증 정보 관리
22.1. Cloud Credential Operator 정보 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 구성 요소가 클러스터를 실행하는 데 필요한 특정 권한으로 클라우드 공급자 인증 정보를 요청할 수 있도록 CCO(Cloud Credential Operator)를 사용하여 클라우드 공급자 인증 정보를 CRD(사용자 정의 리소스 정의)로 관리할 수 있습니다.
다양한 모드에서 작동하도록 CCO(Cloud Credential Operator)를 구성할 수 있습니다. 이러한 옵션은 CCO에서 클라우드 인증 정보를 사용하는 방법에 투명성과 유연성을 제공합니다.
22.1.1. Cloud Credential Operator 모드 정보 링크 복사링크가 클립보드에 복사되었습니다!
다양한 모드에서 작동하도록 CCO(Cloud Credential Operator)를 구성할 수 있습니다. 이러한 옵션은 CCO에서 클라우드 인증 정보를 사용하여 클러스터의 CredentialsRequest CR을 처리하여 조직의 보안 요구 사항에 맞게 투명성과 유연성을 제공합니다.
install-config.yaml 파일에서 credentialsMode 매개변수의 다른 값을 설정하면 mint,passthrough 또는 manual 모드에서 작동하도록 CCO를 구성할 수 있습니다.
- Mint: Mint 모드에서 CCO는 제공된 관리자 수준 클라우드 인증 정보를 사용하여 필요한 특정 권한만으로 클러스터의 구성 요소에 대한 새 인증 정보를 생성합니다.
- passthrough : passthrough 모드에서 CCO는 제공된 클라우드 인증 정보를 클라우드 인증 정보를 요청하는 구성 요소에 전달합니다.
- 구성 요소에 대한 장기 인증 정보가 있는 수동 모드: 수동 모드에서 CCO 대신 장기 클라우드 인증 정보를 관리할 수 있습니다.
-
구성 요소에 대한 단기 인증 정보가 있는 수동 모드: 일부 공급자의 경우 설치 중에 CCO 유틸리티(
ccoctl)를 사용하여 개별 구성 요소에 대한 단기 인증 정보를 구현할 수 있습니다. 이러한 인증 정보는 OpenShift Container Platform 클러스터 외부에서 생성 및 관리됩니다.
모드가 지정되지 않거나 credentialsMode 매개변수가 빈 문자열("")로 설정된 경우 CCO는 기본 모드에서 작동합니다.
다음 표에 설명된 대로 모든 클라우드 공급자에 대해 모든 CCO 모드가 지원되는 것은 아닙니다.
| 클라우드 공급자 | Mint | Passthrough | 장기 인증 정보가 있는 수동 | 단기 인증 정보가 있는 수동 |
|---|---|---|---|---|
| AWS(Amazon Web Services) | X | X | X | X |
| Global Microsoft Azure | X | X | X | |
| Microsoft Azure Stack Hub | X | |||
| Google Cloud | X | X | X | X |
| IBM Cloud® | X [1] | |||
| Nutanix | X [1] | |||
| Red Hat OpenStack Platform (RHOSP) | X | |||
| VMware vSphere | X |
-
이 플랫폼은 설치 중에
ccoctl유틸리티를 사용하여 장기 인증 정보를 구성합니다.
22.1.2. Cloud Credential Operator 모드 확인 링크 복사링크가 클립보드에 복사되었습니다!
여러 모드에서 CCO 사용을 지원하는 플랫폼의 경우 웹 콘솔 또는 CLI를 사용하여 CCO가 사용하도록 구성된 모드를 결정할 수 있습니다.
그림 22.1. CCO 구성 확인
22.1.2.1. 웹 콘솔을 사용하여 Cloud Credential Operator 모드 확인 링크 복사링크가 클립보드에 복사되었습니다!
웹 콘솔을 사용하여 CCO(Cloud Credential Operator)가 사용하도록 구성된 모드를 확인할 수 있습니다.
업그레이드 또는 문제 해결을 수행하기 전에 클러스터의 인증 정보 관리 구성을 이해해야 합니다.
AWS(Amazon Web Services), 글로벌 Microsoft Azure 및 Google Cloud 클러스터만 여러 CCO 모드를 지원합니다.
사전 요구 사항
- 클러스터 관리자 권한이 있는 OpenShift Container Platform 계정에 액세스할 수 있습니다.
프로세스
-
cluster-admin역할의 사용자로 OpenShift Container Platform 웹 콘솔에 로그인합니다. -
관리
클러스터 설정으로 이동합니다. - 클러스터 설정 페이지에서 구성 탭을 선택합니다.
- 구성 리소스에서 클라우드 인을 선택합니다.
- 클라우드 인증 세부 정보 페이지에서 YAML 탭을 선택합니다.
YAML 블록에서
spec.credentialsMode의 값을 확인합니다. 다음 값이 모든 플랫폼에서 지원되지는 않지만 모두 지원되는 것은 아닙니다.-
'': CCO가 기본 모드에서 작동합니다. 이 구성에서 CCO는 설치 중에 제공된 인증 정보에 따라 Mint 또는 passthrough 모드에서 작동합니다. -
Mint: CCO가 Mint 모드에서 작동합니다. -
passthrough: CCO가 passthrough 모드에서 작동합니다. -
Manual: CCO가 수동 모드에서 작동합니다.
중요'',Mint또는Manual의spec.credentialsMode가 있는 AWS, Google Cloud 또는 글로벌 Microsoft Azure 클러스터의 특정 구성을 확인하려면 추가 조사를 수행해야 합니다.AWS 및 Google Cloud 클러스터는 루트 시크릿이 삭제된 mint 모드 사용을 지원합니다.
수동 모드를 사용하는 AWS, Google Cloud 또는 글로벌 Microsoft Azure 클러스터는 AWS STS, Google Cloud Workload Identity 또는 Microsoft Entra Workload ID를 사용하여 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하도록 구성할 수 있습니다. 클러스터
Authentication오브젝트를 검사하여 클러스터에서 이 전략을 사용하는지 확인할 수 있습니다.-
기본(
'')만 사용하는 AWS 또는 Google Cloud 클러스터: 클러스터가 Mint 또는 passthrough 모드에서 작동하는지 확인하려면 클러스터 루트 시크릿의 주석을 검사합니다.워크로드
시크릿 으로 이동하여 클라우드 공급자의 루트 시크릿을 찾습니다. 참고프로젝트 드롭다운이 모든 프로젝트로 설정되어 있는지 확인합니다.
플랫폼 시크릿 이름 AWS
aws-credsGoogle Cloud
gcp-credentials클러스터가 사용 중인 CCO 모드를 보려면 주석 에서
1 annotation을 클릭하고 값 필드를 확인합니다. 다음 값을 사용할 수 있습니다.-
Mint: CCO가 Mint 모드에서 작동합니다. -
passthrough: CCO가 passthrough 모드에서 작동합니다.
클러스터에서 Mint 모드를 사용하는 경우 루트 시크릿 없이 클러스터가 작동하는지 확인할 수도 있습니다.
-
Mint 모드를 사용하는 AWS 또는 Google Cloud 클러스터: 루트 시크릿 없이 클러스터가 작동하는지 확인하려면 워크로드
시크릿으로 이동하여 클라우드 공급자의 루트 시크릿을 찾습니다. 참고프로젝트 드롭다운이 모든 프로젝트로 설정되어 있는지 확인합니다.
플랫폼 시크릿 이름 AWS
aws-credsGoogle Cloud
gcp-credentials- 이러한 값 중 하나가 표시되면 클러스터에서 root 시크릿이 있는 mint 또는 passthrough 모드를 사용하는 것입니다.
- 이러한 값이 표시되지 않으면 클러스터는 루트 시크릿이 제거된 Mint 모드에서 CCO를 사용하는 것입니다.
AWS, Google Cloud 또는 수동 모드를 사용하는 글로벌 Microsoft Azure 클러스터: 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하도록 클러스터가 구성되었는지 확인하려면 클러스터
인증오브젝트 YAML 값을 확인해야 합니다.-
관리
클러스터 설정으로 이동합니다. - 클러스터 설정 페이지에서 구성 탭을 선택합니다.
- 구성 리소스에서 인증을 선택합니다.
- 인증 세부 정보 페이지에서 YAML 탭을 선택합니다.
YAML 블록에서
.spec.serviceAccountIssuer매개변수 값을 확인합니다.-
클라우드 공급자와 연결된 URL이 포함된 값은 CCO가 구성 요소에 대한 단기 인증 정보가 있는 수동 모드를 사용하고 있음을 나타냅니다. 이러한 클러스터는 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하는 데
ccoctl유틸리티를 사용하여 구성됩니다. -
빈 값(
'')은 클러스터가 수동 모드에서 CCO를 사용하고 있지만ccoctl유틸리티를 사용하여 구성되지 않았음을 나타냅니다.
-
클라우드 공급자와 연결된 URL이 포함된 값은 CCO가 구성 요소에 대한 단기 인증 정보가 있는 수동 모드를 사용하고 있음을 나타냅니다. 이러한 클러스터는 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하는 데
-
관리
22.1.2.2. CLI를 사용하여 Cloud Credential Operator 모드 확인 링크 복사링크가 클립보드에 복사되었습니다!
CLI를 사용하여 CCO(Cloud Credential Operator)가 사용하도록 구성된 모드를 확인할 수 있습니다.
업그레이드 또는 문제 해결을 수행하기 전에 클러스터의 인증 정보 관리 구성을 이해해야 합니다.
AWS(Amazon Web Services), 글로벌 Microsoft Azure 및 Google Cloud 클러스터만 여러 CCO 모드를 지원합니다.
사전 요구 사항
- 클러스터 관리자 권한이 있는 OpenShift Container Platform 계정에 액세스할 수 있습니다.
-
OpenShift CLI(
oc)가 설치되어 있습니다.
프로세스
-
cluster-admin역할의 사용자로 클러스터에서oc에 로그인합니다. CCO가 사용하도록 구성된 모드를 결정하려면 다음 명령을 입력합니다.
$ oc get cloudcredentials cluster \ -o=jsonpath={.spec.credentialsMode}다음 출력 값을 사용할 수 있지만 모든 플랫폼에서 모두 지원되는 것은 아닙니다.
-
'': CCO가 기본 모드에서 작동합니다. 이 구성에서 CCO는 설치 중에 제공된 인증 정보에 따라 Mint 또는 passthrough 모드에서 작동합니다. -
Mint: CCO가 Mint 모드에서 작동합니다. -
passthrough: CCO가 passthrough 모드에서 작동합니다. -
Manual: CCO가 수동 모드에서 작동합니다.
중요'',Mint또는Manual의spec.credentialsMode가 있는 AWS, Google Cloud 또는 글로벌 Microsoft Azure 클러스터의 특정 구성을 확인하려면 추가 조사를 수행해야 합니다.AWS 및 Google Cloud 클러스터는 루트 시크릿이 삭제된 mint 모드 사용을 지원합니다.
수동 모드를 사용하는 AWS, Google Cloud 또는 글로벌 Microsoft Azure 클러스터는 AWS STS, Google Cloud Workload Identity 또는 Microsoft Entra Workload ID를 사용하여 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하도록 구성할 수 있습니다. 클러스터
Authentication오브젝트를 검사하여 클러스터에서 이 전략을 사용하는지 확인할 수 있습니다.-
기본(')만 사용하는 AWS 또는 Google Cloud 클러스터: 클러스터가 Mint 또는 passthrough 모드에서 작동하는지 확인하려면 다음 명령을 실행합니다.
$ oc get secret <secret_name> \ -n kube-system \ -o jsonpath \ --template '{ .metadata.annotations }'여기서 &
lt;secret_name>은 AWS의aws-creds또는 Google Cloud의gcp-credentials입니다.이 명령은 클러스터 루트 시크릿 오브젝트에
.metadata.annotations매개변수 값을 표시합니다. 다음 출력 값을 사용할 수 있습니다.-
Mint: CCO가 Mint 모드에서 작동합니다. -
passthrough: CCO가 passthrough 모드에서 작동합니다.
클러스터에서 Mint 모드를 사용하는 경우 루트 시크릿 없이 클러스터가 작동하는지 확인할 수도 있습니다.
-
mint 모드를 사용하는 AWS 또는 Google Cloud 클러스터: 루트 시크릿 없이 클러스터가 작동하는지 확인하려면 다음 명령을 실행합니다.
$ oc get secret <secret_name> \ -n=kube-system여기서 &
lt;secret_name>은 AWS의aws-creds또는 Google Cloud의gcp-credentials입니다.루트 시크릿이 있으면 이 명령의 출력에서 보안에 대한 정보를 반환합니다. root 보안이 클러스터에 존재하지 않음을 나타내는 오류가 있습니다.
AWS, Google Cloud 또는 수동 모드를 사용하는 글로벌 Microsoft Azure 클러스터: 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하도록 클러스터가 구성되었는지 확인하려면 다음 명령을 실행합니다.
$ oc get authentication cluster \ -o jsonpath \ --template='{ .spec.serviceAccountIssuer }'이 명령은 클러스터
Authentication오브젝트에서.spec.serviceAccountIssuer매개변수 값을 표시합니다.-
클라우드 공급자와 연결된 URL의 출력은 CCO가 구성 요소에 대한 단기 인증 정보가 있는 수동 모드를 사용하고 있음을 나타냅니다. 이러한 클러스터는 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하는 데
ccoctl유틸리티를 사용하여 구성됩니다. -
빈 출력은 클러스터가 수동 모드에서 CCO를 사용하고 있지만
ccoctl유틸리티를 사용하여 구성되지 않았음을 나타냅니다.
-
클라우드 공급자와 연결된 URL의 출력은 CCO가 구성 요소에 대한 단기 인증 정보가 있는 수동 모드를 사용하고 있음을 나타냅니다. 이러한 클러스터는 클러스터 외부에서 클라우드 인증 정보를 생성하고 관리하는 데
22.1.3. Cloud Credential Operator 기본 동작 정보 링크 복사링크가 클립보드에 복사되었습니다!
클라우드 인증 정보를 더 잘 관리하려면 Cloud Credential Operator의 기본 동작을 숙지해야 합니다.
여러 모드가 지원되는 플랫폼(AWS, Azure 및 Google Cloud)의 경우 CCO가 기본 모드에서 작동할 때 CredentialsRequest CR을 처리하기에 충분한 모드를 결정하기 위해 제공된 인증 정보를 동적으로 확인합니다.
기본적으로 CCO는 인증 정보가 기본 작동 모드인 mint 모드에 충분한지 결정하고 해당 인증 정보를 사용하여 클러스터의 구성 요소에 적절한 인증 정보를 생성합니다. 인증 정보가 Mint 모드에 충분하지 않으면 passthrough 모드에 충분한지 여부를 결정합니다. 인증 정보가 passthrough 모드에 충분하지 않으면 CCO에서 CredentialsRequest CR을 적절하게 처리할 수 없습니다.
설치 중에 제공된 인증 정보가 충분하지 않다고 판단되면 설치에 실패합니다. AWS의 경우 설치 프로그램이 프로세스 초기에 실패하고 필요한 권한이 누락된 것을 나타냅니다. 다른 공급자는 오류가 발생할 때까지 오류 발생 원인에 대한 구체적인 정보를 제공하지 않을 수 있습니다.
성공적인 설치 후 인증 정보가 변경되고 CCO가 새 인증 정보가 충분하지 않다고 판단하면 CCO에서 새 CredentialsRequest CR에 조건을 배치하여 충분하지 않은 인증 정보로 인해 이를 처리할 수 없음을 나타냅니다.
충분하지 않은 인증 정보 문제를 해결하려면 충분한 권한이 있는 인증 정보를 제공하십시오. 설치 중에 오류가 발생한 경우 다시 설치해보십시오. 새로운 CredentialsRequest CR 문제의 경우 CCO가 CR을 다시 처리할 때까지 기다립니다. 또는 클라우드 공급자에 지원되는 다른 CCO 모드를 사용하도록 클러스터를 구성할 수 있습니다.
22.2. Mint 모드의 Cloud Credential Operator 정보 링크 복사링크가 클립보드에 복사되었습니다!
Mint 모드에서 CCO(Cloud Credential Operator)를 사용하여 클러스터의 구성 요소에 대한 인증 정보를 생성하고 조정할 수 있습니다.
Mint 모드는 이를 지원하는 플랫폼의 OpenShift Container Platform의 기본 CCO 인증 정보 모드입니다. Mint 모드는 AWS(Amazon Web Services) 및 Google Cloud 클러스터를 지원합니다.
22.2.1. Mint 모드 인증 정보 관리 정보 링크 복사링크가 클립보드에 복사되었습니다!
mint 모드에서 CCO(Cloud Credential Operator)를 사용하는 경우 CCO에서 공급자 인증 정보를 사용하는 방법을 숙지해야 합니다.
mint 모드에서 CCO를 사용하는 클러스터의 경우 관리자 수준 인증 정보는 kube-system 네임스페이스에 저장됩니다. CCO는 admin 인증 정보를 사용하여 클러스터의 CredentialsRequest 오브젝트를 처리하고 제한된 권한으로 구성 요소에 대한 사용자를 생성합니다.
mint 모드를 사용하면 각 클러스터 구성 요소에 필요한 특정 권한만 있습니다. 클라우드 인증 정보 조정은 자동 및 연속이므로 구성 요소가 추가 인증 정보 또는 권한이 필요한 작업을 수행할 수 있습니다.
예를 들어 마이너 버전 클러스터 업데이트(예: OpenShift Container Platform 4.22에서 5.0으로 업데이트)에는 클러스터 구성 요소에 대한 업데이트된 CredentialsRequest 리소스가 포함될 수 있습니다. Mint 모드에서 작동하는 CCO는 admin 인증 정보를 사용하여 CredentialsRequest 리소스를 처리하고 업데이트된 인증 요구 사항을 충족하기 위해 제한된 권한이 있는 사용자를 생성합니다.
기본적으로 mint 모드에서는 클러스터 kube-system 네임스페이스에 관리자 인증 정보를 저장해야 합니다. 이 방법이 조직의 보안 요구 사항을 충족하지 않는 경우 클러스터를 설치한 후 인증 정보를 제거할 수 있습니다. 자세한 내용은 "클라우드 공급자 인증 정보 제거"를 참조하십시오.
22.2.1.1. Mint 모드 권한 요구 사항 정보 링크 복사링크가 클립보드에 복사되었습니다!
Mint 모드에서 CCO(Cloud Credential Operator)를 사용하는 경우 제공한 인증 정보가 OpenShift Container Platform을 실행하거나 설치하는 클라우드의 요구 사항을 충족하는지 확인합니다. 제공된 인증 정보가 mint 모드에 충분하지 않으면 CCO에서 IAM 사용자를 생성할 수 없습니다.
22.2.1.1.1. 필요한 GCP 권한 링크 복사링크가 클립보드에 복사되었습니다!
AWS(Amazon Web Services)에서 Mint 모드에 제공하는 인증 정보에는 다음과 같은 권한이 있어야 합니다.
-
iam:CreateAccessKey -
iam:CreateUser -
iam:DeleteAccessKey -
iam:DeleteUser -
iam:DeleteUserPolicy -
iam:GetUser -
iam:GetUserPolicy -
iam:ListAccessKeys -
iam:PutUserPolicy -
iam:TagUser -
iam:SimulatePrincipalPolicy
22.2.1.1.2. 필수 Google Cloud 권한 링크 복사링크가 클립보드에 복사되었습니다!
Google Cloud에서 Mint 모드에 제공하는 인증 정보에는 다음과 같은 권한이 있어야 합니다.
-
resourcemanager.projects.get -
serviceusage.services.list -
iam.serviceAccountKeys.create -
iam.serviceAccountKeys.delete -
iam.serviceAccountKeys.list -
iam.serviceAccounts.create -
iam.serviceAccounts.delete -
iam.serviceAccounts.get -
iam.roles.create -
iam.roles.get -
iam.roles.list -
iam.roles.undelete -
iam.roles.update -
resourcemanager.projects.getIamPolicy -
resourcemanager.projects.setIamPolicy
22.2.1.2. 관리자 인증 정보 루트 시크릿 형식 링크 복사링크가 클립보드에 복사되었습니다!
CCO(Cloud Credential Operator)는 Mint 모드로 새 인증 정보를 생성하거나 패스스루 모드를 사용하여 인증 정보 루트 시크릿을 복사하여 인증 정보 루트 시크릿을 생성합니다.
각 클라우드 공급자는 규칙에 따라 kube-system 네임 스페이스의 인증 정보 루트 시크릿을 사용하며, 이를 통해 모든 인증 정보 요청을 충족하고 해당 암호를 만드는 데 사용됩니다.
시크릿의 형식은 클라우드에 따라 다르며 각 CredentialsRequest 시크릿에도 사용됩니다.
Amazon Web Services (AWS) 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: kube-system
name: aws-creds
stringData:
aws_access_key_id: <base64-encoded_access_key_id>
aws_secret_access_key: <base64-encoded_secret_access_key>
Google Cloud 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: kube-system
name: gcp-credentials
stringData:
service_account.json: <base64-encoded_service_account>
22.2.2. 클라우드 공급자 인증 정보 유지 관리 링크 복사링크가 클립보드에 복사되었습니다!
어떠한 이유로 클라우드 공급자 인증 정보가 변경되면 CCO(Cloud Credential Operator)에서 클라우드 공급자 인증 정보를 관리하기 위해 사용하는 시크릿을 수동으로 업데이트해야 합니다.
클라우드 인증 정보를 교체하는 프로세스는 CCO가 사용하도록 구성된 모드에 따라 달라집니다. Mint 모드를 사용하는 클러스터의 인증 정보를 교체한 후 삭제된 인증 정보를 통해 생성된 구성 요소 인증 정보를 수동으로 제거해야 합니다.
사전 요구 사항
클러스터는 다음을 사용하는 CCO 모드로 클라우드 인증 정보 교체를 수동으로 지원하는 플랫폼에 설치됩니다.
- Mint 모드의 경우 AWS(Amazon Web Services) 및 Google Cloud가 지원됩니다.
- 클라우드 공급자와 인터페이스에 사용되는 인증 정보를 변경했습니다.
- 새 인증 정보에는 클러스터에서 사용할 수 있도록 구성된 모드 CCO에 대한 충분한 권한이 있습니다.
프로세스
-
웹 콘솔의 관리자 화면에서 워크로드
시크릿 으로 이동합니다. Secrets 페이지의 표에서 클라우드 공급자의 루트 시크릿을 찾습니다.
플랫폼 시크릿 이름 AWS
aws-credsGoogle Cloud
gcp-credentials-
시크릿과 동일한 행에서 옵션 메뉴
를 클릭하고 시크릿 편집을 선택합니다.
- Value 필드의 내용을 기록합니다. 이 정보를 사용하여 인증서를 업데이트한 후 값이 다른지 확인할 수 있습니다.
- 클라우드 공급자에 대한 새로운 인증 정보를 사용하여 Value 필드의 텍스트를 업데이트한 다음 저장을 클릭합니다.
개별
CredentialsRequest개체에서 참조하는 각 구성 요소 시크릿을 삭제합니다.-
cluster-admin역할의 사용자로 OpenShift Container Platform CLI에 로그인합니다. 참조되는 모든 구성 요소 시크릿의 이름과 네임스페이스를 가져옵니다.
$ oc -n openshift-cloud-credential-operator get CredentialsRequest \ -o json | jq -r '.items[] | select (.spec.providerSpec.kind=="<provider_spec>") | .spec.secretRef'여기서
<provider_spec>은 클라우드 공급자의 해당 값입니다.-
AWS:
AWSProviderSpec -
Google Cloud:
GCPProviderSpec
다음 예제는 AWS 클러스터에서 명령에 대한 부분적인 출력입니다.
{ "name": "ebs-cloud-credentials", "namespace": "openshift-cluster-csi-drivers" } { "name": "cloud-credential-operator-iam-ro-creds", "namespace": "openshift-cloud-credential-operator" }-
AWS:
참조된 각 구성 요소 시크릿을 삭제합니다.
$ oc delete secret <secret_name> \1 -n <secret_namespace>2 다음과 같습니다.
<secret_name>- 보안 이름을 지정합니다.
<secret_namespace>- 보안이 포함된 네임스페이스를 지정합니다.
다음 예제는 AWS 보안을 삭제하는 명령입니다.
$ oc delete secret ebs-cloud-credentials -n openshift-cluster-csi-drivers공급자 콘솔에서 인증 정보를 수동으로 삭제할 필요가 없습니다. 참조된 구성 요소 시크릿을 삭제하면 CCO가 플랫폼에서 기존 인증 정보를 삭제하고 새 인증서를 생성합니다.
-
검증
-
웹 콘솔의 관리자 화면에서 워크로드
시크릿 으로 이동합니다. - 값 필드의 내용이 변경되었는지 확인합니다.
22.3. passthrough 모드의 Cloud Credential Operator 정보 링크 복사링크가 클립보드에 복사되었습니다!
CCO(Cloud Credential Operator)가 클라우드 인증 정보를 요청하는 구성 요소에 전달할 수 있도록 CCO(Cloud Credential Operator)가 passthrough 모드에서 작동하도록 구성할 수 있습니다.
인증 정보에는 설치를 수행하고 클러스터의 구성 요소에 필요한 작업을 완료할 수 있는 권한이 있어야 하지만 새 인증 정보를 생성할 필요가 없습니다. CCO는 passthrough 모드로 추가 제한된 범위 인증 정보를 생성하지 않습니다.
Passthrough 모드는 AWS(Amazon Web Services), Microsoft Azure, Google Cloud, RHOSP(Red Hat OpenStack Platform) 및 VMware vSphere에서 지원됩니다.
수동 모드는 Microsoft Azure Stack Hub에서 지원되는 유일한 CCO 구성입니다.
22.3.1. Passthrough 모드 권한 요구사항 링크 복사링크가 클립보드에 복사되었습니다!
Passthrough 모드에서 CCO를 사용하는 경우 제공한 인증 정보가 OpenShift Container Platform을 실행 중이거나 설치하는 클라우드의 요구 사항을 충족하는지 확인하십시오.
제공된 인증 정보에서 CCO가 CredentialsRequest CR을 생성하는 구성 요소에 충분하지 않으면 구성 요소가 권한이 없는 API를 호출하려고 할 때 오류를 보고합니다.
- AWS(Amazon Web Services) 권한
AWS에서 passthrough 모드로 제공하는 인증 정보에는 실행 또는 설치 중인 OpenShift Container Platform 버전에 필요한 모든
CredentialsRequestCR에 대한 요청된 권한이 있어야 합니다.필요한
CredentialsRequestCR을 찾으려면 "AWS에 대한 장기 인증 정보 생성을 참조하십시오.- Microsoft Azure 권한
Azure에서 passthrough 모드에 제공하는 인증 정보에는 실행 중 또는 설치 중인 OpenShift Container Platform 버전에 필요한 모든
CredentialsRequestCR에 대한 요청된 권한이 있어야 합니다.필요한
CredentialsRequestCR을 찾으려면 "Azure에 대한 장기 인증 정보 생성"을 참조하십시오.- Google Cloud 권한
Google Cloud에서 passthrough 모드에 제공하는 인증 정보에는 실행 중 또는 설치 중인 OpenShift Container Platform 버전에 필요한 모든
CredentialsRequestCR에 대한 요청된 권한이 있어야 합니다.필요한
CredentialsRequestCR을 찾으려면 "Google Cloud에 대한 장기 인증 정보 생성"을 참조하십시오.- RHOSP(Red Hat OpenStack Platform) 권한
-
RHOSP에 OpenShift Container Platform 클러스터를 설치하려면 CCO에
member사용자 역할의 권한이 있는 인증 정보가 필요합니다. - VMware vSphere 권한
- VMware vSphere에 OpenShift Container Platform 클러스터를 설치하려면 CCO에 다음 vSphere 권한이 있는 인증 정보가 필요합니다.
| 카테고리 | 권한 |
|---|---|
| 데이터 저장소 | 공간 할당 |
| 폴더 | 폴더 생성, 폴더 삭제 |
| vSphere 태그 지정 | 모든 권한 |
| 네트워크 | 네트워크 할당 |
| 리소스 이름 | 리소스 풀에 가상 머신 할당 |
| 프로필 중심 스토리지 | 모든 권한 |
| vApp | 모든 권한 |
| 가상 머신 | 모든 권한 |
클러스터가 업그레이드되어 CredentialsRequest CR이 시간이 지남에 따라 변경되는 경우 요구사항을 충족하도록 passthrough 모드 인증 정보를 수동으로 업데이트해야 합니다. 업그레이드 중 인증 정보 문제가 발생하지 않도록 하려면 업그레이드 전에 새 OpenShift Container Platform 버전에 대해 릴리스 이미지의 CredentialsRequest CR을 확인하십시오.
AWS, Azure 또는 Google Cloud에 필요한 CredentialsRequest CR을 찾으려면 플랫폼에 대한 장기 인증 정보 수동 생성 주제를 참조하십시오.
22.3.2. 관리자 인증 정보 루트 시크릿 형식 링크 복사링크가 클립보드에 복사되었습니다!
CCO(Cloud Credential Operator)는 Mint 모드로 새 인증 정보를 생성하거나 패스스루 모드를 사용하여 인증 정보 루트 시크릿을 복사하여 인증 정보 루트 시크릿을 생성합니다.
각 클라우드 공급자는 규칙에 따라 kube-system 네임 스페이스의 인증 정보 루트 시크릿을 사용하며, 이를 통해 모든 인증 정보 요청을 충족하고 해당 암호를 만드는 데 사용됩니다.
시크릿의 형식은 클라우드에 따라 다르며 각 CredentialsRequest 시크릿에도 사용됩니다.
Amazon Web Services (AWS) 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: kube-system
name: aws-creds
stringData:
aws_access_key_id: <base64-encoded_access_key_id>
aws_secret_access_key: <base64-encoded_secret_access_key>
Microsoft Azure 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: kube-system
name: azure-credentials
stringData:
azure_subscription_id: <base64-encoded_subscription_id>
azure_client_id: <base64-encoded_client_id>
azure_client_secret: <base64-encoded_client_secret>
azure_tenant_id: <base64-encoded_tenant_id>
azure_resource_prefix: <base64-encoded_resource_prefix>
azure_resourcegroup: <base64-encoded_resource_group>
azure_region: <base64-encoded_region>
Microsoft Azure에서 인증 정보 시크릿 형식에는 각 클러스터 설치에 대해 임의로 생성된 클러스터의 인프라 ID를 포함해야 하는 두 가지 속성이 포함되어 있습니다. 이 값은 매니페스트 생성을 실행한 후에 찾을 수 있습니다.
$ cat .openshift_install_state.json | jq '."*installconfig.ClusterID".InfraID' -r
출력 예
mycluster-2mpcn
이 값은 다음과 같이 시크릿 데이터에 사용됩니다.
azure_resource_prefix: mycluster-2mpcn
azure_resourcegroup: mycluster-2mpcn-rg
Google Cloud 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: kube-system
name: gcp-credentials
stringData:
service_account.json: <base64-encoded_service_account>
RHOSP(Red Hat OpenStack Platform) 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: kube-system
name: openstack-credentials
data:
clouds.yaml: <base64-encoded_cloud_creds>
clouds.conf: <base64-encoded_cloud_creds_init>
VMware vSphere 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: kube-system
name: vsphere-creds
data:
vsphere.openshift.example.com.username: <base64-encoded_username>
vsphere.openshift.example.com.password: <base64-encoded_password>
22.3.2.1. 클라우드 공급자 인증 정보 유지 관리 링크 복사링크가 클립보드에 복사되었습니다!
어떠한 이유로 클라우드 공급자 인증 정보가 변경되면 CCO(Cloud Credential Operator)에서 클라우드 공급자 인증 정보를 관리하기 위해 사용하는 시크릿을 수동으로 업데이트해야 합니다.
클라우드 인증 정보를 교체하는 프로세스는 CCO가 사용하도록 구성된 모드에 따라 달라집니다. Mint 모드를 사용하는 클러스터의 인증 정보를 교체한 후 삭제된 인증 정보를 통해 생성된 구성 요소 인증 정보를 수동으로 제거해야 합니다.
사전 요구 사항
클러스터는 다음을 사용하는 CCO 모드로 클라우드 인증 정보 교체를 수동으로 지원하는 플랫폼에 설치됩니다.
- Passthrough 모드의 경우 AWS(Amazon Web Services), Microsoft Azure, Google Cloud, RHOSP(Red Hat OpenStack Platform) 및 VMware vSphere가 지원됩니다.
- 클라우드 공급자와 인터페이스에 사용되는 인증 정보를 변경했습니다.
- 새 인증 정보에는 클러스터에서 사용할 수 있도록 구성된 모드 CCO에 대한 충분한 권한이 있습니다.
프로세스
-
웹 콘솔의 관리자 화면에서 워크로드
시크릿 으로 이동합니다. Secrets 페이지의 표에서 클라우드 공급자의 루트 시크릿을 찾습니다.
플랫폼 시크릿 이름 AWS
aws-credsAzure
azure-credentialsGoogle Cloud
gcp-credentialsRHOSP
openstack-credentialsVMware vSphere
vsphere-creds-
시크릿과 동일한 행에서 옵션 메뉴
를 클릭하고 시크릿 편집을 선택합니다.
- Value 필드의 내용을 기록합니다. 이 정보를 사용하여 인증서를 업데이트한 후 값이 다른지 확인할 수 있습니다.
- 클라우드 공급자에 대한 새로운 인증 정보를 사용하여 Value 필드의 텍스트를 업데이트한 다음 저장을 클릭합니다.
vSphere CSI Driver Operator가 활성화되어 있지 않은 vSphere 클러스터의 인증 정보를 업데이트하는 경우 Kubernetes 컨트롤러 관리자의 롤아웃을 강제 적용하여 업데이트된 인증 정보를 적용해야 합니다.
참고vSphere CSI Driver Operator가 활성화된 경우 이 단계가 필요하지 않습니다.
업데이트된 vSphere 인증 정보를 적용하려면 OpenShift Container Platform CLI에
cluster-admin역할의 사용자로 로그인하고 다음 명령을 실행합니다.$ oc patch kubecontrollermanager cluster \ -p='{"spec": {"forceRedeploymentReason": "recovery-'"$( date )"'"}}' \ --type=merge인증 정보가 출시되는 동안 Kubernetes Controller Manager Operator의 상태는
Progressing=true로 보고합니다. 상태를 보려면 다음 명령을 실행합니다.$ oc get co kube-controller-manager
검증
-
웹 콘솔의 관리자 화면에서 워크로드
시크릿 으로 이동합니다. - 값 필드의 내용이 변경되었는지 확인합니다.
22.3.2.2. 설치 후 권한 감소 링크 복사링크가 클립보드에 복사되었습니다!
passthrough 모드를 사용하는 경우 설치 후 클러스터를 실행하는 데 필요한 권한으로만 설치된 권한을 줄일 수 있습니다.
passthrough 모드에서 각 구성 요소에는 다른 모든 구성 요소에서 사용하는 것과 동일한 권한이 있습니다. 설치 후 권한을 줄이지 않으면 모든 구성 요소에 설치 프로그램을 실행하는 데 필요한 광범위한 권한이 있습니다.
설치 후 사용 중인 OpenShift Container Platform 버전에 대한 릴리스 이미지의 CredentialsRequest CR에서 정의한 권한으로 인증 정보에 대한 권한을 줄입니다.
AWS, Azure 또는 Google Cloud에 필요한 CredentialsRequest CR을 찾고 CCO에서 사용하는 권한을 변경하는 방법을 알아보려면 플랫폼에 대한 장기 인증 정보 항목을 수동으로 생성 을 참조하십시오.
22.4. 구성 요소에 대한 장기 인증 정보가 있는 수동 모드에서 Cloud Credential Operator 정보 링크 복사링크가 클립보드에 복사되었습니다!
Operator를 수동 모드로 설정하여 CCO(Cloud Credential Operator) 대신 클라우드 인증 정보를 관리할 수 있습니다.
AWS(Amazon Web Services), 글로벌 Microsoft Azure, Microsoft Azure Stack Hub, Google Cloud, IBM Cloud® 또는 Nutanix 클러스터에서 수동 모드를 사용할 수 있습니다.
수동 모드를 사용하려면 실행 또는 설치 중인 OpenShift Container Platform 버전의 릴리스 이미지에서 CredentialsRequest CR을 검사하고, 기본 클라우드 공급자에 해당 인증 정보를 생성하고, 올바른 네임스페이스에 Kubernetes 보안을 생성하여 클러스터의 클라우드 공급자에 대한 모든 CredentialsRequest CR을 충족해야 합니다. 일부 플랫폼에서는 CCO 유틸리티(ccoctl)를 사용하여 설치 및 업데이트 중에 이 프로세스를 용이하게 합니다.
장기 자격 증명과 함께 수동 모드를 사용하면 각 클러스터 구성 요소에 관리자 수준 인증 정보를 저장하지 않고 필요한 권한만 가질 수 있습니다. 이 모드에서는 AWS 공용 IAM 끝점과 같은 서비스에도 연결할 필요가 없습니다. 그러나 업그레이드할 때마다 새 릴리스 이미지로 권한을 수동으로 조정해야 합니다.
수동 모드를 사용하도록 클라우드 공급자를 구성하는 방법에 대한 자세한 내용은 클라우드 공급자에 대한 수동 인증 정보 관리 옵션을 참조하십시오.
수동 모드를 사용하는 AWS, 글로벌 Azure 또는 Google Cloud 클러스터는 다양한 구성 요소에 대해 단기 인증 정보를 사용하도록 구성할 수 있습니다. 자세한 내용은 "구성 요소에 대한 단기 자격 증명이 있는 수동 모드"를 참조하십시오.
22.5. 구성 요소에 대한 단기 인증 정보가 있는 수동 모드에서 Cloud Credential Operator 정보 링크 복사링크가 클립보드에 복사되었습니다!
설치하는 동안 수동 모드에서 작동하도록 CCO(Cloud Credential Operator)를 구성하고 CCO 유틸리티(ccoctl)를 사용하여 OpenShift Container Platform 클러스터 외부에서 생성 및 관리되는 개별 구성 요소에 대한 단기 보안 인증 정보를 구현할 수 있습니다.
이 인증 정보 전략은 AWS(Amazon Web Services), Google Cloud 및 글로벌 Microsoft Azure에서만 지원됩니다.
AWS 및 Google Cloud 클러스터의 경우 새 OpenShift Container Platform 클러스터를 설치하는 동안 이 전략을 사용하도록 클러스터를 구성해야 합니다. 이 기능을 사용하기 위해 다른 인증 정보 전략을 사용하는 기존 AWS 또는 Google Cloud 클러스터를 구성할 수 없습니다.
설치 중에 Microsoft Entra Workload ID를 사용하도록 Azure 클러스터를 구성하지 않은 경우 기존 클러스터에서 이 인증 방법을 활성화할 수 있습니다. 자세한 내용은 "토큰 기반 인증 활성화"를 참조하십시오.
클라우드 공급자는 이 인증 방법을 구현하는 데 다른 용어를 사용합니다.
| 클라우드 공급자 | 공급자 nomenclature |
|---|---|
| AWS(Amazon Web Services) | AWS STS(보안 토큰 서비스) |
| Google Cloud | GCP 워크로드 ID |
| Global Microsoft Azure | Microsoft Entra Workload ID |
22.5.1. AWS 보안 토큰 서비스 정보 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 구성 요소에 단기적이고 제한된 권한 보안 인증 정보를 제공하는 IAM 역할을 할당하려면 STS(Security Token Service)를 사용하여 수동 모드를 사용하도록 클러스터를 구성할 수 있으므로 개별 OpenShift Container Platform 구성 요소가 AWS STS를 사용할 수 있습니다.
이러한 인증 정보는 AWS API 호출을 수행하는 각 구성 요소에 특정적인 IAM 역할과 연결됩니다.
22.5.1.1. AWS 보안 토큰 서비스 인증 프로세스 링크 복사링크가 클립보드에 복사되었습니다!
Pod가 IAM 역할 정책에서 정의한 액세스 키를 검색할 수 있도록 AWS STS(보안 토큰 서비스) 및 AssumeRole API 작업 수행 프로세스를 숙지해야 합니다.
OpenShift Container Platform 클러스터에는 Kubernetes 서비스 계정 서명 서비스가 포함되어 있습니다. 이 서비스는 개인 키를 사용하여 서비스 계정 JSON 웹 토큰(JWT)에 서명합니다. 서비스 계정 토큰이 필요한 Pod는 Pod 사양을 통해 하나씩 요청합니다. Pod가 생성되어 노드에 할당되면 노드는 서비스 계정 서명 서비스에서 서명된 서비스 계정을 검색하여 Pod에 마운트합니다.
STS를 사용하는 클러스터에는 Kubernetes 구성 시크릿에 IAM 역할 ID가 포함됩니다. 워크로드에서는 이 IAM 역할 ID의 ID를 가정합니다. 워크로드에 발행된 서명된 서비스 계정 토큰은 AWS의 구성과 일치하여 AWS STS가 지정된 IAM 역할의 액세스 키를 워크로드에 부여할 수 있습니다.
AWS STS는 다음 조건을 충족하는 서비스 계정 토큰이 포함된 요청에만 액세스 키를 부여합니다.
- 토큰 이름 및 네임스페이스는 서비스 계정 이름 및 네임스페이스와 일치합니다.
- 토큰은 공개 키와 일치하는 키로 서명됩니다.
클러스터에서 사용하는 서비스 계정 서명 키의 공개 키 쌍은 AWS S3 버킷에 저장됩니다. AWS STS 페더레이션은 서비스 계정 토큰 서명이 S3 버킷에 저장된 공개 키와 일치하는지 확인합니다.
22.5.1.1.1. AWS STS의 인증 흐름 링크 복사링크가 클립보드에 복사되었습니다!
다음 다이어그램은 AWS STS를 사용할 때 AWS와 OpenShift Container Platform 클러스터 간의 인증 흐름을 보여줍니다.
- 토큰 서명 은 OpenShift Container Platform 클러스터의 Kubernetes 서비스 계정 서명 서비스입니다.
- Pod의 Kubernetes 서비스 계정 은 서명된 서비스 계정 토큰입니다.
그림 22.2. AWS 보안 토큰 서비스 인증 흐름
새로운 인증 정보 및 새로 고침 인증 정보에 대한 요청은 AWS IAM 역할과 결합된 적절하게 구성된 AWS IAM OIDC(OpenID Connect) ID 공급자를 사용하여 자동화됩니다. AWS IAM에서 신뢰하는 서비스 계정 토큰은 OpenShift Container Platform에서 서명하고 Pod에 프로젝션하고 인증에 사용할 수 있습니다.
22.5.1.1.2. AWS STS의 토큰 새로 고침 링크 복사링크가 클립보드에 복사되었습니다!
Pod에서 사용하는 서명된 서비스 계정 토큰이 일정 기간 후에 만료됩니다. AWS STS를 사용하는 클러스터의 경우 이 기간은 3600초 또는 1시간입니다.
토큰이 새로 고쳐지도록 Pod가 할당된 노드의 kubelet입니다. kubelet은 토큰이 수명의 80%보다 오래되면 토큰을 교체하려고 시도합니다.
22.5.1.1.3. AWS STS의 OpenID Connect 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
OIDC 구성에 대한 암호화 키의 공개 부분을 공개 또는 개인 S3 버킷에 저장할 수 있습니다.
OIDC 사양은 HTTPS를 사용해야 합니다. AWS 서비스에는 JWKS(JSON 웹 키 세트) 공개 키 형식의 OIDC 문서를 노출하려면 공개 끝점이 필요합니다. 이를 통해 AWS 서비스는 Kubernetes에서 서명한 바인딩된 토큰의 유효성을 검사하고 인증서를 신뢰할지 여부를 확인할 수 있습니다. 결과적으로 S3 버킷 옵션에는 공용 HTTPS 끝점과 프라이빗 끝점이 모두 지원되지 않습니다.
AWS STS를 사용하려면 AWS STS 서비스의 공용 AWS 백본이 공용 S3 버킷 또는 공용 CloudFront 엔드포인트가 있는 프라이빗 S3 버킷과 통신할 수 있어야 합니다. 설치 중에 CredentialsRequest 오브젝트를 처리할 때 사용할 버킷 유형을 선택할 수 있습니다.
-
기본적으로 CCO 유틸리티(
ccoctl)는 OIDC 구성 파일을 공용 S3 버킷에 저장하고 S3 URL을 공용 OIDC 엔드포인트로 사용합니다. -
또는
ccoctl유틸리티에서 공개 CloudFront 배포 URL을 통해 IAM ID 공급자가 액세스하는 프라이빗 S3 버킷에 OIDC 구성을 저장할 수 있습니다.
22.5.1.2. AWS 구성 요소 시크릿 형식 링크 복사링크가 클립보드에 복사되었습니다!
개별 OpenShift Container Platform 구성 요소에 제공되는 AWS 인증 정보의 내용을 변경하려면 AWS STS(보안 토큰 서비스)와 함께 수동 모드를 사용할 수 있습니다.
다음 보안 형식을 비교합니다.
장기 인증 정보를 사용하는 AWS 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: <target_namespace>
name: <target_secret_name>
data:
aws_access_key_id: <base64_encoded_access_key_id>
aws_secret_access_key: <base64_encoded_secret_access_key>
다음과 같습니다.
metadata.namespace- 구성 요소의 네임스페이스를 지정합니다.
metadata.name- 구성 요소 시크릿의 이름을 지정합니다.
AWS STS를 사용하는 AWS 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: <target_namespace>
name: <target_secret_name>
stringData:
credentials: |-
[default]
sts_regional_endpoints = regional
role_name: <operator_role_name>
web_identity_token_file: <path_to_token>
다음과 같습니다.
metadata.namespace- 구성 요소의 네임스페이스를 지정합니다.
metadata.name- 구성 요소 시크릿의 이름을 지정합니다.
stringData.credentials.role_name- 구성 요소의 IAM 역할을 지정합니다.
stringData.credentials.web_identity_token_file-
Pod 내부의 서비스 계정 토큰의 경로를 지정합니다. 관례상 이는 OpenShift Container Platform 구성 요소의
/var/run/secrets/openshift/serviceaccount/token입니다.
22.5.1.3. AWS 구성 요소 시크릿 권한 요구사항 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 구성 요소에 필요한 권한을 숙지해야 합니다. 이러한 값은 각 구성 요소의 CredentialsRequest CR(사용자 정의 리소스)에 있습니다.
OpenShift Container Platform 구성 요소에는 다음과 같은 권한이 필요합니다.
이러한 권한은 모든 리소스에 적용됩니다. 지정하지 않는 한 이러한 권한에 대한 요청 조건이 없습니다.
| Component | 사용자 정의 리소스 | 서비스에 필요한 권한 |
|---|---|---|
| Cluster CAPI Operator |
| EC2
Elastic 로드 밸런싱
IAM(Identity and Access Management)
키 관리 서비스(Key Management Service)
|
| Machine API Operator |
| EC2
Elastic 로드 밸런싱
IAM(Identity and Access Management)
키 관리 서비스(Key Management Service)
|
| Cloud Credential Operator |
| IAM(Identity and Access Management)
|
| Cluster Image Registry Operator |
| S3
|
| Ingress Operator |
| Elastic 로드 밸런싱
Route 53
Tag
STS(Security Token Service)
|
| CNO(Cluster Network Operator) |
| EC2
|
| AWS Elastic Block Store CSI Driver Operator |
| EC2
키 관리 서비스(Key Management Service)
|
-
요청 조건:
kms:GrantIsForAWSResource: true
22.5.1.4. AWS STS를 통한 인증에 대한 OLM 관리 Operator 지원 링크 복사링크가 클립보드에 복사되었습니다!
AWS 클러스터의 OLM(Operator Lifecycle Manager)에서 관리하는 특정 Operator가 클러스터 외부에서 관리되는 제한된 권한의 단기 인증 정보로 인증할 수 있도록 STS와 함께 수동 모드를 사용할 수 있습니다.
Operator가 AWS STS를 통한 인증을 지원하는지 확인하려면 소프트웨어 카탈로그의 Operator 설명을 참조하십시오.
22.5.2. GCP 워크로드 ID 정보 링크 복사링크가 클립보드에 복사되었습니다!
구성 요소가 Google Cloud Platform Workload Identity를 사용하여 단기적이고 제한된 권한 인증 정보를 사용하여 Google Cloud 서비스 계정을 가장하도록 허용하려면 GCP 워크로드 ID로 수동 모드를 사용하도록 클러스터를 구성할 수 있습니다.
22.5.2.1. Google Cloud 워크로드 ID 인증 프로세스 링크 복사링크가 클립보드에 복사되었습니다!
Google Cloud Workload Identity 인증 프로세스에 대해 숙지해야 합니다.
새로운 인증 정보 및 새로 고침 인증 정보에 대한 요청은 IAM 서비스 계정과 결합된 적절하게 구성된 OpenID Connect(OIDC) ID 공급자를 사용하여 자동화됩니다. Google Cloud에서 신뢰하는 서비스 계정 토큰은 OpenShift Container Platform에서 서명하고 Pod에 프로젝션하고 인증에 사용할 수 있습니다. 토큰은 1시간 후에 새로 고쳐집니다.
다음 다이어그램에서는 Google Cloud 워크로드 ID를 사용할 때 Google Cloud와 OpenShift Container Platform 클러스터 간의 인증 흐름을 자세히 설명합니다.
그림 22.3. Google Cloud 워크로드 ID 인증 흐름
22.5.2.2. Google Cloud 구성 요소 시크릿 형식 링크 복사링크가 클립보드에 복사되었습니다!
개별 OpenShift Container Platform 구성 요소에 제공되는 Google Cloud 인증 정보의 내용을 변경하려면 Google Cloud Workload Identity에서 수동 모드를 사용할 수 있습니다.
다음 시크릿 콘텐츠를 비교합니다.
Google Cloud 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: <target_namespace>
name: <target_secret_name>
data:
service_account.json: <service_account>
다음과 같습니다.
metadata.namespace- 구성 요소의 네임스페이스를 지정합니다.
metadata.name- 구성 요소 시크릿의 이름을 지정합니다.
data.service_account.json- Base64로 인코딩된 서비스 계정을 지정합니다.
장기 인증 정보를 사용하여 Base64로 인코딩된 service_account.json 파일의 콘텐츠
{
"type": "service_account",
"project_id": "<project_id>",
"private_key_id": "<private_key_id>",
"private_key": "<private_key>",
"client_email": "<client_email_address>",
"client_id": "<client_id>",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/<client_email_address>"
}
다음과 같습니다.
type-
인증 정보 유형을 지정합니다. 이 예에서는
service_account입니다. private_key- Google Cloud 인증에 사용되는 개인 RSA 키를 지정합니다. 이 키는 안전하게 유지되어야 하며 순환되지 않습니다.
Google Cloud Workload Identity를 사용하여 Base64로 인코딩된 service_account.json 파일의 콘텐츠
{
"type": "external_account",
"audience": "//iam.googleapis.com/projects/123456789/locations/global/workloadIdentityPools/test-pool/providers/test-provider",
"subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
"token_url": "https://sts.googleapis.com/v1/token",
"service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/<client_email_address>:generateAccessToken",
"credential_source": {
"file": "<path_to_token>",
"format": {
"type": "text"
}
}
}
다음과 같습니다.
type-
인증 정보 유형을 지정합니다. 이 예에서는 type은
external_account입니다. audience- 대상 대상은 Google Cloud Workload Identity 공급자임을 지정합니다.
service_account_impersonation_url- 이러한 자격 증명으로 가장할 수 있는 서비스 계정의 리소스 URL을 지정합니다.
credential_source.file-
Pod 내부의 서비스 계정 토큰의 경로를 지정합니다. 관례상 이는 OpenShift Container Platform 구성 요소의
/var/run/secrets/openshift/serviceaccount/token입니다.
22.5.2.3. Google Cloud 구성 요소 시크릿 권한 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 구성 요소에는 다음과 같은 권한이 필요합니다. 이러한 값은 각 구성 요소의 CredentialsRequest CR(사용자 정의 리소스)에 있습니다.
이러한 권한은 모든 리소스에 적용됩니다. 지정하지 않는 한 이러한 권한에 대한 요청 조건이 없습니다.
| Component | 사용자 정의 리소스 | 서비스에 필요한 권한 |
|---|---|---|
| Cloud Controller Manager Operator |
| 컴퓨팅 엔진
|
| Cloud Credential Operator |
| IAM(Identity and Access Management)
리소스 관리자
서비스 사용량
|
| Cluster Image Registry Operator |
| 클라우드 스토리지
리소스 관리자
|
| Cluster Ingress Operator |
| Cloud DNS
|
| CNO(Cluster Network Operator) |
| 컴퓨팅 엔진
|
| Cluster Storage Operator |
| 컴퓨팅 엔진
이 구성 요소에는 다음과 같은 Google Cloud 사전 정의된 역할도 필요합니다.
|
| Machine API Operator |
| 컴퓨팅 엔진
IAM(Identity and Access Management)
리소스 관리자
서비스 사용량
|
22.5.2.4. GCP 워크로드 ID를 통한 인증에 대한 OLM 관리형 Operator 지원 링크 복사링크가 클립보드에 복사되었습니다!
Google Cloud 클러스터의 OLM(Operator Lifecycle Manager)에서 관리하는 특정 Operator가 클러스터 외부에서 관리되는 제한된 권한의 단기 인증 정보로 인증할 수 있도록 GCP 워크로드 ID와 함께 수동 모드를 사용할 수 있습니다.
Operator가 GCP 워크로드 ID로 인증을 지원하는지 확인하려면 소프트웨어 카탈로그의 Operator 설명을 참조하십시오.
22.5.2.5. GCP 워크로드 ID 서비스 계정 토큰에 대한 애플리케이션 지원 링크 복사링크가 클립보드에 복사되었습니다!
Google Cloud Platform 워크로드 ID를 사용하는 OpenShift Container Platform 클러스터의 고객 워크로드의 애플리케이션에 GCP 워크로드 ID를 사용할 수 있습니다.
애플리케이션과 함께 이 인증 방법을 사용하려면 클라우드 공급자 콘솔 및 OpenShift Container Platform 클러스터에서 구성 단계를 완료해야 합니다.
22.5.3. Microsoft Entra Workload ID 정보 링크 복사링크가 클립보드에 복사되었습니다!
Microsoft Entra Workload ID로 수동 모드를 사용하도록 클러스터를 구성할 때 개별 OpenShift Container Platform 클러스터 구성 요소는 Workload ID 공급자를 사용하여 구성 요소에 단기 보안 인증 정보를 할당합니다.
22.5.3.1. Microsoft Entra Workload ID 인증 프로세스 링크 복사링크가 클립보드에 복사되었습니다!
Microsoft Entra Workload ID 인증 흐름을 숙지해야 합니다.
다음 다이어그램에서는 Workload ID를 사용할 때 Microsoft Azure와 OpenShift Container Platform 클러스터 간의 인증 흐름을 자세히 설명합니다.
그림 22.4. 워크로드 ID 인증 흐름
22.5.3.2. Azure 구성 요소 시크릿 형식 링크 복사링크가 클립보드에 복사되었습니다!
개별 OpenShift Container Platform 구성 요소에 제공되는 Azure 인증 정보의 내용을 변경하려면 Microsoft Entra Workload ID를 사용하여 수동 모드를 사용할 수 있습니다.
다음 보안 형식을 비교합니다.
장기 인증 정보를 사용하는 Azure 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: <target_namespace>
name: <target_secret_name>
data:
azure_client_id: <client_id>
azure_client_secret: <client_secret>
azure_region: <region>
azure_resource_prefix: <resource_group_prefix>
azure_resourcegroup: <resource_group_prefix>-rg
azure_subscription_id: <subscription_id>
azure_tenant_id: <tenant_id>
type: Opaque
다음과 같습니다.
metadata.namespace- 구성 요소의 네임스페이스를 지정합니다.
metadata.name- 구성 요소 시크릿의 이름을 지정합니다.
data.azure_client_id- 구성 요소가 인증하는 데 사용하는 Microsoft Entra ID의 클라이언트 ID를 지정합니다.
data.azure_client_secret-
<
client_id> ID에 대한 Microsoft Entra ID로 인증하는 데 사용되는 구성 요소 시크릿을 지정합니다. data.azure_resource_prefix- 리소스 그룹 접두사를 지정합니다.
data.azure_resourcegroup-
리소스 그룹을 지정합니다. 이 값은 <
resource_group_prefix> 및접미사-rg로 구성됩니다.
Microsoft Entra Workload ID를 사용하는 Azure 시크릿 형식
apiVersion: v1
kind: Secret
metadata:
namespace: <target_namespace>
name: <target_secret_name>
data:
azure_client_id: <client_id>
azure_federated_token_file: <path_to_token_file>
azure_region: <region>
azure_subscription_id: <subscription_id>
azure_tenant_id: <tenant_id>
type: Opaque
다음과 같습니다.
metadata.namespace- 구성 요소의 네임스페이스를 지정합니다.
metadata.name- 구성 요소 시크릿의 이름을 지정합니다.
data.azure_client_id- 구성 요소가 인증하는 데 사용하는 사용자가 할당한 관리 ID의 클라이언트 ID를 지정합니다.
data.azure_federated_token_file- 마운트된 서비스 계정 토큰 파일의 경로를 지정합니다.
22.5.3.3. Azure 구성 요소 시크릿 권한 요구사항 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 구성 요소에 필요한 권한을 숙지해야 합니다. 이러한 값은 각 구성 요소의 CredentialsRequest CR(사용자 정의 리소스)에 있습니다.
| Component | 사용자 정의 리소스 | 서비스에 필요한 권한 |
|---|---|---|
| Cloud Controller Manager Operator |
|
|
| Cluster CAPI Operator |
|
역할: |
| Machine API Operator |
|
|
| Cluster Image Registry Operator |
| 데이터 권한
일반 권한
|
| Ingress Operator |
|
|
| CNO(Cluster Network Operator) |
|
|
| Azure File CSI Driver Operator |
|
|
| Azure Disk CSI Driver Operator |
|
|
- 이 구성 요소에는 권한 세트가 아닌 역할이 필요합니다.
22.5.3.4. Microsoft Entra Workload ID를 사용한 인증에 대한 OLM 관리형 Operator 지원 링크 복사링크가 클립보드에 복사되었습니다!
Azure 클러스터의 OLM(Operator Lifecycle Manager)에서 관리하는 특정 Operator가 클러스터 외부에서 관리되는 제한된 권한, 단기 인증 정보로 인증할 수 있도록 Microsoft Entra Workload ID와 함께 수동 모드를 사용할 수 있습니다.
Operator가 Workload ID로 인증을 지원하는지 확인하려면 소프트웨어 카탈로그의 Operator 설명을 참조하십시오.