عیب‌یابی خطای استقرار خط‌مشی GenerateJWT

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

InvalidNameForAdditionalClaim

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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» و نام ادعا را از پیام خطا شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید خط‌مشی JWT» JWT-Generate-HS256 و نام ادعا iss است:

    Invalid name for additional claim : policy(JWT-Generate-HS256) claim(iss).
    
  2. تأیید کنید که نام ادعای استفاده‌شده تحت عنصر <AdditionalClaims> در XML خط‌مشی «تولید JWT» ناموفق با نام ادعای شناسایی‌شده در پیام خطا مطابقت دارد (مرحله ۱ در بالا). برای مثال، خط‌مشی زیر ادعا را به‌عنوان 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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» ناموفق با نام ادعا و نوع شناسایی‌شده در پیام خطا در «مرحله ۱» مطابقت دارد. برای مثال، خط‌مشی زیر ادعا را به‌عنوان 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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. نام خط‌مشی «تولید JWT» را از پیام خطا شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید JWT» JWT-Generate-HS256 است:

    Error occurred while validation of bean JWT-Generate-HS256.xml. Reason: - Required attribute name is missing in Claim
    
  2. «زبان نشانه‌گذاری توسعه‌پذیر خط‌مشی تولید 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> مشخص شده باشد.

برای اصلاح خط‌مشی «تولید 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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» ناموفق با نام سرایند شناسایی‌شده در پیام خطا در «مرحله ۱» مطابقت داشته باشد. برای مثال، خط‌مشی زیر سرصفحه را به‌عنوان 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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» ناموفق با نام ادعا و نوع ادعای شناسایی‌شده در پیام خطا در «مرحله ۱» مطابقت دارد. برای مثال، خط‌مشی زیر ادعا را به‌عنوان 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).
    

وضوح

مطمئن شوید که فقط از انواع داده پشتیبانی‌شده string، number، boolean، یا map در عنصر فرزند <Claim> عنصر <AdditionalHeaders> استفاده شده است.

برای اصلاح خط‌مشی «تولید 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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» نام ادعای مشخص‌شده در پیام خطا در «مرحله ۱» مطابقت دارد. برای مثال، خط‌مشی زیر نام دعوی را به‌عنوان 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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» و عنصر <SecretKey> با الگوریتم‌های «خانواده RSA» استفاده شود. اگر هریک از این شرایط درست باشد، خطا نیز رخ خواهد داد.

برای مثال، استفاده از عنصر <PrivateKey> با الگوریتم‌های «خانواده HS» منجر به این خطا می‌شود.

تشخیص

  1. نام خط‌مشی «تولید JWT»، نام عنصر، و نام خانواده الگوریتم را از پیام خطا شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید 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» ناموفق با عنصر و خانواده الگوریتم شناسایی‌شده در پیام خطا در «مرحله ۱» مطابقت داشته باشد. برای مثال، خط‌مشی زیر عنصر را به‌عنوان 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> فقط با الگوریتم‌های «خانواده HS» استفاده شود.

برای اصلاح خط‌مشی «تولید JWT» مثال نشان‌داده‌شده در بالا، از <SecretKey> از خط‌مشی «تولید JWT» که از الگوریتم 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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. نام خط‌مشی «تولید JWT» و نام عنصر را از پیام خطا شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید JWT» JWT-Generate-HS256 و نام عنصر Algorithm. است

    Invalid Value for element : policy(JWT-Generate-HS256) element(Algorithm).
    
  2. «XML خط‌مشی تولید 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» استفاده کنید.

<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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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» در خط‌مشی «تولید JWT» استفاده نشود. به‌همین ترتیب، اگر عنصر <SecretKey> با الگوریتم‌های HS Family در خط‌مشی «تولید JWT» استفاده نشود، این خطا می‌تواند رخ دهد.

برای مثال، استفاده نکردن از عنصر <PrivateKey> با الگوریتم‌های «خانواده RSA» منجر به این خطا می‌شود.

تشخیص

  1. نام خط‌مشی «تولید JWT» و نام عنصر ازدست‌رفته را از پیام خطا شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید JWT» JWT-Generate-HS256 و نام عنصر ازدست‌رفته SecretKey است.

    Missing configuration element : policy(JWT-Generate-HS256) element(SecretKey).
    
  2. «زبان نشانه‌گذاری توسعه‌پذیر» خط‌مشی «تولید 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>
    

    خط‌مشی نمونه «تولید خط‌مشی JWT» از الگوریتم‌های «خانواده HS» استفاده می‌کند، اما عنصر اجباری SecretKey وجود ندارد و درنتیجه خطای زیر رخ می‌دهد:

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

وضوح

مطمئن شوید که عنصر اجباری <PrivateKey> با الگوریتم‌های «خانواده RSA» و عنصر اجباری <SecretKey> با الگوریتم‌های «خانواده HS» استفاده می‌شود.

برای اصلاح خط‌مشی «تولید 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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

پیام خطای نمونه

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

نماگرفت نمونه

در «میانای کاربری Edge»، کادر گفتگویی با خطا مشاهده خواهید کرد:

علت

این خطا زمانی رخ می‌دهد که عنصر فرزند اجباری <Value> در عناصر <PrivateKey> یا <SecretKey> در خط‌مشی «تولید JWT» تعریف نشده باشد.

تشخیص

  1. نام خط‌مشی «تولید JWT» را از پیام خطا شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید JWT» JWT-Generate-HS256 است.

    Invalid Key configuration : policy(JWT-Generate-HS256).
    
  2. «زبان نشانه‌گذاری توسعه‌پذیر خط‌مشی تولید 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> خط‌مشی «تولید JWT» تعریف نشده است، این خطا را دریافت می‌کنید:

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

وضوح

مطمئن شوید که عنصر فرزند <Value> همیشه در عناصر <PrivateKey> یا <SecretKey> خط‌مشی «تولید 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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. نام خط‌مشی «تولید JWT» و نام عنصر خالی را از پیام خطا شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید JWT» JWT-Generate-HS256 و نام عنصر خالی SecretKey/Value است.

    Empty Element for Key Configuration : policy(JWT-Generate-HS256) element(SecretKey/Value).
    
  2. «خط‌مشی تولید XML مربوط به JWT» ناموفق را بررسی کنید و ببینید عنصری که در «مرحله ۱» شناسایی شده است خالی است یا نه. اگر خالی باشد، دلیل خطا همین است.

    برای مثال، خط‌مشی زیر نشان می‌دهد که عنصر فرزند <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> در خط‌مشی «تولید 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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. نام خط‌مشی «تولید JWT» و نام عنصر دارای نام متغیر نامعتبر را از پیام خطا شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید JWT» JWT-Generate-HS256 و نام عنصر SecretKey/Value است.

    Invalid variable name for secret : policy(JWT-Generate-HS256) element(SecretKey/Value).
    
  2. فایل XML خط‌مشی «تولید JWT» ناموفق را بررسی کنید و نام متغیر استفاده‌شده در عنصر را که در «مرحله ۱» شناسایی شده است تأیید کنید. اگر نام متغیر پیشوند 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> خط‌مشی «تولید 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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>

در خط‌مشی «تولید JWT».

برای مثال، اگر رمز به‌صورت صریح به‌عنوان abc در عنصر فرزند <Value> عنصر <SecretKey> مشخص شده باشد، این خطا رخ می‌دهد.

تشخیص

  1. نام خط‌مشی «تولید JWT» و نام عنصری را که راز در آن به‌طور صریح از پیام خطا مشخص شده است شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید JWT» JWT-Generate-HS256 و نام عنصر SecretKey/Value است.

    Specifying a secret in the configuration is invalid : policy(JWT-Generate-HS256) element(SecretKey/Value).
    
  2. فایل XML خط‌مشی «تولید JWT» ناموفق را بررسی کنید و ببینید آیا رمز در عنصر شناسایی‌شده در «مرحله ۱» به‌طور صریح مشخص شده است یا نه. اگر به‌طور صریح مشخص شده باشد، آن دلیل خطا است.

    برای مثال، خط‌مشی زیر نشان می‌دهد که رمز در عنصر فرزند <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> خط‌مشی «تولید 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

پیام خطا

استقرار پراکسی API ازطریق «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت Edge» با این پیام خطا ناموفق است:

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. نام خط‌مشی «تولید JWT» و نام عنصری را که قالب زمان نامعتبر دارد از پیام خطا شناسایی کنید. برای مثال، در پیام خطای زیر، نام خط‌مشی «تولید JWT» JWT-Generate-HS256 و نام عنصر NotBefore است.

    Invalid Time format: policy(JWT-Generate-HS256) element(NotBefore).
    
  2. «خط‌مشی تولید XML وب‌توکن JSON» ناموفق را بررسی کنید و قالب زمان استفاده‌شده در عنصر شناسایی‌شده در «مرحله ۱» را درستی‌سنجی کنید. اگر عنصر از هیچ‌یک از قالب‌های پشتیبانی‌شده استفاده نمی‌کند:

    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> در خط‌مشی «تولید 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>