503 পরিষেবা উপলভ্য নেই - SSL হ্যান্ডশেক ব্যর্থ হয়েছে

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন।
তথ্য

সমস্যার উপসর্গ

ক্লায়েন্ট অ্যাপ্লিকেশন, API কলের উত্তর হিসেবে 503 Service Unavailable HTTP স্ট্যাটাস কোড এবং messaging.adaptors.http.flow.SslHandshakeFailed সমস্যার কোড পায়।

সমস্যা সংক্রান্ত মেসেজ

ক্লায়েন্ট অ্যাপ্লিকেশন নিম্নলিখিত রেসপন্স কোড পায়:

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

সম্ভাব্য কারণ

SSL হ্যান্ডশেক প্রসেস চলাকালীন Apigee Edge-এর মেসেজ প্রসেসর ও ব্যাকএন্ড সার্ভারের মধ্যে সমস্যা হওয়ার কারণে আপনি 503 Service Unavailable স্ট্যাটাস কোড সহ messaging.adaptors.http.flow.SslHandshakeFailed সমস্যার কোড পেতে পারেন। এর পিছনে একাধিক কারণ থাকতে পারে। সমস্যার মেসেজটি 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-এ এই সমস্যার মেসেজ দেখতে পান, তাহলে কীভাবে এই সমস্যার সমাধান করবেন তা এই প্লেবুকে ব্যাখ্যা করা হয়েছে।

Apigee Edge-এর মেসেজ প্রসেসর ও ব্যাকএন্ড সার্ভারের মধ্যে SSL হ্যান্ডশেক প্রসেস চলাকালীন এই সমস্যা হয়:

  • Apigee Edge-এর মেসেজ প্রসেসরের truststore:
    • এমন সার্টিফিকেট চেইন আছে যা ব্যাকএন্ড সার্ভারের সম্পূর্ণ সার্টিফিকেট চেইনের সাথে মেলে না, অথবা
    • ব্যাকএন্ড সার্ভারের সম্পূর্ণ সার্টিফিকেট চেইন নেই
  • ব্যাকএন্ড সার্ভারের দেখানো সার্টিফিকেট চেনে:

এই সমস্যার সম্ভাব্য কারণগুলি নিচে উল্লেখ করা হল:

কারণ বিবরণ এর জন্য প্রযোজ্য সমস্যার সমাধান সংক্রান্ত নির্দেশাবলী
মেসেজ প্রসেসরের ট্রাস্টস্টোরে ভুল/অসম্পূর্ণ সার্টিফিকেট বা সার্টিফিকেট চেইন Apigee Edge-এর মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট এবং/অথবা এর চেনের সাথে ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেন মিলছে না অথবা এতে ব্যাকএন্ড সার্ভারের সম্পূর্ণ সার্টিফিকেট চেন নেই। Edge প্রাইভেট ও পাবলিক ক্লাউড ব্যবহারকারী
ব্যাকএন্ড সার্ভারের সার্টিফিকেটে থাকা FQDN এবং টার্গেট এন্ডপয়েন্টে থাকা হোস্ট নামের মধ্যে মিল নেই ব্যাকএন্ড সার্ভারের দেওয়া সার্টিফিকেটে এমন FQDN আছে যা টার্গেট এন্ডপয়েন্টে উল্লেখ করা হোস্ট নামের সাথে মেলে না। Edge প্রাইভেট ও পাবলিক ক্লাউড ব্যবহারকারী
ব্যাকএন্ড সার্ভারের দেখানো সার্টিফিকেট বা সার্টিফিকেট চেন ভুল/অসম্পূর্ণ ব্যাকএন্ড সার্ভারের দেখানো সার্টিফিকেট চেনে কোনও ভুল আছে অথবা সেটি অসম্পূর্ণ। Edge প্রাইভেট ও পাবলিক ক্লাউড ব্যবহারকারী

সাধারণ ডায়াগনসিস ধাপ

এই সমস্যা ডায়াগনসিস করতে নিম্নলিখিত টুল/টেকনিকের মধ্যে একটি ব্যবহার করুন:

API মনিটরিং

পদ্ধতি #১: API মনিটরিং ব্যবহার করা

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

ট্রেস

পদ্ধতি #২: ট্রেস টুল ব্যবহার করা

Trace টুল ব্যবহার করে সমস্যার ডায়াগনসিস করতে:

  1. ট্রেস সেশন চালু করুন এবং এগুলির মধ্যে একটি বেছে নিন:
    • সমস্যার কোড সহ 503 Service Unavailable সমস্যার জন্য অপেক্ষা করুন messaging.adaptors.http.flow.SslHandshakeFailed অথবা
    • আপনি যদি সমস্যাটি আবার তৈরি করতে পারেন, তাহলে সমস্যাটি আবার তৈরি করতে API কল করুন 503 Service Unavailable
  2. সব FlowInfo দেখুন বিকল্প চালু আছে কিনা দেখুন:

  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. আপনি প্রাইভেট ক্লাউড ব্যবহারকারী হলে, HTTP 503 Service Unavailable সম্পর্কে মূল তথ্য নির্ধারণ করতে NGINX অ্যাক্সেস লগ ব্যবহার করতে পারবেন।
  2. NGINX অ্যাক্সেস লগ চেক করুন:

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

  3. নির্দিষ্ট সময়সীমার মধ্যে 503 error code messaging.adaptors.http.flow.SslHandshakeFailed সহ কোনও সমস্যা হয়েছে কিনা তা সার্চ করে দেখুন (যদি সমস্যাটি অতীতে হয়ে থাকে) অথবা 503 সহ কোনও অনুরোধ এখনও ব্যর্থ হচ্ছে কিনা তা দেখুন।
  4. X-Apigee-fault-code-এর সাথে messaging.adaptors.http.flow.SslHandshakeFailed-এর ভ্যালু ম্যাচ করালে যদি কোনও 503 সমস্যা দেখতে পান, তাহলে X-Apigee-fault-source-এর ভ্যালু নির্ধারণ করুন।

    NGINX অ্যাক্সেস লগ থেকে 503 সমস্যার নমুনা:

    ( আরও বড় ছবি দেখুন)

    NGINX অ্যাক্সেস লগ থেকে নেওয়া উপরের নমুনা এন্ট্রিতে X-Apigee-fault-code ও X-Apigee-fault-source-এর জন্য নিম্নলিখিত ভ্যালু আছে:

    হেডার ভ্যালু
    X-Apigee-fault-code messaging.adaptors.http.flow.SslHandshakeFailed
    X-Apigee-fault-source target

মেসেজ প্রসেসর লগ

পদ্ধতি #৪: মেসেজ প্রসেসর লগ ব্যবহার করা

  1. API মনিটরিং, ট্রেস টুল, অথবা NGINX অ্যাক্সেস লগ ব্যবহার করে ব্যর্থ হওয়া অনুরোধগুলির মধ্যে একটির মেসেজ আইডি নির্ধারণ করুন, যা সাধারণ ডায়াগনসিস ধাপ-এ ব্যাখ্যা করা হয়েছে।
  2. Message Processor log-এ নির্দিষ্ট অনুরোধ মেসেজ আইডি সার্চ করুন (/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 মনিটরিং, ট্রেস টুল বা NGINX অ্যাক্সেস লগ ব্যবহার করে দেখা সমস্যার জন্য সমস্যার কোড, সমস্যার সোর্স নির্ধারণ করুন, যা সাধারণ ডায়াগনসিস ধাপ-এ ব্যাখ্যা করা হয়েছে।
  2. ফল্ট কোড messaging.adaptors.http.flow.SslHandshakeFailed হলে, নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করে সমস্যার মেসেজ নির্ধারণ করুন:
  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. ফেজ ২: মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট চেনের সাথে তুলনা করুন

ফেজ ১

ফেজ ১: ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেনের ব্যাপারে নিশ্চিত হওয়া

ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেইন নির্ধারণ করতে নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করুন:

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. TCP/IP প্যাকেট ক্যাপচার করতে নিম্নলিখিত tcpdump কমান্ড ব্যবহার করুন:

    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 সহ একটি রুট সার্টিফিকেট পাঠিয়েছে।

    আপনি যদি নিশ্চিত হন যে সার্ভারের সার্টিফিকেশন যাচাইকরণ ব্যর্থ হয়েছে, তাহলে ফেজ ২: ব্যাকএন্ড সার্ভারের সার্টিফিকেট এবং মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট তুলনা করুন।

পর্যায় ২

ফেজ ২: ব্যাকএন্ড সার্ভারের সার্টিফিকেট এবং মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট তুলনা করুন

  1. ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেনের ব্যাপারে নিশ্চিত হন।
  2. নিম্নলিখিত ধাপগুলি ব্যবহার করে মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট নির্ধারণ করুন:
    1. TargetEndpoint-এর SSLInfo বিভাগে TrustStore এলিমেন্ট থেকে ট্রাস্টস্টোর রেফারেন্স নাম পান।

      TargetEndpoint কনফিগারেশনের মধ্যে একটি Sample SSLInfo বিভাগ দেখা যাক:

      <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 UI-তে, এনভায়রনমেন্ট > রেফারেন্স বিকল্প বেছে নিন। নির্দিষ্ট ট্রাস্টস্টোর রেফারেন্সের জন্য রেফারেন্স কলামে নাম নোট করুন। এটি আপনার ট্রাস্টস্টোরের নাম হবে।

      ( আরও বড় ছবি দেখুন)

    4. উপরের উদাহরণে ট্রাস্টস্টোরের নাম হল:

      myCompanyTruststoreRef: myCompanyTruststore

  3. নিম্নলিখিত API ব্যবহার করে ট্রাস্টস্টোরে (আগের ধাপে নির্ধারিত) সেভ করা সার্টিফিকেট পান:

    1. কীস্টোর বা ট্রাস্টস্টোরের জন্য সব সার্টিফিকেট পান। এই API নির্দিষ্ট ট্রাস্টস্টোরে থাকা সব সার্টিফিকেট তালিকাভুক্ত করে।

      পাবলিক ক্লাউড ব্যবহারকারী:

      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. কীস্টোর বা ট্রাস্টস্টোর থেকে নির্দিষ্ট সার্টিফিকেটের বিবরণ পান। এই API নির্দিষ্ট ট্রাস্টস্টোরে থাকা নির্দিষ্ট সার্টিফিকেট সম্পর্কে তথ্য রিটার্ন করে।

      পাবলিক ক্লাউড ব্যবহারকারী:

      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. যাচাই করে দেখুন যে ধাপ ১-এ প্রাপ্ত আসল সার্ভার সার্টিফিকেট এবং ধাপ ৩-এ প্রাপ্ত ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট একই। সেগুলি না মিললে, সেটিই হল সমস্যার কারণ।

    উপরে দেখানো উদাহরণ থেকে, আসুন আমরা একটি করে সার্টিফিকেট দেখি:

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

      ট্রাস্টস্টোরে সেভ করা অন্তর্বর্তী সার্টিফিকেট ব্যাকএন্ড সার্ভারের সাথে ম্যাচ করে।

    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

      মেসেজ প্রসেসরের ট্রাস্টস্টোরে মূল সার্টিফিকেট সম্পূর্ণভাবে অনুপস্থিত।

    4. ট্রাস্টস্টোরে রুট সার্টিফিকেট না থাকার কারণে, মেসেজ প্রসেসর নিম্নলিখিত ব্যতিক্রম দেখায়:

      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. আপনি পাবলিক ক্লাউড ব্যবহারকারী হলে, Apigee Edge-এর মেসেজ প্রসেসর ট্রাস্টস্টোরে সার্টিফিকেট আপডেট করতে ক্লাউডের জন্য TLS সার্টিফিকেট আপডেট করুন লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করুন।
  3. আপনি প্রাইভেট ক্লাউড ব্যবহারকারী হলে, প্রাইভেট ক্লাউডের জন্য TLS সার্টিফিকেট আপডেট করুন লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করে Apigee Edge-এর মেসেজ প্রসেসর ট্রাস্টস্টোরে সার্টিফিকেট আপডেট করুন।

কারণ: ব্যাকএন্ড সার্ভারের সার্টিফিকেটে থাকা FQDN এবং টার্গেট এন্ডপয়েন্টে থাকা হোস্ট নামের মধ্যে মিল নেই

ব্যাকএন্ড সার্ভার যদি এমন একটি সার্টিফিকেট চেইন উপস্থাপন করে যাতে 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. API প্রক্সির নির্দিষ্ট টার্গেট এন্ডপয়েন্ট পরীক্ষা করে দেখুন যেখানে আপনি এই সমস্যাটি দেখতে পাচ্ছেন এবং ব্যাকএন্ড সার্ভারের হোস্ট নেম নোট করুন:

    Sample 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-এর অংশ হিসেবে নির্দিষ্ট করা FQDN নোট করুন।

    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
    

    উপরের উদাহরণে, ব্যাকএন্ড সার্ভারের FQDN হল backend.apigee.net।

  3. ধাপ ১ থেকে পাওয়া ব্যাকএন্ড সার্ভারের হোস্ট নেম এবং ধাপ ২ থেকে পাওয়া FQDN না মিললে, এটিই হল সমস্যার কারণ।
  4. উপরে আলোচনা করা উদাহরণে, টার্গেট এন্ডপয়েন্টে হোস্টনেম হল backend.company.com. তবে, ব্যাকএন্ড সার্ভারের সার্টিফিকেটে FQDN নাম হল backend.apigee.net। যেহেতু সেগুলি মিলছে না, তাই আপনি এই সমস্যাটি পেয়েছেন।

রেজোলিউশন

আপনি নিম্নলিখিত পদ্ধতির মধ্যে একটি ব্যবহার করে এই সমস্যার সমাধান করতে পারবেন:

সঠিক FQDN

সঠিক FQDN, বৈধ ও সম্পূর্ণ সার্টিফিকেট চেন দিয়ে ব্যাকএন্ড সার্ভারের কীস্টোর আপডেট করুন:

  1. আপনার কাছে সঠিক FQDN সহ কোনও ব্যাকএন্ড সার্ভারের সার্টিফিকেট না থাকলে, উপযুক্ত CA (সার্টিফিকেট অথরিটি) থেকে সঠিক সার্টিফিকেট সংগ্রহ করুন।
  2. আপনার কাছে বৈধ ও সম্পূর্ণ ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেইন আছে কিনা তা যাচাই করুন।

  3. লিফ বা এন্টিটি সার্টিফিকেটে ব্যাকএন্ড সার্ভারের সঠিক FQDN সহ বৈধ ও সম্পূর্ণ সার্টিফিকেট চেইন থাকলে, যা টার্গেট এন্ডপয়েন্টে উল্লেখ করা হোস্ট নামের সাথে একই রকম, সম্পূর্ণ সার্টিফিকেট চেইন সহ ব্যাকএন্ডের কীস্টোর আপডেট করুন।

সঠিক ব্যাকএন্ড সার্ভার

সঠিক ব্যাকএন্ড সার্ভারের হোস্ট নামের মাধ্যমে টার্গেট এন্ডপয়েন্ট আপডেট করুন:

  1. টার্গেট এন্ডপয়েন্টে হোস্টের নাম ভুলভাবে উল্লেখ করা হলে, ব্যাকএন্ড সার্ভারের সার্টিফিকেটে থাকা FQDN-এর সাথে মেলে এমন সঠিক হোস্টের নাম পেতে টার্গেট এন্ডপয়েন্ট আপডেট করুন।
  2. API প্রক্সিতে করা পরিবর্তন সেভ করুন।

    উপরে আলোচনা করা উদাহরণে, ব্যাকএন্ড সার্ভার হোস্টের নাম ভুলভাবে নির্দিষ্ট করা থাকলে, ব্যাকএন্ড সার্ভারের সার্টিফিকেটে থাকা FQDN ব্যবহার করে আপনি এটি ঠিক করতে পারবেন, অর্থাৎ 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 সহায়তা টিমের সাথে যোগাযোগ করুন:

  • আপনি পাবলিক ক্লাউড ব্যবহারকারী হলে, নিম্নলিখিত তথ্য দিন:
    • সংস্থার নাম
    • পরিবেশের নাম
    • API প্রক্সির নাম
    • সমস্যাটি আবার তৈরি করতে curl কমান্ড সম্পূর্ণ করুন
    • সমস্যাটি দেখানো ট্রেস ফাইল
    • openssl কমান্ডের আউটপুট:

      openssl s_client -connect BACKEND_SERVER_HOST_NAME:PORT_#

    • ব্যাকএন্ড সার্ভারে ক্যাপচার করা TCP/IP প্যাকেট
  • আপনি প্রাইভেট ক্লাউড ব্যবহারকারী হলে, নিম্নলিখিত তথ্য দিন:

রেফারেন্স