پروکسی Envoy در «وقث‌دهنده Apigee برای Envoy» با خطای «HTTP 403 ممنوع است» ناموفق است

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

نشانه

وقتی Envoy Proxy ازطریق وقث‌دهنده Apigee برای Envoy فراخوانی می‌شود، با خطای HTTP 403 Forbidden مواجه می‌شود.

پیام خطا

پیام خطای زیر نمایش داده می‌شود:

HTTP/1.1 403 Forbidden
content-length: 19
content-type: text/plain
date: Tue, 03 Nov 2020 00:20:10 GMT
server: istio-envoy

علل احتمالی

اگر یکی از شرایط زیر رخ دهد، پراکسی Envoy خطای HTTP 403 ایجاد می‌کند:

علت شرح دستورالعمل‌های عیب‌یابی برای موارد زیر قابل‌اجرا است
محصول میانای برنامه‌سازی کاربردی فعال نیست محصول API برای محیط خاص فعال نیست. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»
مسیر نشانی وب سرویس هدف در «محصول API» وجود ندارد مسیر نشانی وب سرویس هدف وجود ندارد یا به محصول API در بخش منابع API اضافه نشده است. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»
نام میزبان در «محصول API» وجود ندارد نام میزبان ارائه‌شده در درخواست API مشتری در محصول API در Apigee هدف‌های سرویس از دور وجود ندارد. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»
کلید میانای برنامه‌سازی کاربردی در سرایند درخواست وجود ندارد کلید API در سرصفحه HTTP x-api-key ارسال نشده است. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»
کلید میانای برنامه‌سازی کاربردی نامعتبر است کلید API که به‌عنوان بخشی از درخواست ارسال شده است نامعتبر است. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»
«وقث‌دهنده Apigee برای Envoy» نمی‌تواند با پراکسی API سرویس از دور ارتباط برقرار کند «وقث‌دهنده Apigee برای Envoy» نمی‌تواند با پراکسی میانای برنامه‌سازی کاربردی سرویس راه دور ارتباط برقرار کند. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»
پراکسی Envoy نمی‌تواند با «وقث‌دهنده Apigee برای Envoy» ارتباط برقرار کند پراکسی Envoy نمی‌تواند با «وقث‌دهنده Apigee برای Envoy» ارتباط برقرار کند کاربران «فضای ابری خصوصی و عمومی لبه‌ای»

قبل‌از شروع

  1. تأیید کنید که پیام پاسخ 403 Forbidden را از پراکسی Envoy دریافت می‌کنید. برای مثال:
    curl -i -H "x-api-key: $API_KEY" http://httpbin:8080/echo
    
    HTTP/1.1 403 Forbidden
    content-length: 19
    content-type: text/plain
    date: Tue, 12 Jan 2021 08:18:08 GMT
    server: envoy
    RBAC: access denied
  2. فعال کردن گزارش‌های اشکال‌زدایی:

    برای دریافت جزئیات بیشتر درباره خطا، مطمئن شوید که گزارش‌های اشکال‌زدایی را در «آداپتور Apigee برای Envoy» فعال کرده‌اید. درغیراین‌صورت، «آداپتور Apigee برای Envoy» را متوقف کنید و آن را دوباره با فعال کردن گزارش‌های اشکال‌زدایی بااستفاده از فرمان زیر شروع کنید:

    apigee-remote-service-envoy -c config.yaml -l debug

دلیل: محصول API فعال نیست

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

تشخیص

برای تشخیص مشکل، مراحل زیر را انجام دهید:

  1. گزارش‌های اشکال‌زدایی را همان‌طور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
  2. گزارش‌های «وقث‌دهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید پیام زیر در بخش Authorizing request نمایش داده می‌شود:
    product: API_PRODUCT_NAME not found

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

    2021-01-12T08:18:08.124Z        DEBUG   auth/auth.go:98 Authenticate: key: 7mQIG..., claims: map[string]interface {}(nil)
    2021-01-12T08:18:08.124Z        DEBUG   auth/verify_api_key.go:106      fetchToken fetching: 7mQIG...
    2021-01-12T08:18:08.589Z        DEBUG   auth/auth.go:125        using api key from request
    2021-01-12T08:18:08.589Z        DEBUG   auth/auth.go:157        Authenticate success: &auth.Context{Context:(*server.Handle
    r)(0xc0001a0600), ClientID:"7mQIG...", AccessToken:"", Application:"ENVOY-APP-1", APIProducts:[]string{"ENVOY-PRODUCT-1"},
    Expires:time.Time{wall:0x0, ext:63746037188, loc:(*time.Location)(0x14a3be0)}, DeveloperEmail:"[---masked---]", Scopes:[]
    string{""}, APIKey:"7mQIG..."}
    2021-01-12T08:18:08.589Z        DEBUG   product/manager.go:89
    Authorizing request:
      products: [ENVOY-PRODUCT-1]
      scopes: []
      operation: GET /echo
      target: httpbin:8080
      - product: ENVOY-PRODUCT-1
        not found

    مثال بالا نشان می‌دهد که محصول API ENVOY-PRODUCT-1 در «وقث‌دهنده Apigee برای Envoy» پیدا نشد.

    برای کسب اطلاعات بیشتر درباره ثبت گزارش «وقث‌دهنده Apigee برای Envoy»، به ثبت گزارش مراجعه کنید.

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

وضوح

اگر محیط خاص در محصول API فعال نباشد، مراحل زیر را برای حل مشکل انجام دهید:

  1. به سیستم میانای کاربر Edge وارد شوید.
  2. در صفحه انتشار > محصولات API، روی محصول API خاصی که برای پیکربندی «آداپتور Apigee برای Envoy» استفاده کرده‌اید کلیک کنید.
  3. در صفحه محصولات API > نام محصول، روی ویرایش کلیک کنید.
  4. محیط خاصی را که می‌خواهید در آن درخواست‌های API ایجاد کنید با انتخاب چارگوش انتخاب محیط مربوطه فعال کنید.
  5. روی ذخیره کلیک کنید.

دلیل: مسیر نشانی وب سرویس هدف در محصول میانای برنامه‌سازی کاربردی وجود ندارد

اگر مسیر نشانی وب هدف در «محصول میانای برنامه‌سازی کاربردی» خاصی که Envoy Proxy استفاده می‌کند مشخص نشده باشد، این خطا رخ می‌دهد.

تشخیص

برای تشخیص مشکل، مراحل زیر را انجام دهید:

  1. گزارش‌های اشکال‌زدایی را همان‌طور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
  2. گزارش‌های «آداپتور Apigee برای Envoy» را بررسی کنید و مطمئن شوید که پیام زیر برای «محصول API» خاص مرتبط با هدف خاص در بخش Authorizing request نمایش داده می‌شود:

    no path: REQUEST_URI_PATH

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

    2021-01-12T08:09:02.604Z        DEBUG   auth/auth.go:98 Authenticate: key: 7mQIG..., claims: map[string]interface {}(nil)
    2021-01-12T08:09:02.605Z        DEBUG   auth/auth.go:125        using api key from request
    2021-01-12T08:09:02.605Z        DEBUG   auth/auth.go:157        Authenticate success: &auth.Context{Context:(*server.Handle
    r)(0xc0001a4180), ClientID:"7mQIG...", AccessToken:"", Application:"ENVOY-APP-1", APIProducts:[]string{"ENVOY-PRODUCT-1"},
    Expires:time.Time{wall:0x0, ext:63746036507, loc:(*time.Location)(0x14a3be0)}, DeveloperEmail:"[---masked---]", Scopes:[]
    string{""}, APIKey:"7mQIG..."}
    2021-01-12T08:09:02.605Z        DEBUG   product/manager.go:89
    Authorizing request:
      products: [ENVOY-PRODUCT-1]
      scopes: []
      operation: GET /echo1
      target: httpbin:8080
      - product: ENVOY-PRODUCT-1
        no path: /echo1
    2021-01-12T08:09:02.605Z        DEBUG   server/authorization.go:228     sending ok (actual: PERMISSION_DENIED)

    برونداد نمونه پیام زیر را نشان می‌دهد:

    no path: /echo1

    این نشان می‌دهد که مسیر /echo1 در محصول API ENVOY-PRODUCT-1 پیدا نشد.

  3. اگر پیام no path: REQUEST_URI_PATH را در گزارش‌های اشکال‌زدایی «آداپتور Apigee برای Envoy» می‌بینید، این پیام دلیل این مشکل است. اگر این‌طور نیست، به علت: نام میزبان در محصول API وجود ندارد بروید.

وضوح

اگر «شناسه منبع یکنواخت» درخواست ویژه به «محصول API» برای هدف ویژه اضافه نشده است، مراحل زیر را برای حل‌وفصل مشکل انجام دهید:

  1. به سیستم میانای کاربر Edge وارد شوید.
  2. در صفحه انتشار > محصولات API، روی محصول API خاصی که برای پیکربندی «آداپتور Apigee برای Envoy» استفاده کرده‌اید کلیک کنید.
  3. در صفحه محصولات API > نام محصول، روی ویرایش کلیک کنید.
  4. در قاب منابع API، نشانی وب درخواست API را به محصول API اضافه کنید.
  5. گزارش‌های «وقث‌دهنده Apigee برای Envoy» را پایش کنید و منتظر بمانید تا «وقث‌دهنده Apigee برای Envoy» محصول API به‌روزشده را واکشی کند. پس‌از آن، درخواست API دیگری برای درستی‌سنجی اصلاح ارسال کنید.

دلیل: نام میزبان در محصول «میانای برنامه‌سازی کاربردی» وجود ندارد

اگر ترکیب نام میزبان و درگاه هدف به «محصول API» خاصی که Envoy Proxy استفاده می‌کند اضافه نشده باشد، این خطا رخ خواهد داد.

تشخیص

برای تشخیص مشکل، مراحل زیر را انجام دهید:

  1. گزارش‌های اشکال‌زدایی را همان‌طور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
  2. گزارش‌های «آداپتور Apigee برای Envoy» را بررسی کنید و مطمئن شوید که پیام زیر برای «محصول API» خاص مرتبط با هدف خاص در بخش Authorizing request نمایش داده می‌شود:

    no targets: HOSTNAME:PORT

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

    2021-01-12T08:12:06.019Z        DEBUG   auth/auth.go:98 Authenticate: key: 7mQIG..., claims: map[string]interface {}(nil)
    2021-01-12T08:12:06.019Z        DEBUG   auth/auth.go:125        using api key from request
    2021-01-12T08:12:06.019Z        DEBUG   auth/auth.go:157        Authenticate success: &auth.Context{Context:(*server.Handle
    r)(0xc0001a4180), ClientID:"7mQIG...", AccessToken:"", Application:"ENVOY-APP-1", APIProducts:[]string{"ENVOY-PRODUCT-1"},
    Expires:time.Time{wall:0x0, ext:63746036507, loc:(*time.Location)(0x14a3be0)}, DeveloperEmail:"[---masked---]", Scopes:[]
    string{""}, APIKey:"7mQIG..."}
    2021-01-12T08:12:06.019Z        DEBUG   product/manager.go:89
    Authorizing request:
      products: [ENVOY-PRODUCT-1]
      scopes: []
      operation: GET /echo
      target: httpbin1:8080
      - product: ENVOY-PRODUCT-1
        no targets: httpbin1:8080
    2021-01-12T08:12:06.020Z        DEBUG   server/authorization.go:228     sending ok (actual: PERMISSION_DENIED)

    مثال بالا نشان می‌دهد که ترکیب نام میزبان و درگاه httpbin1:8080 در محصول API ENVOY-PRODUCT-1 پیدا نشد.

  3. اگر گزارش‌های «وقث‌دهنده Apigee برای Envoy» حاوی ورودی با پیام no targets: HOSTNAME:PORT درحین مجاز کردن درخواست باشد، این دلیل مشکل است. اگر این‌طور نیست، به علت: کلید میانای برنامه‌سازی کاربردی در سرایند درخواست وجود ندارد.

وضوح

اگر ترکیب نام میزبان و درگاه هدف به محصول API اضافه نشده است، مراحل زیر را برای حل مشکل انجام دهید:

  1. به سیستم میانای کاربر Edge وارد شوید.
  2. در صفحه انتشار > محصولات API، روی محصول API خاصی که برای پیکربندی «آداپتور Apigee برای Envoy» استفاده کرده‌اید کلیک کنید.
  3. در صفحه محصولات API > نام محصول، روی ویرایش کلیک کنید.
  4. در قاب هدف‌های سرویس راه دور Apigee، نام میزبان هدف و درگاه را اضافه کنید و روی ذخیره کردن کلیک کنید.

    اگر بخش هدف‌های سرویس راه دور Apigee را در واسط کاربر نمی‌بینید، با نام apigee-remote-service-targets به محصول API یک مشخصه سفارشی اضافه کنید و مقدار HOSTNAME:PORT را بااستفاده از Edge API اضافه کنید. برای مثال:

    curl https://api.enterprise.apigee.com/v1/organizations/$ORG/apiproducts/$ENVOY_PRODUCT \
        -X GET \
        -H "Authorization: Bearer $ACCESS_TOKEN" \
        -H "Content-Type:application/json" \
        -d \
    {
        "apiResources": [
            "/echo",
            "/verifyApiKey"
        ],
        "approvalType": "auto",
        "attributes": [
            {
                "name": "access",
                "value": "public"
            },
            {
                "name": "apigee-remote-service-targets",
                "value": "localhost:8080"
            }
        ],
        "createdAt": 1610435989556,
        "createdBy": "---masked---",
        "description": "",
        "displayName": "ENVOY-PRODUCT-1",
        "environments": [
            "test"
        ],
        "lastModifiedAt": 1612234134060,
        "lastModifiedBy": "---masked---",
        "name": "ENVOY-PRODUCT-1",
        "proxies": [
            "remote-service"
        ],
        "scopes": []
    }
  5. پس‌از انجام تکلیف بالا، گزارش‌های «وقث‌دهنده Apigee برای Envoy» را پایش کنید و منتظر بمانید تا «وقث‌دهنده Apigee برای Envoy» محصول API به‌روزشده را واکشی کند. پس‌از آن، درخواست API دیگری برای درستی‌سنجی اصلاح ارسال کنید.

دلیل: کلید API در سرایند درخواست وجود ندارد

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

تشخیص

برای تشخیص مشکل، مراحل زیر را انجام دهید:

  1. گزارش‌های اشکال‌زدایی را همان‌طور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
  2. گزارش‌های «وقث‌دهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید پیام [missing authentication] را در بخش Authenticate error می‌بینید.

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

    2021-01-12T08:20:31.461Z        DEBUG   auth/auth.go:98 Authenticate: key: , claims: map[string]interface {}(nil)
    2021-01-12T08:20:31.461Z        DEBUG   auth/auth.go:159
    Authenticate error: &auth.Context{Context:(*server.Handler)
    (0xc0001a0600), ClientID:"", AccessToken:"", Application:"", APIProducts:[]string(nil), Expires:time.Time{wall:0x0, ext:0,
    loc:(*time.Location)(nil)}, DeveloperEmail:"", Scopes:[]string(nil), APIKey:""} [missing authentication]
    2021-01-12T08:20:31.461Z        DEBUG   server/authorization.go:205     sending denied: UNAUTHENTICATED
    2021-01-12T08:20:32.448Z        DEBUG   server/header_context.go:68     No context header x-apigee-api, using target header
    : :authority

    برونداد نمونه نشان‌داده‌شده در بالا پیام [missing authentication] را دارد. این پیام نشان می‌دهد که کلید API به‌عنوان بخشی از سرایند درخواست ارسال نشده است.

  3. اگر گزارش‌های «وقث‌دهنده Apigee برای Envoy» حاوی ورودی گزارش با پیام [missing authentication]در بخش Authenticate error باشد، این دلیل مشکل است. اگر این‌طور نیست، به علت: کلید میانای برنامه‌سازی کاربردی نامعتبر بروید.

وضوح

اگر خطای [missing authentication] در گزارش‌های «آداپتور Apigee برای Envoy» نمایش داده شد، مراحل زیر را برای حل مشکل انجام دهید:

  1. بررسی کنید که آیا کارخواه کلید میانای برنامه‌سازی کاربردی را بااستفاده از سرایند HTTP x-api-key در درخواست میانای برنامه‌سازی کاربردی ارسال کرده است یا نه. درغیراین‌صورت، از کارخواه بخواهید کلید API را در سرایند HTTP x-api-key ارسال کند.
  2. فایل پیکربندی «آداپتور Apigee برای Envoy» را بررسی کنید و مطمئن شوید نام سرایند کلید API پیش‌فرض x-api-key تغییر کرده باشد، برای مثال:
    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: apigee-remote-service-envoy
      namespace: apigee
    data:
      config.yaml: |
        global:
          tls:
            ...
        tenant:
          ...
        auth:
          target_header: api-key

    در مثال بالا، نام سرایند «کلید API» پیش‌فرض به api-key تغییر کرده است. در این مورد، باید «کلید API» را به‌عنوان بخشی از سرایند api-key ارسال کنید.

  3. اگر نام سرایند کلید API پیش‌فرض تغییر کرده است، از کارخواه بخواهید از نام سرایند کلید API به‌روزشده استفاده کند و درخواست API دیگری ارسال کند و بررسی کند که آیا مشکل حل می‌شود یا نه.

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

اگر «کلید API» نامعتبر به‌عنوان بخشی از سرایند درخواست ارسال شود، این خطا رخ خواهد داد.

تشخیص

برای تشخیص مشکل، مراحل زیر را انجام دهید:

  1. گزارش‌های اشکال‌زدایی را همان‌طور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
  2. گزارش‌های «وقث‌دهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید پیام [permission denied] را در بخش Authenticate error می‌بینید. این پیام معمولاً پس‌از آنکه «کلید API» توسط «آداپتور» واکشی شد نمایش داده می‌شود که با پیام fetchToken fetching: API_KEY نشان داده می‌شود.

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

    2021-01-12T05:01:07.198Z        DEBUG   auth/auth.go:98 Authenticate: key: 123, claims: map[string]interface {}(nil)
    2021-01-12T05:01:07.198Z        DEBUG   auth/verify_api_key.go:106      fetchToken fetching: API_KEY
    2021-01-12T05:01:09.102Z        DEBUG   server/header_context.go:68     No context header x-apigee-api, using target header: :authority
    2021-01-12T05:01:09.831Z        DEBUG   auth/auth.go:159        Authenticate error: &auth.Context{Context:(*server.Handler)(0xc0001640c0), ClientID:"", AccessToken:"", Application:"", APIProducts:[]string(nil), Expires:time.Time{wall:0x0, ext:0, loc:(*time.Location)(nil)}, DeveloperEmail:"", Scopes:[]string(nil), APIKey:""} [permission denied]
    2021-01-12T05:01:09.832Z        DEBUG   server/authorization.go:228     sending ok (actual: PERMISSION_DENIED)

    در این مثال، کلید میانای API ارسال‌شده در درخواست API معتبر نبود.

  3. اگر گزارش‌های «آداپتور Apigee برای Envoy» حاوی ورودی گزارشی با [permission denied] در بخش Authenticate error باشد، نشان می‌دهد که «کلید API» که به‌عنوان بخشی از درخواست ارسال شده است نامعتبر است و دلیل مشکل همین است. درغیراین‌صورت، به علت: «وقث‌دهنده Apigee برای Envoy» نمی‌تواند با پراکسی API سرویس از دور ارتباط برقرار کند.

وضوح

اگر پیام [permission denied] در بخش Authenticate error در گزارش‌های «آداپتور Apigee برای Envoy» مشاهده شد، مراحل زیر را برای حل کردن مشکل انجام دهید: :

  1. کلید میانای برنامه‌سازی کاربردی ارسال‌شده در درخواست میانای برنامه‌سازی کاربردی را با مقدار کلید میانای برنامه‌سازی کاربردی موجود در برنامه متصل به محصول میانای برنامه‌سازی کاربردی بررسی کنید.
  2. اگر کلید API استفاده‌شده توسط مشتری معتبر نیست، از مشتری بخواهید کلید API معتبر را ارسال کند.
  3. اگر کلید API استفاده‌شده توسط مشتری معتبر است و همچنان خطای HTTP 403 را می‌بینید، لطفاً با پشتیبانی Apigee Edge تماس بگیرید تا این موضوع را بیشتر بررسی کنند.

دلیل: «وقث‌دهنده Apigee برای Envoy» نمی‌تواند با پراکسی «میانای برنامه‌سازی کاربردی سرویس از دور» ارتباط برقرار کند

اگر «میانای Apigee برای Envoy» نتواند با «پراکسی API سرویس راه دور» ارتباط برقرار کند، این خطا رخ می‌دهد اگر میزبان سرویس راه دور پیکربندی‌شده نامعتبر باشد.

تشخیص

برای تشخیص مشکل، مراحل زیر را انجام دهید:

  1. گزارش‌های اشکال‌زدایی را همان‌طور که در مرحله ۲ بالا توضیح داده شده است فعال کنید.
  2. گزارش‌های «وقث‌دهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید که پیام زیر را می‌بینید:

    Error retrieving products: REQUEST_URI: no such host

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

    2021-01-12T08:29:06.499Z        DEBUG   product/manager.go:188  retrieving products from: https://foo/remote-service/products
    2021-01-12T08:29:06.505Z        ERROR   product/manager.go:164  Error retrieving products: GET "https://foo/remote-service/pro
    ducts": dial tcp: lookup foo on 169.254.169.254:53: no such host
    github.com/apigee/apigee-remote-service-golib/product.(*manager).start.func1
            /go/pkg/mod/github.com/apigee/apigee-remote-service-golib@v1.4.0/product/manager.go:164
    github.com/apigee/apigee-remote-service-golib/util.(*Looper).Run
            /go/pkg/mod/github.com/apigee/apigee-remote-service-golib@v1.4.0/util/looper.go:87
    github.com/apigee/apigee-remote-service-golib/util.(*Looper).Start.func1
            /go/pkg/mod/github.com/apigee/apigee-remote-service-golib@v1.4.0/util/looper.go:59

    در این مثال، «آداپتور Apigee برای Envoy» نتوانست با پراکسی API سرویس راه دور ارتباط برقرار کند زیرا نام میزبان ارائه‌شده در نشانی وب پراکسی API سرور راه دور معتبر نیست، همان‌طور که خطای no such host نشان می‌دهد .

  3. اگر گزارش‌های «وقث‌دهنده Apigee برای Envoy» حاوی ورودی گزارش با پیام no such host باشد، این دلیل مشکل است. اگر این‌طور نیست، به علت: پراکسی Envoy نمی‌تواند با «وقث‌دهنده Apigee برای Envoy» ارتباط برقرار کند.

وضوح

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

  1. فایل پیکربندی «آداپتور Apigee برای Envoy» را بررسی کنید و مطمئن شوید نشانی وب پراکسی API سرویس راه دور معتبر باشد.

    اگر این‌طور نیست، «وقث‌دهنده Apigee برای Envoy» را متوقف کنید، نشانی وب پراکسی API سرویس راه دور را در فایل پیکربندی اصلاح کنید، «وقث‌دهنده Apigee برای Envoy» را شروع کنید، و درخواست API دیگری ارسال کنید و اصلاح را درستی‌سنجی کنید.

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

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: apigee-remote-service-envoy
      namespace: apigee
    data:
      config.yaml: |
        tenant:
          internal_api: https://istioservices.apigee.net/edgemicro
          remote_service_api: https://ORG-ENV.apigee.net/remote-service
          org_name: ORG
          env_name: ENV
          key: KEY
          secret: SECRET
          
  2. تأیید کنید که پراکسی remote-service API در محیط Edge مربوطه مستقر شده باشد. اگر این‌طور نیست، پراکسی remote-service API را در محیط Edge مربوطه مستقر کنید و دوباره امتحان کنید.
  3. اتصال‌پذیری شبکه بین «آداپتور Apigee برای Envoy» و نقطه پایانی پراکسی API remote-service را به‌تأیید برسانید. اگر مشکلی در اتصال‌پذیری شبکه پیدا شد، با تیم شبکه‌سازی خود تماس بگیرید و سعی کنید مشکل را برطرف کنید.

دلیل: پراکسی Envoy نمی‌تواند با «وقث‌دهنده Apigee برای Envoy» ارتباط برقرار کند

تشخیص

برای تشخیص مشکل، مراحل زیر را انجام دهید:

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

    استقرار مستقل:

    envoy -c envoy-config.yaml -l debug

    استقرار مبتنی بر Kubernetes/Istio:

    kubectl -n=istio-system get pods
    kubectl -n=istio-system exec -it INGRESS_GATEWAY_NAME bash -- curl -X POST localhost:15000/logging?connection=debug
  2. گزارش‌های «وقث‌دهنده Apigee برای Envoy» را بررسی کنید و مطمئن شوید ورودی گزارشی با این پیام وجود دارد:
    connecting to APIGEE_ENVOY_ADAPTER_HOST:5000

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

    upstream connect error or disconnect/reset before headers. reset reason: ACTUAL_REASON

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

    [2021-03-23 05:44:41.867][1303661][debug][connection] [external/envoy/source/common/network/connection_impl.cc:769] [C4] connecting to 127.0.0.1:5000
    [2021-03-23 05:44:41.867][1303661][debug][connection] [external/envoy/source/common/network/connection_impl.cc:785] [C4] connection in progress
    [2021-03-23 05:44:41.868][1303661][debug][http2] [external/envoy/source/common/http/http2/codec_impl.cc:1173] [C4] updating connection-level initial window size to 268435456
    [2021-03-23 05:44:41.869][1303661][debug][connection] [external/envoy/source/common/network/connection_impl.cc:634] [C4] delayed connection error: 111
    [2021-03-23 05:44:41.869][1303661][debug][connection] [external/envoy/source/common/network/connection_impl.cc:203] [C4] closing socket: 0
    [2021-03-23 05:44:41.869][1303661][debug][client] [external/envoy/source/common/http/codec_client.cc:96] [C4] disconnect. resetting 0 pending requests
    [2021-03-23 05:44:41.869][1303661][debug][pool] [external/envoy/source/common/conn_pool/conn_pool_base.cc:314] [C4] client disconnected, failure reason:
    [2021-03-23 05:44:41.869][1303661][debug][router] [external/envoy/source/common/router/router.cc:1031] [C0][S6149963213555558594] upstream reset: reset reason: connection failure, transport failure reason:
    [2021-03-23 05:44:41.869][1303661][debug][http] [external/envoy/source/common/http/async_client_impl.cc:100] async http request response headers (end_stream=true):
    ':status', '200'
    'content-type', 'application/grpc'
    'grpc-status', '14'
    'grpc-message', 'upstream connect error or disconnect/reset before headers. reset reason: connection failure'

    مثال بالا نشان می‌دهد که Envoy به‌دلیل connection failure نتوانسته است با «وقث‌دهنده Apigee برای Envoy» ارتباط برقرار کند.

  3. connection failure می‌تواند به دلایل متعددی باشد. بیایید هریک از این سناریوها را بررسی کنیم.

سناریو شماره ۱: فرایند آداپتور اجرا نمی‌شود

اگر فرایند «وقث‌دهنده Apigee برای Envoy» درحال اجرا نباشد، این خطا ممکن است رخ دهد.

  1. با اجرای فرمان زیر، مطمئن شوید فرایند «آداپتور Apigee برای Envoy» درحال اجرا است. فرمان. اگر فرایند «وقث‌دهنده Apigee برای Envoy» درحال اجرا باشد، نتیجه فرمان زیر باید آن را فهرست کند.
    ps -ef | grep apigee-remote-service-envoy
  2. اگر درحال اجرا نیست، پس این دلیل مشکل است.

وضوح

  1. اگر فرایند «وقث‌دهنده Apigee برای Envoy» اجرا نمی‌شود، «وقث‌دهنده Apigee برای Envoy» را شروع کنید.
  2. درخواست API دیگری ایجاد کنید و بررسی کنید که آیا مشکل برطرف شده است یا خیر.

سناریو شماره ۲: فرایند آداپتور در درگاه مشخص‌شده گوش نمی‌دهد

اگر فرایند «وقث‌دهنده Apigee برای Envoy» در درگاه مشخصی گوش نمی‌دهد، این خطا می‌تواند رخ دهد.

اگر فرایند «وقث‌دهنده Apigee برای Envoy» درحال اجرا است، بررسی کنید که یک سوکت درحال گوش دادن به درگاه ۵۰۰۰ وجود داشته باشد: APIGEE_ENVOY_ADAPTER_HOST:5000. برای درستی‌سنجی این مورد می‌توانید فرمان netstat را اجرا کنید:

sudo netstat -lnp | grep 5000

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

sudo netstat -lnp | grep 5000

tcp6       0      0 :::5000                 :::*                    LISTEN      1596530/./apigee-re

اگر هیچ سوکتی درحال گوش دادن به درگاه ۵۰۰۰ نباشد، این می‌تواند دلیل این مشکل باشد.

وضوح

  1. «وقث‌دهنده Apigee برای Envoy» را متوقف کنید و دوباره آن را شروع کنید.
  2. درخواست API دیگری ایجاد کنید و بررسی کنید که آیا مشکل برطرف شده است یا خیر.

سناریو شماره ۳: اتصال‌پذیری شبکه بین Envoy و «وقث‌دهنده Apigee برای Envoy»

  1. اتصال‌پذیری شبکه بین Envoy و «وقث‌دهنده Apigee برای Envoy» را درستی‌سنجی کنید:
    ssh $ENVOY_HOST
    telnet $APIGEE_ENVOY_ADAPTER_HOST 5000

    اگر telnet بتواند اتصال TCP به «آداپتور Apigee برای Envoy» برقرار کند بروندادی مشابه زیر نمایش داده خواهد شد:

    telnet $APIGEE_ENVOY_ADAPTER_HOST 5000
    
    Trying ::1...
    Connected to localhost.
    Escape character is '^]'.
  2. اگر خطای Connection timed out را با telnet مشاهده کردید، این نشان می‌دهد که مشکل اتصال‌پذیری شبکه بین Envoy و «آداپتور Apigee برای Envoy» وجود دارد.

وضوح

اگر مشکلی در اتصال‌پذیری شبکه بین Envoy و «آداپتور Apigee برای Envoy» مشاهده کردید، لطفاً با تیم شبکه‌تان تماس بگیرید و سعی کنید مشکل را حل کنید.

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

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

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

  1. محصول Apigee استفاده‌شده:

    مثال: Apigee Edge Cloud،‏ Apigee OPDK،‏ Apigee hybrid،‏ Apigee X

  2. سازمان و محیط Apigee
  3. تعریف محصول میانای برنامه‌سازی کاربردی خوانده‌شده بااستفاده از Edge API:

    curl -i -u $USER:$PASSWORD $MANAGEMENT_SERVER_ENDPOINT/v1/organizations/$ORGANIZATION/apiproducts/$API_PRODUCT

    مرجع: میاناهای برنامه‌سازی کاربردی Apigee Edge

  4. بااستفاده از واسط کاربر Apigee Edge، جلسه ردیابی را در پراکسی API remote-service شروع کنید. این مشکل را بازتولید کنید و فایل XML جلسه «ردیابی» را هم‌رسانی کنید.

    مرجع: استفاده از ابزار «پیگیری» | Apigee Edge

  5. گزارش‌های «وقث‌دهنده Apigee برای Envoy» (گزارش‌های کامل مربوط به دوره زمانی داده‌شده)

    استقرار مستقل:

    # by default Apigee Envoy write logs to stdout and stderr, check your deployment configuration and collect logs accordingly

    استقرار مبتنی بر Kubernetes/Istio:

    kubectl -n=apigee get pods
    kubectl -n=apigee logs APIGEE_REMOTE_SERVICE_ENVOY_POD_NAME > apigee-remote-service-envoy.log
  6. درخواست API ارسال‌شده به پراکسی Envoy بااستفاده از فرمان curl (برونداد کامل فرمان curl):
    curl -v ENVOY_PROXY_ENDPOINT
  7. درخواست میانای برنامه‌سازی کاربردی که بااستفاده از فرمان curl به سرویس هدف ارسال شده است (برونداد کامل فرمان curl):
    curl -v TARGET_SERVICE_ENDPOINT