Skydda inkommande trafik med implementeringen av gateway-API:et för programroutning

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

Nödvändiga klient-/servercertifikat och nycklar

  1. 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
  1. 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

  1. 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 $LOCATION
    
  2. Aktivera 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 $CLUSTER
    
  3. Om 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 list
    
  4. Vä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.

  1. 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.crt
    

    Note

    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.

  2. Skapa SecretProviderClass som 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.

  1. Skapa SecretProviderClass som 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.

  1. 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"
    EOF
    
    • Kontrollera att hemligheten httpbin-credential har skapats i default namnområdet enligt definitionen i SecretProviderClass-resursen.

      kubectl describe secret/httpbin-credential
      

      Exempel 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

  1. Skapa en Kubernetes Gateway som refererar till hemligheten httpbin-credential under 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
    EOF
    

    Skapa sedan en motsvarande HTTPRoute fö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
    EOF
    

    Hä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}')
    
  2. Skicka en HTTPS-begäran för att få åtkomst till httpbin tjä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.