Estás viendo la documentación de Apigee Edge.
Ir 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, comunícate con el equipo de asistencia de Apigee Edge.
Para obtener una lista de todas las notas de la versión de Apigee Edge, consulta las Notas de la versión de Apigee.
Nuevas funciones y mejoras
A continuación, se indican las nuevas funciones y mejoras de esta versión.
OpenLDAP: Instalación y actualización
OpenLDAP ahora es el único servidor LDAP compatible con Edge para las instalaciones nuevas y las actualizaciones.
Servicios de APIs
A continuación, se indican las nuevas funciones y mejoras en los servicios de la 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 actuar como 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 Uso de WebSockets en Apigee Edge para la nube privada.
Compatibilidad con proveedores de autenticación externos para la administración de APIs
Edge se integra con Active Directory y otros proveedores de autenticación externos o sistemas LDAP que contienen a los usuarios administradores de la API. Para obtener más información, consulta la guía Configuración de autenticación externa de Edge para nube privada.
Asociación de marcas en la IU de administración
Puedes agregar tu propio 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. Esto significaba que el usuario quedaba bloqueado a menos que cambiara su contraseña antes de que venciera. Sin embargo, también provocó que venciera la contraseña del administrador del sistema, por lo que el administrador del sistema no pudo acceder a Edge.
Cuando actualices a la versión 4.15.04.00, el valor predeterminado cambiará 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 de los administradores 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 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 Private Cloud.
Mensajes de error de la IU de administración
Se rediseñó la visualización de mensajes de error en la IU de administración para usar el espacio de pantalla de manera más eficiente.
Nuevas variables de falla de OAuthV2
La política de OAuthV2 establece estas nuevas variables relacionadas con errores:
- oauthV2.<policy-name>.failed: Se 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 vencido
Consulta http://apigee.com/docs/api-services/content/oauthv2-policy.
Creación de productos
Cuando creas un producto nuevo, ahora puedes 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, se reemplazó el botón Borrar por el botón Quitar. Esto ayuda a aclarar 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 Proxies de API, Productos, Desarrolladores y Apps de la IU de administración, hay nuevas opciones de filtrado disponibles para la búsqueda.
Herramienta de Offline Trace
La herramienta Offline Trace te permite ver y analizar las sesiones de seguimiento que se guardaron previamente. 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 de la herramienta de Offline Trace es similar a la herramienta de Trace "en vivo".
Para obtener más información, consulta Usa la herramienta Offline Trace.
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 perimetral
Esta versión incluye una serie de pequeñas mejoras en la usabilidad y la coherencia de la IU de administración de Edge.
Servicios de estadísticas
A continuación, se indican las nuevas funciones y mejoras de los servicios de análisis perimetral.
Seis meses de datos 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 Edge.
Variables agregadas a Analytics
Las siguientes variables nuevas se pasan a las estadísticas de Edge y son visibles 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 que no son del destino para las respuestas HTTP incorrectas (valor "0"). El valor es nulo para una respuesta HTTP correcta.
-
apigee.edge.execution.is_policy_error: Te permite identificar si falló una política (valor "1") o si no falló ninguna política en una respuesta HTTP sin éxito (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 falló 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. Los valores posibles son PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW y PROXY_RESP_FLOW.
Paneles
- Se movieron los gráficos de rendimiento de las APIs, los desarrolladores, los productos y las apps para desarrolladores. Antes se mostraban en la parte inferior de las páginas principales de estas entidades. Ahora, puedes acceder a los gráficos seleccionando la pestaña Analytics en la parte superior de cada página.
- Esta versión incluye un trabajo importante en los siguientes paneles existentes o nuevos:
- Panel de Apigee (revisado): Incluye tres gráficos de métricas: Tráfico de proxy, Participación de desarrolladores y Apps para desarrolladores. Cada gráfico proporciona una vista de "más detalles" que te permite desglosar cada métrica. Consulta el panel de Apigee.
- Rendimiento del proxy (nuevo): Muestra los patrones de tráfico del proxy de la API y los tiempos de procesamiento. Reemplaza el panel de rendimiento del proxy de API. Consulta Rendimiento del proxy de API.
- Composición del tráfico (revisado): Se revisó por completo el aspecto, la sensación y el contenido del panel. Mide la contribución relativa de tus principales APIs, apps, desarrolladores y productos a tu programa de API general. Consulta Composición del tráfico.
- Error Analysis (revisado): Se revisó por completo el aspecto y el contenido. Muestra las tasas de error para los proxies de API y los destinos. Consulta el panel de análisis de código de error.
-
Se cambió el nombre de los siguientes paneles existentes:
- Rendimiento del extremo cambió su nombre 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.
- Interacción con socios cambió su nombre a Interacción con desarrolladores: Te 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 indican 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 objetos de esquema de seguridad y esquemas centralizados estará disponible en una versión posterior.
Monetización
A continuación, se indican las nuevas funciones y mejoras en la monetización de Edge. Consulta también la sección "Problemas conocidos" para obtener más información sobre la monetización.
Manejo independiente de empresas y desarrolladores
Ahora, las empresas y los desarrolladores se manejan por separado, lo que permite agregar varias empresas a los desarrolladores y varios desarrolladores a las empresas con mayor flexibilidad. 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 | Description |
|---|---|
| OPDK-954 | 4.15.01 No se actualizó el esquema de Cassandra |
| MGMT-1986 | Error de IU al agregar un desarrollador |
| MGMT-1983 | La API de Get an OAuth 2.0 authorization code devuelve un estado incorrecto |
| MGMT-1962 | Error al acceder a la IU de administración con una contraseña segura Ya no se produce un error al acceder a la IU con ciertos caracteres especiales, como el signo de porcentaje. |
| 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 el TLD .acn |
| MGMT-1362 | El correo electrónico de restablecimiento de contraseña no funciona si la dirección de correo electrónico contiene "_". Se corrigió el problema de restablecimiento de contraseña en la Nube privada con direcciones de correo electrónico que contienen un guion bajo. |
| CORERT-613 | Errores de protocolo de enlace SSL debido a "unrecognized_name" |
| APIRT-1346 | OAuth2.0: Se devuelve 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 |
En la versión, no se incluyeron 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 la monetización:
|
| CORERT-318 | A veces, las llamadas a la API con cargas útiles grandes (cientos de KB) pueden dejar de responder. Para solucionar este problema, establece el siguiente valor de propiedad en tu archivo router.properties:HTTPServer.streaming.buffer.limit=0 (el parámetro de configuración predeterminado es 10) |