פתרון בעיות בפריסת מדיניות GenerateJWT

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

InvalidNameForAdditionalClaim

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם השם של התביעה שמשמש ברכיב הצאצא <Claim> של הרכיב <AdditionalClaims> הוא אחד מהשמות הרשומים הבאים:

‫'kid',‏ 'iss',‏ 'sub',‏ 'aud',‏ 'iat',‏ 'exp',‏ 'nbf',‏ 'jti'

התביעות הרשומות מפורטות ב-RFC7519.

לדוגמה, שימוש בשם ההצהרה iss ברכיב <AdditionalClaims> יוביל לשגיאה הזו.

אבחון

1. מזהים את השם של מדיניות יצירת ה-JWT ואת שם הטענה מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות Generate JWT הוא JWT-Generate-HS256 ושם ההצהרה הוא iss:

   Invalid name for additional claim : policy(JWT-Generate-HS256) claim(iss).
   

2. מוודאים ששם הטענה שמשמש ברכיב <AdditionalClaims> ב-XML של מדיניות יצירת JWT שנכשלה זהה לשם הטענה שצוין בהודעת השגיאה (שלב 1 למעלה). לדוגמה, המדיניות הבאה מציינת את ההצהרה כ-iss, שזהה למה שמופיע בהודעת השגיאה:

   <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. אם שם התג שמשמש ברכיב המשני <Claim> של הרכיב <AdditionalClaims> הוא אחד מהשמות הרשומים הבאים:

   ‫'kid',‏ 'iss',‏ 'sub',‏ 'aud',‏ 'iat',‏ 'exp',‏ 'nbf',‏ 'jti'

   אז זו הסיבה לשגיאה.

   בדוגמה של מדיניות ליצירת JWT שמוצגת למעלה, השם <Claim> מצוין כ-iss ברכיב <AdditionalClaims>, ולכן מתקבלת השגיאה:

   Invalid name for additional claim : policy(JWT-Generate-HS256) claim(iss).
   

רזולוציה

אסור להשתמש בשמות הרשומים 'kid',‏ 'iss',‏ 'sub',‏ 'aud',‏ 'iat',‏ 'exp',‏ 'nbf' או 'jti' ברכיב הצאצא <Claim>של הרכיב<AdditionalClaims>.

כדי לתקן את הדוגמה למדיניות ליצירת JWT שמוצגת למעלה, משנים את שם ההצהרה ל-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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם סוג התביעה שמשמש ברכיב הצאצא <Claim> של רכיב <AdditionalClaims> במדיניות GenerateJWT הוא לא אחד מהסוגים הבאים:

‫string (ברירת מחדל), number, boolean או map

לדוגמה, שימוש בסוג התלונה integer ברכיב <AdditionalClaims> יגרום לשגיאה.

אבחון

1. מזהים את השם של מדיניות יצירת ה-JWT, את שם הטענה ואת סוג הטענה מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות יצירת ה-JWT הוא JWT-Generate-HS256, שם ההצהרה הוא claim וסוג ההצהרה הוא integer:

   Invalid type for additional claim : policy(JWT-Generate-HS256) claim(claim) type(integer).
   

2. מוודאים ששם הטענה והסוג שמשמשים ברכיב <AdditionalClaims> ב-XML של מדיניות יצירת ה-JWT שנכשלה זהים לשם הטענה ולסוג שזוהו בהודעת השגיאה בשלב 1. לדוגמה, במדיניות הבאה ההצהרה מוגדרת כ-claim והסוג מוגדר כ-integer, שזהה למה שמופיע בהודעת השגיאה:

   <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. אם סוג התלונה שמשמש ברכיב הצאצא <Claim> של הרכיב <AdditionalClaims> הוא לא אחד מהסוגים הבאים:

   ‫string (ברירת מחדל), number, boolean או map

   אז זו הסיבה לשגיאה.

   בדוגמה של מדיניות ליצירת JWT שמוצגת למעלה, הסוג <Claim> שמתחת לרכיב <AdditionalClaims> מוגדר כ-integer. מכיוון ש-integer הוא לא סוג נתמך, מוצגת השגיאה:

   Invalid type for additional claim : policy(JWT-Generate-HS256) claim(claim) type(integer).
   

רזולוציה

מוודאים שמשתמשים רק בסוגי נתונים נתמכים כמו string,‏ number,‏ boolean או map ברכיב הצאצא <Claim> של הרכיב <AdditionalClaims>.

כדי לתקן את המדיניות של יצירת JWT שמוצגת למעלה, משנים את סוג הטענה ל-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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם שם הטענה לא מצוין ברכיב הבן <Claim> של הרכיב <AdditionalClaims> או <AdditionalHeaders>.

אבחון

1. מזהים את השם של מדיניות Generate JWT (יצירת JWT) מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות Generate JWT הוא JWT-Generate-HS256:

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

2. בודקים את קובץ ה-XML של המדיניות Generate JWT שנכשל ומוודאים ששם התביעה לא חסר ברכיב הצאצא <Claims> מתחת לרכיב <AdditionalClaims> או <AdditionalHeaders>. לדוגמה, במדיניות הבאה של יצירת JWT לא מצוין שם ההצהרה ברכיב <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>
   

   מכיוון שהשם <Claim> לא צוין באלמנט <AdditionalClaims>, מוצגת השגיאה:

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

רזולוציה

חשוב לוודא ששם התלונה תמיד מצוין ברכיב הבן <Claim> של הרכיב <AdditionalClaims> או <AdditionalHeaders>.

כדי לתקן את הדוגמה למדיניות Generate 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/>
    <AdditionalClaims>
        <Claim name='claim' ref='reqclaim' type='boolean'/>
    </AdditionalClaims>
</GenerateJWT>

InvalidNameForAdditionalHeader

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם השם של ההצהרה שמשמשת ברכיב הצאצא <Claim> של הרכיב <AdditionalHeaders> הוא אחד מכותרות ה-JWT הסטנדרטיות הבאות:

alg או typ

לדוגמה, שימוש בשם ההצהרה alg מתחת לרכיב <AdditionalHeaders> יגרום לשגיאה.

אבחון

1. מזהים את השם של מדיניות יצירת ה-JWT ואת שם הכותרת מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות יצירת ה-JWT הוא JWT-Generate-HS256 ושם הכותרת הוא alg:

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

2. מוודאים ששם הכותרת שמשמש ברכיב הצאצא <Claim> מתחת לרכיב <AdditionalHeaders> בקובץ ה-XML של מדיניות יצירת ה-JWT שנכשלה זהה לשם הכותרת שצוין בהודעת השגיאה בשלב 1. לדוגמה, במדיניות הבאה הכותרת מוגדרת כ-alg, שזהה למה שמופיע בהודעת השגיאה:

   <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. אם שם הכותרת שמשמש ברכיב המשני <Claim> של הרכיב <AdditionalClaims> הוא אחת מכותרות ה-JWT הסטנדרטיות הבאות:

   alg או typ

   אז זו הסיבה לשגיאה.

   בדוגמה של מדיניות ליצירת JWT שמוצגת למעלה, השם <Claim> מצוין כ-alg ברכיב <AdditionalClaims>, ולכן מתקבלת השגיאה:

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

רזולוציה

אל תשתמשו בכותרות JWT הרגילות alg או typ ברכיב המשני <Claim> של הרכיב <AdditionalHeaders>.

כדי לתקן את המדיניות של יצירת JWT שמוצגת בדוגמה שלמעלה, צריך להשתמש בשם x5c ברכיב המשני <Claim> של הרכיב <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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה תתרחש אם סוג הטענה שנעשה בו שימוש ברכיב הצאצא <Claim> של הרכיב <AdditionalHeaders> במדיניות GenerateJWT הוא לא אחד מהסוגים הבאים:

‫string (ברירת מחדל), number, boolean או map.

לדוגמה, שימוש בסוג התלונה integer מתחת לרכיב <AdditionalHeaders> יגרום לשגיאה.

אבחון

1. מזהים את השם של מדיניות יצירת ה-JWT, את שם הטענה ואת סוג הטענה מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות יצירת ה-JWT הוא JWT-Generate-HS256, שם ההצהרה הוא claim, וסוג ההצהרה הוא integer:

   Invalid type for additional header : policy(JWT-Generate-HS256) claim(claim) type(integer).
   

2. מוודאים ששם הטענה וסוג הטענה שמשמשים ברכיב <AdditionalClaims> ב-XML של מדיניות יצירת ה-JWT שנכשלה זהים לשם הטענה ולסוג הטענה שזוהו בהודעת השגיאה בשלב 1. לדוגמה, במדיניות הבאה התלונה מוגדרת כ-claim וסוג התלונה מוגדר כ-integer, שזהה למה שמופיע בהודעת השגיאה:

   <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. אם סוג התלונה שמשמש ברכיב הצאצא <Claim> של הרכיב <AdditionalHeaders> הוא לא אחד מהסוגים הבאים:

   ‫string (ברירת מחדל), number, boolean או map

   אז זה הגורם לשגיאה.

   בדוגמה של מדיניות ליצירת JWT שמוצגת למעלה, הסוג <Claim> שמתחת לרכיב <AdditionalHeaders> מוגדר כ-integer. מכיוון ש-integer הוא לא סוג נתמך, מוצגת השגיאה:

   Invalid type for additional header : policy(JWT-Generate-HS256) claim(claim) type(integer).
   

רזולוציה

מוודאים שברכיב הצאצא <Claim> של הרכיב <AdditionalHeaders> נעשה שימוש רק בסוגי הנתונים הנתמכים string,‏ number,‏ boolean או map.

כדי לתקן את מדיניות יצירת ה-JWT שמוצגת למעלה, משנים את סוג ההצהרה ל-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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם הערך של מאפיין המערך באלמנט הצאצא <Claim> של האלמנט <AdditionalClaims> או <AdditionalHeaders> לא מוגדר כ-true או כ-false.

לדוגמה, הגדרת הערך של מאפיין המערך כ-yes ברכיב הצאצא <Claim> של <AdditionalClaims> או <AdditionalHeaders> גורמת לשגיאה.

אבחון

1. מזהים את השם של מדיניות יצירת ה-JWT ואת שם הטענה מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות יצירת ה-JWT הוא JWT-Generate-HS256 ושם ההצהרה הוא claim:

   Invalid value for array attribute: policy(JWT-Generate-HS256) claim(claim).
   

2. מוודאים ששם התביעה שמשמש ברכיב הצאצא <Claim> מתחת לרכיב <AdditionalHeaders> ב-XML של מדיניות יצירת ה-JWT שנכשלה זהה לשם התביעה שצוין בהודעת השגיאה בשלב 1. לדוגמה, במדיניות הבאה שם ההצהרה הוא claim, שזהה למה שמופיע בהודעת השגיאה:

   <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. אם הערך של המאפיין array ברכיב הצאצא <Claim> של הרכיב <AdditionalClaims> לא מוגדר כ-true או כ-false, זו הסיבה לשגיאה.

   בדוגמה שלמעלה, המאפיין array ברכיב הצאצא <Claim> של הרכיב <AdditionalClaims> מוגדר כ-yes, ולכן מתקבלת השגיאה:

   Invalid value for array attribute: policy(JWT-Generate-HS256) claim(claim).
   

רזולוציה

מוודאים שהערך של מאפיין המערך ברכיב הצאצא <Claim> של <AdditionalClaims> או <AdditionalHeaders> מוגדר כ-true או כ-false.

כדי לתקן את המדיניות לדוגמה של יצירת JWT שמוצגת למעלה, צריך לשנות את הערך של מאפיין המערך ל-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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם נעשה שימוש באלמנט <PrivateKey> עם אלגוריתמים של HS Family, ונעשה שימוש באלמנט <SecretKey> עם אלגוריתמים של RSA Family. השגיאה תופיע גם אם אחד מהתנאים האלה מתקיים.

לדוגמה, שימוש ברכיב <PrivateKey> עם אלגוריתמים של HS Family מוביל לשגיאה הזו.

אבחון

1. מזהים את השם של מדיניות Generate JWT, את שם הרכיב ואת השם של משפחת האלגוריתמים מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות Generate JWT הוא JWT-Generate-HS256, שם הרכיב הוא PrivateKey ומשפחת האלגוריתמים היא HMAC:

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

2. מוודאים שהרכיב ומשפחת האלגוריתמים שבהם נעשה שימוש ב-XML של מדיניות יצירת ה-JWT שנכשלה זהים לרכיב ולמשפחת האלגוריתמים שזוהו בהודעת השגיאה בשלב 1. לדוגמה, במדיניות הבאה הרכיב מוגדר כ-PrivateKey ומשפחת האלגוריתמים מוגדרת כ-HMAC, שזהה למה שמופיע בהודעת השגיאה:

   <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. אם הערך של הרכיב <Algorithm> הוא HS256, אבל השתמשתם בערך <PrivateKey>, אז זו הסיבה לשגיאה.

   בדוגמה של מדיניות ליצירת JWT שמוצגת למעלה, נעשה שימוש ב-<PrivateKey> למרות ש-<PrivateKey> מוגדר לאלגוריתם משפחתי, HS256, וכתוצאה מכך מופיעה השגיאה:

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

רזולוציה

מוודאים שהרכיב <PrivateKey> משמש רק עם אלגוריתמים של מודעות רספונסיביות לרשת החיפוש (RSA) שמתאימים למשפחות, והרכיב <SecretKey> משמש רק עם אלגוריתמים של מודעות רספונסיביות לרשת החיפוש (RSA) שמתאימים למשפחות.

כדי לתקן את הדוגמה למדיניות Generate JWT שמוצגת למעלה, משתמשים ב-<SecretKey> ממדיניות GenerateJWT שמשתמשת באלגוריתם 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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

Error Saving Revision 2
Invalid Value for element : policy(JWT-Generate-HS256) element(Algorithm).

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם הערך שצוין ברכיב <Algorithm> לא תואם לאחד מהערכים הבאים:

HS256,‏ HS384,‏ HS512,‏ RS256,‏ RS384,‏ RS512

לדוגמה, אם מציינים את ערך האלגוריתם כ-RS128 ברכיב <Algorithm>, מוצגת השגיאה הזו.

אבחון

1. מזהים את השם של מדיניות Generate JWT ואת שם הרכיב מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות Generate JWT הוא JWT-Generate-HS256 ושם הרכיב הוא Algorithm.

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

2. בודקים את קובץ ה-XML של המדיניות Generate JWT שנכשל, ואת הערך שצוין לרכיב <Algorithm>.

   דוגמה למדיניות ליצירת 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. בודקים את הערך שצוין ברכיב <Algorithm>. אם הוא לא אחד מהערכים הבאים:

   HS256,‏ HS384,‏ HS512,‏ RS256,‏ RS384,‏ RS512

   אז זו הסיבה לשגיאה.

   בדוגמה של מדיניות ליצירת JWT שמוצגת למעלה, השם <Algorithm> מוגדר כ-HS128. מכיוון שזהו אלגוריתם לא נתמך, מוצגת השגיאה:

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

רזולוציה

צריך לוודא שהערך שצוין ברכיב <Algorithm> הוא אחד מהערכים הנתמכים:

HS256,‏ HS384,‏ HS512,‏ RS256,‏ RS384,‏ RS512

כדי לתקן את הדוגמה למדיניות ליצירת JWT שמוצגת למעלה, שבה נעשה שימוש ברכיב <SecretKey>, צריך לשנות את הערך של <Algorithm> ל-HS25. הערה: כשמשתמשים ברכיב <SecretKey>, אפשר להשתמש רק באלגוריתמים של HS Family.

<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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת כשלא משתמשים ברכיב <PrivateKey> עם אלגוריתמים של משפחת RSA במדיניות Generate JWT. באופן דומה, השגיאה יכולה להתרחש אם לא משתמשים ברכיב <SecretKey> עם אלגוריתמים של משפחת HS במדיניות Generate JWT.

לדוגמה, אם לא משתמשים ברכיב <PrivateKey> עם אלגוריתמים של RSA Family, השגיאה הזו תופיע.

אבחון

1. מזהים את השם של מדיניות Generate JWT ואת השם של הרכיב החסר מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות יצירת ה-JWT הוא JWT-Generate-HS256 והשם של הרכיב החסר הוא SecretKey.

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

2. בודקים את קובץ ה-XML של המדיניות Generate JWT (יצירת JWT) שנכשל ומוודאים שהרכיב שמצוין בהודעת השגיאה חסר. אם הוא חסר, זה הגורם לשגיאה.

   לדוגמה, במדיניות הבאה חסר SecretKey והערך של Algorithm הוא 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>
   

   בדוגמה Generate JWT policy נעשה שימוש באלגוריתמים של משפחת HS, אבל חסר הרכיב הנדרש SecretKey, ולכן מתקבלת השגיאה:

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

רזולוציה

חשוב לוודא שנעשה שימוש ברכיב <PrivateKey> שהוא חובה עם אלגוריתמים של RSA Family, וברכיב <SecretKey> שהוא חובה עם אלגוריתמים של HS Family.

כדי לתקן את הדוגמה למדיניות ליצירת JWT שמוצגת למעלה, שמשתמשת באלגוריתם HS256, מוסיפים את הרכיב <SecretKey> למדיניות ליצירת 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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם רכיב הבן <Value> שחובה להגדיר אותו לא מוגדר באלמנטים <PrivateKey> או <SecretKey> במדיניות Generate JWT.

אבחון

1. מזהים את השם של מדיניות Generate JWT (יצירת JWT) מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות יצירת ה-JWT הוא JWT-Generate-HS256.

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

2. בודקים את קובץ ה-XML של המדיניות Generate JWT שנכשל, ומוודאים שרכיב הצאצא <Value> לא מוגדר ברכיבים <PrivateKey> או <SecretKey>. אם <Value> לא מוגדר, זה הגורם לשגיאה.

   לדוגמה, במדיניות הבאה רכיב הבן <Value> לא מוגדר ברכיב <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>
   

   מכיוון שרכיב הבן <Value> לא מוגדר ברכיב <SecretKey> של מדיניות Generate JWT, מוצגת השגיאה:

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

רזולוציה

חשוב לוודא שרכיב הבן <Value> מוגדר תמיד ברכיבים <PrivateKey> או <SecretKey> של מדיניות Generate JWT.

כדי לתקן את מדיניות יצירת ה-JWT שמוצגת למעלה, מגדירים את רכיב הצאצא <Value> מתחת לרכיב <SecretKey> כמו שמוצג בהמשך:

<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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם מאפיין ה-ref ברכיב הצאצא <Value> של הרכיבים <PrivateKey> או <SecretKey> לא צוין או ריק.

לדוגמה, אם רכיב הצאצא <Value> של האלמנט <SecretKey> ריק, השגיאה מתרחשת.

אבחון

1. מזהים את השם של מדיניות Generate JWT ואת השם של הרכיב הריק מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות יצירת ה-JWT הוא JWT-Generate-HS256 והשם של הרכיב הריק הוא SecretKey/Value.

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

2. בודקים את קובץ ה-XML של המדיניות Generate JWT שנכשל, ומוודאים שהרכיב שזוהה בשלב 1 ריק. אם הוא ריק, זו הסיבה לשגיאה.

   לדוגמה, במדיניות הבאה אפשר לראות שרכיב הבן <Value> של הרכיב <SecretKey> ריק:

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

   כי רכיב הצאצא <Value> של האלמנט <SecretKey> במדיניות Generate JWT ריק, ולכן מוצגת השגיאה:

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

רזולוציה

מוודאים שמאפיין ה-ref ברכיב הצאצא <Value> של הרכיבים <PrivateKey> או <SecretKey> תמיד מצוין וכולל את הקידומת private..

כדי לתקן את המדיניות של יצירת JWT שמוצגת בדוגמה שלמעלה, משתמשים במשתנה של זרימת העבודה private.privatekey ברכיב המשני <Value> של הרכיב <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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם שם משתנה הזרימה שצוין במאפיין ref ברכיב הבן <Value> של הרכיבים <PrivateKey> או <SecretKey> לא כולל את הקידומת הפרטית (private.).

לדוגמה :

אם שם משתנה הזרימה מצוין כ-mykey במאפיין ref של רכיב הצאצא <Value> של רכיב <PrivateKey>, השגיאה הזו מתרחשת.

אבחון

1. מזהים את השם של מדיניות Generate JWT ואת השם של הרכיב עם שם משתנה לא תקין מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות Generate JWT הוא JWT-Generate-HS256 ושם הרכיב הוא SecretKey/Value.

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

2. בודקים את קובץ ה-XML של המדיניות Generate JWT (יצירת JWT) שנכשל, ומוודאים ששם המשתנה שמופיע ברכיב זהה לשם שזוהה בשלב 1. אם לשם המשתנה אין את הקידומת private., זו הסיבה לשגיאה.

   לדוגמה, במדיניות הבאה אפשר לראות שלרכיב הבן <Value> של הרכיב <SecretKey> יש שם משתנה לא תקין 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>
   

   מכיוון לשם המשתנה שצוין ברכיב הצאצא <Value> של הרכיב <SecretKey> במדיניות Generate JWT לא מוגדרת הקידומת private., מוצגת השגיאה:

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

רזולוציה

חשוב לוודא שמאפיין ה-ref ברכיב הבן <Value> של הרכיבים <PrivateKey> או <SecretKey> תמיד מצוין וכולל את הקידומת private..

כדי לתקן את המדיניות של יצירת JWT שמוצגת למעלה, משתמשים במשתנה הזרימה private.privatekey ברכיב המשני <Value> של הרכיב <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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם הערך (הסוד) מצוין באופן מפורש ב:

• רכיבי הצאצא <Value> או <Password> של הרכיב <PrivateKey> או
• רכיב הבן <Value> של הרכיב <SecretKey>

במדיניות Generate JWT.

לדוגמה, אם הסוד מצוין באופן מפורש כ-abc ברכיב הצאצא <Value> של הרכיב <SecretKey>, השגיאה הזו מתרחשת.

אבחון

1. מזהים את השם של מדיניות Generate JWT (יצירת JWT) ואת שם הרכיב שבו הסוד מצוין באופן מפורש בהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות Generate JWT הוא JWT-Generate-HS256 ושם הרכיב הוא SecretKey/Value.

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

2. בודקים את קובץ ה-XML של המדיניות Generate JWT שנכשל, ומוודאים שהסוד מצוין באופן מפורש ברכיב שזוהה בשלב 1. אם היא מצוינת באופן מפורש, אז היא הגורם לשגיאה.

   לדוגמה, במדיניות הבאה אפשר לראות שהסוד צוין באופן מפורש ברכיב הבן <Value> של הרכיב <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>
   

   מכיוון שהסוד מצוין באופן מפורש ברכיב הבן <Value> של הרכיב <SecretKey> במדיניות Generate JWT, מוצגת השגיאה:

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

רזולוציה

חשוב לוודא שהערך תמיד מצוין כמשתנה של זרימה ברכיב הצאצא <Value> של הרכיבים <PrivateKey> או <SecretKey>.

כדי לתקן את הדוגמה למדיניות ליצירת JWT שמוצגת למעלה, משתמשים במשתנה של התהליך private.secretkey במאפיין ref של הרכיב המשני <Value> של <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

הודעת שגיאה

פריסת ה-proxy ל-API דרך ממשק המשתמש של Edge או דרך Edge management API נכשלת עם הודעת השגיאה הבאה:

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

הודעת שגיאה לדוגמה

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

דוגמה לצילום מסך

בממשק המשתמש של Edge, תופיע תיבת דו-שיח עם שגיאה:

סיבה

השגיאה הזו מתרחשת אם הערך שצוין ברכיב <NotBefore> לא נמצא בין הפורמטים הנתמכים:

sortable, RFC 1123, RFC 850, ANCI-C

לדוגמה, אם הערך שצוין ב-<NotBefore> הוא 20-JUN-1990 08:03, שהוא לא פורמט נתמך, תופיע השגיאה הזו.

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

אבחון

1. מזהים את השם של מדיניות Generate JWT ואת שם הרכיב שכולל פורמט זמן לא תקין מהודעת השגיאה. לדוגמה, בהודעת השגיאה הבאה, השם של מדיניות Generate JWT הוא JWT-Generate-HS256 ושם הרכיב הוא NotBefore.

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

2. בודקים את קובץ ה-XML של מדיניות יצירת ה-JWT שנכשלת ומוודאים שפורמט הזמן שבו נעשה שימוש ברכיב שזוהה בשלב 1 תקין. אם הרכיב לא משתמש באף אחד מהפורמטים הנתמכים:

   sortable, RFC 1123, RFC 850, ANCI-C

   אז זו הסיבה לשגיאה.

   לדוגמה, במדיניות הבאה אפשר לראות שרכיב הצאצא <NotBefore> משתמש בפורמט זמן שלא נתמך:

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

   מכיוון שהרכיב <NotBefore> של מדיניות Generate JWT לא משתמש באף אחד מפורמטי הזמן הנתמכים, מוצגת השגיאה:

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

רזולוציה

מוודאים שהערך שצוין ברכיב <NotBefore> הוא באחד מהפורמטים הנתמכים:

sortable, RFC 1123, RFC 850, ANCI-C

כדי לתקן את הדוגמה למדיניות ליצירת JWT, משנים את התאריך ברכיב <NotBefore> לפורמט sortable כמו שמוצג בהמשך:

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