خط مشی DecodeJWS

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

چی

هدر JWS را بدون تایید امضای JWS رمزگشایی می کند و هر هدر را روی یک متغیر جریان می نویسد. این خط‌مشی زمانی بیشترین کاربرد را دارد که در هماهنگی با خط‌مشی VerifyJWS استفاده می‌شود، زمانی که مقدار یک هدر از داخل JWS باید قبل از تأیید امضای JWS شناخته شود.

یک JWS می‌تواند یک محموله متصل داشته باشد، مانند شکل:

header.payload.signature

یا، JWS می‌تواند محموله‌ای را که به آن پی‌بار جدا شده می‌گویند، حذف کند و به شکل زیر باشد:

header..signature

خط مشی DecodeJWS با هر دو شکل کار می کند زیرا فقط قسمت هدر JWS را رمزگشایی می کند. خط مشی DecodeJWS نیز بدون توجه به الگوریتمی که برای امضای JWS استفاده شده است، کار می کند.

برای معرفی دقیق و مروری بر فرمت یک JWS به نمای کلی سیاست های JWS و JWT مراجعه کنید.

ویدئو

برای یادگیری نحوه رمزگشایی JWT یک ویدیوی کوتاه را تماشا کنید. در حالی که این ویدیو مختص یک JWT است، بسیاری از مفاهیم برای JWS یکسان است.

نمونه: رمزگشایی یک JWS

خط مشی نشان داده شده در زیر یک JWS موجود در متغیر جریان var.JWS را رمزگشایی می کند. این متغیر باید وجود داشته باشد و دارای یک JWS زنده (قابل رمزگشایی) باشد. این خط مشی می تواند JWS را از هر متغیر جریان بدست آورد.

<DecodeJWS name="JWS-Decode-HS256">
    <DisplayName>JWS Verify HS256</DisplayName>
    <Source>var.JWS</Source>
</DecodeJWS>

برای هر هدر در قسمت سرصفحه JWS، این خط مشی یک متغیر جریان را تنظیم می کند به نام:

jws.policy-name.header.header-name

اگر JWS دارای یک payload متصل باشد، jws. policy-name .header.payload متغیر جریان jws. policy-name .header.payload به payload. برای یک محموله جدا، payload خالی است. برای فهرست کاملی از متغیرهای تنظیم شده توسط این خط مشی ، متغیرهای جریان را ببینید.

مرجع عنصر برای رمزگشایی JWS

مرجع خط مشی عناصر و ویژگی های خط مشی Decode JWS را توصیف می کند.

ویژگی هایی که برای عنصر سطح بالا اعمال می شود

<DecodeJWS name="JWS" continueOnError="false" enabled="true" async="false">

ویژگی های زیر برای همه عناصر اصلی خط مشی مشترک است.

<DisplayName>

<DisplayName>Policy Display Name</DisplayName>

علاوه بر ویژگی نام، برای برچسب‌گذاری خط‌مشی در ویرایشگر پروکسی رابط کاربری مدیریت با نامی متفاوت و به زبان طبیعی، از آن استفاده کنید.

<منبع>

<Source>JWS-variable</Source>

در صورت وجود، متغیر جریانی را مشخص می کند که در آن خط مشی انتظار دارد JWS را برای رمزگشایی پیدا کند.

متغیرهای جریان

پس از موفقیت، سیاست های Verify JWS و Decode JWS متغیرهای زمینه را مطابق این الگو تنظیم می کنند:

jws.{policy_name}.{variable_name}

به عنوان مثال، اگر نام خط مشی verify-jws باشد، این خط مشی الگوریتم مشخص شده در JWS را در این متغیر زمینه ذخیره می کند: jws.verify-jws.header.algorithm

مرجع خطا

This section describes the fault codes and error messages that are returned and fault variables that are set by Edge when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

متغیرهای خطا

این متغیرها زمانی تنظیم می شوند که یک خطای زمان اجرا رخ دهد. برای اطلاعات بیشتر، به آنچه باید در مورد خطاهای خط مشی بدانید مراجعه کنید.

نمونه پاسخ خطا

برای رسیدگی به خطا، بهترین روش به دام انداختن قسمت errorcode در پاسخ به خطا است. به متن موجود در faultstring تکیه نکنید، زیرا ممکن است تغییر کند.

مثال قانون خطا

<FaultRules>
    <FaultRule name="JWS Policy Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "TokenExpired")</Condition>
        </Step>
        <Condition>JWS.failed=true</Condition>
    </FaultRule>
</FaultRules>