درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
برای اینکه Apigee Edge به‌عنوان سرور مجوز OAuth2 کار کند، باید نقاط پایانی را آشکار کند که در آن‌ها کارخواه‌ها بتوانند کد مجوز و کد درخواست کنند. این موضوع مقدمه‌ای سریع بر این نقاط پایانی ارائه می‌دهد و نحوه راه‌اندازی آن‌ها در Edge را به شما نشان می‌دهد.
نقطه پایان OAuth2 چیست؟
نقطه پایان OAuth2 نشانی وبی است که کارخواه‌ها برای درخواست کدهای OAuth (یا کدهای مجوز) فراخوانی می‌کنند. در اینجا یک درخواست نمونه برای کد دسترسی آورده شده است:
$ curl -i -H 'ContentType: x-www-form-urlencoded' \ -X POST 'https://docs-test.apigee.net/oauth/client_credential/accesstoken' \ -d 'grant_type=client_credentials' \ -H 'Authorization: Basic c3FIOG9vSGV4VHo4QzAySVg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ'
در محیط Apigee Edge، خط‌مشی‌ای برای مدیریت این نوع درخواست لازم است. همان‌طور که می‌توانید از درخواست استنباط کنید، خط‌مشی باید از نوع اعطای «اطلاعات اعتباری مشتری» پشتیبانی کند و خط‌مشی باید در مسیر /oauth/client_credentials/accesstoken اجرا شود.
خط‌مشی صحیح در این مورد خط‌مشی OAuthV2 است که برای اجرا در جریانی مانند مثال زیر پیکربندی شده است (که در آن نام خط‌مشی GenerateAccessTokenClient است):
<Flow name="AccessTokenClientCredential">
<Description/>
<Request>
<Step>
<FaultRules/>
<Name>GenerateAccessTokenClient</Name>
</Step>
</Request>
<Response/>
<Condition>(proxy.pathsuffix MatchesPath "/accesstoken") and (request.verb = "POST")</Condition>
</Flow>اگر مشتری اطلاعات اعتباری صحیح را ارائه دهد، خط‌مشی یک کد تولید و برمی‌گرداند؛ درغیراین‌صورت، خطایی برمی‌گرداند.
درحال مکان‌یابی نقطه‌های پایانی پیش‌فرض
Apigee به‌طور پیش‌فرض یک پراکسی نقطه پایانی OAuth2 نمونه به هر سازمان جدیدی که ایجاد می‌کند اضافه می‌کند. اگر جستجو کنید، در سازمانتان کارگزاری به‌نام oauth پیدا خواهید کرد.
برای پیدا کردن این پراکسی:
- همان‌طور که در زیر توضیح داده شده است، به صفحه «پراکسی‌های میانای برنامه‌سازی کاربردی» دسترسی پیدا کنید.
Edge
برای دسترسی به صفحه «پراکسی‌های میانای برنامه‌سازی کاربردی» بااستفاده از «واسط کاربر Edge»:
- به سیستم apigee.com/edge وارد شوید.
- در نوار پیمایش سمت راست، توسعه > پراکسی‌های API را انتخاب کنید.
- روی +پراکسی کلیک کنید
Classic Edge (ابر خصوصی)
برای دسترسی به صفحه «پراکسی‌های API» بااستفاده از «واسط کاربر Classic Edge»:
- به سیستم
http://ms-ip:9000وارد شوید، که در آن ms-ip نشانی IP یا نام ساناد گره «سرور مدیریت» است. - در نوار پیمایش بالا، میاناهای برنامه‌سازی کاربردی > پراکسی‌های میانای برنامه‌سازی کاربردی را انتخاب کنید.
- در فهرست پراکسی‌ها، پراکسی‌ای به‌نام oauth را انتخاب کنید.
- در صفحه نمای کلی پراکسی، برگه توسعه را انتخاب کنید تا ویرایشگر پراکسی نمایان شود و خط‌مشی‌ها و جریان‌های موجود در پراکسی را بررسی کنید.
بهترین شیوه: پراکسی نقطه پایانی OAuth2 خودتان را ایجاد کنید
کارگزار نیابتی پیش‌فرض oauth محدود است: فقط از نوع اعطای اطلاعات اعتباری کارخواه پشتیبانی می‌کند. این پراکسی فقط به‌عنوان مثال درنظر گرفته شده است. برای تولید، می‌خواهید پراکسی‌ای ایجاد کنید که نقطه‌های پایانی OAuth2 را که با الزامات شما مطابقت دارند پیکربندی کند.
یک نکته مهم: پراکسی که نقاط پایانی OAuth2 را تعریف می‌کند معمولاً پراکسی «بدون هدف» است. کارگزار به‌عنوان سرویسی عمل می‌کند که در ProxyEndpoint اجرا می‌شود و مستقیماً به کارخواه برمی‌گردد.