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.
- 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
- Configura la proprietà
virtualhostsnel file delle sostituzioni:virtualhosts: - name: $ENVIRONMENT_GROUP_NAME tlsMode: SIMPLE # Note: SIMPLE is the default, so it is optional. sslSecret: $SECRET_NAME - 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
- Crea un secret per la CA:
kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME-cacert \ --from-file=cacert=$CA_FILE
- Configura la proprietà
virtualhostsnel file delle sostituzioni:virtualhosts: - name: $ENVIRONMENT_GROUP_NAME tlsMode: MUTUAL # Note: Be sure to specify MUTUAL sslSecret: $SECRET_NAME
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.