הפעלת SAML עבור API BaaS

Edge for Private Cloud גרסה 4.17.09

אחרי שמפעילים את SAML ב-Edge, אפשר להפעיל את SAML ב-API BaaS. כדי להשתמש בתמיכה של SAML ב-API BaaS, צריך להתקין ולהגדיר את מודול ה-SSO של Edge בצומת של שרת הניהול של Edge.

התהליך הכללי להפעלת SAML ל-API BaaS הוא:

  1. מגדירים את SAML ב-Edge, כמו שמתואר במאמר התקנה והגדרה של SAML ל-Edge.
  2. מתקינים את API BaaS ומוודאים שההתקנה פועלת כמו שצריך. זה כולל יצירת ארגוני BaaS. התקנת API BaaS.
  3. לכל משתמשי BaaS הקיימים, כולל מנהל המערכת של BaaS ומנהלי הארגון של BaaS, יוצרים משתמש תואם ב-IDP. כתובת האימייל של המשתמש ב-IDP צריכה להיות זהה לכתובת ששימשה ליצירת המשתמש ב-BaaS.
  4. מגדירים SAML ב-API BaaS.

הגדרת SAML ב-API BaaS

כדי להגדיר SAML ב-API BaaS, צריך להפעיל אותו גם בפורטל BaaS וגם ב-Stack, בסדר הזה.

קודם יוצרים קובץ תצורה כדי להגדיר את SAML:

# IP address of BaaS Portal
IP1=11.111.11.111

# IP address of apigee-sso node
IP2=22.222.22.222

# Information about apigee-sso.
# Externally accessible IP or DNS of apigee-sso.
SSO_PUBLIC_URL_HOSTNAME=$IP2
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on apigee-sso.
SSO_PUBLIC_URL_SCHEME=http

# SSO admin credentials as set when you installed apigee-sso.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=Secret123

# The name of the OAuth client used to connect to apigee-sso.
# The default client name is "baas". 
BAAS_SSO_CLIENT_NAME=baas

# If set, the existing BAAS client is deleted and new one is created.
# The default value is "n".
# Set to "y" when you reconfigure SAML and change the value of 
# any of the BAAS_* properties.
BAAS_SSO_CLIENT_OVERWRITE=y

# API BaaS Portal properties:
BAAS_SSO_ENABLED=y

# Comma separated list of URLs for the BAAS portal, 
# in the format:  http_or_https://IP_or_hostname_of_UI:9000. 
# You can have multiple URLs when you have multiple installations
# of the BAAS portal or you have multiple data centers.
BAAS_PUBLIC_URIS=http_or_https://IP_or_hostname_of_BAAS:9000
BAAS_SSO_REGISTERED_PUBLIC_URIS=$BAAS_PUBLIC_URIS

# API BaaS Stack properties
BAAS_SSO_ENABLED=y

כדי להגדיר את API BaaS כך שיאפשר תמיכה ב-SAML:

  1. מריצים את הפקודה הבאה כדי להגדיר SAML בפורטל BaaS:
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal configure-sso -f samlConfigFile

    כאשר samlConfigFile הוא קובץ התצורה של SAML.
  2. מריצים את הפקודה הבאה כדי להפעיל מחדש את הפורטל:
    > ‎/opt/apigee/apigee-service/bin/apigee-service baas-portal restart
  3. מריצים את הפקודה הבאה כדי להגדיר SAML בכל הצמתים של BaaS Stack:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure-sso -f samlConfigFile

כדי לשנות את הערכים האלה בהמשך, מעדכנים את קובצי התצורה ומבצעים שוב את השלבים האלה.

השבתת SAML ב-API BaaS

כדי להשבית את SAML ב-API BaaS:

  1. עורכים את קובץ התצורה שבו השתמשתם כדי להגדיר את SAM, ומגדירים:
    BAAS_SSO_ENABLED=n
  2. מגדירים את פורטל BaaS:
    > ‎/opt/apigee/apigee-service/bin/apigee-service baas-portal configure-sso -f configFile

    הערה: משתמשים שמעולם לא הגדירו סיסמת BaaS צריכים לבחור בקישור Reset password בדף ההתחברות כדי להגדיר סיסמה חדשה.
  3. מריצים את הפקודה הבאה כדי להפעיל מחדש את הפורטל:
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal restart
  4. מגדירים את BaaS Stack:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure-sso -f configFile