استفاده از میاناهای برنامه‌سازی کاربردی و ابزارهای کمکی سرپرست Edge پس‌از فعال کردن «شناسایی یگانه Apigee»

این بخش نحوه اجرای ابزارها و فرمان‌های سرپرست سیستم Edge را پس‌از فعال کردن Apigee SSO شرح می‌دهد. بسیاری از وظایف در Edge به اطلاعات اعتباری سرپرست سیستم نیاز دارند، ازجمله:

• ایجاد سازمان‌ها و محیط‌ها
• افزودن و برداشتن مؤلفه‌های Edge
• درحال اجرای apigee-adminapi.sh فرمان

بااین‌حال، پس‌از فعال کردن SSO در Edge، معمولاً Basic Auth را غیرفعال می‌کنید تا تنها راه اصالت‌سنجی ازطریق OIDC/SAML IDP باشد. بنابراین، باید مطمئن شوید که حساب سرپرست سیستم را به IDP خود اضافه کرده‌اید یا یک «کاربر ماشین» محلی برای خودکارسازی ایجاد کرده‌اید.

فراخوانی میاناهای برنامه‌سازی کاربردی مدیریت Edge به‌عنوان سرپرست سیستم

بسیاری از فراخوانی‌های Edge API مستلزم این است که اعتبارنامه‌های سرپرست سیستم را ارسال کنید. استفاده از SAML با Edge management API حاوی دستورالعمل‌هایی درباره نحوه دریافت و بازآوری کردن ژتون‌ها بااستفاده از ابزار کمکی get_token هنگام برقراری تماس‌های Edge management API است.

استفاده کردن از ابزار کمکی apigee-adminapi.sh با «شناسایی یگانه» Apigee

از ابزار کمکی apigee-adminapi.sh برای انجام همان کارهای پیکربندی Edge استفاده کنید که با برقراری تماس با Edge management API انجام می‌دهید. مزیت ابزار کمکی apigee-adminapi.sh این است که:

• از یک رابط خط فرمان ساده استفاده می‌کند
• تکمیل فرمان مبتنی بر زبانه را پیاده‌سازی می‌کند
• اطلاعات راهنمایی و استفاده را ارائه می‌دهد
• اگر تصمیم بگیرید میانای برنامه‌سازی کاربردی را امتحان کنید، می‌تواند فراخوانی میانای برنامه‌سازی کاربردی مربوطه را نمایش دهد

پس‌از فعال کردن Apigee SSO، دو روش اصلی برای ارسال اطلاعات کاربری به ابزار کمکی apigee-adminapi.sh دارید، بسته به اینکه سرپرست انسانی باشید یا اسکریپت خودکار.

بااستفاده از گزینه -h برای فرمان، می‌توانید همه گزینه‌های هر فرمان apigee-adminapi.sh را ببینید، ازجمله گزینه‌های مشخص کردن اطلاعات اعتباری SSO. برای مثال:

apigee-adminapi.sh orgs list -h

ارسال رمزیاب دارنده (برای سرپرستان انسانی)

چون «شناسایی یگانه» Apigee مدرن‌شده از جریان کپی-جای‌گذاری قدیمی /passcode پشتیبانی نمی‌کند، سرپرستان انسانی باید از ابزار کمکی get_token برای تکمیل جریان «کد دستگاه» OAuth 2.0 استفاده کنند و سپس کد حاصل را به اسکریپت ارسال کنند.

ابتدا، یک داده‌واحد دریافت کنید:

/opt/apigee/apigee-openldap/bin/get_token -u adminEmail

سپس، هنگام فراخوانی فرمان از این کد استفاده کنید:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \
  --admin adminEmail --oauth-token token_string

مکان:

• ‫oauth-flow passcode را مشخص می‌کند (این به نوشتار قدیمی علامت می‌دهد که یک رمز ارائه می‌شود).
• oauth-token حاوی رشته JWT خام به‌دست‌آمده از get_token است.

ارسال گذرواژه (فقط برای کاربران ماشین)

اگر استقرار زیرساخت را خودکارسازی می‌کنید، می‌توانید اعتبارنامه‌ها را مستقیماً بااستفاده از جریان password_grant ارسال کنید. بااین‌حال، اگر فدراسیون SAML/OIDC فعال باشد، کاربران سایه انسانی از ورود به سیستم با گذرواژه مسدود می‌شوند تا از دور زدن احراز هویت چندعاملی جلوگیری شود. ابتدا باید یک کاربر ماشین صریح در OpenLDAP فراهم کنید.

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow password_grant \
  --admin machineUserEmail --oauth-password machineUserPassword

مکان:

• گزینه sso-url نشانی وب Apigee SSO را مشخص می‌کند. اگر درگاه یا پروتکل را از ۹۰۹۹ و HTTP تغییر داده‌اید، آن‌ها را اصلاح کنید.
• ‫oauth-flow‏ password_grant را مشخص می‌کند.
• machineUserEmail نشانی ایمیل «کاربر ماشینی» خودکار است.
• oauth-password گذرواژه «کاربر ماشین» را مشخص می‌کند.

استفاده از ابزارهای Edge با «شناسایی یگانه Apigee»

بسیاری از ابزارهای کمکی Edge به اطلاعات اعتباری سرپرست سیستم نیاز دارند، ازجمله:

• apigee-provision برای ایجاد سازمان‌ها، محیط‌ها، و میزبان‌های مجازی استفاده می‌شود
• setup.sh برای افزودن گره به سیستم موجود استفاده می‌شود
• هر ابزار دیگری که در آن باید اعتبارنامه سرپرست سیستم را در فایل پیکربندی مشخص کنید

این ابزارها فایل پیکربندی را به‌عنوان ورودی می‌گیرند که اطلاعات اعتباری سرپرست سیستم را مشخص می‌کند. قبل‌از فعال شدن SSO، این کار بااستفاده از این ویژگی‌ها انجام می‌شود:

ADMIN_EMAIL="adminEmail"
APIGEE_ADMINPW="adminPWord"

پس‌از فعال کردن Apigee SSO، باید از ویژگی‌های متفاوتی برای مشخص کردن اطلاعات کاربری سرپرست سیستم استفاده کنید.

استفاده از کد حامل (برای سرپرستان انسانی)

برای استقرار تعاملی توسط سرپرستان انسانی، بااستفاده از ابزار get_token یک کد دریافت کنید و آن را ازطریق دارایی OAUTH_BEARER_TOKEN ارائه دهید:

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL="http://edge_sso_IP_DNS:9099"
OAUTH_FLOW="passcode"
OAUTH_BEARER_TOKEN="token_string"

مکان:

• ‫OAUTH_FLOW passcode را مشخص می‌کند (نشان می‌دهد که یک توکن ارائه شده است).
• ‫OAUTH_BEARER_TOKEN حاوی رشته JWT خام دریافت‌شده از get_token است.

استفاده از گذرواژه (فقط برای کاربران ماشین)

برای استقرارهای کاملاً خودکار، اطلاعات کاربری «کاربر ماشین» صریحاً تأمین‌شده را بااستفاده از جریان password_grant ارائه دهید:

ADMIN_EMAIL="machineUserEmail"
SSO_LOGIN_URL="http://edge_sso_IP_DNS:9099"
OAUTH_FLOW="password_grant"
OAUTH_ADMIN_PASSWORD="machineUserPassword"

مکان:

• ‫SSO_LOGIN_URL نشانی وب Apigee SSO را مشخص می‌کند.
• ‫OAUTH_FLOW‏ password_grant را مشخص می‌کند.
• OAUTH_ADMIN_PASSWORD گذرواژه «کاربر ماشین» را مشخص می‌کند.