Configurazione di TLS e mTLS sul gateway in entrata

Questo argomento spiega come attivare TLS e mTLS unidirezionali su ingressgateway.

Configurazione di TLS unidirezionale

Utilizza TLS unidirezionale per proteggere gli endpoint dei proxy API sul gateway in entrata. Per abilitare TLS unidirezionale, configura l'oggetto Ingress con coppie di certificati/chiavi TLS o con un secret Kubernetes, come spiegato nelle opzioni seguenti.

Opzione 1: coppia chiave/certificato

Fornisci i file di certificato e chiave SSL nella proprietà virtualhosts del file delle sostituzioni:

virtualhosts:
  - name: $ENVIRONMENT_GROUP_NAME
    sslCertPath: "$CERT_FILE"
    sslKeyPath: "$KEY_FILE"

Dove $ENVIRONMENT_GROUP_NAME è il nome di un gruppo di ambienti con alias host corrispondenti e $CERT_FILE e $KEY_FILE sono file di chiavi e certificati TLS. Consulta Crea certificati TLS.

Opzione 2: secret Kubernetes

Crea un secret di Kubernetes e aggiungilo al file delle sostituzioni.

  1. Crea il secret nello spazio dei nomi apigee:
    kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME  \
      --from-file=key=$KEY_FILE \
      --from-file=cert=$CERT_FILE
  2. Configura la proprietà virtualhosts nel file delle sostituzioni:
    virtualhosts:
      - name: $ENVIRONMENT_GROUP_NAME
        tlsMode: SIMPLE  # Note: SIMPLE is the default, so it is optional.
        sslSecret: $SECRET_NAME
  3. Configurazione di mTLS

    Anziché TLS unidirezionale, puoi configurare mTLS sul gateway in entrata. Esistono due opzioni per configurare mTLS, come spiegato di seguito.

    Opzione 1: coppia di chiavi/certificati e file CA

    Fornisci i dati del certificato TLS contenenti i certificati dell'autorità di certificazione:

    virtualhosts:
      - name: $ENVIRONMENT_GROUP_NAME
        tlsMode: MUTUAL
        caCertPath: "$CA_FILE"
        sslCertPath: "$CERT_FILE"
        sslKeyPath: "$KEY_FILE"

    Dove $ENVIRONMENT_GROUP_NAME è il nome di un gruppo di ambienti con alias host corrispondenti, $CA_FILE specifica i dati del certificato TLS (file bundle CA) contenenti i certificati dell'autorità di certificazione e $CERT_FILE e $KEY_FILE sono i file di chiave e certificato TLS. Consulta Crea certificati TLS.

    Opzione 2: secret di Kubernetes

    Crea due Secret di Kubernetes. Il primo secret è per la coppia di chiavi/certificati SSL e il secondo è per la CA. quindi aggiungili al file di override.

    1. Crea due secret Kubernetes nello spazio dei nomi apigee:
      kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME  \
        --from-file=key=$KEY_FILE \
        --from-file=cert=$CERT_FILE
    2. Crea un secret per la CA:
      kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME-cacert  \
        --from-file=cacert=$CA_FILE
    3. Configura la proprietà virtualhosts nel file delle sostituzioni:
      virtualhosts:
        - name: $ENVIRONMENT_GROUP_NAME
          tlsMode: MUTUAL  # Note: Be sure to specify MUTUAL
          sslSecret: $SECRET_NAME