‫OAuth 2.0: پیکربندی پراکسی جدید میانای برنامه‌سازی کاربردی

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

اگر از نسخه Apigee Cloud مربوط به Edge استفاده می‌کنید، می‌بینید که یک پراکسی به‌نام oauth به‌طور پیش‌فرض در سازمانتان گنجانده شده است. این پراکسی دو نقطه پایانی نمونه برای تولید کردن کدهای دسترسی و بازآوری ارائه می‌دهد. اگر می‌خواهید درباره نقطه‌های پایانی کد OAuth بیشتر بدانید، به آشنایی با نقطه‌های پایانی OAuth مراجعه کنید.

نوع اعطای اطلاعات اعتباری مشتری رویه‌ای را برای صدور کد دسترسی در ازای اطلاعات اعتباری برنامه تعریف می‌کند. این اطلاعات اعتباری برنامه جفت کلید مصرف‌کننده و رمز است که Apigee Edge برای هر برنامه‌ای که در سازمانی ثبت شده است صادر می‌کند. برای جزئیات بیشتر، به پیاده‌سازی نوع اعطای کد مجوز مراجعه کنید.

افزودن OAuth 2.0 به پراکسی جدید میانای برنامه‌سازی کاربردی

وقتی کارگزار میانای برنامه‌سازی کاربردی جدیدی ایجاد می‌کنید، می‌توانید به‌راحتی درستی‌سنجی OAuth را به میانای برنامه‌سازی کاربردی اضافه کنید.

Edge

برای افزودن درستی‌سنجی OAuth به یک «میانای برنامه‌سازی کاربردی» بااستفاده از «واسط کاربر Edge»:

  1. به سیستم apigee.com/edge وارد شوید.
  2. در نوار پیمایش سمت راست، توسعه > پراکسی‌های API را انتخاب کنید.
  3. روی + پراکسی کلیک کنید
  4. از جادوگر «ایجاد پراکسی» برای ایجاد پراکسی معکوس استفاده کنید. ساختن پراکسی میانای برنامه‌سازی کاربردی ساده را ببینید.
  5. در صفحه خط‌مشی‌های مشترک در دستیار، دکمه رادیویی کنار OAuth v2.0 را انتخاب کنید.

Classic Edge (ابر خصوصی)

برای افزودن درستی‌سنجی OAuth به یک «میانای برنامه‌سازی کاربردی» بااستفاده از «واسط کاربر Classic Edge»:

  1. به سیستم http://ms-ip:9000 وارد شوید، که در آن ms-ip نشانی IP یا نام ساناد گره «سرور مدیریت» است.
  2. در نوار پیمایش بالا، میاناهای برنامه‌سازی کاربردی > پراکسی‌های میانای برنامه‌سازی کاربردی را انتخاب کنید.
  3. روی + پراکسی API کلیک کنید
  4. از جادوگر «ایجاد پراکسی» برای ایجاد پراکسی معکوس استفاده کنید. ساختن پراکسی میانای برنامه‌سازی کاربردی ساده را ببینید.
  5. در صفحه امنیت جادوگر، دکمه رادیویی کنار OAuth v2.0 را انتخاب کنید.

وقتی این گزینه را انتخاب می‌کنید، دو خط‌مشی به کارگزاری API که به‌تازگی ایجاد شده است پیوست می‌شود، یکی برای درستی‌سنجی کدهای دسترسی و دیگری برای حذف کد دسترسی پس‌از درستی‌سنجی آن.

توجه داشته باشید که چارگوش انتخاب Publish API Product قابل انتخاب می‌شود و به‌طور خودکار انتخاب می‌شود. اگر می‌خواهید هنگام ساختن پراکسی جدید API، محصول به‌طور خودکار تولید شود، این گزینه را علامت بزنید. محصول تولیدشده به‌طور خودکار با یک ارتباط به پراکسی جدید API ایجاد خواهد شد. اگر محصولی ازقبل دارید که می‌خواهید این میانای برنامه‌سازی کاربردی جدید را با آن مرتبط کنید، حتماً این چارگوش انتخاب را لغو کنید تا محصول غیرضروری ایجاد نکنید. برای کسب اطلاعات درباره محصولات، محصول میانای برنامه کاربردی چیست؟ را ببینید.

کار کردن با پراکسی OAuth پیش‌فرض

پراکسی oauth نشانی وب نقطه پایان زیر را آشکار می‌کند:

/oauth/client_credential/accesstoken

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

نقطه پایان کد اطلاعات اعتباری کارخواه پیش‌فرض در شبکه در نشانی وب زیر نمایان است: URL:

https://{org_name}-{env_name}.apigee.net/oauth/client_credential/accesstoken

برای مثال، اگر نام سازمان شما «apimakers» باشد، نشانی وب به‌صورت زیر خواهد بود:

https://apimakers-test.apigee.net/oauth/client_credential/accesstoken

این نشانی وبی است که توسعه‌دهندگان برای دریافت کدهای دسترسی فراخوانی می‌کنند.

فراخوانی میانای برنامه‌سازی کاربردی

وقتی کد دسترسی را دریافت کردید، می‌توانید با سرصفحه «مجوز» و کد حامل، مانند این، با میانای برنامه‌سازی کاربردی تماس بگیرید:

curl -H "Authorization: Bearer <your access token>" http://myorg-myenv.apigee.net/myapi

همچنین تأیید کردن کدهای دسترسی را ببینید.