ถอดรหัสนโยบาย JWS

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X info

อะไร

ถอดรหัสส่วนหัวของ JWS โดยไม่ต้องยืนยันลายเซ็นใน JWS และเขียนส่วนหัวแต่ละรายการลงในตัวแปรโฟลว์ นโยบายนี้มีประโยชน์มากที่สุดเมื่อใช้ร่วมกับนโยบาย VerifyJWS ในกรณีที่ต้องทราบค่าของส่วนหัวจากภายใน JWS ก่อนที่จะยืนยันลายเซ็นของ JWS

JWS สามารถมีเพย์โหลด แนบ ได้ในรูปแบบต่อไปนี้

header.payload.signature

หรือ JWS สามารถละเว้นเพย์โหลด ซึ่งเรียกว่าเพย์โหลด แยก และอยู่ในรูปแบบต่อไปนี้

header..signature

นโยบาย DecodeJWS ใช้ได้กับทั้ง 2 รูปแบบเนื่องจากถอดรหัสเฉพาะส่วนหัวของ 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 มีเพย์โหลดแนบอยู่ นโยบายจะตั้งค่าตัวแปรโฟลว์ jws.policy-name.header.payload เป็นเพย์โหลด สำหรับเพย์โหลดที่แยกออกมา payload จะว่างเปล่า ดูรายการตัวแปรทั้งหมดที่นโยบายนี้ตั้งค่าได้ที่ ตัวแปรโฟลว์

ข้อมูลอ้างอิงองค์ประกอบสำหรับ Decode JWS

ข้อมูลอ้างอิงนโยบายจะอธิบายองค์ประกอบและแอตทริบิวต์ของนโยบาย Decode JWS

แอตทริบิวต์ที่ ใช้กับองค์ประกอบระดับบนสุด

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

แอตทริบิวต์ต่อไปนี้เป็นแอตทริบิวต์ทั่วไปขององค์ประกอบระดับบนสุดของนโยบายทั้งหมด

<DisplayName>

<DisplayName>Policy Display Name</DisplayName>

ใช้เพิ่มเติมจากแอตทริบิวต์ name เพื่อติดป้ายกำกับนโยบายในเครื่องมือแก้ไขพร็อกซีของ UI การจัดการ ด้วยชื่อภาษาธรรมชาติอื่น

<Source>

<Source>JWS-variable</Source>

หากมี จะระบุตัวแปรโฟลว์ที่นโยบายคาดว่าจะพบ JWS ที่จะ ถอดรหัส

ตัวแปรโฟลว์

เมื่อประสบความสำเร็จ นโยบาย ยืนยัน JWS และ Decode 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>