DeleteOAuthV2Info

درحال مشاهده اسناد 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">
مشخصه شرح پیش‌فرض حضور
غیرهمگام

روی true تنظیم کنید تا مشخص کنید خط‌مشی باید در استخر رشته‌ای متفاوت از استخر سرویس‌دهنده جریان درخواست/پاسخ اجرا شود. پیش‌فرض false است.

این تنظیم فقط برای بهینه‌سازی داخلی استفاده می‌شود.

نادرست اختیاری
continueOnError

انتظار می‌رود اکثر خط‌مشی‌ها درصورت بروز خطا، خطا برگردانند. با تنظیم این مشخصه روی true، اجرای «جریان» درصورت عدم موفقیت ادامه می‌یابد.

نادرست اختیاری
فعال شد تعیین می‌کند که آیا خط‌مشی اجرا می‌شود یا نه. اگر روی false تنظیم شود، خط‌مشی «خاموش» می‌شود و اعمال نمی‌شود (حتی اگر خط‌مشی به «جریان» پیوست شده باشد). درست اختیاری
نام

نام داخلی خط‌مشی. این نام در عناصر «مرحله» برای پیوست کردن خط‌مشی به «جریان» ارجاع داده می‌شود.

توجه: نویسه‌هایی که می‌توانید در نام استفاده کنید به موارد زیر محدود می‌شود: A-Z0-9._\-$ %. «میانای کاربر مدیریت» محدودیت‌های بیشتری را اعمال می‌کند، مثلاً نویسه‌هایی را که الفبایی عددی نیستند به‌طور خودکار برمی‌دارد.

موجود نیست الزامی

عنصر <AccessToken>

متغیری را که کد دسترسی برای حذف در آن قرار دارد شناسایی می‌کند. برای مثال، اگر کد دسترسی به‌عنوان پارامتر پُرسمان با نام «access_token» به پیام درخواست پیوست شده است، request.queryparam.access_token را مشخص کنید. می‌توانید از هر متغیر معتبری که به نشان ارجاع می‌دهد استفاده کنید. یا می‌تواند رشته نشانه تحت‌اللفظی را ارسال کند (مورد نادر).

 <AccessToken ref="request.queryparam.access_token"></AccessToken>
پیش‌فرض: موجود نیست
حضور: یا <AccessToken> یا <AuthorizationCode> لازم است.
نوع: رشته

مشخصه‌ها

مشخصه شرح پیش‌فرض حضور
مرجع

متغیر کد دسترسی. معمولاً از متغیر جاری‌سازی بازیابی می‌شود. برای مثال: request.header.token یا request.queryparam.token.

موجود نیست اختیاری

عنصر <AuthorizationCode>

متغیری را که کد مجوز حذف در آن قرار دارد شناسایی می‌کند. برای مثال، اگر کد تأیید هویت به‌عنوان پارامتر پُرسمان با نام «code» به پیام درخواست پیوست شده است، request.queryparam.code را مشخص کنید. می‌توانید از هر متغیر معتبری که به کد ارجاع می‌دهد استفاده کنید. یا می‌تواند رشته نشانه تحت‌اللفظی را ارسال کند (مورد نادر).

 <AccessToken ref="request.queryparam.access_token"></AccessToken>
پیش‌فرض: موجود نیست
حضور: یا <AccessToken> یا <AuthorizationCode> لازم است.
نوع: رشته

مشخصه‌ها

مشخصه شرح پیش‌فرض حضور
مرجع

متغیر کد دسترسی. معمولاً از متغیر جاری‌سازی بازیابی می‌شود. برای مثال: request.header.code یا request.queryparam.code.

موجود نیست اختیاری

عنصر<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 دردسترس است.

موضوعات مرتبط