فعال کردن SAML برای API BaaS

Edge for Private Cloud v. 4.17.09

پس‌از فعال کردن SAML برای Edge، می‌توانید SAML را برای API BaaS فعال کنید. پشتیبانی از SAML برای API BaaS نیازمند آن است که قبلاً واحد Edge SSO را در گره «سرور مدیریت 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» و هم در «پشته» فعال کنید، به همین ترتیب.

ابتدا یک فایل پیکربندی برای پیکربندی 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» پیکربندی کنید:
    > /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 تنظیم نکرده‌اند باید پیوند بازنشانی گذرواژه را در صفحه ورود به سیستم انتخاب کنند تا گذرواژه جدیدی تنظیم کنند.
  3. برای بازراه‌اندازی کردن درگاه، فرمان زیر را اجرا کنید:
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal restart
  4. پیکربندی پشته BaaS:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure-sso -f configFile