El proxy de Envoy falla con el error HTTP 403 Prohibido en el adaptador de Apigee para Envoy

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X.
info

Síntoma

El proxy de Envoy falla con el error HTTP 403 Forbidden cuando se invoca a través del adaptador de Apigee para Envoy.

Mensaje de error

Se muestra el siguiente mensaje de error:

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

Causas posibles

El proxy de Envoy generará un error HTTP 403 si se produce una de las siguientes condiciones:

Causa Descripción Instrucciones de solución de problemas aplicables para
El producto de la API no está habilitado El producto de API no está habilitado para el entorno específico. Usuarios de la nube pública y privada de Edge
Falta la ruta de acceso del URI del servicio de destino en el producto de API Falta la ruta del URI del servicio de destino o no se agregó al producto de API en los recursos de la API. Usuarios de la nube pública y privada de Edge
Falta el nombre de host en el producto de API Falta el nombre de host proporcionado en la solicitud de la API del cliente en el producto de API en los destinos de servicio remoto de Apigee. Usuarios de la nube pública y privada de Edge
Falta la clave de API en el encabezado de la solicitud La clave de API no se pasa en el encabezado HTTP x-api-key. Usuarios de la nube pública y privada de Edge
La clave de API no es válida La clave de API que se pasó como parte de la solicitud no es válida. Usuarios de la nube pública y privada de Edge
Apigee Adapter for Envoy no puede comunicarse con el proxy de API de servicio remoto El adaptador de Apigee para Envoy no puede comunicarse con el proxy de API de servicio remoto. Usuarios de la nube pública y privada de Edge
El proxy de Envoy no puede comunicarse con el adaptador de Apigee para Envoy El proxy de Envoy no puede comunicarse con Apigee Adapter for Envoy Usuarios de la nube pública y privada de Edge

Antes de comenzar

  1. Verifica que recibas el mensaje de respuesta 403 Forbidden del proxy de Envoy. Por ejemplo:
    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. Habilita los registros de depuración:

    Asegúrate de haber habilitado los registros de depuración en el adaptador de Apigee para Envoy para capturar más detalles sobre el error. Si no es así, detén Apigee Adapter for Envoy y vuelve a iniciarlo, habilitando los registros de depuración con el siguiente comando:

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

Causa: El producto de API no está habilitado

Este error ocurrirá si el producto de API específico que usa el proxy de Envoy no está habilitado en el entorno específico en el que se invocan las llamadas a la API.

Diagnóstico

Sigue estos pasos para diagnosticar el problema:

  1. Habilita los registros de depuración como se explica en el paso 2 anterior.
  2. Verifica los registros del adaptador de Apigee para Envoy y comprueba que se muestre el siguiente mensaje en la sección Authorizing request:
    product: API_PRODUCT_NAME not found

    Ejemplo de registro de depuración:

    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

    En el ejemplo anterior, se muestra que no se encontró el producto de API ENVOY-PRODUCT-1 en el adaptador de Apigee para Envoy.

    Para obtener más información sobre el registro del adaptador de Apigee para Envoy, consulta Logging.

  3. Si ves este mensaje mientras autorizas la solicitud a la API, es muy probable que indique que el producto de API específico no está habilitado para un entorno específico en el que realizas las llamadas a la API.
  4. Sigue estos pasos para verificarlo:
    1. Accede a la IU de Edge.
    2. En la página Publicar > Productos de API, haz clic en el producto de API específico que usaste para configurar el adaptador de Apigee para Envoy.
    3. Verifica que el entorno específico en el que realizas las solicitudes a la API esté habilitado en el producto de API.
    4. Si el entorno específico no está habilitado en el producto de API, esa es la causa de este problema.
  5. Si el entorno específico ya está habilitado, ve a Causa: Falta la ruta de URI del servicio de destino en el producto de API.

Solución

Si el entorno específico no está habilitado en el producto de API, sigue estos pasos para resolver el problema:

  1. Accede a la IU de Edge.
  2. En la página Publicar > Productos de API, haz clic en el producto de API específico que usaste para configurar el adaptador de Apigee para Envoy.
  3. En la página Productos de API > Nombre del producto, haz clic en Editar.
  4. Selecciona la casilla de verificación del entorno pertinente para habilitar el entorno específico en el que deseas realizar solicitudes a la API.
  5. Haz clic en Guardar.

Causa: Falta la ruta del URI del servicio de destino en el producto de API

Este error se producirá si la ruta de URI del destino no se especifica en el producto de API específico que usa el proxy de Envoy.

Diagnóstico

Sigue estos pasos para diagnosticar el problema:

  1. Habilita los registros de depuración como se explica en el paso 2 anterior.
  2. Revisa los registros del adaptador de Apigee para Envoy y verifica que se muestre el siguiente mensaje para el producto de API específico asociado con un destino específico en la sección Authorizing request:

    no path: REQUEST_URI_PATH

    Ejemplo de registro de depuración:

    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)

    El resultado de la muestra muestra el siguiente mensaje:

    no path: /echo1

    Esto indica que no se encontró la ruta de acceso /echo1 en el producto de API ENVOY-PRODUCT-1.

  3. Si ves el mensaje no path: REQUEST_URI_PATH en los registros de depuración del adaptador de Apigee para Envoy, esa es la causa del problema. De lo contrario, consulta Causa: Falta el nombre de host en el producto de API.

Solución

Si el URI de solicitud específico no se agrega al producto de API para el destino específico, sigue estos pasos para resolver el problema:

  1. Accede a la IU de Edge.
  2. En la página Publicar > Productos de API, haz clic en el producto de API específico que usaste para configurar el adaptador de Apigee para Envoy.
  3. En la página Productos de API > Nombre del producto, haz clic en Editar.
  4. En el panel Recursos de API, agrega el URI de solicitud a la API al producto de API.
  5. Supervisa los registros del adaptador de Apigee para Envoy y espera hasta que este recupere el producto de API actualizado. Luego, envía otra solicitud a la API para verificar la corrección.

Causa: Falta el nombre de host en el producto de API

Este error ocurrirá si la combinación de nombre de host y puerto de destino no se agrega al producto de API específico que usa el proxy de Envoy.

Diagnóstico

Sigue estos pasos para diagnosticar el problema:

  1. Habilita los registros de depuración como se explica en el paso 2 anterior.
  2. Revisa los registros del adaptador de Apigee para Envoy y verifica que se muestre el siguiente mensaje para el producto de API específico asociado con un destino específico en la sección Authorizing request:

    no targets: HOSTNAME:PORT

    Ejemplo de registro de depuración:

    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)

    En el ejemplo anterior, se muestra que no se encontró la combinación de nombre de host y puerto httpbin1:8080 en el producto de API ENVOY-PRODUCT-1.

  3. Si los registros del adaptador de Apigee para Envoy contienen una entrada con el mensaje no targets: HOSTNAME:PORT durante la autorización de la solicitud, esta es la causa del problema. Si no es así, ve a Causa: Falta la clave de API en el encabezado de la solicitud.

Solución

Si la combinación de nombre de host y puerto de destino no se agrega al producto de API, sigue estos pasos para resolver el problema:

  1. Accede a la IU de Edge.
  2. En la página Publicar > Productos de API, haz clic en el producto de API específico que usaste para configurar el adaptador de Apigee para Envoy.
  3. En la página Productos de API > Nombre del producto, haz clic en Editar.
  4. En el panel Destinos del servicio remoto de Apigee, agrega el nombre de host y el puerto de destino, y haz clic en Guardar.

    Si no ves la sección Destinos del servicio remoto de Apigee en la IU, agrega un atributo personalizado al producto de API con el nombre apigee-remote-service-targets y agrega el valor HOSTNAME:PORT con la API de Edge. Por ejemplo:

    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. Una vez que se complete la tarea anterior, supervisa los registros del adaptador de Apigee para Envoy y espera hasta que el adaptador de Apigee para Envoy recupere el producto de API actualizado. Luego, envía otra solicitud a la API para verificar la corrección.

Causa: Falta la clave de API en el encabezado de la solicitud

Este error se producirá si no se pasa la clave de API como parte de los encabezados de la solicitud.

Diagnóstico

Sigue estos pasos para diagnosticar el problema:

  1. Habilita los registros de depuración como se explica en el paso 2 anterior.
  2. Revisa los registros del adaptador de Apigee para Envoy y verifica que veas el mensaje [missing authentication] en la sección Authenticate error.

    Ejemplo de registro de depuración:

    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

    El resultado de ejemplo que se muestra arriba tiene el mensaje [missing authentication]. Este mensaje indica que la clave de API no se pasó como parte del encabezado de la solicitud.

  3. Si los registros del adaptador de Apigee para Envoy contienen una entrada de registro con el mensaje [missing authentication] en la sección Authenticate error , esta es la causa del problema. Si no es así, ve a Causa: Clave de API no válida.

Solución

Si el error [missing authentication] se mostró en los registros del adaptador de Apigee para Envoy, realiza los siguientes pasos para resolver el problema:

  1. Comprueba si el cliente envió la clave de API con el encabezado HTTP x-api-key en la solicitud a la API. De lo contrario, solicita al cliente que envíe la clave de API en el encabezado HTTP x-api-key.
  2. Verifica el archivo de configuración del adaptador de Apigee para Envoy y comprueba que se haya cambiado el nombre del encabezado de la clave de API predeterminada x-api-key. Por ejemplo:
    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: apigee-remote-service-envoy
      namespace: apigee
    data:
      config.yaml: |
        global:
          tls:
            ...
        tenant:
          ...
        auth:
          target_header: api-key

    En el ejemplo anterior, se modificó el nombre del encabezado de la clave de API predeterminada a api-key. En este caso, debes pasar la clave de API como parte del encabezado api-key.

  3. Si se cambió el nombre predeterminado del encabezado de la clave de API, solicita al cliente que use el nombre actualizado del encabezado de la clave de API y que envíe otra solicitud a la API para verificar si se resuelve el problema.

Causa: Clave de API no válida

Este error se producirá si se pasa una clave de API no válida como parte del encabezado de la solicitud.

Diagnóstico

Sigue estos pasos para diagnosticar el problema:

  1. Habilita los registros de depuración como se explica en el paso 2 anterior.
  2. Revisa los registros del adaptador de Apigee para Envoy y verifica que veas el mensaje [permission denied] en la sección Authenticate error. Por lo general, se muestra después de que el adaptador recupera la clave de API, lo que se indica con el mensaje fetchToken fetching: API_KEY.

    Ejemplo de registro de depuración:

    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)

    En este ejemplo, la clave de API enviada en la solicitud a la API no era válida.

  3. Si los registros del adaptador de Apigee para Envoy contienen una entrada de registro con [permission denied] en la sección Authenticate error , significa que la clave de API que se pasó como parte de la solicitud no es válida y es la causa del problema. De lo contrario, consulta Causa: Apigee Adapter for Envoy no puede comunicarse con el proxy de API de servicio remoto.

Solución

Si se observa el mensaje [permission denied] en la sección Authenticate error de los registros del adaptador de Apigee para Envoy, realiza los siguientes pasos para resolver el problema:

  1. Comprueba la clave de API enviada en la solicitud a la API con el valor de la clave de API que se encuentra en la aplicación conectada al producto de API.
  2. Si la clave de API que usa el cliente no es válida, solicítale que envíe la clave de API válida.
  3. Si la clave de API que usa el cliente es válida y sigues viendo un error 403 de HTTP, comunícate con el equipo de asistencia de Apigee Edge para investigar más a fondo.

Causa: Apigee Adapter for Envoy no puede comunicarse con el proxy de API de servicio remoto

Este error ocurrirá si Apigee Adapter for Envoy no puede comunicarse con el proxy de API del servicio remoto si el host del servicio remoto configurado no es válido.

Diagnóstico

Sigue estos pasos para diagnosticar el problema:

  1. Habilita los registros de depuración como se explica en el paso 2 anterior.
  2. Revisa los registros del adaptador de Apigee para Envoy y verifica que veas el siguiente mensaje:

    Error retrieving products: REQUEST_URI: no such host

    Ejemplo de registro de depuración:

    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

    En este ejemplo, el adaptador de Apigee para Envoy no pudo comunicarse con el proxy de API de remote-service porque el nombre de host proporcionado en la URL del proxy de API del servidor remoto no es válido, como lo indica el error no such host .

  3. Si los registros del adaptador de Apigee para Envoy contienen una entrada de registro con el mensaje no such host, esta es la causa del problema. De lo contrario, consulta Causa: El proxy de Envoy no puede comunicarse con el adaptador de Apigee para Envoy.

Solución

Si los errores anteriores se muestran en los registros del adaptador de Apigee para Envoy, realiza los siguientes pasos para resolver el problema:

  1. Verifica el archivo de configuración de Apigee Adapter for Envoy y comprueba que la URL del proxy de API del servicio remoto proporcionada sea válida.

    De lo contrario, detén Apigee Adapter for Envoy, corrige la URL del proxy de API de servicio remoto en el archivo de configuración, inicia Apigee Adapter for Envoy, envía otra solicitud a la API y verifica la corrección.

    Configuración de muestra:

    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. Verifica que el proxy de API de remote-service esté implementado en el entorno de Edge pertinente. Si no es así, implementa el proxy de API de remote-service en el entorno de Edge pertinente y vuelve a intentarlo.
  3. Verifica la conectividad de red entre el adaptador de Apigee para Envoy y el extremo del proxy de API remote-service. Si se detectan problemas de conectividad de red, comunícate con tu equipo de redes y trata de resolver el problema.

Causa: El proxy de Envoy no puede comunicarse con Apigee Adapter for Envoy

Diagnóstico

Sigue estos pasos para diagnosticar el problema:

  1. Asegúrate de haber habilitado los registros de depuración en Envoy. De lo contrario, detén Envoy y vuelve a iniciarlo, habilitando los registros de depuración. Luego, envía otra solicitud a la API.

    Implementaciones independientes:

    envoy -c envoy-config.yaml -l debug

    Implementaciones basadas en Kubernetes o 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. Verifica los registros del adaptador de Apigee para Envoy y comprueba que haya una entrada de registro con el siguiente mensaje:
    connecting to APIGEE_ENVOY_ADAPTER_HOST:5000

    Luego, se sigue con lo siguiente:

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

    Ejemplo de registro de depuración:

    [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'

    En el ejemplo anterior, se muestra que Envoy no pudo comunicarse con el adaptador de Apigee para Envoy debido al motivo connection failure.

  3. El connection failure puede deberse a varios motivos. Analicemos cada una de las situaciones.

Situación 1: El proceso del adaptador no se está ejecutando

Si el proceso del adaptador de Apigee para Envoy no se está ejecutando, se puede producir este error.

  1. Ejecuta el siguiente comando para verificar que el proceso del adaptador de Apigee para Envoy esté en ejecución. Si el proceso del adaptador de Apigee para Envoy está en ejecución, el resultado del siguiente comando debería mostrarlo.
    ps -ef | grep apigee-remote-service-envoy
  2. Si no se está ejecutando, esa es la causa del problema.

Solución

  1. Si el proceso de Apigee Adapter for Envoy no se está ejecutando, inicia el Apigee Adapter for Envoy.
  2. Realiza otra solicitud a la API y verifica si se solucionó el problema.

Situación 2: El proceso del adaptador no escucha en el puerto específico

Si el proceso del adaptador de Apigee para Envoy no está escuchando en el puerto específico, se puede producir este error.

Si el proceso del adaptador de Apigee para Envoy se está ejecutando, verifica que haya un socket escuchando en el puerto 5000: APIGEE_ENVOY_ADAPTER_HOST:5000. Puedes ejecutar el comando netstat para verificarlo:

sudo netstat -lnp | grep 5000

Resultado de muestra:

sudo netstat -lnp | grep 5000

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

Si no hay un socket escuchando en el puerto 5000, ese podría ser el motivo del problema.

Solución

  1. Detén el adaptador de Apigee para Envoy y vuelve a iniciarlo.
  2. Realiza otra solicitud a la API y verifica si se solucionó el problema.

Situación 3: Conectividad de red entre Envoy y el adaptador de Apigee para Envoy

  1. Verifica la conectividad de red entre Envoy y el adaptador de Apigee para Envoy:
    ssh $ENVOY_HOST
    telnet $APIGEE_ENVOY_ADAPTER_HOST 5000

    Si Telnet pudo establecer una conexión TCP con el adaptador de Apigee para Envoy, se mostrará un resultado similar al siguiente:

    telnet $APIGEE_ENVOY_ADAPTER_HOST 5000
    
    Trying ::1...
    Connected to localhost.
    Escape character is '^]'.
  2. Si observas el error Connection timed out con telnet, significa que hay un problema de conectividad de red entre Envoy y el adaptador de Apigee para Envoy.

Solución

Si ves algún problema de conectividad de red entre Envoy y el adaptador de Apigee para Envoy, comunícate con tu equipo de redes y trata de resolver el problema.

Si el problema persiste, consulta Recopila información de diagnóstico.

Se debe recopilar información de diagnóstico

Si el problema persiste después de seguir las instrucciones anteriores, recopila la siguiente información de diagnóstico y, luego, comunícate con el equipo de asistencia de Apigee Edge:

  1. Producto de Apigee utilizado:

    Ejemplo: Apigee Edge Cloud, Apigee OPDK, Apigee Hybrid, Apigee X

  2. Organización y entorno de Apigee
  3. Definición del producto de API leída con la API de Edge:

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

    Referencia: APIs de Apigee Edge

  4. Inicia una sesión de seguimiento en el proxy de API de remote-service con la IU de Apigee Edge. Reproduce este problema y comparte el archivo en formato XML de la sesión de registro.

    Referencia: Usa la herramienta Trace | Apigee Edge

  5. Registros del adaptador de Apigee para Envoy (registros completos relacionados con el período determinado)

    Implementaciones independientes:

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

    Implementaciones basadas en Kubernetes o Istio:

    kubectl -n=apigee get pods
    kubectl -n=apigee logs APIGEE_REMOTE_SERVICE_ENVOY_POD_NAME > apigee-remote-service-envoy.log
  6. Una solicitud a la API enviada al proxy de Envoy con un comando curl (el resultado completo del comando curl):
    curl -v ENVOY_PROXY_ENDPOINT
  7. Una solicitud a la API enviada al servicio de destino con un comando curl (el resultado completo del comando curl):
    curl -v TARGET_SERVICE_ENDPOINT