‫۵۰۳ سرویس دردسترس نیست - تبادل SSL ناموفق بود

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

نشانه

برنامه مشتری کد وضعیت HTTP 503 Service Unavailable را با کد خطای messaging.adaptors.http.flow.SslHandshakeFailed به‌عنوان پاسخ برای فراخوانی‌های API دریافت می‌کند.

پیام خطا

برنامه کارخواه کد پاسخ زیر را دریافت می‌کند:

HTTP/1.1 503 Service Unavailable

علاوه‌براین، ممکن است پیام خطای زیر را مشاهده کنید:

{
   "fault":{
      "faultstring":"SSL Handshake failed sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target",
      "detail":{
         "errorcode":"messaging.adaptors.http.flow.SslHandshakeFailed"
      }
   }
}

علل احتمالی

ممکن است کد وضعیت 503 Service Unavailable را با کد خطای messaging.adaptors.http.flow.SslHandshakeFailed به‌دلیل ناموفق بودن فرایند دست دادن SSL بین «پردازشگر پیام» Apigee Edge و سرور پشتیبان به دلایل مختلف دریافت کنید. پیام خطا در faultstring معمولاً نشان‌دهنده علت احتمالی سطح بالایی است که منجر به این خطا شده است.

بسته به پیام خطایی که در faultstring مشاهده می‌شود، باید از تکنیک‌های مناسب برای عیب‌یابی مشکل استفاده کنید. این کتابچه راهنما توضیح می‌دهد که اگر پیام خطای SSL Handshake failed sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target را در faultstring مشاهده کردید، چگونه این خطا را عیب‌یابی کنید.

این خطا درطول فرایند دست دادن SSL بین «پردازشگر پیام» Apigee Edge و سرور زیرینه رخ می‌دهد:

  • اگر truststore «پردازشگر پیام» Apigee Edge:
    • حاوی زنجیره گواهینامه‌ای است که با زنجیره گواهینامه کامل سرور پشتیبان مطابقت ندارد، یا
    • زنجیره گواهینامه کامل سرور زیرینه را ندارد
  • اگر زنجیره گواهینامه ارائه‌شده توسط سرور نهایی:

دلایل احتمالی این مشکل به شرح زیر است:

علت شرح دستورالعمل‌های عیب‌یابی برای موارد زیر قابل‌اجرا است
گواهینامه یا زنجیره گواهینامه نادرست/ناقص در مخزن اعتماد «پردازشگر پیام» گواهینامه و/یا زنجیره آن که در مخزن اعتماد «پردازشگر پیام» Apigee Edge ذخیره شده است با زنجیره گواهینامه سرور زیرینه مطابقت ندارد یا حاوی زنجیره گواهینامه کامل سرور زیرینه نیست. کاربران «ابر خصوصی» و «ابر عمومی» لبه
عدم تطابق FQDN در گواهینامه سرور زیرینه و نام میزبان در نقطه پایان هدف گواهینامه ارائه‌شده توسط سرور زیرینه حاوی «نام دامنه کاملاً واجدشرایطی» است که با نام میزبان مشخص‌شده در نقطه پایانی هدف مطابقت ندارد. کاربران «ابر خصوصی» و «ابر عمومی» لبه
گواهینامه یا زنجیره گواهینامه نادرست/ناقص ارائه‌شده توسط سرور زیرینه زنجیره گواهینامه ارائه‌شده توسط سرور زیرینه نادرست یا ناقص است. کاربران «ابر خصوصی» و «ابر عمومی» لبه

مراحل متداول تشخیص خرابی

برای تشخیص این خطا، از یکی از ابزارها/تکنیک‌های زیر استفاده کنید:

پایش میانای برنامه‌سازی کاربردی

رویه شماره ۱: استفاده از «پایش میانای برنامه‌سازی کاربردی»

برای تشخیص خطا بااستفاده از «پایش API»:

  1. به‌عنوان کاربری با نقش مناسب به سیستم Apigee Edge UI وارد شوید.
  2. به سازمانی که می‌خواهید مشکل را در آن بررسی کنید بروید.

  3. به صفحه تجزیه‌وتحلیل > پایش API > بررسی پیمایش کنید.
  4. بازه زمانی خاصی را که در آن خطاها را مشاهده کرده‌اید انتخاب کنید.
  5. رسم کد خطا دربرابر زمان.

  6. سلولی را که کد خطای messaging.adaptors.http.flow.SslHandshakeFailed را دارد انتخاب کنید همان‌طور که در زیر نشان داده شده است:

    ( مشاهده تصویر بزرگ‌تر)

  7. اطلاعات مربوط به کد خطا messaging.adaptors.http.flow.SslHandshakeFailed به‌صورت نشان داده می‌شود:

    ( مشاهده تصویر بزرگ‌تر)

  8. روی مشاهده گزارش‌ها کلیک کنید و ردیف درخواست ناموفق را ازهم باز کنید.

    ( مشاهده تصویر بزرگ‌تر)

  9. از پنجره گزارش‌ها، جزئیات زیر را یادداشت کنید:
    • شناسه پیام درخواست
    • کد وضعیت: 503
    • منبع خطا: target
    • کد خطا: messaging.adaptors.http.flow.SslHandshakeFailed

ردیابی

رویه شماره ۲: استفاده از ابزار «ردیابی»

برای تشخیص خرابی بااستفاده از ابزار «ردیابی»:

  1. جلسه ردیابی و یکی از این موارد را فعال کنید
    • منتظر خطای 503 Service Unavailable با کد خطای messaging.adaptors.http.flow.SslHandshakeFailed بمانید، یا
    • اگر می‌توانید مشکل را بازتولید کنید، برای بازتولید مشکل، تماس API برقرار کنید 503 Service Unavailable
  2. مطمئن شوید که نمایش همه FlowInfos فعال باشد:

  3. یکی از درخواست‌های ناموفق را انتخاب کنید و ردیابی را بررسی کنید.
  4. در مراحل مختلف ردیابی پیمایش کنید و مکان وقوع خطا را پیدا کنید.
  5. معمولاً خطا را پس‌از مرحله جریان درخواست هدف شروع شد همان‌طور که در زیر نشان داده شده است پیدا خواهید کرد:

    ( مشاهده تصویر بزرگ‌تر)

  6. مقادیر زیر را از ردیابی یادداشت کنید:
    • خطا: SSL Handshake failed sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
    • error.cause: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
    • error.class: com.apigee.errors.http.server.ServiceUnavailableException
    • مقدار خطای SSL Handshake failed sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target نشان می‌دهد که «دست‌دهی SSL» ناموفق بوده است، زیرا «پردازشگر پیام» Apigee Edge نتوانسته است گواهینامه سرور پشتیبان را اعتبارسنجی کند.
  7. به فاز AX (داده‌های Analytics ضبط‌شده) در ردیابی بروید و روی آن کلیک کنید.
  8. به بخش سرایندهای خطای جزئیات فاز پیمایش کنید و مقادیر X-Apigee-fault-code و X-Apigee-fault-source و X-Apigee-Message-ID را همان‌طور که در زیر نشان داده شده است تعیین کنید:

    ( مشاهده تصویر بزرگ‌تر)

  9. مقادیر X-Apigee-fault-code، X-Apigee-fault-source، و X-Apigee-Message-ID را یادداشت کنید:
  10. سرایندهای خطا مقدار
    X-Apigee-fault-code messaging.adaptors.http.flow.SslHandshakeFailed
    X-Apigee-fault-source target
    X-Apigee-Message-ID MESSAGE_ID

NGINX

رویه شماره ۳: استفاده از گزارش‌های دسترسی NGINX

برای تشخیص خطا بااستفاده از گزارش‌های دسترسی NGINX:

  1. اگر کاربر «ابر خصوصی» هستید، می‌توانید از گزارش‌های دسترسی NGINX برای تعیین اطلاعات کلیدی درباره 503 Service Unavailable HTTP استفاده کنید.
  2. گزارش‌های دسترسی NGINX را بررسی کنید:

    /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  3. جستجو کنید تا ببینید آیا درطول مدت مشخصی 503 خطایی با کد خطا messaging.adaptors.http.flow.SslHandshakeFailed وجود دارد (اگر مشکل در گذشته رخ داده است) یا اینکه آیا درخواست‌هایی هنوز با 503 ناموفق هستند یا نه.
  4. اگر خطاهای 503 را پیدا کردید که با X-Apigee-fault-code مطابقت دارد و مقدار messaging.adaptors.http.flow.SslHandshakeFailed را دارد، سپس مقدار X-Apigee-fault-source را تعیین کنید.

    نمونه خطای ۵۰۳ از گزارش دسترسی NGINX:

    ( مشاهده تصویر بزرگ‌تر)

    ورودی نمونه بالا از گزارش دسترسی NGINX مقادیر زیر را برای X-Apigee-fault-code و X-Apigee-fault-source: دارد:

    سرایندها مقدار
    X-Apigee-fault-code messaging.adaptors.http.flow.SslHandshakeFailed
    X-Apigee-fault-source target

گزارش‌های «پردازشگر پیام»

رویه شماره ۴: استفاده از گزارش‌های «پردازشگر پیام»

  1. شناسه پیام یکی از درخواست‌های ناموفق را بااستفاده از «پایش میانای برنامه‌سازی کاربردی»، «ابزار ردیابی»، یا «گزارش‌های دسترسی NGINX» همان‌طور که در مراحل تشخیص رایج توضیح داده شده است تعیین کنید.
  2. شناسه پیام درخواست خاص را در گزارش «پردازشگر پیام» (/opt/apigee/var/log/edge-message-processor/logs/system.log) جستجو کنید. ممکن است خطای زیر را مشاهده کنید:

    org:myorg env:test api:MyProxy rev:1
    messageid:myorg-28247-3541813-1
    NIOThread@1 ERROR HTTP.CLIENT - HTTPClient$Context.handshakeFailed() :
    SSLClientChannel[Connected: Remote:X.X.X.X:443
    Local:192.168.194.140:55102]@64596 useCount=1
    bytesRead=0 bytesWritten=0 age=233ms  lastIO=233ms
    isOpen=true handshake failed, message: General SSLEngine problem
    

    خطای بالا نشان می‌دهد که دست‌دهی SSL بین «پردازشگر پیام» و سرور زیرینه ناموفق بوده است.

    پس‌از آن، استثنایی با ردیابی پشته‌ای دقیق همان‌طور که در زیر نشان داده شده است رخ خواهد داد:

    org:myorg env:test api:MyProxy rev:1
    messageid:myorg-28247-3541813-1
    NIOThread@1 ERROR ADAPTORS.HTTP.FLOW - RequestWriteListener.onException() :
    RequestWriteListener.onException(HTTPRequest@1522922c)
    javax.net.ssl.SSLHandshakeException: General SSLEngine problem
    	at sun.security.ssl.Handshaker.checkThrown(Handshaker.java:1478)
    	at sun.security.ssl.SSLEngineImpl.checkTaskThrown(SSLEngineImpl.java:535)
    	... <snipped>
    Caused by: javax.net.ssl.SSLHandshakeException: General SSLEngine problem
    	at sun.security.ssl.Alerts.getSSLException(Alerts.java:203)
    	at sun.security.ssl.SSLEngineImpl.fatal(SSLEngineImpl.java:1728)
    	... <snipped>
    Caused by: sun.security.validator.ValidatorException: PKIX path building failed:
    sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid
    certification path to requested target
    	at sun.security.validator.PKIXValidator.doBuild(PKIXValidator.java:397)
    	at sun.security.validator.PKIXValidator.engineValidate(PKIXValidator.java:302)
    	... <snipped>
      

    توجه داشته باشید که عدم موفقیت در دست دادن به‌دلیل موارد زیر است:

    Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

    این نشان می‌دهد که «دست‌دهی SSL» ناموفق بوده است زیرا «پردازشگر پیام» Apigee Edge نتوانسته است گواهینامه سرور زیرینه را اعتبارسنجی کند.

دلیل: گواهینامه یا زنجیره گواهینامه نادرست/ناقص در مخزن اعتماد «پردازشگر پیام»

تشخیص

  1. کد خطا و منبع خطا را برای خطای مشاهده‌شده بااستفاده از API Monitoring، ابزار Trace، یا گزارش‌های دسترسی NGINX همان‌طور که در مراحل تشخیص متداول توضیح داده شده است تعیین کنید.
  2. اگر کد خطا messaging.adaptors.http.flow.SslHandshakeFailed است، سپس پیام خطا را بااستفاده از یکی از روش‌های زیر تعیین کنید:
    • error.cause را بااستفاده از ابزار «ردیابی» همان‌طور که در مراحل تشخیص خرابی متداول توضیح داده شده است پیدا کنید
    • استثنا را بااستفاده از «گزارش‌های پردازشگر پیام» که در مراحل تشخیص خرابی رایج توضیح داده شده است پیدا کنید
    • faultstring را از پاسخ خطا به فراخوانی API خودتان که در پیام خطا می‌بینید پیدا کنید
  3. اگر پیام خطا sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target" است، نشان می‌دهد که «دست‌دهی SSL» ناموفق بوده است، زیرا «پردازشگر پیام» Apigee Edge نتوانسته است گواهینامه سرور زیرینه را اعتبارسنجی کند.

می‌توانید این مشکل را در دو مرحله اشکال‌زدایی کنید:

  1. فاز ۱: تعیین زنجیره گواهینامه سرور پشتیبان
  2. فاز ۲: مقایسه زنجیره گواهینامه ذخیره‌شده در truststore «پردازشگر پیام»

فاز ۱

فاز ۱: تعیین زنجیره گواهینامه سرور زیرینه

برای تعیین زنجیره گواهی سرور زیرینه، از یکی از روش‌های زیر استفاده کنید:

openssl

فرمان openssl را دربرابر نام میزبان سرور زیرینه به‌صورت زیر اجرا کنید:

openssl s_client -connect BACKEND_SERVER_HOST_NAME:PORT#

«زنجیره گواهینامه» را از برونداد فرمان بالا یادداشت کنید:

نمونه زنجیره گواهینامه سرور زیرینه از برونداد فرمان openssl:

Certificate chain
 0 s:/CN=mocktarget.apigee.net
   i:/C=US/O=Google Trust Services LLC/CN=GTS CA 1D4
 1 s:/C=US/O=Google Trust Services LLC/CN=GTS CA 1D4
   i:/C=US/O=Google Trust Services LLC/CN=GTS Root R1
 2 s:/C=US/O=Google Trust Services LLC/CN=GTS Root R1
   i:/C=US/O=Google Trust Services LLC/CN=GTS Root R1

tcpdump

  1. اگر کاربر «ابر عمومی» هستید، بسته‌های TCP/IP را در سرور زیرینه ضبط کنید.
  2. اگر کاربر «ابر خصوصی» هستید، می‌توانید بسته‌های TCP/IP را در سرور پشتیبان یا «پردازشگر پیام» ضبط کنید. ترجیحاً آن‌ها را در سرور زیرینه ضبط کنید زیرا بسته‌ها در سرور زیرینه رمزگشایی می‌شوند.
  3. از فرمان tcpdump زیر برای ضبط بسته‌های TCP/IP استفاده کنید:

    tcpdump -i any -s 0 host IP_ADDRESS -w FILE_NAME
    
  4. بسته‌های TCP/IP را بااستفاده از ابزار Wireshark یا ابزار مشابهی که با آن آشنا هستید تجزیه‌وتحلیل کنید.

    تجزیه‌وتحلیل نمونه Tcpdump

    ( مشاهده تصویر بزرگ‌تر)

    • بسته شماره ۴۳: «پردازشگر پیام» (منبع) پیامی به Client Hello سرور زیرینه (مقصد) ارسال کرد.
    • بسته شماره ۴۴: سرور زیرینه دریافت پیام Client Hello از «پردازشگر پیام» را تأیید می‌کند.
    • بسته شماره ۴۵: سرور زیرینه پیام Server Hello را به‌همراه گواهی‌اش ارسال می‌کند.
    • بسته شماره ۴۶: «پردازنده پیام» دریافت پیام Server Hello و گواهینامه را تأیید می‌کند.
    • بسته شماره ۴۷: «پردازنده پیام» پیام FIN, ACK و سپس RST, ACK را در بسته شماره ۴۸ ارسال می‌کند.

      این خطا نشان می‌دهد که اعتبارسنجی گواهینامه سرور زیرینه توسط «پردازشگر پیام» ناموفق بوده است. به‌دلیل این است که «پردازشگر پیام» هیچ گواهینامه‌ای ندارد که با گواهینامه سرور زیرینه مطابقت داشته باشد یا نمی‌تواند گواهینامه سرور زیرینه را با گواهینامه‌های موجود در مخزن مطمئن خود (پردازشگر پیام) مطمئن بداند.

    • می‌توانید برگردید و بسته شماره ۴۵ را مرور کنید و زنجیره گواهی ارسالی ازسوی سرور زیرینه را تعیین کنید

      ( مشاهده تصویر بزرگ‌تر)

    • در این مثال، می‌بینید که سرور گواهی برگ را با common name (CN) = mocktarget.apigee.net، سپس گواهی واسط با CN= GTS CA 1D4، و گواهی ریشه را با CN = GTX Root R1 ارسال کرده است.

    اگر مطمئن شدید که اعتبارسنجی گواهینامه سرور ناموفق بوده است، به فاز ۲: مقایسه گواهینامه سرور زیرینه و گواهینامه‌های ذخیره‌شده در truststore «پردازشگر پیام» بروید.

فاز ۲

فاز ۲: مقایسه گواهینامه سرور زیرینه و گواهینامه‌های ذخیره‌شده در truststore «پردازشگر پیام»

  1. زنجیره گواهینامه سرور نهایی را تعیین کنید.
  2. بااستفاده از مراحل زیر، گواهینامه ذخیره‌شده در مخزن اعتماد «پردازشگر پیام» را تعیین کنید:
    1. نام مرجع مخزن مطمئن را از عنصر TrustStore در بخش SSLInfo در TargetEndpoint دریافت کنید.

      بیایید به بخش SSLInfo نمونه در پیکربندی TargetEndpoint نگاهی بیندازیم:

      <TargetEndpoint name="default">
      ...
         <HTTPTargetConnection>
            <Properties />
            <SSLInfo>
               <Enabled>true</Enabled>
               <ClientAuthEnabled>true</ClientAuthEnabled>
               <KeyStore>ref://myKeystoreRef</KeyStore>
               <KeyAlias>myKey</KeyAlias>
               <TrustStore>
                  ref://myCompanyTrustStoreRef
               </TrustStore>
            </SSLInfo>
         </HTTPTargetConnection>
         ...
      </TargetEndpoint>
    2. در مثال بالا، نام مرجع TrustStore عبارت است از myCompanyTruststoreRef.
    3. در «واسط کاربر Edge»، محیط‌ها > مرجع‌ها را انتخاب کنید. نام را در ستون مرجع برای مرجع مشخص فروشگاه امین یادداشت کنید. این نام مخزن مطمئن شما خواهد بود.

      ( مشاهده تصویر بزرگ‌تر)

    4. در مثال بالا، نام فروشگاه مطمئن این است:

      myCompanyTruststoreRef: myCompanyTruststore

  3. گواهینامه‌های ذخیره‌شده در truststore (تعیین‌شده در مرحله قبلی) را بااستفاده از میاناهای برنامه‌سازی کاربردی زیر دریافت کنید:

    1. دریافت همه گواهی‌های یک keystore یا truststore. این «میانای برنامه‌سازی کاربردی» همه گواهینامه‌ها را در انبار اعتماد خاص فهرست می‌کند.

      کاربر «ابر عمومی»:

      curl -v -X GET https//api.enterprise.apigee.com/v1/organizations/ORGANIZATION_NAME/environments/ENVIRONMENT_NAME/keystores/KEYSTORE_NAME/certs -H "Authorization: Bearer $TOKEN"
      

      کاربر «ابر خصوصی»:

      curl -v -X GET http://MANAGEMENT_HOST:PORT_#/v1/organizations/ORGANIZATION_NAME/environments/ENVIRONMENT_NAME/keystores/KEYSTORE_NAME/certs -H "Authorization: Bearer $TOKEN"
      

      مکان:

      • ORGANIZATION_NAME نام سازمان است
      • ‫ENVIRONMENT_NAME نام محیط است
      • ‫KEYSTORE_NAME نام انبار کلید است
      • ‫$TOKEN روی کد دسترسی OAuth 2.0 شما تنظیم شده است، همان‌طور که در دریافت کد دسترسی OAuth 2.0 توضیح داده شده است
      • ‫curl گزینه استفاده‌شده در این مثال در استفاده از curl توضیح داده شده است

      برونداد نمونه:

      گواهینامه‌های فروشگاه مطمئن نمونه myCompanyTruststore عبارت‌اند از:

      [
        "serverCert"
      ]
    2. «جزئیات گواهینامه» را برای گواهینامه خاص از «انبار کلید» یا «انبار اعتماد» دریافت کنید. این «میانای برنامه‌سازی کاربردی» اطلاعات مربوط به گواهینامه خاصی را در مخزن اعتماد خاص برمی‌گرداند.

      کاربر «ابر عمومی»:

      curl -v -X GET https//api.enterprise.apigee.com/v1/organizations/ORGANIZATION_NAME/environments/ENVIRONMENT_NAME/keystores/KEYSTORE_NAME/certs/CERT_NAME -H "Authorization: Bearer $TOKEN"
      

      کاربر «ابر خصوصی»

      curl -v -X GET http://MANAGEMENT_HOST:PORT_#>/v1/organizations/ORGANIZATION_NAME/environments/ENVIRONMENT_NAME/keystores/KEYSTORE_NAME/certs/CERT_NAME -H "Authorization: Bearer $TOKEN"
      

      مکان:

      • ORGANIZATION_NAME نام سازمان است
      • ‫ENVIRONMENT_NAME نام محیط است
      • ‫KEYSTORE_NAME نام انبار کلید است
      • ‫CERT_NAME نام گواهینامه است
      • ‫$TOKEN روی کد دسترسی OAuth 2.0 شما تنظیم شده است، همان‌طور که در دریافت کد دسترسی OAuth 2.0 توضیح داده شده است
      • ‫curl گزینه استفاده‌شده در این مثال در استفاده از curl توضیح داده شده است

      نمونه برونداد

      جزئیات serverCert موضوع و صادرکننده را به‌صورت زیر نشان می‌دهد:

      گواهینامه برگ/نهاد:

      "subject": "CN=mocktarget.apigee.net",
      "issuer": "CN=GTS CA 1D4, O=Google Trust Services LLC, C=US",

      گواهینامه واسط:

      "subject" : "CN=GTS CA 1D4, O=Google Trust Services LLC, C=US",
      "issuer" : "CN=GTS Root R1, O=Google Trust Services LLC, C=US",
  4. تأیید کنید که گواهینامه سرور واقعی که در مرحله ۱ به‌دست آمده است و گواهینامه ذخیره‌شده در truststore که در مرحله ۳ به‌دست آمده است مطابقت دارند. اگر مطابقت نداشته باشند، این دلیل مشکل است.

    از مثال نشان‌داده‌شده در بالا، بیایید هر بار به یک گواهینامه نگاه کنیم:

    1. گواهینامه نهایی:

      از سرور زیرینه:

      s:/CN=mocktarget.apigee.net
      i:/C=US/O=Google Trust Services LLC/CN=GTS CA 1D4

      از مخزن اعتماد «پردازشگر پیام» (کارخواه):

      "subject": "CN=mocktarget.apigee.net",
      "issuer": "CN=GTS CA 1D4, O=Google Trust Services LLC, C=US",

      گواهینامه برگ ذخیره‌شده در مخزن اعتماد با گواهینامه سرور پشتیبان مطابقت داشته باشد.

    2. گواهینامه واسط:

      از سرور زیرینه:

      s:/C=US/O=Google Trust Services LLC/CN=GTS CA 1D4
      i:/C=US/O=Google Trust Services LLC/CN=GTS Root R1

      از مخزن اعتماد «پردازشگر پیام» (کارخواه):

      "subject" : "CN=GTS CA 1D4, O=Google Trust Services LLC, C=US",
      "issuer" : "CN=GTS Root R1, O=Google Trust Services LLC, C=US",

      گواهینامه واسط ذخیره‌شده در truststore با گواهینامه سرور پشتیبان مطابقت داشته باشد.

    3. گواهینامه ریشه:

      از سرور زیرینه:

      s:/C=US/O=Google Trust Services LLC/CN=GTS Root R1
      i:/C=US/O=Google Trust Services LLC/CN=GTS Root R1

      گواهینامه ریشه به‌طور کامل در truststore «پردازشگر پیام» وجود ندارد.

    4. ازآنجایی‌که گواهینامه ریشه در truststore وجود ندارد، «پردازشگر پیام» استثنای زیر را ایجاد می‌کند:

      sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

      و 503 Service Unavailable را با کد خطای messaging.adaptors.http.flow.SslHandshakeFailed به برنامه‌های کاربر برمی‌گرداند.

وضوح

  1. مطمئن شوید که زنجیره گواهینامه کامل و مناسب سرور نهایی را دارید.
  2. اگر کاربر «ابر عمومی» هستید، دستورالعمل‌های به‌روزرسانی گواهینامه TLS برای «ابر» را دنبال کنید تا گواهینامه را در «انبار اعتماد پردازشگر پیام» Apigee Edge به‌روزرسانی کنید.
  3. اگر کاربر «ابر خصوصی» هستید، دستورالعمل‌های به‌روزرسانی گواهینامه «امنیت لایه انتقال» برای «ابر خصوصی» را برای به‌روزرسانی گواهینامه در «انبار اعتماد پردازشگر پیام» Apigee Edge دنبال کنید.

دلیل: عدم تطابق نام کاملاً واجدشرایط در گواهینامه سرور زیرینه و نام میزبان در نقطه پایان هدف

اگر سرور زیرینه زنجیره گواهینامه‌ای ارائه دهد که حاوی FQDN باشد و با نام میزبان مشخص‌شده در نقطه پایانی هدف مطابقت نداشته باشد، «پردازش پیام» Apigee Edge خطای SSL Handshake failed sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target را برمی‌گرداند.

تشخیص

  1. نقطه پایانی هدف خاص را در پراکسی «میانای برنامه‌سازی کاربردی» که در آن این خطا را مشاهده می‌کنید بررسی کنید و نام میزبان سرور زیرینه را یادداشت کنید:

    نمونه TargetEndpoint:

    <TargetEndpoint name="default">
       …
       <HTTPTargetConnection>
          <Properties />
          <SSLInfo>
             <Enabled>true</Enabled>
             <TrustStore>ref://myTrustStoreRef</TrustStore>
          </SSLInfo>
          <URL>https://backend.company.com/resource</URL>
       </HTTPTargetConnection>
    </TargetEndpoint>

    در مثال بالا، نام میزبان سرور زیرینه backend.company.com است.

  2. بااستفاده از فرمان openssl همان‌طور که در زیر نشان داده شده است، FQDN را در گواهی سرور پشتیبان تعیین کنید:

    openssl s_client -connect BACKEND_SERVER_HOST_NAME>:PORT_#>
    

    برای مثال:

    openssl s_client -connect backend.company.com:443
    

    بخش Certificate chain را بررسی کنید و نام دامنه کاملاً واجدشرایط مشخص‌شده به‌عنوان بخشی از CN در موضوع گواهینامه برگ را یادداشت کنید.

    Certificate chain
     0 s:/CN=backend.apigee.net
       i:/C=US/O=Google Trust Services LLC/CN=GTS CA 1D4
     1 s:/C=US/O=Google Trust Services LLC/CN=GTS CA 1D4
       i:/C=US/O=Google Trust Services LLC/CN=GTS Root R1
     2 s:/C=US/O=Google Trust Services LLC/CN=GTS Root R1
       i:/C=US/O=Google Trust Services LLC/CN=GTS Root R1
    

    در مثال بالا، نام کامل دامنه سرور پشتیبان backend.apigee.net است.

  3. اگر نام میزبان سرور زیرینه که از مرحله ۱ به‌دست آمده است با FQDN که از مرحله ۲ به‌دست آمده است مطابقت نداشته باشد، این دلیل خطا است.
  4. در مثال بالا، نام میزبان در نقطه پایانی هدف backend.company.com است. بااین‌حال، نام FQDN در گواهینامه سرور زیرینه backend.apigee.net است. چون مطابقت ندارند، این خطا را دریافت می‌کنید.

وضوح

بااستفاده از یکی از روش‌های زیر می‌توانید این مشکل را برطرف کنید:

نام دامنه کاملاً واجدشرایط درست

انبار کلید سرور زیرینه را با نام دامنه کاملاً واجدشرایط صحیح و زنجیره گواهینامه معتبر و کامل به‌روز کنید:

  1. اگر گواهینامه سرور زیرینه با نام کامل دامنه صحیح ندارید، گواهینامه مناسب را از «مرکز صدور گواهی» (CA) مناسب تهیه کنید.
  2. تأیید کنید که زنجیره گواهینامه سرور نهایی معتبر و کامل دارید.

  3. وقتی زنجیره گواهینامه معتبر و کامل را با نام دامنه کاملاً واجدشرایط صحیح سرور پشتیبان در گواهینامه برگ یا نهاد که با نام میزبان مشخص‌شده در نقطه پایانی هدف یکسان است دریافت کردید، انبار کلید پشتیبان را با زنجیره گواهینامه کامل به‌روز کنید.

سرور زیرینه صحیح

نقطه پایان هدف را با نام میزبان صحیح سرور زیرینه به‌روز کنید:

  1. اگر نام میزبان در نقطه پایانی هدف به‌اشتباه مشخص شده است، نقطه پایانی هدف را به‌روزرسانی کنید تا نام میزبان صحیح داشته باشد که با نام کاملاً واجدشرایط در گواهینامه سرور پشتیبان مطابقت داشته باشد.
  2. تغییرات را در پراکسی API ذخیره کنید.

    در مثال بالا، اگر نام میزبان سرور پشتیبان به‌اشتباه مشخص شده باشد، می‌توانید آن را بااستفاده از نام کاملاً واجدشرایط گواهینامه سرور پشتیبان، یعنی backend.apigee.net، به‌صورت زیر اصلاح کنید:

    <TargetEndpoint name="default">
       …
       <HTTPTargetConnection>
          <Properties />
          <SSLInfo>
             <Enabled>true</Enabled>
             <TrustStore>ref://myTrustStoreRef</TrustStore>
          </SSLInfo>
          <URL>https://backend.apigee.net/resource</URL>
       </HTTPTargetConnection>
    </TargetEndpoint>

علت: گواهینامه یا زنجیره گواهینامه نادرست/ناقص ارائه‌شده توسط سرور زیرینه

تشخیص

  1. زنجیره گواهینامه سرور زیرینه را با اجرای فرمان openssl دربرابر نام میزبان سرور زیرینه به روش زیر دریافت کنید:
    openssl s_client -connect BACKEND_SERVER_HOST_NAME:PORT_#
    

    Certificate chain را از برونداد دستور بالا یادداشت کنید.

    نمونه زنجیره گواهینامه سرور زیرینه از برونداد فرمان openssl:

    Certificate chain
     0 s:/CN=mocktarget.apigee.net
       i:/C=US/O=Google Trust Services LLC/CN=GTS CA 1D4
     1 s:/C=US/O=Google Trust Services LLC/CN=GTS CA 1D4
       i:/C=US/O=Google Trust Services LLC/CN=GTS Root R1
       
  2. مطمئن شوید که زنجیره گواهینامه صحیح و کامل را دارید، همان‌طور که در اعتبارسنجی زنجیره گواهینامه توضیح داده شده است.
  3. اگر زنجیره گواهینامه معتبر و کاملی برای سرور زیرینه ندارید، این دلیل بروز این مشکل است.

    در زنجیره گواهینامه سرور زیرینه نمونه که در بالا نشان داده شده است، گواهینامه ریشه وجود ندارد. بنابراین، این خطا را دریافت می‌کنید.

وضوح

انبار کلید سرور زیرینه را با زنجیره گواهینامه معتبر و کامل به‌روز کنید:

  1. تأیید کنید که زنجیره گواهینامه سرور نهایی معتبر و کامل دارید.

  2. زنجیره گواهینامه معتبر و کامل را در انبار کلید سرور زیرینه به‌روز کنید.

اگر مشکل همچنان ادامه داشت، به باید اطلاعات تشخیصی را جمع‌آوری کنید بروید.

باید اطلاعات تشخیص خرابی را جمع‌آوری کند

اگر مشکل حتی پس‌از دنبال کردن دستورالعمل‌های بالا برطرف نشد، اطلاعات تشخیص سلامت زیر را جمع‌آوری کنید و با پشتیبانی Apigee Edge تماس بگیرید:

مرجع‌ها