Khắc phục sự cố lỗi triển khai chính sách VerifyJWT

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

InvalidNameForAdditionalClaim

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision revision_number
Invalid name for additional claim : policy(policy_name) claim(claim_name).

Ví dụ về thông báo lỗi

Error Saving Revision 2
Invalid name for additional claim : policy(JWT-Verify-RS256) claim(iss).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu tên của thông báo xác nhận quyền sở hữu dùng trong phần tử con <Claim> của phần tử <AdditionalClaims> là một trong các tên đã đăng ký sau đây:

"kid", "iss", "sub", "aud", "iat", "exp", "nbf", "jti"

Thông báo xác nhận quyền sở hữu đã đăng ký được nêu rõ trong RFC7519.

Ví dụ: Việc sử dụng tên xác nhận quyền sở hữu iss trong thành phần <AdditionalClaims> sẽ dẫn đến lỗi này.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT và tên thông báo xác nhận quyền sở hữu trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256 và tên thông báo xác nhận quyền sở hữu là iss:

   Invalid name for additional claim : policy(JWT-Verify-RS256) claim(iss).
   

2. Xác minh rằng tên thông báo xác nhận quyền sở hữu dùng trong phần tử <AdditionalClaims> trong tệp XML chính sách JWT không thành công sẽ khớp với tên thông báo xác nhận quyền sở hữu được xác định trong thông báo lỗi ở Bước 1. Ví dụ: chính sách sau đây chỉ định thông báo xác nhận quyền sở hữu là iss, khớp với nội dung trong thông báo lỗi:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <SecretKey>
           <Value ref="private.secretkey"/>
           <Id>1918290</Id>
       </SecretKey>
       <ExpiresIn>1h</ExpiresIn>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalClaims>
           <Claim name="iss"/>
       </AdditionalClaims>
   </VerifyJWT>
   

3. Nếu tên xác nhận quyền sở hữu dùng trong phần tử con <Claim> của phần tử <AdditionalClaims> là một trong các tên đã đăng ký sau đây:

   "kid", "iss", "sub", "aud", "iat", "exp", "nbf", "jti"

   thì đó là nguyên nhân gây ra lỗi.

   Trong ví dụ về chính sách Xác minh JWT minh hoạ ở trên, tên <Claim> được chỉ định là iss trong phần tử <AdditionalClaims>, dẫn đến lỗi:

   Invalid name for additional claim : policy(JWT-Verify-RS256) claim(iss).
   

Độ phân giải

Không được sử dụng bất kỳ tên nào đã đăng ký như "kid", "iss", "sub", "aud", "iat", "exp", "nbf" hoặc "jti" trong phần tử con <Claim> của phần tử <AdditionalClaims>.

Để khắc phục vấn đề với chính sách Xác minh JWT mẫu, hãy thay đổi tên thông báo xác nhận quyền sở hữu thành status:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalClaims>
        <Claim name='status' type='string'>Development</Claim>
    </AdditionalClaims>
</VerifyJWT>

InvalidTypeForAdditionalClaim

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision revision_number
Invalid type for additional claim : policy(policy_name) claim(claim_name) type(type_name).

Ví dụ về thông báo lỗi

Error Saving Revision 2
Invalid type for additional claim : policy(JWT-Verify-RS256) claim(claim) type(integer).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Loại thông báo xác nhận quyền sở hữu dùng trong phần tử con <Claim> của phần tử <AdditionalClaims> của chính sách VerifyJWT không thuộc một trong các loại sau:

string (mặc định), number, boolean hoặc map

Ví dụ: việc sử dụng loại thông báo xác nhận quyền sở hữu integer trong phần tử <AdditionalClaims> sẽ dẫn đến lỗi.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT, tên thông báo xác nhận quyền sở hữu và loại thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256, tên thông báo xác nhận quyền sở hữu là claim và loại thông báo là integer:

   Invalid type for additional claim : policy(JWT-Verify-RS256) claim(claim) type(integer).
   

2. Xác minh rằng tên và loại thông báo xác nhận quyền sở hữu dùng trong phần tử <AdditionalClaims> trong tệp XML chính sách JWT không thành công sẽ khớp với tên và loại thông báo xác nhận quyền sở hữu được xác định trong thông báo lỗi ở Bước 1. Ví dụ: chính sách sau đây chỉ định thông báo xác nhận quyền sở hữu là claim và kiểu là integer, khớp với nội dung trong thông báo lỗi:

   <VerifyJWT name="JWT-Verify-RS256">
     <DisplayName>JWT Verify RS256</DisplayName>
     <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
     <SecretKey>
         <Value ref="private.secretkey"/>
         <Id>1918290</Id>
     </SecretKey>
     <ExpiresIn>1h</ExpiresIn>
     <Subject>monty-pythons-flying-circus</Subject>
     <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
     <Audience>fans</Audience>
     <Id/>
     <AdditionalClaims>
         <Claim name='claim' ref='reqclaim' type='integer'/>
     </AdditionalClaims>
   </VerifyJWT>
   

3. Nếu loại thông báo xác nhận quyền sở hữu dùng trong phần tử con <Claim> của phần tử <AdditionalClaims> không thuộc một trong các loại dưới đây:

   string (mặc định), number, boolean hoặc map

   thì đó là nguyên nhân gây ra lỗi.

   Trong ví dụ về chính sách Xác minh JWT nêu trên, loại <Claim> được chỉ định là integer trong phần tử <AdditionalClaims>. Vì integer không phải là loại được hỗ trợ nên bạn sẽ gặp lỗi:

   Invalid type for additional claim : policy(JWT-Verify-RS256) claim(claim) type(integer).
   

Độ phân giải

Đảm bảo chỉ sử dụng các kiểu dữ liệu được hỗ trợ string (mặc định), number, boolean hoặc map trong phần tử con <Claim> của phần tử <AdditionalClaims>.

Để sửa ví dụ về chính sách Xác minh JWT, hãy thay đổi loại thông báo xác nhận quyền sở hữu thành boolean:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalClaims>
        <Claim name='claim' ref='reqclaim' type='boolean'/>
    </AdditionalClaims>
</VerifyJWT>

MissingNameForAdditionalClaim

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision revision_number
Error occurred while validation of bean(policy_name.xml) Reason: - Required attribute name is missing in Claim.

Ví dụ về thông báo lỗi

Error Saving Revision 2
Error occurred while validation of bean JWT-Verify-RS256.xml. Reason: - Required attribute name is missing in Claim

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu tên thông báo xác nhận quyền sở hữu không được chỉ định trong phần tử con <Claim> của phần tử <AdditionalClaims> hoặc <AdditionalHeaders>.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256:

   Error occurred while validation of bean JWT-Verify-RS256.xml. Reason: - Required attribute name is missing in Claim
   

2. Kiểm tra tệp XML của chính sách JWT không thành công và xác minh rằng tên thông báo xác nhận quyền sở hữu bị thiếu trong phần tử con <Claims> thuộc phần tử <AdditionalClaims> hoặc <AdditionalHeaders>. Ví dụ: Chính sách Xác minh JWT sau đây không chỉ định tên thông báo xác nhận quyền sở hữu trong phần tử <AdditionalClaims>:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <SecretKey>
           <Value ref="private.secretkey"/>
           <Id>1918290</Id>
       </SecretKey>
       <ExpiresIn>1h</ExpiresIn>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalClaims>
           <Claim ref='reqclaim' type='boolean'/>
       </AdditionalClaims>
   </VerifyJWT>
   

   Vì tên <Claim> không được chỉ định trong phần tử <AdditionalClaims>, nên bạn gặp lỗi:

   Error occurred while validation of bean JWT-Verify-RS256.xml. Reason: - Required attribute name is missing in Claim
   

Độ phân giải

Hãy đảm bảo luôn chỉ định tên của thông báo xác nhận quyền sở hữu trong phần tử con <Claim> của phần tử <AdditionalClaims> hoặc <AdditionalHeaders>.

Để sửa ví dụ về chính sách Xác minh JWT, hãy chỉ định tên thông báo xác nhận quyền sở hữu như bên dưới:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalClaims>
        <Claim name='claim' ref='reqclaim' type='boolean'/>
    </AdditionalClaims>
</VerifyJWT>

InvalidNameForAdditionalHeader

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision revision_number
Invalid name for additional header : policy(policy_name)header(header_name).

Ví dụ về thông báo lỗi

Error Saving Revision 2
Invalid name for additional header: policy(JWT-Verify-RS256) header(alg).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu tên của thông báo xác nhận quyền sở hữu dùng trong phần tử con <Claim> của phần tử <AdditionalHeaders> là một trong các tiêu đề JWT chuẩn sau đây:

alg hoặc typ

Ví dụ: việc sử dụng tên xác nhận quyền sở hữu alg trong phần tử <AdditionalHeaders> sẽ gây ra lỗi.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT và tên tiêu đề trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256 và tên tiêu đề là alg:

   Invalid name for additional header: policy(JWT-Verify-RS256) header(alg).
   

2. Xác minh rằng tên tiêu đề dùng trong phần tử con <Claim> thuộc phần tử <AdditionalHeaders> của tệp XML chính sách JWT không thành công Xác minh rằng tên tiêu đề được xác định trong thông báo lỗi ở Bước 1. Ví dụ: chính sách sau đây chỉ định tiêu đề là alg, khớp với nội dung trong thông báo lỗi:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <SecretKey>
           <Value ref="private.secretkey"/>
           <Id>1918290</Id>
       </SecretKey>
       <ExpiresIn>1h</ExpiresIn>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalHeaders>
           <Claim name="alg"/>
       </AdditionalHeaders>
   </VerifyJWT>
   

3. Nếu tên tiêu đề dùng trong phần tử con <Claim> của phần tử <AdditionalClaims> là một trong các tiêu đề JWT chuẩn sau đây:

   alg hoặc typ

   thì đó là nguyên nhân gây ra lỗi.

   Trong ví dụ về chính sách Xác minh JWT minh hoạ ở trên, tên <Claim> được chỉ định là alg trong phần tử <AdditionalClaims>, dẫn đến lỗi:

   Invalid name for additional header: policy(JWT-Verify-RS256) header(alg).
   

Độ phân giải

Đừng sử dụng các tiêu đề JWT chuẩn alg hoặc typ trong phần tử con <Claim> của phần tử <AdditionalHeaders>.

Để sửa ví dụ về chính sách Xác minh JWT, hãy sử dụng tên x5c trong phần tử con <Claim> của phần tử <AdditionalHeaders>:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalHeaders>
        <Claim name='x5c'/>
    </AdditionalHeaders>
</VerifyJWT>

InvalidTypeForAdditionalHeader

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision revision_number
Invalid type for additional header : policy(policy_name) claim(claim_name) type(type_name).

Ví dụ về thông báo lỗi

Error Saving Revision 2
Invalid type for additional header : policy(JWT-Verify-RS256) claim(claim1) type(integer).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này sẽ xảy ra nếu loại thông báo xác nhận quyền sở hữu dùng trong phần tử con <Claim> của phần tử <AdditionalHeaders> của chính sách Xác minh JWT không thuộc một trong các loại sau đây:

string (mặc định), number, boolean hoặc map

Ví dụ: việc sử dụng loại thông báo xác nhận quyền sở hữu integer trong phần tử <AdditionalHeaders> sẽ gây ra lỗi.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT, tên thông báo xác nhận quyền sở hữu và loại thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256, tên thông báo xác nhận quyền sở hữu là claim và loại thông báo là integer:

   Invalid type for additional header : policy(JWT-Verify-RS256) claim(claim) type(integer).
   

2. Xác minh rằng tên và loại thông báo xác nhận quyền sở hữu dùng trong phần tử <AdditionalClaims> trong tệp XML chính sách JWT không thành công sẽ khớp với tên và loại thông báo xác nhận quyền sở hữu được xác định trong thông báo lỗi ở Bước 1. Ví dụ: chính sách sau đây chỉ định thông báo xác nhận quyền sở hữu là claim và loại thông báo xác nhận quyền sở hữu là integer, khớp với nội dung trong thông báo lỗi:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <SecretKey>
           <Value ref="private.secretkey"/>
           <Id>1918290</Id>
       </SecretKey>
       <ExpiresIn>1h</ExpiresIn>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalHeaders>
           <Claim name='claim' ref='reqclaim' type='integer'/>
       </AdditionalHeaders>
   </VerifyJWT>
   

3. Nếu loại thông báo xác nhận quyền sở hữu dùng trong phần tử con <Claim> của phần tử <AdditionalHeaders> không thuộc một trong các loại dưới đây:

   string (mặc định), number, boolean hoặc map

   thì đó là nguyên nhân gây ra lỗi.

   Trong ví dụ về chính sách Xác minh JWT nêu trên, loại <Claim> trong phần tử <AdditionalHeaders> được chỉ định là integer. Vì integer không phải là loại được hỗ trợ nên bạn sẽ gặp lỗi:

   Invalid type for additional header : policy(JWT-Verify-RS256) claim(claim) type(integer).
   

Độ phân giải

Đảm bảo chỉ sử dụng các kiểu dữ liệu được hỗ trợ string, number, boolean hoặc map trong phần tử con <Claim> của phần tử <AdditionalHeaders>.

Để sửa ví dụ về chính sách Xác minh JWT, hãy thay đổi loại thông báo xác nhận quyền sở hữu thành boolean:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalHeaders>
        <Claim name='claim' ref='reqclaim' type='boolean'/>
    </AdditionalHeaders>
</VerifyJWT>

InvalidValueOfArrayAttribute

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision revision_number
Invalid value for array attribute: policy(policy_name)claim(claim_name).

Ví dụ về thông báo lỗi

Error Saving Revision 2
Invalid value for array attribute: policy(JWT-Verify-RS256) claim(claim).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu giá trị của thuộc tính mảng trong phần tử con <Claim> của phần tử <AdditionalClaims> hoặc <AdditionalHeaders> không được đặt thành true hoặc false.

Ví dụ: việc đặt giá trị của thuộc tính mảng là yes trong phần tử con <Claim> của phần tử <AdditionalClaims> hoặc <AdditionalHeaders> gây ra lỗi.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT và tên thông báo xác nhận quyền sở hữu trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256 và tên thông báo xác nhận quyền sở hữu là claim:

   Invalid value for array attribute: policy(JWT-Verify-RS256) claim(claim).
   

2. Xác minh rằng tên thông báo xác nhận quyền sở hữu dùng trong phần tử con <Claim> thuộc phần tử <AdditionalHeaders> của tệp XML chính sách JWT không thành công. Xác minh rằng tên thông báo xác nhận quyền sở hữu được xác định trong thông báo lỗi ở Bước 1. Ví dụ: chính sách sau đây chỉ định tên xác nhận quyền sở hữu là claim, khớp với tên trong thông báo lỗi:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <SecretKey>
           <Value ref="private.secretkey"/>
           <Id>1918290</Id>
       </SecretKey>
       <ExpiresIn>1h</ExpiresIn>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalClaims>
           <Claim name='claim' ref='reqclaim' type='string' array='yes'/>
       </AdditionalClaims>
   </VerifyJWT>
   

3. Nếu giá trị của thuộc tính array trong phần tử con <Claim> của phần tử <AdditionalClaims> không được đặt thành true hoặc false, thì đó là nguyên nhân gây ra lỗi.

   Do thuộc tính array trong phần tử con <Claim> của phần tử <AdditionalClaims> được đặt thành yes trong ví dụ trên nên bạn sẽ gặp lỗi:

   Invalid value for array attribute: policy(JWT-Verify-RS256) claim(claim).
   

Độ phân giải

Đảm bảo rằng giá trị của thuộc tính mảng trong phần tử con <Claim> của các phần tử <AdditionalClaims> hoặc <AdditionalHeaders> được đặt thành true hoặc false.

Để sửa ví dụ về chính sách Xác minh JWT nêu trên, hãy thay đổi giá trị của thuộc tính mảng thành true:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalHeaders>
        <Claim name='claim' ref='reqclaim' type='string' array='true'/>
    </AdditionalHeaders>
</VerifyJWT>

InvalidValueForElement

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision
Invalid Value for element : policy(policy_name) element(element_name).

Ví dụ về thông báo lỗi

Error Saving Revision
Invalid Value for element : policy(JWT-Verify-RS256) element(Algorithm).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu giá trị được chỉ định trong phần tử <Algorithm> không phải là một trong các giá trị sau:

HS256, HS384, HS512, RS256, RS384, RS512

Ví dụ: việc chỉ định giá trị thuật toán là RS128 trong phần tử <Algorithm> sẽ dẫn đến lỗi này.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT và tên phần tử trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256 và tên phần tử là Algorithm:

   Invalid Value for element : policy(JWT-Verify-RS256) element(Algorithm).
   

2. Kiểm tra tệp XML của chính sách JWT không thành công và kiểm tra giá trị được chỉ định cho phần tử <Algorithm>.

   Dưới đây là ví dụ về chính sách Xác minh JWT:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS128</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <SecretKey>
           <Value ref="private.secretkey"/>
           <Id>1918290</Id>
       </SecretKey>
       <ExpiresIn>1h</ExpiresIn>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalClaims>
           <Claim name='status' type='string'>Development</Claim>
       </AdditionalClaims>
   </VerifyJWT>
   

3. Kiểm tra giá trị được chỉ định trong phần tử <Algorithm>. Nếu giá trị này không phải là một trong các giá trị sau:

   HS256, HS384, HS512, RS256, RS384, RS512

   thì đó là nguyên nhân gây ra lỗi.

   Trong ví dụ về chính sách Xác minh JWT nêu trên, tên <Algorithm> được chỉ định là HS128. Vì đây không phải là thuật toán được hỗ trợ nên bạn sẽ gặp lỗi:

   Invalid Value for element : policy(JWT-Verify-RS256) element(Algorithm).
   

Độ phân giải

Hãy đảm bảo rằng giá trị được chỉ định trong phần tử <Algorithm> là một trong những giá trị được hỗ trợ:

HS256, HS384, HS512, RS256, RS384, RS512

Để sửa ví dụ về chính sách Xác minh JWT nêu trên (sử dụng phần tử <SecretKey>), hãy thay đổi giá trị của <Algorithm> thành HS25. Lưu ý: Khi sử dụng phần tử <SecretKey>, bạn chỉ có thể sử dụng thuật toán Gia đình HS.

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalClaims>
        <Claim name='status' type='string'>Development</Claim>
    </AdditionalClaims>
</VerifyJWT>

MissingConfigurationElement

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision
Missing configuration element : policy(policy_name) element(element_name).

Ví dụ về thông báo lỗi

Error Saving Revision
Missing configuration element : policy(JWT-Verify-RS256) element(PublicKey).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra khi phần tử <PublicKey> không được sử dụng với thuật toán Nhóm quảng cáo tìm kiếm thích ứng (RSA) trong chính sách Xác minh JWT. Tương tự, lỗi có thể xảy ra nếu phần tử <SecretKey> không được dùng với thuật toán Nhóm HS trong chính sách Xác minh JWT.

Ví dụ: việc không sử dụng phần tử <PublicKey> bằng thuật toán Gia đình RSA sẽ dẫn đến lỗi này.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT và tên phần tử bị thiếu trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256 và tên phần tử bị thiếu là PublicKey:

   Missing configuration element : policy(JWT-Verify-RS256) element(PublicKey).
   

2. Kiểm tra tệp XML của chính sách JWT không thành công và xác minh rằng phần tử được chỉ ra trong thông báo lỗi bị thiếu. Nếu thông tin này bị thiếu thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây cho thấy PublicKey bị thiếu và Algorithm được dùng là RS256:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalClaims>
           <Claim name='claim' ref='reqclaim' type='string' array='true'/>
       </AdditionalClaims>
   </VerifyJWT>
   

   Ví dụ về chính sách Xác minh JWT sử dụng thuật toán Gia đình HS nhưng thiếu phần tử bắt buộc PublicKey nên dẫn đến lỗi:

   Missing configuration element : policy(JWT-Verify-RS256) element(PublicKey).
   

Độ phân giải

Đảm bảo rằng phần tử <PublicKey> bắt buộc được sử dụng với các thuật toán RSA Family và phần tử <SecretKey> bắt buộc được sử dụng với các thuật toán HS Family.

Để sửa ví dụ về chính sách Xác minh JWT nêu trên (sử dụng thuật toán RS256), hãy thêm phần tử <PublicKey> vào chính sách VerifyJWT:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <Algorithm>RS256</Algorithm>
    <PublicKey>
      <Value ref="public.publickey"/>
    </PublicKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalHeaders>
        <Claim name='claim' ref='reqclaim' type='string' array='true'/>
    </AdditionalHeaders>
</VerifyJWT>

InvalidKeyConfiguration

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision 
Invalid Key configuration : policy(policy_name).

Ví dụ về thông báo lỗi

Error Saving Revision 2
Invalid Key configuration : policy(JWT-Verify-RS256).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu bạn không xác định phần tử con <Value> hoặc phần tử con bắt buộc <JWKS> trong phần tử <PublicKey> hoặc <SecretKey> của chính sách Xác minh JWT.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256:

   Invalid Key configuration : policy(JWT-Verify-RS256).
   

2. Kiểm tra tệp XML của chính sách JWT không thành công và xác minh xem phần tử con <Value> hoặc phần tử con <JWKS> có được xác định trong phần tử <PublicKey> hoặc <SecretKey> hay không. Nếu phần tử con không được xác định, thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây cho thấy phần tử con <Value> hoặc <JWKS> không được xác định trong phần tử <PublicKey>:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <PublicKey>
       </PublicKey>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalClaims>
           <Claim name='claim' ref='reqclaim' type='string' array='true'/>
       </AdditionalClaims>
   </VerifyJWT>
   

   Vì phần tử con <Value> hoặc <JWKS> không được xác định trong phần tử <PublicKey> của chính sách Xác minh JWT nên bạn sẽ gặp lỗi:

   Invalid Key configuration : policy(JWT-Verify-RS256).
   

Độ phân giải

Đảm bảo phần tử con <Value> hoặc <JWKS> luôn được xác định trong phần tử <PublicKey> của chính sách Xác minh JWT.

Để sửa ví dụ về chính sách Xác minh JWT, hãy xác định phần tử con <Value> hoặc <JWKS> trong phần tử <PublicKey> như minh hoạ dưới đây:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <PublicKey>
        <Value ref="public.publickey"/>
    </PublicKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalHeaders>
        <Claim name='claim' ref='reqclaim' type='string' array='true'/>
    </AdditionalHeaders>
</PublicJWT>

EmptyElementForKeyConfiguration

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision revision_number
Empty Element for Key Configuration : policy(policy_name) element(element_name).

Ví dụ về thông báo lỗi

Error Saving Revision 2
Empty Element for Key Configuration : policy(JWT-Verify-RS256) element(PublicKey/Value).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu thuộc tính tham chiếu trong phần tử con <Value> hoặc <JWKS> của phần tử <PublicKey> không được chỉ định hoặc để trống.

Ví dụ: nếu phần tử con <Value> của phần tử <PublicKey> bị trống, thì lỗi sẽ xảy ra.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT và tên phần tử đang trống trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256 và tên phần tử là PublicKey/Value:

   Empty Element for Key Configuration : policy(JWT-Verify-RS256) element(PublicKey/Value).
   

2. Kiểm tra tệp XML của chính sách JWT không thành công và xác minh rằng phần tử được xác định trong Bước 1 bị trống. Nếu giá trị trống thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây cho thấy phần tử con <Value> của phần tử <PublicKey> đang trống:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <PublicKey>
           <Value/>
       </PublicKey>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalClaims>
           <Claim name='claim' ref='reqclaim' type='string' array='true'/>
       </AdditionalClaims>
   </VerifyJWT>
   

   Vì phần tử con <Value> của phần tử <PublicKey> của chính sách Xác minh JWT bị trống nên bạn gặp lỗi:

   Empty Element for Key Configuration : policy(JWT-Verify-RS256) element(PublicKey/Value).
   

Độ phân giải

Đảm bảo rằng thuộc tính tham chiếu trong phần tử con <Value> hoặc <JWKS> của phần tử <PublicKey> luôn được chỉ định.

Để sửa ví dụ về chính sách Xác minh JWT, hãy sử dụng biến luồng public.publickey trong phần tử con <Value> của phần tử <PublicKey>:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <PublicKey>
        <Value ref="public.publickey"/>
    </PublicKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalHeaders>
        <Claim name='claim' ref='reqclaim' type='string' array='true'/>
    </AdditionalHeaders>
</VerifyJWT>

InvalidConfigurationForVerify

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision revision_number
Invalid configuration element for verify : policy(policy_name) element(element_name).

Ví dụ về thông báo lỗi

Error Saving Revision 3
Invalid configuration element for verify : policy(JWT-Verify-HS256) element(SecretKey/Id).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu phần tử <Id> được xác định trong phần tử <SecretKey> của chính sách VerifyJWT.

Ví dụ: lỗi này sẽ xảy ra nếu phần tử <Id> được xác định trong phần tử <SecretKey>.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT và tên phần tử không hợp lệ trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256 và tên phần tử là SecretKey/Id:

   Invalid configuration element for verify : policy(JWT-Verify-HS256) element(SecretKey/Id)
   

2. Kiểm tra tệp XML của chính sách JWT không thành công và xác minh rằng phần tử không hợp lệ được xác định trong Bước 1 đã được xác định. Nếu đúng như vậy thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây cho thấy phần tử con <Id> của phần tử <SecretKey> được xác định:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <SecretKey>
           <Value ref="private.secretkey"/>
           <Id/>
       </SecretKey>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalClaims>
           <Claim name='claim' ref='reqclaim' type='string' array='true'/>
       </AdditionalClaims>
   </VerifyJWT>
   

   Vì phần tử <Id> được định nghĩa trong phần tử <SecretKey> của chính sách Xác minh JWT nên bạn sẽ gặp lỗi:

   Invalid configuration element for verify : policy(JWT-Verify-HS256) element(SecretKey/Id)
   

Độ phân giải

Đảm bảo phần tử <Id> không bao giờ được xác định trong phần tử <SecretKey> của chính sách Xác minh JWT.

Để sửa ví dụ về chính sách Xác minh JWT, hãy xoá phần tử con <Id> khỏi phần tử <SecretKey>:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <SecretKey>
        <Value ref='private.secretkey'/>
    </SecretKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalHeaders>
        <Claim name='claim' ref='reqclaim' type='string' array='true'/>
    </AdditionalHeaders>
</VerifyJWT>

InvalidEmptyElement

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision 
Invalid empty element : policy(policy_name) element(element_name).

Ví dụ về thông báo lỗi

Error Saving Revision 3
Invalid empty element : policy(JWT-Verify-HS256) element(Source).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu phần tử <Source> của chính sách Xác minh JWT trống. Nếu có, bạn phải xác định đối số này bằng tên biến Luồng cạnh.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT và tên phần tử trống trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256 và tên phần tử là PublicKey/Value:

   Invalid empty element : policy(JWT-Verify-HS256) element(Source).
   

2. Kiểm tra tệp XML của chính sách JWT không thành công và xác minh rằng phần tử được xác định trong Bước 1 bị trống. Nếu giá trị trống thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây cho thấy phần tử <Source> bị trống:

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <Source></Source>
       <PublicKey>
           <Value ref="public.publickey"/>
       </PublicKey>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
       <AdditionalClaims>
           <Claim name='claim' ref='reqclaim' type='string' array='true'/>
       </AdditionalClaims>
   </VerifyJWT>
   

   Vì phần tử <Source> của chính sách Xác minh JWT đang trống nên bạn sẽ gặp lỗi:

   Invalid empty element : policy(JWT-Verify-HS256) element(Source).
   

Độ phân giải

Nếu có phần tử <Source> của chính sách Xác minh JWT, hãy đảm bảo rằng phần tử đó chỉ định một biến luồng.

Để sửa ví dụ về chính sách Xác minh JWT, hãy sử dụng một biến luồng hợp lệ trong phần tử <Source>:

<VerifyJWT name="JWT-Verify-RS256">
    <DisplayName>JWT Verify RS256</DisplayName>
    <Algorithm>RS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <Source>jwt-variable</Source>
    <PublicKey>
        <Value ref="public.publickey"/>
    </PublicKey>
    <ExpiresIn>1h</ExpiresIn>
    <Subject>monty-pythons-flying-circus</Subject>
    <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
    <Audience>fans</Audience>
    <Id/>
    <AdditionalHeaders>
        <Claim name='claim' ref='reqclaim' type='string' array='true'/>
    </AdditionalHeaders>
</VerifyJWT>

InvalidPublicKeyValue

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision revision_number
Invalid Public Key Value in Configuration : policy(policy_name) element(element_name).

Ví dụ về thông báo lỗi

Error Saving Revision 2
Invalid Public Key Value in Configuration : policy(JWT-Verify-RS256) element(PublicKey/JWKS).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu giá trị dùng trong phần tử con <JWKS> của phần tử <PublicKey> không ở định dạng hợp lệ theo quy định trong RFC 7517.

Ví dụ: Việc sử dụng abc làm giá trị của phần tử con <JWKS> trong phần tử <PublicKey> sẽ dẫn đến lỗi này.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT và tên phần tử có chứa giá trị không hợp lệ trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-RS256 và phần tử là PublicKey/JWKS:

   Invalid Public Key Value in Configuration : policy(JWT-Verify-RS256) element(PublicKey/JWKS).
   

2. Kiểm tra XML của chính sách JWT không thành công và xác minh rằng phần tử được xác định ở Bước 1 chứa giá trị ở định dạng hợp lệ theo RFC 7517. Nếu giá trị của phần tử không ở định dạng hợp lệ thì đó là nguyên nhân gây ra lỗi.

   <VerifyJWT name="JWT-Verify-RS256">
       <DisplayName>JWT Verify RS256</DisplayName>
       <Algorithm>RS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <PublicKey>
           <JWKS>abc<JWKS>
       </PublicKey>
       <ExpiresIn>1h</ExpiresIn>
       <Subject>monty-pythons-flying-circus</Subject>
       <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
       <Audience>fans</Audience>
       <Id/>
   </VerifyJWT>
   

   Vì giá trị trong phần tử con <JWKS> của phần tử <PublicKey> không ở định dạng hợp lệ theo RFC 7517 nên bạn sẽ gặp lỗi:

   Invalid Public Key Value in Configuration : policy(JWT-Verify-RS256) element(PublicKey/JWKS).
   

Độ phân giải

Đảm bảo rằng giá trị được chỉ định trong phần tử con <JWKS> của phần tử <PublicKey> phải là một chuỗi hoặc biến luồng hợp lệ ở định dạng JWKS hợp lệ (RFC 7517).

Để sửa ví dụ về chính sách Xác minh JWT, hãy thay đổi giá trị của <JWKS> như minh hoạ dưới đây:

    <VerifyJWT name="JWT-Verify-RS256">
        <DisplayName>JWT Verify RS256</DisplayName>
        <Algorithm>RS256</Algorithm>
        <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
        <PublicKey>
        <JWKS>eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VySWQiOiJiMDhmODZhZi0zNWRhLTQ4ZjItOGZhYi1jZWYzOTA0NjYwYmQifQ.-xN_h82PHVTCMA9vdoHrcZxH-x5mb11y1537t3rGzcM</JWKS>
        </PublicKey>
        <ExpiresIn>1h</ExpiresIn>
        <Subject>monty-pythons-flying-circus</Subject>
        <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
        <Audience>fans</Audience>
        <Id/>
    </VerifyJWT>

InvalidConfigurationForActionAndAlgorithm

Thông báo lỗi

Thông báo lỗi sau không triển khai được proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge:

Error Saving Revision <var>revision_number</var>
Invalid configuration element for this action and algorithm Family: policy(<var>policy_name</var>) element(<var>element_name</var>) action(<var>action_name</var>) family(<var>family_name</var>).

Ví dụ về thông báo lỗi

Error Saving Revision
Invalid configuration element for this action and algorithm Family: policy(JWT-Verify-HS256) element(PublicKey) action(Verify) family(RSA).

Ảnh chụp màn hình mẫu

Trong giao diện người dùng Edge, bạn sẽ thấy một hộp thoại có lỗi:

Nguyên nhân

Lỗi này xảy ra nếu phần tử <PublicKey> được sử dụng với thuật toán HS Family và phần tử <SecretKey> được sử dụng với thuật toán RSA Family. Lỗi cũng sẽ xảy ra nếu một trong các điều kiện này xảy ra.

Ví dụ: việc sử dụng phần tử <PublicKey> bằng thuật toán Gia đình HS sẽ dẫn đến lỗi này.

Chẩn đoán

1. Xác định tên của chính sách Xác minh JWT, tên phần tử và tên nhóm thuật toán trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau đây, tên của chính sách Xác minh JWT là JWT-Verify-HS256, tên phần tử là PublicKey và nhóm thuật toán là RSA:

   Invalid configuration element for this action and algorithm Family: policy(JWT-Verify-HS256) element(PublicKey) action(Verify) family(RSA).
   

2. Xác minh rằng phần tử và nhóm thuật toán dùng trong tệp XML chính sách JWT không thành công sẽ khớp với phần tử và nhóm thuật toán được xác định trong thông báo lỗi ở Bước 1. Ví dụ: chính sách sau đây chỉ định phần tử là PublicKey và nhóm thuật toán là HMAC, khớp với nội dung trong thông báo lỗi

   <VerifyJWT name="JWT-Verify-HS256">
       <DisplayName>JWT Verify HS256</DisplayName>
       <Algorithm>HS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <Source>request.formparam.jwt</Source>
       <PublicKey>
           <Value ref="var-value"/>
       </PublicKey>
       <SecretKey>
           <Value ref="private.secretkey"/>
       </SecretKey>
           <ExpiresIn>1h</ExpiresIn>
           <Subject>monty-pythons-flying-circus</Subject>
           <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
           <Audience>fans</Audience>
       </VerifyJWT>
   

3. Nếu giá trị của phần tử <Algorithm> là HS256 nhưng bạn đã sử dụng <PublicKey> thì đó là nguyên nhân gây ra lỗi.

   Trong ví dụ về chính sách Xác minh JWT trình bày ở trên, phần tử <PublicKey> được sử dụng ngay cả khi <Algorithm> được đặt thành thuật toán nhóm HS256, dẫn đến lỗi:

   Invalid configuration element for this action and algorithm Family: policy(JWT-Verify-HS256) element(PublicKey) action(Verify) family(RSA).
   

Độ phân giải

Đảm bảo rằng chỉ sử dụng phần tử <PublicKey> với các thuật toán RSA Family và chỉ dùng phần tử <SecretKey> với thuật toán HS Family.

Để sửa ví dụ về chính sách Xác minh JWT, hãy dùng <SecretKey> trong chính sách VerifyJWT sử dụng thuật toán HS256:

    <VerifyJWT name="JWT-Verify-HS256">
        <DisplayName>JWT Verify HS256</DisplayName>
        <Algorithm>HS256</Algorithm>
        <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
        <Source>request.formparam.jwt</Source>
        <SecretKey>
        <Value ref="private.secretkey"/>
    </SecretKey>
        <ExpiresIn>1h</ExpiresIn>
        <Subject>monty-pythons-flying-circus</Subject>
        <Issuer>urn://apigee-edge-JWT-policy-test</Issuer>
        <Audience>fans</Audience>
    </VerifyJWT>