Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Note
Den här artikeln beskriver hur du manuellt konfigurerar TLS-avslutning på en Gateway-resurs genom att skapa en egen SecretProviderClass, montera Azure Key Vault-providern för Secrets Store CSI-drivrutinen via en exempelpodd och referera direkt till den resulterande Kubernetes-hemligheten i lyssnarens GatewaycertificateRefs. Den här metoden är användbar om du behöver fullständig kontroll över arbetsflödet för certifikatsynkronisering eller föredrar att hantera dessa resurser själv.
För de flesta användare är den rekommenderade lösningen den automatiserade integreringen med Azure DNS och Azure Key Vault som drivs av Application Routing-operatorn, som etablerar och synkroniserar SecretProviderClass, den synkroniserade Kubernetes-hemligheten och lyssnaren certificateRefs åt dig baserat på ett par lyssnar-tls.options. Information om hur du använder det automatiserade arbetsflödet finns i Konfigurera Azure DNS och TLS med implementeringen av gateway-API:et för programdirigering.
Tillägget för programroutning stöder synkronisering av hemligheter från Azure Key Vault (AKV) för att skydda gateway-API:ets inkommande trafik med TLS-avslutning. Följ stegen nedan för att skapa certifikat och nycklar för att avsluta TLS-trafik på gatewayen.
Förutsättningar
- Aktivera implementeringen av gateway-API:et för programroutning
- Aktivera API-installationen för Managed Gateway
- Ange miljövariabler:
export CLUSTER=<cluster-name> export RESOURCE_GROUP=<resource-group-name> export LOCATION=<location>
Nödvändiga klient-/servercertifikat och nycklar
- Skapa ett rotcertifikat och en privat nyckel för signering av certifikaten för exempeltjänster:
mkdir httpbin_certs
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -subj '/O=example Inc./CN=example.com' -keyout httpbin_certs/example.com.key -out httpbin_certs/example.com.crt
- Generera ett certifikat och en privat nyckel för
httpbin.example.com:
openssl req -out httpbin_certs/httpbin.example.com.csr -newkey rsa:2048 -nodes -keyout httpbin_certs/httpbin.example.com.key -subj "/CN=httpbin.example.com/O=httpbin organization"
openssl x509 -req -sha256 -days 365 -CA httpbin_certs/example.com.crt -CAkey httpbin_certs/example.com.key -set_serial 0 -in httpbin_certs/httpbin.example.com.csr -out httpbin_certs/httpbin.example.com.crt
Konfigurera en TLS-ingressgateway
Konfigurera Azure Key Vault och synkronisera hemligheter till klustret
Skapa Azure Key Vault
Du behöver en Azure Key Vault-resurs för att ange certifikat- och nyckelindata till tillägget för programdirigering.
export AKV_NAME=<azure-key-vault-resource-name> az keyvault create --name $AKV_NAME --resource-group $RESOURCE_GROUP --location $LOCATIONAktivera tillägget Azure Key Vault provider för Secret Store CSI Driver i ditt kluster.
az aks enable-addons --addons azure-keyvault-secrets-provider --resource-group $RESOURCE_GROUP --name $CLUSTEROm ditt Key Vault använder Azure RBAC för behörighetsmodellen följer du anvisningarna här för att tilldela en Azure-roll för Key Vault Secrets User för tilläggets användartilldelade hanterade identitet. Alternativt, om ditt nyckelvalv använder behörighetsmodellen för valvåtkomstprincip kan du auktorisera den användartilldelade hanterade identiteten för tillägget för att få åtkomst till Azure Key Vault-resursen med hjälp av åtkomstprinciper:
OBJECT_ID=$(az aks show --resource-group $RESOURCE_GROUP --name $CLUSTER --query 'addonProfiles.azureKeyvaultSecretsProvider.identity.objectId' -o tsv | tr -d '\r') CLIENT_ID=$(az aks show --resource-group $RESOURCE_GROUP --name $CLUSTER --query 'addonProfiles.azureKeyvaultSecretsProvider.identity.clientId') TENANT_ID=$(az keyvault show --resource-group $RESOURCE_GROUP --name $AKV_NAME --query 'properties.tenantId') az keyvault set-policy --name $AKV_NAME --object-id $OBJECT_ID --secret-permissions get listVälj hur du anger TLS-certifikatet.
Azure Key Vault stöder olika objekttyper. I den här genomgången väljer du något av följande alternativ från slutpunkt till slutpunkt och fortsätter sedan med de vanliga verifierings- och gatewaystegen.
Option Använd det här alternativet när Key Vault butiker Kubernetes Secret-resultat Alternativ 1: Lagra certifikatet och nyckeln som Key Vault hemligheter Du har separata PEM-certifikatfiler ( .crt) och privata nyckelfiler (.key), till exempel de filer som genererades tidigare i den här artikeln.Två Key Vault hemligheter. En synkroniserad Kubernetes TLS-hemlighet med namnet httpbin-credential.Alternativ 2: Referera till ett Key Vault certifikatobjekt direkt Certifikatet lagras redan i Key Vault som ett certifikatobjekt, till exempel en importerad .pfx.Ett Key Vault certifikatobjekt. En synkroniserad Kubernetes TLS-hemlighet med namnet httpbin-credential.Important
Följ inte båda alternativen. Om du använder alternativ 1, laddar du upp certifikatet och nyckelfilerna som hemligheter i Key Vault och tillämpar sedan manifestet för alternativ 1
SecretProviderClass. Om du använder alternativ 2 hoppar du över Key Vault hemliga uppladdningssteget och tillämpar manifestet Alternativ 2SecretProviderClass.
Alternativ 1: Lagra certifikatet och nyckeln som Key Vault hemligheter
Använd det här alternativet när du har separata PEM-certifikatfiler (.crt) och privata nyckelfiler (.key), till exempel de filer som genererades tidigare i den här artikeln.
Ladda upp certifikat- och nyckelfilerna som Key Vault hemligheter:
az keyvault secret set --vault-name $AKV_NAME --name test-httpbin-key --file httpbin_certs/httpbin.example.com.key az keyvault secret set --vault-name $AKV_NAME --name test-httpbin-crt --file httpbin_certs/httpbin.example.com.crtNote
Varje gång du roterar (ändrar) certifikatet eller nyckeln kör du det här steget igen för att ladda upp de nya versionerna som hemligheter. Om du vill synkronisera de uppdaterade värdena automatiskt in i klustret aktiverar du automatisk rotation på Azure Key Vault-providern för Secrets Store CSI Driver. Mer information finns i Översikt över autorotation och hemlig synkronisering. Om du föredrar att ha Key Vault hantera certifikatets livscykel använder du alternativ 2 i stället.
Skapa
SecretProviderClasssom refererar till de två hemligheterna som du skapade i Key Vault:cat <<EOF | kubectl apply -f - apiVersion: secrets-store.csi.x-k8s.io/v1 kind: SecretProviderClass metadata: name: httpbin-credential-spc spec: provider: azure secretObjects: - secretName: httpbin-credential type: kubernetes.io/tls data: - objectName: test-httpbin-key key: tls.key - objectName: test-httpbin-crt key: tls.crt parameters: useVMManagedIdentity: "true" userAssignedIdentityID: $CLIENT_ID keyvaultName: $AKV_NAME cloudName: "" objects: | array: - | objectName: test-httpbin-key objectType: secret objectAlias: "test-httpbin-key" - | objectName: test-httpbin-crt objectType: secret objectAlias: "test-httpbin-crt" tenantId: $TENANT_ID EOF
Alternativ 2: Referera till ett Key Vault certifikatobjekt direkt
Använd det här alternativet när certifikatet redan lagras i Azure Key Vault som ett certifikatobjekt. Du behöver inte ladda upp .crt filerna och .key som separata Key Vault hemligheter.
I det här exemplet test-httpbin-cert-pfx är namnet på certifikatobjektet i Azure Key Vault. Information om hur du importerar ett befintligt certifikat till Key Vault som ett certifikatobjekt finns i Importera ett certifikat till Key Vault. Mer information om objektparametrarna finns i hämta certifikat och nycklar.
Skapa
SecretProviderClasssom refererar till Key Vault-certifikatobjektet:cat <<EOF | kubectl apply -f - apiVersion: secrets-store.csi.x-k8s.io/v1 kind: SecretProviderClass metadata: name: httpbin-credential-spc spec: provider: azure secretObjects: - secretName: httpbin-credential type: kubernetes.io/tls data: - objectName: test-httpbin-key key: tls.key - objectName: test-httpbin-crt key: tls.crt parameters: useVMManagedIdentity: "true" userAssignedIdentityID: $CLIENT_ID keyvaultName: $AKV_NAME cloudName: "" objects: | array: - | objectName: test-httpbin-cert-pfx #certificate object name from keyvault objectType: secret objectAlias: "test-httpbin-key" - | objectName: test-httpbin-cert-pfx #certificate object name from keyvault objectType: cert objectAlias: "test-httpbin-crt" tenantId: $TENANT_ID EOF
Synkronisera hemligheten med klustret
När du har slutfört alternativ 1 eller alternativ 2 distribuerar du en exempelpodd för att synkronisera hemligheten till klustret. CSI-drivrutinen för Secrets Store kräver att en podd refererar till resursen SecretProviderClass så att hemligheter synkroniseras från Azure Key Vault till klustret.
Använd följande manifest för att distribuera en exempelpodd:
cat <<EOF | kubectl apply -f - apiVersion: v1 kind: Pod metadata: name: secrets-store-sync-httpbin spec: containers: - name: busybox image: mcr.microsoft.com/oss/busybox/busybox:1.33.1 command: - "/bin/sleep" - "10" volumeMounts: - name: secrets-store01-inline mountPath: "/mnt/secrets-store" readOnly: true volumes: - name: secrets-store01-inline csi: driver: secrets-store.csi.k8s.io readOnly: true volumeAttributes: secretProviderClass: "httpbin-credential-spc" EOFKontrollera att hemligheten
httpbin-credentialhar skapats idefaultnamnområdet enligt definitionen i SecretProviderClass-resursen.kubectl describe secret/httpbin-credentialExempel på utdata:
Name: httpbin-credential Namespace: default Labels: secrets-store.csi.k8s.io/managed=true Annotations: <none> Type: kubernetes.io/tls Data ==== tls.crt: 1180 bytes tls.key: 1675 bytes
Distribuera TLS Gateway
Skapa en Kubernetes Gateway som refererar till hemligheten
httpbin-credentialunder TLS-konfigurationen:cat <<EOF | kubectl apply -f - apiVersion: gateway.networking.k8s.io/v1 kind: Gateway metadata: name: httpbin-gateway spec: gatewayClassName: approuting-istio listeners: - name: https hostname: "httpbin.example.com" port: 443 protocol: HTTPS tls: mode: Terminate certificateRefs: - name: httpbin-credential allowedRoutes: namespaces: from: Selector selector: matchLabels: kubernetes.io/metadata.name: default EOFSkapa sedan en motsvarande
HTTPRouteför att konfigurera gatewayens inkommande trafikvägar:cat <<EOF | kubectl apply -f - apiVersion: gateway.networking.k8s.io/v1 kind: HTTPRoute metadata: name: httpbin spec: parentRefs: - name: httpbin-gateway hostnames: ["httpbin.example.com"] rules: - matches: - path: type: PathPrefix value: /status - path: type: PathPrefix value: /delay backendRefs: - name: httpbin port: 8000 EOFHämta gatewayadressen och porten:
kubectl wait --for=condition=programmed gateways.gateway.networking.k8s.io httpbin-gateway export INGRESS_HOST=$(kubectl get gateways.gateway.networking.k8s.io httpbin-gateway -o jsonpath='{.status.addresses[0].value}') export SECURE_INGRESS_PORT=$(kubectl get gateways.gateway.networking.k8s.io httpbin-gateway -o jsonpath='{.spec.listeners[?(@.name=="https")].port}')Skicka en HTTPS-begäran för att få åtkomst till
httpbintjänsten:curl -v -HHost:httpbin.example.com --resolve "httpbin.example.com:$SECURE_INGRESS_PORT:$INGRESS_HOST" \ --cacert httpbin_certs/example.com.crt "https://httpbin.example.com:$SECURE_INGRESS_PORT/status/418"Du bör se httpbin-tjänsten returnera 418 I'm a Teapot code.