سياسة فك الترميز

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

الأدوات المستخدمة

يفك ترميز عنوان JWS بدون التحقّق من التوقيع على JWS، ويكتب كل عنوان في متغيّر تدفّق. تكون هذه السياسة أكثر فائدة عند استخدامها بالتزامن مع سياسة VerifyJWS، عندما يجب معرفة قيمة عنوان من داخل JWS قبل التحقّق من توقيع JWS.

يمكن أن يحتوي JWS على حمولة مرفقة، كما في النموذج:

header.payload.signature

أو يمكن أن يحذف JWS الحمولة، ويُطلق عليها اسم حمولة منفصلة، ويكون بالشكل التالي:

header..signature

تعمل سياسة DecodeJWS مع كلا النموذجين لأنّها لا تفك ترميز جزء العنوان من JWS إلا. تعمل سياسة DecodeJWS أيضًا بغض النظر عن الخوارزمية التي تم استخدامها لتوقيع JWS.

يمكنك الاطّلاع على نظرة عامة على سياسات JWS وJWT للحصول على مقدمة تفصيلية ونظرة عامة على تنسيق JWS.

فيديو

شاهِد فيديو قصيرًا لمعرفة كيفية فك ترميز رمز 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 يتضمّن حمولة مرفقة، سيتم ضبط متغيّر المسار jws.policy-name.header.payload على الحمولة. بالنسبة إلى الحمولة المنفصلة، يكون payload فارغًا. اطّلِع على متغيرات التدفق للحصول على قائمة كاملة بالمتغيرات التي تحدّدها هذه السياسة.

مرجع العنصر لـ "فك ترميز JWS"

يصف مرجع السياسة عناصر وسمات سياسة Decode JWS.

السمات التي تنطبق على العنصر ذي المستوى الأعلى

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

السمات التالية مشتركة بين جميع العناصر الرئيسية للسياسة.

<DisplayName>

<DisplayName>Policy Display Name</DisplayName>

استخدِم هذه السمة بالإضافة إلى سمة الاسم لتصنيف السياسة في أداة تعديل وكيل واجهة المستخدم الإدارية باستخدام اسم مختلف بلغة طبيعية.

<Source>

<Source>JWS-variable</Source>

إذا كانت هذه السمة متوفّرة، فإنّها تحدّد متغيّر التدفق الذي تتوقّع السياسة العثور فيه على JWS لفك تشفيره.

متغيّرات التدفق

بعد النجاح، تم ضبط السياستَين التحقّق من JWS وفك ترميز JWS. متغيرات السياق وفقًا لهذا النمط:

jws.{policy_name}.{variable_name}

على سبيل المثال، إذا كان اسم السياسة هو verify-jws، يتم تخزين السياسة. الخوارزمية المحدّدة في JWS لمتغير السياق هذا: jws.verify-jws.header.algorithm

مرجع الخطأ

يصف هذا القسم رموز الأخطاء ورسائل الخطأ التي يتم عرضها ومتغيرات الأخطاء التي تضبطها Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد للأخطاء للتعامل معها. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

أخطاء في وقت التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

متغيّرات الأخطاء

يتم ضبط هذه المتغيّرات عند حدوث خطأ في بيئة التشغيل. يمكنك الاطّلاع على مقالة ما تحتاج إلى معرفته للحصول على مزيد من المعلومات. حول أخطاء السياسة.

مثال على استجابة الخطأ

لمعالجة الخطأ، أفضل ممارسة هي رصد الجزء 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>