בנושא הזה מוסבר איך להפעיל TLS חד-כיווני ו-mTLS ב-ingressgateway.
הגדרת TLS חד-כיווני
משתמשים ב-TLS חד-כיווני כדי לאבטח נקודות קצה של שרתי proxy ל-API בשער הכניסה. כדי להפעיל TLS חד-כיווני, מגדירים את ה-ingress עם זוגות מפתחות/אישורי TLS או עם Kubernetes Secret, כמו שמוסבר באפשרויות הבאות.
אפשרות 1: צמד מפתח/אישור
מציינים את קובצי המפתח ואישור ה-SSL במאפיין virtualhosts בקובץ השינויים:
virtualhosts:
- name: $ENVIRONMENT_GROUP_NAME
sslCertPath: "$CERT_FILE"
sslKeyPath: "$KEY_FILE"$ENVIRONMENT_GROUP_NAME הוא השם של קבוצת סביבות עם כינויי מארחים תואמים, ו-$CERT_FILE ו-$KEY_FILE הם קובצי מפתח ואישור TLS. איך יוצרים אישורי TLS
אפשרות 2: סוד של Kubernetes
יוצרים סוד של Kubernetes ומוסיפים אותו לקובץ השינויים.
- יוצרים את הסוד במרחב השמות
apigee:kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME \ --from-file=key=$KEY_FILE \ --from-file=cert=$CERT_FILE
- מגדירים את המאפיין
virtualhostsבקובץ השינויים:virtualhosts: - name: $ENVIRONMENT_GROUP_NAME tlsMode: SIMPLE # Note: SIMPLE is the default, so it is optional. sslSecret: $SECRET_NAME - יוצרים שני סודות של Kubernetes במרחב השמות
apigee:kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME \ --from-file=key=$KEY_FILE \ --from-file=cert=$CERT_FILE
- יוצרים סוד לרשות האישורים:
kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME-cacert \ --from-file=cacert=$CA_FILE
- מגדירים את המאפיין
virtualhostsבקובץ השינויים:virtualhosts: - name: $ENVIRONMENT_GROUP_NAME tlsMode: MUTUAL # Note: Be sure to specify MUTUAL sslSecret: $SECRET_NAME
הגדרת mTLS
במקום TLS חד-כיווני, אפשר להגדיר mTLS בשער הכניסה. יש שתי אפשרויות להגדרת mTLS, כפי שמוסבר בהמשך.
אפשרות 1: צמד מפתח/אישור וקובץ CA
מספקים נתוני אישור TLS שמכילים אישורים של רשות אישורים:
virtualhosts:
- name: $ENVIRONMENT_GROUP_NAME
tlsMode: MUTUAL
caCertPath: "$CA_FILE"
sslCertPath: "$CERT_FILE"
sslKeyPath: "$KEY_FILE"$ENVIRONMENT_GROUP_NAME הוא השם של קבוצת סביבות עם כינויי מארח תואמים, $CA_FILE מציין נתוני אישור TLS (קובץ חבילת CA) שמכיל אישורים של רשות אישורים, ו-$CERT_FILE ו-$KEY_FILE הם קובצי מפתח ואישור TLS. איך יוצרים אישורי TLS
אפשרות 2: סודות של Kubernetes
ליצור שני סודות של Kubernetes. הסוד הראשון מיועד לזוג המפתחות/אישור ה-SSL, והסוד השני מיועד לרשות האישורים. לאחר מכן, מוסיפים אותם לקובץ ההחרגות.