‫۴۰۰ درخواست نامناسب - درخواست اچ‌تی‌تی‌پی ساده به درگاه اچ‌تی‌تی‌پی‌اس ارسال شد

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

نشانه

برنامه مشتری پاسخ HTTP 400 Bad Request را با پیام The plain HTTP request was sent to HTTPS port دریافت می‌کند.

پیام خطا

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

HTTP/1.1 400 Bad Request

به‌دنبال آن صفحه خطای HTML زیر نمایش داده می‌شود:

<html>
<head><title>400 The plain HTTP request was sent to HTTPS port</title></head>
<body>
<center><h1>400 Bad Request</h1></center>
<center>The plain HTTP request was sent to HTTPS port</center>
</body>
</html>

علل احتمالی

علت شرح دستورالعمل‌های عیب‌یابی برای موارد زیر قابل‌اجرا است
درخواست HTTP به میزبان مجازی پیکربندی‌شده با TLS کارخواه درخواست HTTP را به میزبان مجازی پیکربندی‌شده با TLS ارسال می‌کند کاربران «فضای ابری خصوصی و عمومی لبه‌ای»
درخواست HTTP به نقطه پایانی هدف پیکربندی‌شده با TLS درخواست HTTP به سرور زیرینه فعال‌سازی‌شده با TLS در نقطه پایان هدف ارسال شد. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»
پیکربندی سرور مقصد نادرست است سرور هدف با درگاه امن 443 پیکربندی شده است اما SSL فعال نیست. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»

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

این خطا زمانی رخ می‌دهد که مشتری سعی می‌کند به یک API در Apigee متصل شود و میزبان مجازی ذکرشده برای استفاده از SSL پیکربندی شده است و به‌جای آن درخواست HTTP دریافت می‌کند.

تشخیص

ازآنجایی‌که این مشکل در نقطه پایانی Northbound رخ می‌دهد و درخواست‌های «میانای برنامه‌سازی کاربردی» در نقطه ورودی تعامل بین برنامه کارخواه و «مسیریاب» ناموفق است، این پیام‌های خطا در گزارش‌های دسترسی مسیریاب NGINX ثبت نمی‌شود. بنابراین، این درخواست‌ها در ابزارهایی مانند «پایش API» و ابزار «ردیابی» ضبط نخواهند شد.

  1. درخواست API خود را تأیید کنید و ببینید آیا درخواست HTTP برای نام مستعار میزبان ارسال می‌کنید که پیکربندی شده است تا درخواست‌ها را فقط در درگاه امن 443 بپذیرد. اگر این‌طور است، این علت مشکل است.

    نمونه درخواست نادرست API:

    curl http://org-test.apigee.net:443/400-demo
    
    <html>
    <head><title>400 The plain HTTP request was sent to HTTPS port</title></head>
    <body>
    <center><h1>400 Bad Request</h1></center>
    <center>The plain HTTP request was sent to HTTPS port</center>
    <hr><center>server</center>
    </body>
    </html>
  2. در درخواست نمونه بالا، توجه داشته باشید که درخواست HTTP به نام مستعار میزبان myorg-test.apigee.net در درگاه امن 443 ارسال می‌شود. این دلیل خطای 400 Bad Request است.

وضوح

باید بررسی کنید که آیا مشتری به‌جای HTTPs از HTTP استفاده می‌کند یا نه و درخواست صحیح را همان‌طور که در زیر نشان داده شده است انجام دهید:

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

curl https://org-test.apigee.net:443/400-demo

یا

curl https://org-test.apigee.net/400-demo
< HTTP/1.1 200 OK
< Date: Thu, 25 Feb 2021 13:01:43 GMT
< Content-Type: text/xml;charset=UTF-8
< Content-Length: 403
< Connection: keep-alive
< Server: gunicorn/19.9.0
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Credentials: true

علت: درخواست HTTP به نقطه پایانی هدف پیکربندی‌شده با TLS

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

تشخیص

از مراحل زیر برای تشخیص خطا بااستفاده از ابزار «ردیابی» استفاده کنید:

  1. ردیابی را در «واسط کاربر Apigee» برای «پراکسی میانای برنامه‌سازی کاربردی» تحت‌تأثیر قرارگرفته فعال کنید.
  2. درخواست‌هایی را به «پراکسی میانای برنامه‌سازی کاربردی» ارسال کنید.
  3. یکی از درخواست‌های API را که با کد پاسخ 400 ناموفق بوده است انتخاب کنید.
  4. در مراحل مختلف پیمایش کنید و تعیین کنید که خرابی در کجا رخ داده است.
  5. معمولاً پاسخ خطای 400 را از سرور زیرینه خواهید دید. یعنی پاسخ خطای 400 را در مرحله پاسخ از سرور مقصد دریافت شد همان‌طور که در زیر نشان داده شده است خواهید دید:

  6. با کلیک کردن روی نماد AX (داده‌های Analytics ضبط‌شده) در ردیابی، نقطه پایانی هدف را که درخواست برای آن ساخته شده است تعیین کنید.

  7. به target.url توجه کنید که حاوی پروتکل، نام مستعار میزبان سرور پشتیبان، و گاهی شماره درگاه است. درگاه استفاده‌شده برای نشانی وب مقصد 443 است اما پروتکل HTTP است.
  8. تعریف نقطه پایانی هدف را بررسی کنید تا پیکربندی را درک کنید.
  9. تأیید کنید که میزبان سرور نهایی ایمن است و در درگاه ایمنی مثل 443 گوش می‌دهد. اگر از این پروتکل به‌عنوان http در عنصر <URL> استفاده می‌کنید، این دلیل بروز این مشکل است.

    پیکربندی نقطه پایانی هدف نمونه:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <TargetEndpoint name="default">
        <Description/>
        <FaultRules/>
        <PreFlow name="PreFlow">
            <Request/>
            <Response/>
        </PreFlow>
        <PostFlow name="PostFlow">
            <Request/>
            <Response/>
        </PostFlow>
        <Flows/>
        <HTTPTargetConnection>
            <Properties/>
            <URL>http://somehost.org:443/get</URL>
        </HTTPTargetConnection>
    </TargetEndpoint>

    مثال بالا نشان می‌دهد که از پروتکل HTTP استفاده می‌کنید، اما درگاه استفاده‌شده درگاه امن 443 است. این کار باعث می‌شود سرور زیرینه با 400 Bad Request و پیام خطای The plain HTTP request was sent to HTTPS port پاسخ دهد.

وضوح

  1. اگر سرور زیرینه شما ایمن است/ «امنیت لایه انتقال» فعال است، مطمئن شوید که از این پروتکل به‌صورت https در عنصر <URL> نقطه پایانی هدف استفاده می‌کنید، همان‌طور که در مثال زیر نشان داده شده است:

    پیکربندی نقطه پایانی هدف نمونه:

    <HTTPTargetConnection>
        <Properties/>
        <URL>https://somehost.org:443/get</URL>
    </HTTPTargetConnection>
  2. اگر سرور نهایی شما امن نباشد، در این‌صورت:

    • شماره درگاه امن را ذکر نکنید، مثلاً 443.
    • اگر سرور زیرینه شما در درگاه غیرامن استاندارد گوش می‌دهد، اصلاً لازم نیست شماره درگاه را ذکر کنید
    • اگر از درگاه غیرامنی استفاده می‌کنید، شماره درگاه را ذکر کنید، برای مثال: 9080

    پیکربندی نقطه پایانی هدف نمونه:

    <HTTPTargetConnection>
        <Properties/>
        <URL>http://somehost.org/get</URL>
    </HTTPTargetConnection>
    
    or
    
    <HTTPTargetConnection>
        <Properties/>
        <URL>http://somehost.org:9080/get</URL>
    </HTTPTargetConnection>

دلیل: پیکربندی نادرست سرور هدف

اگر سرور مقصد با درگاه امنی مثل 443 پیکربندی شده باشد بدون اینکه «لایه سوکت امن» فعال شده باشد، «پردازشگر پیام» Apigee Edge درخواست‌های HTTP را به سرور مقصد امن یا پیکربندی‌شده با «امنیت لایه انتقال» ارسال می‌کند که منجر به این مشکل می‌شود.

تشخیص

از مراحل زیر برای تشخیص خطا بااستفاده از ابزار «ردیابی» استفاده کنید:

  1. ردیابی را در «واسط کاربر Apigee» برای «پراکسی میانای برنامه‌سازی کاربردی» تحت‌تأثیر قرارگرفته فعال کنید.
  2. درخواست‌هایی را به «پراکسی میانای برنامه‌سازی کاربردی» ارسال کنید.
  3. یکی از درخواست‌های API را که با کد پاسخ 400 ناموفق بوده است انتخاب کنید.
  4. در مراحل مختلف پیمایش کنید و تعیین کنید که خرابی در کجا رخ داده است.
  5. معمولاً پاسخ خطای 400 را از سرور زیرینه خواهید دید. یعنی پاسخ خطای 400 را در مرحله پاسخ دریافتی از سرور هدف همان‌طور که در زیر نشان داده شده است خواهید دید:

  6. با کلیک کردن روی نماد AX (داده‌های Analytics ضبط‌شده) در ردیابی، نقطه پایانی هدف را که درخواست برای آن ساخته شده است تعیین کنید.

  7. target.name را که نشان‌دهنده نام نقطه پایانی هدف است یادداشت کنید.

    در فایل ردیابی مثال بالا، target.name برابر با default است. این نشان می‌دهد که نقطه پایانی هدف استفاده‌شده برای این درخواست پیش‌فرض است.

  8. تعریف نقطه پایانی هدف را بررسی کنید تا پیکربندی را درک کنید.

    پیکربندی نقطه پایانی هدف نمونه:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <TargetEndpoint name="default">
        <Description/>
        <FaultRules/>
        <PreFlow name="PreFlow">
            <Request/>
            <Response/>
        </PreFlow>
        <PostFlow name="PostFlow">
            <Request/>
            <Response/>
        </PostFlow>
        <Flows/>
        <HTTPTargetConnection>
            <Properties/>
            <LoadBalancer>
            <Server name="faulty-target"/>
            </LoadBalancer>
        </HTTPTargetConnection>
    </TargetEndpoint>

    پیکربندی نقطه پایانی هدف نمونه بالا نشان می‌دهد که از سرور هدف به‌نام faulty-target استفاده می‌کنید.

  9. پس‌از اینکه نام سرور مقصد را دریافت کردید، می‌توانید از یکی از روش‌های زیر برای بررسی پیکربندی سرور مقصد استفاده کنید:

    • میانای کاربر Edge
    • میانای برنامه‌سازی کاربردی مدیریت

میانای کاربر Edge

  1. به Apigee Edge > سرپرست > محیط‌ها > سرورهای هدف پیمایش کنید.
  2. کاربر سرور هدف خاصی را که ازطریق پراکسی API شناسایی شده است انتخاب کند و روی ویرایش کلیک کند.
  3. درگاه مشخص‌شده برای سرور هدف و اطلاعات SSL را درستی‌سنجی کنید.
  4. اگر سرور مقصد با درگاه امنی (برای مثال: 443) پیکربندی شده باشد، اما SSL فعال نباشد، این دلیل بروز این مشکل است.

    همان‌طور که در نماگرفت بالا می‌بینید، درگاه مورد استفاده 443 است اما SSL برای آن درگاه در پیکربندی سرور مقصد فعال نیست. این کار باعث می‌شود «پردازنده پیام» Apigee Edge درخواست‌های HTTP را به درگاه امن 443 ارسال کند. بنابراین، خطای 400 Bad Request را با پیام The plain HTTP request was sent to HTTPS port دریافت می‌کنید.

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

  1. میانای برنامه‌سازی کاربردی دریافت سرور هدف را اجرا کنید تا جزئیات مربوط به پیکربندی سرور هدف خاص را همان‌طور که در زیر نشان داده شده است دریافت کنید:

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

    curl -v 'https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/environments/ENV_NAME>/targetservers/TARGET_SERVER_NAME' \
    -H "Content-Type:application/xml" \
    -H "Authorization:Bearer $TOKEN"
    

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

    curl -v 'http://MANAGEMENT_IP:8080/v1/organizations/ORG_NAME/environments/ENV_NAME/targetservers/TARGET_SERVER_NAME' \
    -H "Content-Type:application/xml" \
    -H "Authorization:Bearer $TOKEN"
    
  2. درگاه مشخص‌شده برای سرور هدف و اطلاعات SSL را درستی‌سنجی کنید.
  3. اگر سرور هدف با درگاه امنی پیکربندی شده باشد (برای نمونه: 443)، اما بخش SSLInfo تعریف نشده باشد یا فعال نباشد، این دلیل بروز این مشکل است.

    پیکربندی سرور هدف نمونه:

    {
      "host" : "somehost.org",
      "isEnabled" : true,
      "name" : "faulty-target",
      "port" : 443
    }

    در برونداد نمونه بالا، می‌بینیم که درگاه استفاده‌شده برای اتصال هدف 443 است، اما هیچ بلوک پیکربندی SSLInfo وجود ندارد.

    این کار باعث می‌شود «پردازشگر پیام» Apigee Edge درخواست‌های HTTP را به درگاه امن 443 ارسال کند. بنابراین، خطای 400 Bad Request را با پیام The plain HTTP request was sent to HTTPS port دریافت می‌کنید.

وضوح

اگر سرور هدف شما ایمن است یا «امنیت لایه انتقال» پیکربندی شده است، باید SSL را برای سرور هدف خاص فعال کنید.

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

  • میانای کاربر Edge
  • میانای برنامه‌سازی کاربردی مدیریت

میانای کاربر Edge

  1. در واسط کاربر Edge > سرپرست > محیط‌ها > سرورهای هدف به سرور هدف پیمایش کنید.
  2. کارساز هدف خاص را انتخاب کنید و روی ویرایش کلیک کنید.
  3. اگر سرور مقصد شما ایمن است و از درگاهی مثل 443 استفاده می‌کند، با انتخاب چارگوش کنار گزینه SSL، آن را فعال کنید.
  4. Truststore، Ciphers، و Protocols را پیکربندی کنید. (فقط درصورت نیاز)

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

از API مدیریت برای پیکربندی سرور هدف همان‌گونه که در به‌روزرسانی پیکربندی سرور هدف مستند شده است استفاده کنید.

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

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

  1. اگر کاربر ابر عمومی هستید، اطلاعات زیر را ارائه دهید:
    • نام سازمان
    • نام محیط
    • نام پراکسی میانای برنامه‌سازی کاربردی
    • فرمان curl را برای بازتولید خطا تکمیل کنید
    • برونداد ابزار ردیابی (اگر توانسته‌اید درخواست ناموفق را ضبط کنید)
  2. اگر کاربر ابر خصوصی هستید، اطلاعات زیر را ارائه دهید:
    • پیام خطای کامل مشاهده شد
    • نام محیط
    • دسته پراکسی میانای برنامه‌سازی کاربردی
    • تعریف سرور هدف (اگر از سرور هدف در نقطه پایانی‌تان استفاده می‌کنید)
    • برونداد ابزار ردیابی (اگر توانسته‌اید درخواست ناموفق را ضبط کنید)