Estás viendo la documentación de Apigee Edge.
Ve a la
documentación de Apigee X. info
El martes 19 de mayo de 2015, lanzamos una versión trimestral de Apigee Edge para la nube privada.
El nombre anterior del producto "Apigee Edge On-premises" o "OPDK" ahora es "Apigee Edge para la nube privada".
Si tienes preguntas, visita la Asistencia al cliente de Apigee.
Para obtener una lista de todas las notas de la versión de Apigee Edge, consulta Notas de la versión de Apigee.
Nuevas funciones y mejoras
A continuación, presentamos las nuevas funciones y mejoras de esta versión.
OpenLDAP: Instalación y actualización
OpenLDAP ahora es el único servidor LDAP que admite Edge para instalaciones nuevas y de actualización.
Servicios de APIs
A continuación, se incluyen las funciones y mejoras nuevas de los servicios de API de Edge.
WebSockets
Para habilitar las comunicaciones web en tiempo real entre un cliente y un servidor web, Edge admite el protocolo WebSocket. Edge puede desempeñar el rol de cliente o servidor en las comunicaciones de WebSocket. Para obtener información sobre cómo configurar y usar WebSockets en Edge, consulta la guía Apigee Edge para la nube privada con WebSockets.
Compatibilidad con proveedores de autenticación externos para la administración de APIs
Edge se integra en Active Directory y otros proveedores de autenticación externos o sistemas LDAP que contengan a los usuarios administrativos de tu API. Para obtener más información, consulta la guía Configuración de autenticación externa de Edge para la nube privada.
Asociación de marcas en la IU de administración
Puedes agregar tu logotipo personalizado a la IU de administración de Edge, que aparecerá junto al logotipo de Apigee. Para obtener más información, consulta "Cómo agregar un logotipo personalizado al menú de la IU de Apigee" en la Guía de operaciones de Apigee Edge para la nube privada.
Registros de Node.js en Trace
Cuando depuras proxies de API de Node.js, puedes habilitar la función de registro de Node.js en la vista de seguimiento del editor de proxy de API. Para habilitar la función, configura apigee.feature.disableNodeJSLogs="false" en el archivo apigee-base.conf o apigee-onpremise.conf de tu instalación. Para obtener más información sobre el registro de Node.js, consulta Cómo depurar y solucionar problemas de proxies de Node.js.
Vencimiento de las contraseñas
En Edge 4.15.01.x, las contraseñas de Edge vencían automáticamente después de 30 días. Eso significaba que un usuario se bloqueaba, a menos que cambiara su contraseña antes de que venciera. Sin embargo, también hizo que venciera la contraseña del administrador del sistema, por lo que este no pudo acceder a Edge.
Cuando actualizas a la versión 4.15.04.00, se aplican cambios predeterminados para que las contraseñas no venzan. Si es necesario, puedes configurar las contraseñas de Edge para que venzan con la secuencia de comandos /opt/apigee4/bin/apigee-enable-pwlockout.sh. Para obtener más información, consulta la Guía de operaciones de Apigee Edge para la nube privada.
Limita el acceso del administrador del sistema a dominios de correo electrónico específicos
Puedes restringir la membresía en los roles de administrador del sistema o de administrador del sistema de solo lectura a los usuarios de dominios de correo electrónico específicos. Para habilitar esta función, agrega los dominios permitidos al archivo apigee4/conf/apigee/management-server/security.properties, como se describe en la Guía de operaciones de Apigee Edge para la nube privada.
Mensajes de error de la IU de administración
Se rediseñó la visualización de los mensajes de error en la IU de administración para usar el espacio de la pantalla de manera más eficiente.
Nuevas variables de fallas de OAuthV2
La política de OAuthV2 establece estas nuevas variables relacionadas con fallas:
- oauthV2.<policy-name>.failed: Establece como verdadero si la política falló.
- oauthv2.<policy_name>.<fault_name>: Es el nombre de la falla. Por ejemplo, invalid_request
- oauthv2.<policy_name>.<fault_cause>: Es el motivo de la falla. Por ejemplo: Token Expired
Consulta http://apigee.com/docs/api-services/content/oauthv2-policy.
Creación de productos
Cuando crees un producto nuevo, ahora podrás especificar el nombre del producto además del nombre visible.
Consulta http://apigee.com/docs/developer-services/content/creating-api-products.
IU para quitar usuarios de una organización
En la página Usuarios de la organización de la IU, el botón Borrar se reemplazó por el botón Quitar. Esto es para dejar en claro que, cuando quitas a un usuario de una organización, su cuenta de Apigee permanece activa.
Consulta http://apigee.com/docs/api-services/content/managing-organization-users.
Opciones de filtrado en la IU de administración
En las páginas Proxy de API, Productos, Desarrolladores y Apps de la IU de administración, hay nuevas opciones de filtro disponibles para la búsqueda.
Herramienta de seguimiento sin conexión
La herramienta de Trace sin conexión te permite ver y analizar las sesiones de seguimiento que se guardaron anteriormente. Una sesión de seguimiento guardada es esencialmente una "grabación" de una sesión de seguimiento y puede ser útil para casos en los que se requieren soluciones de problemas y análisis adicionales. La IU para la herramienta de Trace sin conexión es similar a la herramienta de Trace “en vivo”.
Para obtener más información, consulta Cómo usar la herramienta de seguimiento sin conexión.
Roles del usuario que se muestran en la configuración del usuario
En la página Configuración del usuario de la IU de administración (nombre de usuario > Configuración del usuario), ahora se muestran los roles del usuario.
Mejoras en la IU de administración de Edge
Esta versión incluye una serie de pequeñas mejoras de usabilidad y coherencia en la IU de administración de Edge.
Servicios de estadísticas
A continuación, se incluyen las nuevas funciones y mejoras de los servicios de estadísticas de Edge.
Datos de seis meses disponibles
Cuando se generan informes de estadísticas con la IU o la API de administración, no se puede acceder a los datos con más de seis meses a partir de la fecha actual de forma predeterminada. Si deseas acceder a datos con más de seis meses, comunícate con el equipo de Asistencia de Apigee.
Variables agregadas a las estadísticas
Las siguientes variables nuevas se pasan a las estadísticas de Edge, que se pueden ver en la etapa AX de la ventana de seguimiento del proxy de API.
- apigee.edge.execution.is_target_error: Te permite identificar si los errores de la API son errores del destino (valor “1”) o errores no del destino para respuestas HTTP que no se realizaron correctamente (valor “0”). El valor es nulo para una respuesta HTTP correcta.
-
apigee.edge.execution.is_policy_error: Te permite identificar si una política falló (valor “1”) o si no falló en una respuesta HTTP no exitosa (valor “0”). El valor es nulo para una respuesta HTTP correcta.
Las siguientes variables relacionadas proporcionan detalles de la política que falló primero. Los valores son nulos si no se produjo un error en ninguna política.- apigee.edge.execution.fault_policy_name: Es el nombre de la política que falló.
- apigee.edge.execution.fault_flow_name: Es el nombre del flujo en la política que falló (como PreFlow, PostFlow o un flujo definido por el usuario).
- apigee.edge.execution.fault_flow_state: Es la ubicación en la que se adjuntó la política en el flujo. Valores posibles: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Paneles
- Se movieron los gráficos de rendimiento de las APIs, los desarrolladores, los productos y las apps para desarrolladores. Solían mostrarse en la parte inferior de las páginas principales de estas entidades. Ahora, para acceder a los gráficos, selecciona la pestaña Analytics en la parte superior de cada página.
- Esta versión incluye trabajos importantes en estos paneles nuevos o existentes:
- Panel de Apigee (revisado): Incluye tres gráficos de métricas: Tráfico de proxy, Participación de los desarrolladores y Apps de los desarrolladores. Cada gráfico proporciona una vista "Más detalles" que te permite desglosar cada métrica. Consulta el panel de Apigee.
- Rendimiento de proxy (nuevo): Muestra los patrones de tráfico del proxy de la API y los tiempos de procesamiento. Reemplaza el panel Rendimiento del proxy de API. Consulta Rendimiento del proxy de la API.
- Composición del tráfico (revisado): Se revisaron por completo el aspecto y el contenido del panel. Mide la contribución relativa de tus APIs, apps, desarrolladores y productos principales al programa de API general. Consulta Composición del tráfico.
- Análisis de errores (revisado): Se revisaron por completo el diseño y el contenido. Muestra las tasas de error para los destinos y proxies de API. Consulta el panel de análisis de código de error.
-
Se cambió el nombre de los siguientes paneles existentes:
- Se cambió el nombre de Rendimiento del extremo a Rendimiento objetivo: Muestra los patrones de tráfico y las métricas de rendimiento para los objetivos de backend del proxy de API. Consulta Rendimiento objetivo.
- Se cambió el nombre de Participación de socios a Participación de desarrolladores: Muestra cuáles de tus desarrolladores de apps registrados generan la mayor cantidad de tráfico de API. Para cada uno de tus desarrolladores, puedes averiguar quién genera la mayor cantidad de tráfico de API y la mayor cantidad de errores. Consulta Interacción con desarrolladores.
Servicios para desarrolladores
A continuación, se incluyen las nuevas funciones y mejoras de los servicios para desarrolladores de Edge.
Compatibilidad con Swagger 2.0 para SmartDocs
SmartDocs admite la importación de documentos de especificación de Swagger 2.0 y mantiene la compatibilidad con versiones anteriores de Swagger 1.2. La compatibilidad con los objetos de esquemas de seguridad y los esquemas centralizados estará disponible en una versión posterior.
Monetización
A continuación, se incluyen las nuevas funciones y mejoras de la monetización de Edge. Consulta también la sección "Problemas conocidos" para obtener más información sobre la monetización.
Control independiente de empresas y desarrolladores
Las empresas y los desarrolladores ahora se manejan por separado, lo que permite mayor flexibilidad para agregar varias empresas a los desarrolladores y varios desarrolladores a las empresas. La IU de administración ahora proporciona ventanas separadas para "Empresas" y "Desarrolladores" (a las que se puede acceder desde el menú "Publicar").
Consulta Administra empresas y desarrolladores.
En los informes de monetización, las empresas siguen siendo un filtro principal, aunque la etiqueta del filtro cambió de “Desarrolladores” a “Empresas”.
Fallas corregidas
En esta versión, se corrigieron los siguientes errores.
| ID del problema | Descripción |
|---|---|
| OPDK-954 | No se actualiza el esquema de Cassandra 4.15.01 |
| MGMT-1986 | Error de IU cuando se agrega un desarrollador |
| MGMT-1983 | La API de Get an OAuth 2.0 authorization code muestra un estado incorrecto |
| MGMT-1962 | Error de acceso a la IU de administración con una contraseña segura Ya no se produce un error cuando se accede a la IU con ciertos caracteres especiales, como el signo porcentual. |
| MGMT-1894 | La página Apps para desarrolladores nunca termina de cargarse en la columna del desarrollador |
| MGMT-1872 | No se pueden descargar informes personalizados |
| MGMT-1777 | No se puede agregar un usuario con una dirección de correo electrónico que tenga un TLD de .acn |
| MGMT-1362 | El correo electrónico de Olvidé mi contraseña no funciona si la dirección de correo electrónico contiene '_' Se corrigió el problema de restablecimiento de contraseña en Private Cloud con direcciones de correo electrónico que contienen un guión bajo. |
| CORERT-613 | Fallas en el protocolo de enlace SSL debido a "unrecognized_name" |
| APIRT-1346 | OAuth2.0: Se muestra un valor con hash en la respuesta del token de acceso cuando hash.oauth.tokens.enabled es verdadero |
Esta versión también contiene correcciones de errores de las siguientes versiones:
| Nube perimetral | Edge para la nube privada |
|---|---|
Problemas conocidos
Esta versión tiene los siguientes problemas conocidos.
| ID del problema | Descripción |
|---|---|
| N/A |
No se incluyeron en la versión dos secuencias de comandos de Cassandra, que el instalador usa en la instalación o actualización de monetización. Para solucionar este problema, ejecuta los siguientes comandos después de la instalación o actualización de Cassandra para completar la instalación o actualización de monetización:
|
| CORERT-318 | Las llamadas a la API con cargas útiles grandes (cientos de KB) a veces pueden bloquearse. Para solucionar este problema, establece el siguiente valor de propiedad en el archivo router.properties:HTTPServer.streaming.buffer.limit=0 (el parámetro de configuración predeterminado es 10). |