הגדרת TLS ו-mTLS בשער הכניסה

בנושא הזה מוסבר איך להפעיל 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 ומוסיפים אותו לקובץ השינויים.

  1. יוצרים את הסוד במרחב השמות apigee:
    kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME  \
      --from-file=key=$KEY_FILE \
      --from-file=cert=$CERT_FILE
  2. מגדירים את המאפיין virtualhosts בקובץ השינויים:
    virtualhosts:
      - name: $ENVIRONMENT_GROUP_NAME
        tlsMode: SIMPLE  # Note: SIMPLE is the default, so it is optional.
        sslSecret: $SECRET_NAME
  3. הגדרת 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, והסוד השני מיועד לרשות האישורים. לאחר מכן, מוסיפים אותם לקובץ ההחרגות.

    1. יוצרים שני סודות של Kubernetes במרחב השמות apigee:
      kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME  \
        --from-file=key=$KEY_FILE \
        --from-file=cert=$CERT_FILE
    2. יוצרים סוד לרשות האישורים:
      kubectl create -n APIGEE_NAMESPACE secret generic $SECRET_NAME-cacert  \
        --from-file=cacert=$CA_FILE
    3. מגדירים את המאפיין virtualhosts בקובץ השינויים:
      virtualhosts:
        - name: $ENVIRONMENT_GROUP_NAME
          tlsMode: MUTUAL  # Note: Be sure to specify MUTUAL
          sslSecret: $SECRET_NAME