اصالت‌سنجی پایه یکی از روش‌های اصالت‌سنجی هنگام تماس با «میانای برنامه‌سازی کاربردی مدیریت Edge» است.
برای مثال، می‌توانید درخواست curl زیر را به Edge management API ارسال کنید تا به اطلاعات سازمانتان دسترسی پیدا کنید:
curl -u USER_NAME:PASSWORD http://MS_IP_DNS:8080/v1/organizations/ORG_NAME
در این مثال، از گزینه curl -u برای ارسال اعتبارنامه‌های اصالت‌سنجی «پایه» استفاده می‌کنید. یا می‌توانید یک کد OIDC/OAuth2 را در سرصفحه Authorization: Bearer ارسال کنید تا
تماس‌های API مدیریت Edge را برقرار کنید، همان‌طور که در مثال زیر نشان داده شده است:
curl -H "Authorization: Bearer ACCESS_TOKEN" http://MS_IP_DNS:8080/v1/organizations/ORG_NAME
پس‌از فعال کردن IDP خارجی برای اصالت‌سنجی، می‌توانید اصالت‌سنجی «پایه» را به‌صورت اختیاری غیرفعال کنید. اگر «اصالت‌سنجی پایه» را غیرفعال کنید، همه دستورگان‌ها (مثل Maven، پوسته، و apigeetool) که به فراخوان‌های Edge management API پشتیبان «اصالت‌سنجی پایه» متکی هستند دیگر کار نخواهند کرد. باید هرگونه فراخوانی میانای برنامه‌سازی کاربردی و دستورگانی را که از اصالت‌سنجی «پایه» برای ارسال کد دسترسی OAuth2 در سرصفحه Bearer استفاده می‌کند به‌روز کنید.
دریافت و بازآوری کردن ژتون‌ها با get_token
برنامه کمکی get_token از «جریان کد دستگاه OAuth 2.0» استاندارد برای دریافت کدهای دسترسی و بازآوری OIDC/OAuth2 استفاده می‌کند. برنامه کمکی از شما می‌خواهد برای اصالت‌سنجی ازطریق ارائه‌دهنده هویت خارجی (یا LDAP محلی) به نشانی وب در مرورگرتان بروید، و سپس به‌طور خودکار قفل پایانه را برای چاپ کردن کد دسترسی معتبر باز می‌کند.
برنامه کمکی get_token نشانه‌ها را به‌طور ایمن در دیسک در ~/.sso-cli/ ذخیره می‌کند و برای استفاده درصورت نیاز آماده است. همچنین کد دسترسی معتبری را برای stdout چاپ می‌کند. اگر داده‌واحد موجودی قابل‌بازآوری باشد، این ابزار به‌طور خودکار آن را بازآوری خواهد کرد. اگر ژتون بازآوری منقضی شود، جریان صدور مجوز جدیدی مبتنی بر مرورگر شروع خواهد شد.
برای دریافت کد دسترسی OAuth2 برای برقراری تماس‌های Edge management API:
- برنامه‌های کمکی
get_tokenوacurlدر گره میزبان Apigee SSO (گره OpenLDAP) در این مکان ازپیش نصب شده‌اند:/opt/apigee/apigee-openldap/bin/ - (اختیاری) متغیر محیطی
SSO_LOGIN_URLرا روی نشانی وب صادرکننده SSO خود تنظیم کنید، به این شکل:export SSO_LOGIN_URL="http://EDGE_SSO_IP_DNS:9099"
که در آن EDGE_SSO_IP_DNS نشانی IP یا نام ساناد دستگاه میزبان Apigee SSO است. اگر «امنیت لایه انتقال» را در «شناسایی یگانه Apigee» پیکربندی کرده‌اید، از
httpsو شماره درگاه صحیح «امنیت لایه انتقال» استفاده کنید. get_tokenرا با نشانی ایمیلتان فراخوانی کنید تا «جریان کد دستگاه OAuth 2.0» را آغاز کنید:/opt/apigee/apigee-openldap/bin/get_token -u EMAIL_ADDRESS
که در آن EMAIL_ADDRESS نشانی ایمیل کاربر Edge است.
- برنامه کمکی موقتاً متوقف می‌شود و نشانی وب و کد دستگاه ۸ نویسه‌ای را در پایانه شما چاپ می‌کند:
Please visit: http://EDGE_SSO_IP_DNS:9099/device And enter code: ABCD-EFGH
- نشانی وب مشخص‌شده را در مرورگرتان باز کنید، کد دستگاه را وارد کنید، و روی ارسال کلیک کنید. برای اصالت‌سنجی و تأیید درخواست، به IDP خارجی (یا فرم LDAP محلی) هدایت خواهید شد.
- پس‌از اینکه اصالت‌سنجی در مرورگر با موفقیت انجام شد، به پایانه برگردید. برنامه کمکی
get_tokenبه‌طور خودکار تأیید را شناسایی می‌کند، کد دسترسی OAuth2 را دریافت می‌کند، آن را روی صفحه چاپ می‌کند، و آن را به‌طور ایمن ذخیره می‌کند. - بااستفاده از ابزار کمکی
acurl، کد دسترسی را به فراخوانی Edge management API ارسال کنید. این ابزار کمکی به‌طور خودکار کد ذخیره‌شده در حافظه نهان را می‌خواند و سرصفحه Bearer را تزریق می‌کند:/opt/apigee/apigee-openldap/bin/acurl http://MS_IP_DNS:8080/v1/organizations/ORG_NAME
یا اینکه می‌توانید کد را بااستفاده از
curlاستاندارد به‌صورت دستی ارسال کنید:curl -H "Authorization: Bearer ACCESS_TOKEN" \ http://MS_IP_DNS:8080/v1/organizations/ORG_NAME
از میانای برنامه‌سازی کاربردی مدیریت برای دریافت و بازآوری کردن ژتون‌ها استفاده کنید
نقطه پایانی قدیمی /passcode برداشته شده است. بنابراین، کاربران انسانی باید از ابزار کمکی get_token همان‌طور که قبلاً توضیح داده شد استفاده کنند تا «جریان کد دستگاه OAuth 2.0» مبتنی بر مرورگر را برای اصالت‌سنجی اولیه آغاز کنند.
اگر درحال نوشتن دستورگان یا خطوط لوله CI/CD هستید که نمی‌توانند با مرورگر تعامل داشته باشند، خودکارسازی وظایف با کاربران ماشین را ببینید. کاربران ماشین خودکار یا برنامه‌های دارای اطلاعات اعتباری معتبر می‌توانند از تماس‌های استاندارد «میانای برنامه‌سازی کاربردی» برای دریافت و بازآوری کد استفاده کنند.