Chính sách DecodeJWS

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Nội dung

Giải mã tiêu đề JWS mà không xác minh chữ ký trên JWS và ghi từng tiêu đề vào một biến luồng. Chính sách này hữu ích nhất khi được dùng cùng với chính sách VerifyJWS, khi bạn phải biết giá trị của một tiêu đề trong JWS trước khi xác minh chữ ký của JWS.

JWS có thể có tải trọng đính kèm, ở dạng:

header.payload.signature

Hoặc JWS có thể bỏ qua tải trọng (gọi là tải trọng độc lập) và có dạng:

header..signature

Chính sách DecodeJWS hoạt động với cả hai biểu mẫu vì chính sách này chỉ giải mã phần tiêu đề của JWS. Chính sách DecodeJWS cũng hoạt động bất kể thuật toán nào được dùng để ký JWS.

Hãy xem Tổng quan về các chính sách JWS và JWT để biết thông tin giới thiệu chi tiết và tổng quan về định dạng của JWS.

Video

Xem video ngắn này để tìm hiểu cách giải mã JWT. Mặc dù video này dành riêng cho JWT, nhưng nhiều khái niệm cũng tương tự đối với JWS.

Ví dụ: Giải mã JWS

Chính sách bên dưới sẽ giải mã một JWS có trong biến luồng var.JWS. Biến này phải có và chứa một JWS khả thi (có thể giải mã). Chính sách này có thể lấy JWS từ bất kỳ biến luồng nào.

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

Đối với mỗi tiêu đề trong phần tiêu đề của JWS, chính sách sẽ đặt một biến luồng có tên:

jws.policy-name.header.header-name

Nếu JWS có tải trọng được đính kèm, thì JWS sẽ đặt biến luồng jws.policy-name.header.payload thành tải trọng. Đối với tải trọng tách rời, payload đang trống. Hãy xem phần Biến luồng để biết danh sách đầy đủ các biến do chính sách này đặt.

Tài liệu tham khảo về phần tử cho Giải mã JWS

Tài liệu tham khảo về chính sách này mô tả các phần tử và thuộc tính của chính sách Giải mã JWS.

Các thuộc tính áp dụng cho phần tử cấp cao nhất

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

Các thuộc tính sau đây là thuộc tính chung của tất cả các phần tử chính của chính sách.

<DisplayName>

<DisplayName>Policy Display Name</DisplayName>

Sử dụng cùng với thuộc tính name để gắn nhãn chính sách trong trình chỉnh sửa proxy giao diện người dùng quản lý bằng một tên khác bằng ngôn ngữ tự nhiên.

<Source>

<Source>JWS-variable</Source>

Nếu có, hãy chỉ định biến luồng mà chính sách dự kiến sẽ tìm thấy JWS để giải mã.

Biến luồng

Sau khi thành công, các chính sách Xác minh JWS và Giải mã JWS đã được thiết lập biến ngữ cảnh theo mẫu sau:

jws.{policy_name}.{variable_name}

Ví dụ: nếu tên chính sách là verify-jws, thì chính sách sẽ lưu trữ thuật toán được chỉ định trong JWS cho biến ngữ cảnh này: jws.verify-jws.header.algorithm

Tham chiếu lỗi

Phần này mô tả các mã lỗi và thông báo lỗi được trả về, cũng như các biến lỗi do Edge đặt khi chính sách này kích hoạt lỗi. Thông tin này đóng vai trò quan trọng trong việc phát triển các quy tắc lỗi để xử lý lỗi. Để tìm hiểu thêm, hãy xem Những điều bạn cần biết về lỗi chính sách và Xử lý lỗi.

Lỗi thời gian chạy

Những lỗi này có thể xảy ra khi thực thi chính sách.

Lỗi triển khai

Những lỗi này có thể xảy ra khi bạn triển khai proxy chứa chính sách này.

Biến lỗi

Các biến này được đặt khi xảy ra lỗi thời gian chạy. Để biết thêm thông tin, hãy xem bài viết Những điều bạn cần biết về lỗi chính sách.

Ví dụ về phản hồi khi gặp lỗi

Để xử lý lỗi, phương pháp hay nhất là bẫy phần errorcode của lỗi của bạn. Đừng dựa vào văn bản trong faultstring vì văn bản này có thể thay đổi.

Ví dụ về quy tắc lỗi

<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>