درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
چه
کد صدور مجوز یا کد دسترسی OAuth V2 مشخصشده را حذف میکند.
نمونهها
حذف کد دسترسی
در زیر نمونهای از خطمشی مورداستفاده برای حذف کردن کد دسترسی OAuth 2.0 آورده شده است. مثال زیر
با جستجوی سرایندی بهنام
access_token، نشانه دسترسی را برای حذف در پیام درخواست پیدا میکند.
<DeleteOAuthV2Info name="DeleteAccessToken">
<AccessToken ref="request.header.access_token"></AccessToken>
</DeleteOAuthV2Info>در زیر یک خطمشی نمونه برای حذف کد اصالتسنجی OAuth 2.0 آورده شده است. مثال زیر با جستجوی پارامتر پُرسمان بهنام code، کد اصالت را در پیام درخواست پیدا میکند تا آن را حذف کند.
<DeleteOAuthV2Info name="DeleteAuthCode">
<AuthorizationCode ref="request.queryparam.code"></AuthorizationCode>
</DeleteOAuthV2Info>مرجع عنصر
مرجع عنصر، عناصر و مشخصههای خطمشی DeleteOAuthV2Info را توصیف میکند.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <DeleteOAuthV2Info async="false" continueOnError="false" enabled="true" name="DeleteOAuthV2Info-1"> <DisplayName>Delete OAuth v2.0 Info 1</DisplayName> <AccessToken ref={some-variable}></AccessToken> <!--<AuthorizationCode ref={some-variable}></AuthorizationCode>--> <Attributes/> </DeleteOAuthV2Info
مشخصههای <DeleteOAuthV2Info>
<DeleteOAuthV2Info async="false" continueOnError="false" enabled="true" name="Delete-OAuth-v20-Info-1">
| مشخصه | شرح | پیشفرض | حضور |
|---|---|---|---|
| غیرهمگام |
روی این تنظیم فقط برای بهینهسازی داخلی استفاده میشود. |
نادرست | اختیاری |
| continueOnError |
انتظار میرود اکثر خطمشیها درصورت بروز خطا، خطا برگردانند. با تنظیم این
مشخصه روی |
نادرست | اختیاری |
| فعال شد | تعیین میکند که آیا خطمشی اجرا میشود یا نه. اگر روی false تنظیم شود، خطمشی
«خاموش» میشود و اعمال نمیشود (حتی اگر خطمشی به
«جریان» پیوست شده باشد). |
درست | اختیاری |
| نام |
نام داخلی خطمشی. این نام در عناصر «مرحله» برای پیوست کردن خطمشی به «جریان» ارجاع داده میشود. توجه: نویسههایی که میتوانید در نام استفاده کنید به موارد زیر محدود میشود:
|
موجود نیست | الزامی |
عنصر <AccessToken>
متغیری را که کد دسترسی برای حذف در آن قرار دارد شناسایی میکند. برای مثال، اگر
کد دسترسی بهعنوان پارامتر پُرسمان با نام «access_token» به پیام درخواست پیوست شده است،
request.queryparam.access_token را مشخص کنید. میتوانید از هر متغیر معتبری که به
نشان ارجاع میدهد استفاده کنید. یا میتواند رشته نشانه تحتاللفظی را ارسال کند (مورد نادر).
<AccessToken ref="request.queryparam.access_token"></AccessToken>
| پیشفرض: | موجود نیست |
| حضور: | یا <AccessToken> یا <AuthorizationCode> لازم است. |
| نوع: | رشته |
مشخصهها
| مشخصه | شرح | پیشفرض | حضور |
|---|---|---|---|
| مرجع |
متغیر کد دسترسی. معمولاً از متغیر جاریسازی بازیابی میشود. برای
مثال: |
موجود نیست | اختیاری |
عنصر <AuthorizationCode>
متغیری را که کد مجوز حذف در آن قرار دارد شناسایی میکند. برای مثال، اگر کد
تأیید هویت بهعنوان پارامتر پُرسمان با نام «code» به پیام درخواست پیوست شده است،
request.queryparam.code را مشخص کنید. میتوانید از هر متغیر معتبری که به کد ارجاع میدهد استفاده کنید.
یا میتواند رشته نشانه تحتاللفظی را ارسال کند (مورد نادر).
<AccessToken ref="request.queryparam.access_token"></AccessToken>
| پیشفرض: | موجود نیست |
| حضور: | یا <AccessToken> یا <AuthorizationCode> لازم است. |
| نوع: | رشته |
مشخصهها
| مشخصه | شرح | پیشفرض | حضور |
|---|---|---|---|
| مرجع |
متغیر کد دسترسی. معمولاً از متغیر جاریسازی بازیابی میشود. برای
مثال: |
موجود نیست | اختیاری |
عنصر<DisplayName>
نامی به زبان طبیعی که خطمشی را در ویرایشگر پراکسی میانای کاربر مدیریت برچسبگذاری میکند. اگر حذف شود، از مشخصه نام خطمشی استفاده میشود.
<DisplayName>DeleteOAuthV2Info 1</DisplayName>
| پیشفرض: | مقدار مشخصه name خطمشی. |
| حضور: | اختیاری |
| نوع: | رشته |
خروجی
درصورت موفقیت، خطمشی وضعیت ۲۰۰ را برمیگرداند.
درصورت عدم موفقیت، خطمشی کد ۴۰۴ و بروندادی مشابه موارد زیر برمیگرداند (بسته به اینکه توکن دسترسی یا کد اصالتسنجی را حذف میکنید):
HTTP/1.1 404 Not Found Content-Type: application/json Content-Length: 144 Connection: keep-alive {"fault":{"faultstring":"Invalid Authorization Code","detail":{"errorcode":"keymanagement.service.invalid_request-authorization_code_invalid"}}}
طرح
هر نوع خطمشی با یک طرحواره XML (.xsd) تعریف میشود. برای مرجع، طرحوارههای خطمشی
در GitHub دردسترس است.