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

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

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 2
Invalid name for additional claim : policy(JWT-Generate-HS256) 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"

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

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

Chẩn đoán

1. Xác định tên của chính sách Tạo 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, tên của chính sách Tạo JWT là JWT-Generate-HS256 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-Generate-HS256) 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 XML của chính sách JWT không thành công khớp với tên thông báo xác nhận quyền sở hữu nêu trong thông báo lỗi (Bước 1 ở trên). 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:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</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>
   </GenerateJWT>
   

3. Nếu tên 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 những tên đã đăng ký sau đây:

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

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

   Trong ví dụ về Tạo chính sách JWT ở 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-Generate-HS256) claim(iss).
   

Độ phân giải

Đừng dùng tên đã đăng ký "kid", "iss", "sub", "aud", "iat", "exp", "nbf" hoặc "jti" trong phần tử con <Claim>của phần tử <AdditionalClaims>.

Để sửa ví dụ về việc Tạo chính sách JWT ở trên, hãy đổi tên thông báo xác nhận quyền sở hữu thành status:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

InvalidTypeForAdditionalClaim

Thông báo lỗi

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 2
Invalid type for additional claim : policy(JWT-Generate-HS256) 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

Lỗi này 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> thuộc phần tử <AdditionalClaims> của chính sách GenerateJWT 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ử <AdditionalClaims> sẽ dẫn đến lỗi.

Chẩn đoán

1. Xác định tên của chính sách Tạo JWT, tên thông báo xác nhận quyền sở hữu và loại 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 Tạo JWT là JWT-Generate-HS256, tên 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:

   Invalid type for additional claim : policy(JWT-Generate-HS256) 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 của chính sách JWT không thành công 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 là integer, khớp với nội dung trong thông báo lỗi:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</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>
   </GenerateJWT>
   

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 sau đây:

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

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

   Trong ví dụ về Tạo chính sách JWT ở trên, loại <Claim> của phần tử <AdditionalClaims> đượ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 claim : policy(JWT-Generate-HS256) claim(claim) type(integer).
   

Độ phân giải

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

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

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

MissingNameForAdditionalClaim

Thông báo lỗi

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 2
Error occurred while validation of bean JWT-Generate-HS256.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 của 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 Tạo 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 Tạo JWT là JWT-Generate-HS256:

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

2. Kiểm tra việc Tạo XML của chính sách JWT không thành công và xác minh xem tên thông báo xác nhận quyền sở hữu có bị thiếu trong phần tử con <Claims> trong phần tử <AdditionalClaims> hoặc <AdditionalHeaders> hay không. Ví dụ: chính sách Tạo 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>:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</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>
   </GenerateJWT>
   

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

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

Độ phân giải

Đả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ề Tạo chính sách JWT ở trên, hãy chỉ định tên thông báo xác nhận quyền sở hữu như minh hoạ dưới đây:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

InvalidNameForAdditionalHeader

Thông báo lỗi

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 2
Invalid name for additional header: policy(JWT-Generate-HS256) 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 thông báo 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 Tạo và tên tiêu đề trong thông báo lỗi. Ví dụ: trong thông báo lỗi sau, tên của chính sách Tạo JWT là JWT-Generate-HS256 và tên tiêu đề là alg:

   Invalid name for additional header: policy(JWT-Generate-HS256) header(alg).
   

2. Xác minh rằng tên tiêu đề dùng trong phần tử con <Claim> trong phần tử <AdditionalHeaders> trong XML không tạo được chính sách JWT khớp với 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:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</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>
   </GenerateJWT>
   

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 những tiêu đề JWT chuẩn sau đây:

   alg hoặc typ

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

   Trong ví dụ về Tạo chính sách JWT ở 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-Generate-HS256) header(alg).
   

Độ phân giải

Đừng 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ề việc Tạo chính sách JWT nêu trên, hãy dùng tên x5c trong phần tử con <Claim> của phần tử <AdditionalHeaders>:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

InvalidTypeForAdditionalHeader

Thông báo lỗi

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 2
Invalid type for additional header : policy(JWT-Generate-HS256) 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 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> thuộc phần tử <AdditionalHeaders> của chính sách GenerateJWT 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 Tạo JWT, tên thông báo xác nhận quyền sở hữu và loại 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 Tạo JWT là JWT-Generate-HS256, tên 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:

   Invalid type for additional header : policy(JWT-Generate-HS256) 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> của tệp XML chính sách JWT không thành công 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:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</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>
   </GenerateJWT>
   

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 sau đây:

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

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

   Trong ví dụ về Tạo chính sách JWT ở trên, loại <Claim> của 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-Generate-HS256) claim(claim) type(integer).
   

Độ phân giải

Đảm bảo rằng bạn chỉ sử dụng các loại 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ề việc Tạo chính sách JWT nêu trên, hãy thay đổi loại thông báo xác nhận quyền sở hữu thành boolean:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

InvalidValueOfArrayAttribute

Thông báo lỗi

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 2
Invalid value for array attribute: policy(JWT-Generate-HS256) 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> chưa đượ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 <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 Tạo 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 Tạo JWT là JWT-Generate-HS256 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-Generate-HS256) 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> trong XML của chính sách JWT không tạo được trùng khớp với tên thông báo xác nhận quyền sở hữu đã 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 thông báo xác nhận quyền sở hữu là claim, khớp với tên trong thông báo lỗi:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</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>
   </GenerateJWT>
   

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

   Vì 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-Generate-HS256) 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 <AdditionalClaims> hoặc <AdditionalHeaders> được đặt thành true hoặc false.

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

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

InvalidConfigurationForActionAndAlgorithm

Thông báo lỗi

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 với thông báo lỗi sau:

Error Saving Revision 2
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>).

Thông báo lỗi mẫu

Error Saving Revision 2
Invalid configuration element for this action and algorithm Family: policy(JWT-Generate-HS256) element(PrivateKey) action(Generate) family(HMAC).

Ả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ử <PrivateKey> được sử dụng với thuật toán Gia đình HS và phần tử <SecretKey> được sử dụng với thuật toán Gia đình RSA. Lỗi cũng sẽ xảy ra nếu một trong các điều kiện này đúng.

Ví dụ: việc sử dụng phần tử <PrivateKey> với thuật toán HS Family sẽ dẫn đến lỗi này.

Chẩn đoán

1. Xác định tên của chính sách Tạo 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 Tạo JWT là JWT-Generate-HS256, tên phần tử là PrivateKey và nhóm thuật toán là HMAC:

   Invalid configuration element for this action and algorithm Family: policy(JWT-Generate-HS256) element(PrivateKey) action(Generate) family(HMAC).
   

2. Xác minh rằng phần tử và nhóm thuật toán dùng trong XML chính sách JWT không thành công khớp với phần tử và nhóm thuật toán đã 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à PrivateKey và nhóm thuật toán là HMAC, khớp với nội dung trong thông báo lỗi:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <PrivateKey>
           <Password ref="private.privatekey-password"/>
   
       </PrivateKey>
           <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=tuu
       =/>
           </AdditionalClaims>
       </GenerateJWT>
   

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

   Trong ví dụ về chính sách Tạo JWT trình bày ở trên, <PrivateKey> được sử dụng mặc dù <PrivateKey> đượ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-Generate-HS256) element(PrivateKey) action(Generate) family(HMAC).
   

Độ phân giải

Đảm bảo chỉ sử dụng phần tử <PrivateKey> với thuật toán Gia đình RSA và phần tử <SecretKey> chỉ được sử dụng với thuật toán Gia đình HS.

Để sửa ví dụ về việc Tạo chính sách JWT nêu trên, hãy dùng <SecretKey> của chính sách GenerateJWT sử dụng thuật toán HS256:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

InvalidValueForElement

Thông báo lỗi

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 2
Invalid Value for element : policy(JWT-Generate-HS256) 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 Tạo 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 Tạo JWT là JWT-Generate-HS256 và tên phần tử là Algorithm.

   Invalid Value for element : policy(JWT-Generate-HS256) element(Algorithm).
   

2. Kiểm tra việc Tạo 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 Tạo JWT:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS128</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>
   </GenerateJWT>
   

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

   HS256, HS384, HS512, RS256, RS384, RS512

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

   Trong ví dụ về Tạo chính sách JWT ở 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-Generate-HS256) element(Algorithm).
   

Độ phân giải

Đảm bảo giá trị được chỉ định trong phần tử <Algorithm> là một trong các giá trị được hỗ trợ:

HS256, HS384, HS512, RS256, RS384, RS512

Để sửa ví dụ về việc Tạo chính sách JWT nêu trên, trong đó 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ể dùng thuật toán Gia đình HS.

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

MissingConfigurationElement

Thông báo lỗi

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 2
Missing configuration element : policy(JWT-Generate-HS256) element(SecretKey).

Ả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ử <PrivateKey> không được sử dụng cùng với thuật toán Nhóm RSA trong chính sách Tạo JWT. Tương tự, lỗi có thể xảy ra nếu phần tử <SecretKey> không được sử dụng với thuật toán Nhóm HS trong chính sách Tạo JWT.

Ví dụ: việc không sử dụng phần tử <PrivateKey> với thuật toán RSA Family sẽ dẫn đến lỗi này.

Chẩn đoán

1. Xác định tên của chính sách Tạo 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 Tạo JWT là JWT-Generate-HS256 và tên phần tử bị thiếu là SecretKey.

   Missing configuration element : policy(JWT-Generate-HS256) element(SecretKey).
   

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 chỉ ra trong thông báo lỗi bị thiếu. Nếu mã này bị thiếu thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: trong chính sách sau đây, SecretKey bị thiếu và Algorithm được sử dụng là HS256:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</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>
   </GenerateJWT>
   

   Ví dụ về chính sách Tạo JWT sử dụng thuật toán Gia đình HS, nhưng phần tử bắt buộc SecretKey bị thiếu, dẫn đến lỗi:

   Missing configuration element : policy(JWT-Generate-HS256) element(SecretKey).
   

Độ phân giải

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

Để sửa ví dụ về việc Tạo chính sách JWT nêu trên (bằng thuật toán HS256), hãy thêm phần tử <SecretKey> vào chính sách Tạo JWT:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

InvalidKeyConfiguration

Thông báo lỗi

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 3
Invalid Key configuration : policy(JWT-Generate-HS256).

Ả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ử con bắt buộc <Value> không được xác định trong các phần tử <PrivateKey> hoặc <SecretKey> trong chính sách Tạo JWT.

Chẩn đoán

1. Xác định tên của chính sách Tạo 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 Tạo JWT là JWT-Generate-HS256.

   Invalid Key configuration : policy(JWT-Generate-HS256).
   

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

   Ví dụ: trong chính sách sau đây, phần tử con <Value> không được xác định trong phần tử <SecretKey>:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <SecretKey>
       </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>
   </GenerateJWT>
   

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

   Invalid Key configuration : policy(JWT-Generate-HS256).
   

Độ phân giải

Đảm bảo rằng phần tử con <Value> luôn được xác định trong các phần tử <PrivateKey> hoặc <SecretKey> của chính sách Tạo JWT.

Để sửa ví dụ về việc Tạo chính sách JWT nêu trên, hãy xác định phần tử con <Value> trong phần tử <SecretKey> như minh hoạ bên dưới:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

EmptyElementForKeyConfiguration

Thông báo lỗi

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 với thông báo lỗi sau:

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

Thông báo lỗi mẫu

Error Saving Revision 2
Empty Element for Key Configuration : policy(JWT-Generate-HS256) element(SecretKey/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> của các phần tử <PrivateKey> hoặc <SecretKey> chưa được chỉ định hoặc để trống.

Ví dụ: nếu phần tử con <Value> của phần tử <SecretKey> 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 Tạo 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 Tạo JWT là JWT-Generate-HS256 và tên phần tử trống là SecretKey/Value.

   Empty Element for Key Configuration : policy(JWT-Generate-HS256) element(SecretKey/Value).
   

2. Kiểm tra XML của chính sách JWT không thành công và xác minh xem phần tử xác định trong Bước 1 có trống hay không. Nếu phần này 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ử <SecretKey> bị trống:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <SecretKey>
           <Value/>
           <Id>1918290</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>
   </GenerateJWT>
   

   Vì phần tử con <Value> của phần tử <SecretKey> trong chính sách Tạo JWT đang trống, nên bạn sẽ gặp lỗi:

   Empty Element for Key Configuration : policy(JWT-Generate-HS256) element(SecretKey/Value).
   

Độ phân giải

Đảm bảo rằng thuộc tính tham chiếu trong phần tử con <Value> của các phần tử <PrivateKey> hoặc <SecretKey> luôn được chỉ định và có tiền tố "private.".

Để sửa ví dụ về Tạo chính sách JWT nêu trên, hãy sử dụng biến luồng private.privatekey trong phần tử con <Value> của phần tử <SecretKey>.

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

InvalidVariableNameForSecret

Thông báo lỗi

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 với thông báo lỗi sau:

Error Saving Revision 2
Invalid variable name for secret : policy(policy_name) element(element_name).

Thông báo lỗi mẫu

Error Saving Revision 2
Invalid variable name for secret : policy(JWT-Generate-HS256) element(SecretKey/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 tên biến luồng được chỉ định trong thuộc tính tham chiếu ở phần tử con <Value> của các phần tử <PrivateKey> hoặc <SecretKey> không bao gồm tiền tố riêng (private.).

For example :

Nếu tên biến luồng được chỉ định là mykey trong thuộc tính tham chiếu của phần tử con <Value> của phần tử <PrivateKey>, thì lỗi này sẽ xảy ra.

Chẩn đoán

1. Xác định tên của chính sách Tạo JWT và tên của phần tử có tên biến 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 Tạo JWT là JWT-Generate-HS256 và tên phần tử là SecretKey/Value.

   Invalid variable name for secret : policy(JWT-Generate-HS256) element(SecretKey/Value).
   

2. Kiểm tra việc Tạo XML của chính sách JWT không thành công và xác minh tên biến dùng trong phần tử như đã xác định ở Bước 1. Nếu tên biến không có tiền tố private., 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ử <SecretKey> có tên biến không hợp lệ mykey:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <SecretKey>
           <Value ref="mykey"/>
           <Id>1918290</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>
   </GenerateJWT>
   

   Vì tên biến được chỉ định trong phần tử con <Value> thuộc phần tử <SecretKey> của chính sách Tạo JWT không có tiền tố private., nên bạn sẽ gặp lỗi:

   Invalid variable name for secret : policy(JWT-Generate-HS256) element(SecretKey/Value).
   

Độ phân giải

Đảm bảo rằng thuộc tính tham chiếu trong phần tử con <Value> của các phần tử <PrivateKey> hoặc <SecretKey> luôn được chỉ định và có tiền tố private..

Để sửa ví dụ về Tạo chính sách JWT nêu trên, hãy sử dụng biến luồng private.privatekey trong phần tử con <Value> của phần tử <SecretKey>:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</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>
</GenerateJWT>

InvalidSecretInConfig

Thông báo lỗi

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 với thông báo lỗi sau:

Error Saving Revision 2
Specifying a secret in the configuration is invalid : policy(policy_name) element(element_name).

Thông báo lỗi mẫu

Error Saving Revision 2
Specifying a secret in the configuration is invalid : policy(JWT-Generate-HS256) element(SecretKey/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 giá trị (bí mật) được chỉ định rõ ràng trong:

• Phần tử con <Value> hoặc <Password> của phần tử <PrivateKey> hoặc
• Phần tử con <Value> của phần tử <SecretKey>

trong chính sách Tạo JWT.

Ví dụ: nếu khoá bí mật được chỉ định rõ ràng là abc trong phần tử con <Value> của phần tử <SecretKey>, thì lỗi này sẽ xảy ra.

Chẩn đoán

1. Xác định tên của chính sách Tạo JWT và tên phần tử, trong đó khoá bí mật được chỉ định rõ rà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 Tạo JWT là JWT-Generate-HS256 và tên phần tử là SecretKey/Value.

   Specifying a secret in the configuration is invalid : policy(JWT-Generate-HS256) element(SecretKey/Value).
   

2. Kiểm tra XML của chính sách JWT không thành công và xác minh xem bạn có chỉ định rõ khóa bí mật trong phần tử đã xác định ở Bước 1 hay không. Nếu bạn chỉ định rõ ràng, thì đó chính là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây cho thấy khoá bí mật đã được chỉ định rõ ràng trong phần tử con <Value> của phần tử <SecretKey>:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <SecretKey>
           <Value>abc</Value>
           <Id>1918290</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>
   </GenerateJWT>
   

   Vì khoá bí mật được chỉ định rõ ràng trong phần tử con <Value> thuộc phần tử <SecretKey> của chính sách Tạo JWT, nên bạn sẽ gặp lỗi:

   Specifying a secret in the configuration is invalid : policy(JWT-Generate-HS256) element(SecretKey/Value).
   

Độ phân giải

Đảm bảo giá trị luôn được chỉ định làm biến luồng trong phần tử con <Value> của các phần tử <PrivateKey> hoặc <SecretKey>.

Để sửa ví dụ về Tạo chính sách JWT nêu trên, hãy sử dụng biến luồng private.secretkey trong thuộc tính tham chiếu của phần tử con <Value> trong <SecretKey>:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <ExpiresIn>1h</ExpiresIn>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <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>
</GenerateJWT>

InvalidTimeFormat

Thông báo lỗi

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 với thông báo lỗi sau:

Error Saving Revision 2
Invalid Time format: policy(policy_name) element(element_name).

Thông báo lỗi mẫu

Error Saving Revision 3
Invalid Time format: policy(JWT-Generate-HS256) element(NotBefore).

Ả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ử <NotBefore> không thuộc một trong các định dạng được hỗ trợ:

sortable, RFC 1123, RFC 850, ANCI-C

Ví dụ: nếu giá trị được chỉ định trong <NotBefore> là 20-JUN-1990 08:03 và đây không phải là định dạng được hỗ trợ, thì lỗi này sẽ xảy ra.

<NotBefore>20-JUN-1990 08:03:00:21-07:00</NotBefore>

Chẩn đoán

1. Xác định tên của chính sách Tạo JWT và tên phần tử có định dạng thời gian 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 Tạo JWT là JWT-Generate-HS256 và tên phần tử là NotBefore.

   Invalid Time format: policy(JWT-Generate-HS256) element(NotBefore).
   

2. Kiểm tra tệp XML của chính sách JWT không thành công và xác minh định dạng thời gian dùng trong phần tử đã xác định ở Bước 1. Nếu phần tử không sử dụng bất kỳ định dạng được hỗ trợ nào:

   sortable, RFC 1123, RFC 850, ANCI-C

   thì đó chính 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 <NotBefore> sử dụng định dạng thời gian không được hỗ trợ:

   <GenerateJWT name="JWT-Generate-HS256">
       <DisplayName>JWT Generate HS256</DisplayName>
       <Algorithm>HS256</Algorithm>
       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
       <ExpiresIn>1h</ExpiresIn>
       <NotBefore>20-JUN-1990 08:03:00:21-07:00</NotBefore>
       <SecretKey>
           <Value ref="private.secretkey"/>
           <Id>1918290</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>
   </GenerateJWT>
   

   Do phần tử <NotBefore> của chính sách Tạo JWT không sử dụng bất kỳ định dạng thời gian được hỗ trợ nào, nên bạn sẽ gặp lỗi:

   Invalid variable name for secret : policy(JWT-Generate-HS256) element(SecretKey/Value).
   

Độ phân giải

Đảm bảo giá trị được chỉ định trong phần tử <NotBefore> sử dụng một trong các định dạng được hỗ trợ:

sortable, RFC 1123, RFC 850, ANCI-C

Để sửa ví dụ về việc Tạo chính sách JWT, hãy sửa đổi ngày trong phần tử <NotBefore> để dùng định dạng sortable như dưới đây:

<GenerateJWT name="JWT-Generate-HS256">
    <DisplayName>JWT Generate HS256</DisplayName>
    <Algorithm>HS256</Algorithm>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <ExpiresIn>1h</ExpiresIn>
    <NotBefore>2018-08-14T11:00:21-07:00</NotBefore>
    <SecretKey>
        <Value ref="private.secretkey"/>
        <Id>1918290</Id>
    </SecretKey>
    <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>
</GenerateJWT>