আপনি 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:
- এমন সার্টিফিকেট চেইন আছে যা ব্যাকএন্ড সার্ভারের সম্পূর্ণ সার্টিফিকেট চেইনের সাথে মেলে না, অথবা
- ব্যাকএন্ড সার্ভারের সম্পূর্ণ সার্টিফিকেট চেইন নেই
- ব্যাকএন্ড সার্ভারের দেখানো সার্টিফিকেট চেনে:
- এতে সম্পূর্ণভাবে উপযুক্ত ডোমেনের নাম (FQDN) আছে যা টার্গেট এন্ডপয়েন্টে উল্লেখ করা হোস্ট নামের সাথে মেলে না
- ভুল বা অসম্পূর্ণ সার্টিফিকেট চেইন রয়েছে
এই সমস্যার সম্ভাব্য কারণগুলি নিচে উল্লেখ করা হল:
| কারণ | বিবরণ | এর জন্য প্রযোজ্য সমস্যার সমাধান সংক্রান্ত নির্দেশাবলী |
|---|---|---|
| মেসেজ প্রসেসরের ট্রাস্টস্টোরে ভুল/অসম্পূর্ণ সার্টিফিকেট বা সার্টিফিকেট চেইন | Apigee Edge-এর মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট এবং/অথবা এর চেনের সাথে ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেন মিলছে না অথবা এতে ব্যাকএন্ড সার্ভারের সম্পূর্ণ সার্টিফিকেট চেন নেই। | Edge প্রাইভেট ও পাবলিক ক্লাউড ব্যবহারকারী |
| ব্যাকএন্ড সার্ভারের সার্টিফিকেটে থাকা FQDN এবং টার্গেট এন্ডপয়েন্টে থাকা হোস্ট নামের মধ্যে মিল নেই | ব্যাকএন্ড সার্ভারের দেওয়া সার্টিফিকেটে এমন FQDN আছে যা টার্গেট এন্ডপয়েন্টে উল্লেখ করা হোস্ট নামের সাথে মেলে না। | Edge প্রাইভেট ও পাবলিক ক্লাউড ব্যবহারকারী |
| ব্যাকএন্ড সার্ভারের দেখানো সার্টিফিকেট বা সার্টিফিকেট চেন ভুল/অসম্পূর্ণ | ব্যাকএন্ড সার্ভারের দেখানো সার্টিফিকেট চেনে কোনও ভুল আছে অথবা সেটি অসম্পূর্ণ। | Edge প্রাইভেট ও পাবলিক ক্লাউড ব্যবহারকারী |
সাধারণ ডায়াগনসিস ধাপ
এই সমস্যা ডায়াগনসিস করতে নিম্নলিখিত টুল/টেকনিকের মধ্যে একটি ব্যবহার করুন:
API মনিটরিং
পদ্ধতি #১: API মনিটরিং ব্যবহার করা
API মনিটরিং ব্যবহার করে সমস্যার ডায়াগনসিস করতে:
- Apigee Edge UI-তে সাইন-ইন করুন উপযুক্ত ভূমিকা সহ ব্যবহারকারী হিসেবে।
যে প্রতিষ্ঠানে সমস্যাটি তদন্ত করতে চান সেটিতে পরিবর্তন করুন।
- বিশ্লেষণ করুন > API মনিটরিং > তদন্ত করুন পৃষ্ঠায় নেভিগেট করুন।
- আপনি যে নির্দিষ্ট সময়সীমার মধ্যে সমস্যাটি লক্ষ্য করেছেন সেটি বেছে নিন।
সময় অনুযায়ী সমস্যার কোড প্লট করুন।
এমন একটি সেল বেছে নিন যেখানে ফল্ট কোড
messaging.adaptors.http.flow.SslHandshakeFailedদেখানো হয়েছে নিচে:
সমস্যার কোড সম্পর্কে তথ্য
messaging.adaptors.http.flow.SslHandshakeFailedএইভাবে দেখানো হয় নিচে দেখানো হল:
লগ দেখুন বিকল্পে ক্লিক করুন এবং ব্যর্থ অনুরোধের সারিটি বড় করে দেখুন।
- লগ উইন্ডো থেকে, নিম্নলিখিত বিবরণগুলি নোট করুন:
- অনুরোধ মেসেজ আইডি
- স্ট্যাটাস কোড:
503 - সমস্যার সোর্স:
target - সমস্যার কোড:
messaging.adaptors.http.flow.SslHandshakeFailed
ট্রেস
পদ্ধতি #২: ট্রেস টুল ব্যবহার করা
Trace টুল ব্যবহার করে সমস্যার ডায়াগনসিস করতে:
- ট্রেস সেশন চালু করুন এবং এগুলির মধ্যে একটি বেছে নিন:
- সমস্যার কোড
সহ
503 Service Unavailableসমস্যার জন্য অপেক্ষা করুনmessaging.adaptors.http.flow.SslHandshakeFailedঅথবা - আপনি যদি সমস্যাটি আবার তৈরি করতে পারেন, তাহলে সমস্যাটি আবার তৈরি করতে API কল করুন
503 Service Unavailable
- সমস্যার কোড
সহ
সব FlowInfo দেখুন বিকল্প চালু আছে কিনা দেখুন:

- কাজ না করা অনুরোধগুলির মধ্যে একটি বেছে নিন এবং ট্রেস পরীক্ষা করুন।
- ট্রেসের বিভিন্ন ফেজ নেভিগেট করুন এবং কোথায় সমস্যা হয়েছে তা খুঁজে বের করুন।
আপনি সাধারণত টার্গেট অনুরোধ ফ্লো শুরু হয়েছে ফেজের পরে সমস্যাটি দেখতে পাবেন, যেমন নিচে দেখানো হয়েছে:

- ট্রেস থেকে নিম্নলিখিত ভ্যালুগুলি নোট করুন:
- সমস্যা:
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-এর মেসেজ প্রসেসর ব্যাকএন্ড সার্ভারের সার্টিফিকেট যাচাই করতে পারেনি।
- সমস্যা:
- ট্রেসে AX (Analytics ডেটা রেকর্ড করা হয়েছে) ফেজে নেভিগেট করে সেটিতে ক্লিক করুন।
নিচের দিকে স্ক্রল করে ফেজ সংক্রান্ত সমস্যার বিবরণী হেডার বিভাগে যান এবং X-Apigee-fault-code ও X-Apigee-fault-source এবং X-Apigee-Message-ID-এর ভ্যালু নির্ধারণ করুন, যেমন নিচে দেখানো হয়েছে:

- X-Apigee-fault-code, X-Apigee-fault-source, এবং X-Apigee-Message-ID-এর ভ্যালু নোট করুন:
| সমস্যার হেডার | ভ্যালু |
|---|---|
| X-Apigee-fault-code | messaging.adaptors.http.flow.SslHandshakeFailed |
| X-Apigee-fault-source | target |
| X-Apigee-Message-ID | MESSAGE_ID |
NGINX
পদ্ধতি #৩: NGINX অ্যাক্সেস লগ ব্যবহার করা
NGINX অ্যাক্সেস লগ ব্যবহার করে সমস্যার ডায়াগনসিস করতে:
- আপনি প্রাইভেট ক্লাউড ব্যবহারকারী হলে, HTTP
503 Service Unavailableসম্পর্কে মূল তথ্য নির্ধারণ করতে NGINX অ্যাক্সেস লগ ব্যবহার করতে পারবেন। NGINX অ্যাক্সেস লগ চেক করুন:
/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log- নির্দিষ্ট সময়সীমার মধ্যে
503error codemessaging.adaptors.http.flow.SslHandshakeFailedসহ কোনও সমস্যা হয়েছে কিনা তা সার্চ করে দেখুন (যদি সমস্যাটি অতীতে হয়ে থাকে) অথবা503সহ কোনও অনুরোধ এখনও ব্যর্থ হচ্ছে কিনা তা দেখুন। 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.SslHandshakeFailedX-Apigee-fault-source target
মেসেজ প্রসেসর লগ
পদ্ধতি #৪: মেসেজ প্রসেসর লগ ব্যবহার করা
- API মনিটরিং, ট্রেস টুল, অথবা NGINX অ্যাক্সেস লগ ব্যবহার করে ব্যর্থ হওয়া অনুরোধগুলির মধ্যে একটির মেসেজ আইডি নির্ধারণ করুন, যা সাধারণ ডায়াগনসিস ধাপ-এ ব্যাখ্যা করা হয়েছে।
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-1NIOThread@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-1NIOThread@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 targetat 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-এর মেসেজ প্রসেসর ব্যাকএন্ড সার্ভারের সার্টিফিকেট যাচাই করতে পারেনি।
কারণ: মেসেজ প্রসেসরের ট্রাস্টস্টোরে ভুল/অসম্পূর্ণ সার্টিফিকেট বা সার্টিফিকেট চেইন
ডায়াগনসিস
- API মনিটরিং, ট্রেস টুল বা NGINX অ্যাক্সেস লগ ব্যবহার করে দেখা সমস্যার জন্য সমস্যার কোড, সমস্যার সোর্স নির্ধারণ করুন, যা সাধারণ ডায়াগনসিস ধাপ-এ ব্যাখ্যা করা হয়েছে।
- ফল্ট কোড
messaging.adaptors.http.flow.SslHandshakeFailedহলে, নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করে সমস্যার মেসেজ নির্ধারণ করুন: - Trace টুলের সাহায্যে error.cause খুঁজে বের করুন, এটি সমস্যার সমাধান সংক্রান্ত সাধারণ ধাপ অংশে ব্যাখ্যা করা হয়েছে
- মেসেজ প্রসেসর লগ ব্যবহার করে ব্যতিক্রম খুঁজে বের করুন, যা সাধারণ ডায়াগনসিস ধাপ-এ ব্যাখ্যা করা হয়েছে
- আপনার API কলের সমস্যার উত্তরে
faultstringখুঁজে দেখুন, যেমন সমস্যার মেসেজে দেখা যায় - সমস্যার মেসেজ
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-এর মেসেজ প্রসেসর ব্যাকএন্ড সার্ভারের সার্টিফিকেট যাচাই করতে পারেনি।
আপনি দুটি ধাপে এই সমস্যার সমাধান করতে পারবেন:
- ফেজ ১: ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেনের ব্যাপারে নিশ্চিত হওয়া
- ফেজ ২: মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট চেনের সাথে তুলনা করুন
ফেজ ১
ফেজ ১: ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেনের ব্যাপারে নিশ্চিত হওয়া
ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেইন নির্ধারণ করতে নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করুন:
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
- আপনি পাবলিক ক্লাউড ব্যবহারকারী হলে, ব্যাকএন্ড সার্ভারে TCP/IP প্যাকেট ক্যাপচার করুন।
- আপনি প্রাইভেট ক্লাউড ব্যবহারকারী হলে, ব্যাকএন্ড সার্ভার বা মেসেজ প্রসেসরে TCP/IP প্যাকেট ক্যাপচার করতে পারবেন। পছন্দমতো, ব্যাকএন্ড সার্ভারে সেগুলি ক্যাপচার করুন, কারণ ব্যাকএন্ড সার্ভারে প্যাকেটগুলি ডিক্রিপ্ট করা হয়।
TCP/IP প্যাকেট ক্যাপচার করতে নিম্নলিখিত tcpdump কমান্ড ব্যবহার করুন:
tcpdump -i any -s 0 host IP_ADDRESS -w FILE_NAME
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সহ একটি রুট সার্টিফিকেট পাঠিয়েছে।
আপনি যদি নিশ্চিত হন যে সার্ভারের সার্টিফিকেশন যাচাইকরণ ব্যর্থ হয়েছে, তাহলে ফেজ ২: ব্যাকএন্ড সার্ভারের সার্টিফিকেট এবং মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট তুলনা করুন।
- প্যাকেট #৪৩: মেসেজ প্রসেসর (সোর্স) ব্যাকএন্ড সার্ভারে (ডেস্টিনেশন) একটি
পর্যায় ২
ফেজ ২: ব্যাকএন্ড সার্ভারের সার্টিফিকেট এবং মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট তুলনা করুন
- ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেনের ব্যাপারে নিশ্চিত হন।
- নিম্নলিখিত ধাপগুলি ব্যবহার করে মেসেজ প্রসেসরের ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট নির্ধারণ করুন:
TargetEndpoint-এরSSLInfoবিভাগেTrustStoreএলিমেন্ট থেকে ট্রাস্টস্টোর রেফারেন্স নাম পান।TargetEndpointকনফিগারেশনের মধ্যে একটি SampleSSLInfoবিভাগ দেখা যাক:<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>- উপরের উদাহরণে,
TrustStoreরেফারেন্স নাম হলmyCompanyTruststoreRef। Edge UI-তে, এনভায়রনমেন্ট > রেফারেন্স বিকল্প বেছে নিন। নির্দিষ্ট ট্রাস্টস্টোর রেফারেন্সের জন্য রেফারেন্স কলামে নাম নোট করুন। এটি আপনার ট্রাস্টস্টোরের নাম হবে।
উপরের উদাহরণে ট্রাস্টস্টোরের নাম হল:
myCompanyTruststoreRef:
myCompanyTruststore
নিম্নলিখিত API ব্যবহার করে ট্রাস্টস্টোরে (আগের ধাপে নির্ধারিত) সেভ করা সার্টিফিকেট পান:
কীস্টোর বা ট্রাস্টস্টোরের জন্য সব সার্টিফিকেট পান। এই 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" ]
-
কীস্টোর বা ট্রাস্টস্টোর থেকে নির্দিষ্ট সার্টিফিকেটের বিবরণ পান।
এই 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",
যাচাই করে দেখুন যে ধাপ ১-এ প্রাপ্ত আসল সার্ভার সার্টিফিকেট এবং ধাপ ৩-এ প্রাপ্ত ট্রাস্টস্টোরে সেভ করা সার্টিফিকেট একই। সেগুলি না মিললে, সেটিই হল সমস্যার কারণ।
উপরে দেখানো উদাহরণ থেকে, আসুন আমরা একটি করে সার্টিফিকেট দেখি:
- লিফ সার্টিফিকেট:
ব্যাকএন্ড সার্ভার থেকে:
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",
ট্রাস্টস্টোরে সেভ করা লিফ সার্টিফিকেট ব্যাকএন্ড সার্ভারের সাথে ম্যাচ করে।
- অন্তর্বর্তী সার্টিফিকেট:
ব্যাকএন্ড সার্ভার থেকে:
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",
ট্রাস্টস্টোরে সেভ করা অন্তর্বর্তী সার্টিফিকেট ব্যাকএন্ড সার্ভারের সাথে ম্যাচ করে।
- মূল সার্টিফিকেট:
ব্যাকএন্ড সার্ভার থেকে:
s:/C=US/O=Google Trust Services LLC/CN=GTS Root R1 i:/C=US/O=Google Trust Services LLC/CN=GTS Root R1
মেসেজ প্রসেসরের ট্রাস্টস্টোরে মূল সার্টিফিকেট সম্পূর্ণভাবে অনুপস্থিত।
ট্রাস্টস্টোরে রুট সার্টিফিকেট না থাকার কারণে, মেসেজ প্রসেসর নিম্নলিখিত ব্যতিক্রম দেখায়:
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রিটার্ন করে।
- লিফ সার্টিফিকেট:
রেজোলিউশন
- ব্যাকএন্ড সার্ভারের সঠিক ও সম্পূর্ণ সার্টিফিকেট চেন আপনার কাছে আছে কিনা তা নিশ্চিত করুন।
- আপনি পাবলিক ক্লাউড ব্যবহারকারী হলে, Apigee Edge-এর মেসেজ প্রসেসর ট্রাস্টস্টোরে সার্টিফিকেট আপডেট করতে ক্লাউডের জন্য TLS সার্টিফিকেট আপডেট করুন লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করুন।
- আপনি প্রাইভেট ক্লাউড ব্যবহারকারী হলে, প্রাইভেট ক্লাউডের জন্য 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 এরর রিটার্ন করে।
ডায়াগনসিস
- 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। নিচে দেখানো
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.neti:/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।- ধাপ ১ থেকে পাওয়া ব্যাকএন্ড সার্ভারের হোস্ট নেম এবং ধাপ ২ থেকে পাওয়া FQDN না মিললে, এটিই হল সমস্যার কারণ।
- উপরে আলোচনা করা উদাহরণে, টার্গেট এন্ডপয়েন্টে হোস্টনেম হল
backend.company.com. তবে, ব্যাকএন্ড সার্ভারের সার্টিফিকেটে FQDN নাম হলbackend.apigee.net। যেহেতু সেগুলি মিলছে না, তাই আপনি এই সমস্যাটি পেয়েছেন।
রেজোলিউশন
আপনি নিম্নলিখিত পদ্ধতির মধ্যে একটি ব্যবহার করে এই সমস্যার সমাধান করতে পারবেন:
সঠিক FQDN
সঠিক FQDN, বৈধ ও সম্পূর্ণ সার্টিফিকেট চেন দিয়ে ব্যাকএন্ড সার্ভারের কীস্টোর আপডেট করুন:
- আপনার কাছে সঠিক FQDN সহ কোনও ব্যাকএন্ড সার্ভারের সার্টিফিকেট না থাকলে, উপযুক্ত CA (সার্টিফিকেট অথরিটি) থেকে সঠিক সার্টিফিকেট সংগ্রহ করুন।
আপনার কাছে বৈধ ও সম্পূর্ণ ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেইন আছে কিনা তা যাচাই করুন।
- লিফ বা এন্টিটি সার্টিফিকেটে ব্যাকএন্ড সার্ভারের সঠিক FQDN সহ বৈধ ও সম্পূর্ণ সার্টিফিকেট চেইন থাকলে, যা টার্গেট এন্ডপয়েন্টে উল্লেখ করা হোস্ট নামের সাথে একই রকম, সম্পূর্ণ সার্টিফিকেট চেইন সহ ব্যাকএন্ডের কীস্টোর আপডেট করুন।
সঠিক ব্যাকএন্ড সার্ভার
সঠিক ব্যাকএন্ড সার্ভারের হোস্ট নামের মাধ্যমে টার্গেট এন্ডপয়েন্ট আপডেট করুন:
- টার্গেট এন্ডপয়েন্টে হোস্টের নাম ভুলভাবে উল্লেখ করা হলে, ব্যাকএন্ড সার্ভারের সার্টিফিকেটে থাকা FQDN-এর সাথে মেলে এমন সঠিক হোস্টের নাম পেতে টার্গেট এন্ডপয়েন্ট আপডেট করুন।
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>
কারণ: ব্যাকএন্ড সার্ভার ভুল/অসম্পূর্ণ সার্টিফিকেট বা সার্টিফিকেট চেইন প্রদান করেছে
ডায়াগনসিস
- ব্যাকএন্ড সার্ভারের হোস্ট নামের বিরুদ্ধে নিম্নলিখিত
opensslকমান্ড এক্সিকিউট করে ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেইন পান:openssl s_client -connect BACKEND_SERVER_HOST_NAME:PORT_#
উপরের কমান্ডের আউটপুট থেকে
Certificate chainনোট করুন।openssl কমান্ড আউটপুট থেকে স্যাম্পেল ব্যাকএন্ড সার্ভার সার্টিফিকেট চেইন:
Certificate chain 0 s:/
CN=mocktarget.apigee.neti:/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 - সার্টিফিকেট চেইন যাচাই করা লিঙ্কে গিয়ে দেখে নিন যে আপনার কাছে সঠিক ও সম্পূর্ণ সার্টিফিকেট চেইন আছে কিনা।
ব্যাকএন্ড সার্ভারের জন্য আপনার কাছে বৈধ ও সম্পূর্ণ সার্টিফিকেট চেইন না থাকলে, সেটিই এই সমস্যার কারণ।
উপরে দেখানো নমুনা ব্যাকএন্ড সার্ভারের সার্টিফিকেট চেনে, রুট সার্টিফিকেট নেই। তাই, আপনি এই সমস্যাটি দেখতে পান।
রেজোলিউশন
সঠিক ও সম্পূর্ণ সার্টিফিকেট চেনের মাধ্যমে ব্যাকএন্ড সার্ভারের কীস্টোর আপডেট করুন:
আপনার কাছে ব্যাকএন্ড সার্ভারের বৈধ ও সম্পূর্ণ সার্টিফিকেট চেইন আছে কিনা তা যাচাই করুন।
- ব্যাকএন্ড সার্ভারের কীস্টোরে সঠিক ও সম্পূর্ণ সার্টিফিকেট চেন আপডেট করুন।
এর পরেও সমস্যা থেকে গেলে, রোগ নির্ণয় সংক্রান্ত তথ্য অবশ্যই সংগ্রহ করতে হবে বিকল্পে যান।
অবশ্যই ডায়াগনস্টিক তথ্য সংগ্রহ করতে হবে
উপরে উল্লেখ করা নির্দেশাবলী অনুসরণ করার পরেও সমস্যাটি থেকে গেলে, নিম্নলিখিত ডায়াগনস্টিক তথ্য সংগ্রহ করুন এবং Apigee Edge সহায়তা টিমের সাথে যোগাযোগ করুন:
- আপনি পাবলিক ক্লাউড ব্যবহারকারী হলে, নিম্নলিখিত তথ্য দিন:
- সংস্থার নাম
- পরিবেশের নাম
- API প্রক্সির নাম
- সমস্যাটি আবার তৈরি করতে
curlকমান্ড সম্পূর্ণ করুন - সমস্যাটি দেখানো ট্রেস ফাইল
opensslকমান্ডের আউটপুট:openssl s_client -connect BACKEND_SERVER_HOST_NAME:PORT_#- ব্যাকএন্ড সার্ভারে ক্যাপচার করা TCP/IP প্যাকেট
- আপনি প্রাইভেট ক্লাউড ব্যবহারকারী হলে, নিম্নলিখিত তথ্য দিন:
- সম্পূর্ণ সমস্যার মেসেজ দেখা গেছে
- API প্রক্সি বান্ডেল
- সমস্যাটি দেখানো ট্রেস ফাইল
- মেসেজ প্রসেসর লগ
/opt/apigee/var/log/edge-message-processor/logs/system.log opensslকমান্ডের আউটপুট:openssl s_client -connect BACKEND_SERVER_HOST_NAME:PORT_#- ব্যাকএন্ড সার্ভার বা মেসেজ প্রসেসরে ক্যাপচার করা TCP/IP প্যাকেট।
- আউটপুট কোনো কীস্টোর বা ট্রাস্টস্টোরের জন্য সব সার্টিফিকেট পান API এবং কীস্টোর বা ট্রাস্টস্টোর থেকে সার্টিফিকেটের বিবরণ পান API ব্যবহার করে পাওয়া প্রতিটি সার্টিফিকেটের বিবরণ।
রেফারেন্স
- সার্টিফিকেট চেন অফ ট্রাস্ট
- OpenSSL কমান্ড