Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
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 Local” o “OPDK” ahora es “Apigee Edge for Private Cloud”.
Si tienes preguntas, ve a 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, se indican las nuevas funciones y mejoras de esta versión.
OpenLDAP: instalación y actualización
Ahora OpenLDAP es el único servidor LDAP compatible con Edge para instalaciones nuevas y de actualización.
Servicios de APIs
A continuación, se presentan nuevas funciones y mejoras de los servicios de API perimetral.
WebSockets
Para habilitar las comunicaciones web en tiempo real entre un cliente web y un servidor, Edge admite el protocolo WebSocket. Edge puede desempeñar el rol de cliente o servidor en las comunicaciones de WebSocket. Si deseas obtener información sobre la configuración y el uso de WebSockets de 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 API
Edge se integra en Active Directory y otros proveedores de autenticación externos o sistemas LDAP que contienen los usuarios administradores de tu API. Si deseas 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 asociar la marca de la IU de administración de Edge con tu propio logotipo personalizado, que aparece junto al logotipo de Apigee. Para obtener más información, consulta “Agrega 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 los proxies de la API de Node.js, puedes habilitar la función de registro de Node.js en la vista de seguimiento del editor de proxy de la API. Para habilitar la función, configura apigee.feature.disableNodeJSLogs="false" en el archivo apigee-base.conf o apigee-on aviso.conf en la instalación. Para obtener más información sobre el registro de Node.js, consulta Depuración y solución de problemas de proxies de Node.js.
Vencimiento de las contraseñas
En Edge 4.15.01.x, las contraseñas de Edge caducaban automáticamente después de 30 días. Eso significaba que se bloqueó el acceso del usuario, a menos que cambiara la contraseña antes de que venciera. Sin embargo, también provocó el vencimiento de la contraseña del administrador del sistema, por lo que el administrador del sistema estaba bloqueado para acceder a Edge.
Cuando actualizas a la versión 4.15.04.00, la configuración predeterminada cambia para que las contraseñas no venzan. Si es necesario, puedes configurar las contraseñas de Edge para que venzan mediante la secuencia de comandos /opt/apigee4/bin/apigee-enable-pwlockout.sh. Si deseas 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 de las funciones de solo lectura de administrador del sistema o de solo lectura a usuarios en 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 del mensaje de error en la IU de administración para usar el espacio en pantalla de manera más eficiente.
Nuevas variables de falla de OAuthV2
La política OAuthV2 establece estas variables relacionadas con fallas nuevas:
- oauthV2.<policy-name>.failed: se establece como verdadero si falló la política.
- oauthv2.<policy_name>.<fault_name>: El nombre de la falla. Por ejemplo, solicitud_válida
- oauthv2.<policy_name>.<fault_cause>: el motivo de la falla. Por ejemplo: Token vencido
Consulta http://apigee.com/docs/api-services/content/oauthv2-policy.
Creación de productos
Cuando crees 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 permite aclarar que, cuando quitas a un usuario de una organización, la cuenta de Apigee de ese usuario 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, Products, Developers y Apps de la IU de administración, hay nuevas opciones de filtrado disponibles para la búsqueda.
Herramienta de seguimiento sin conexión
La herramienta de seguimiento 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 de la herramienta de seguimiento sin conexión es similar a la herramienta de seguimiento "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 perimetral
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 presentan nuevas funciones y mejoras de los servicios de Edge Analytics.
Seis meses de datos disponibles
Cuando se generan informes de estadísticas con la IU o la API de administración, los datos anteriores a seis meses desde la fecha actual no son accesibles de forma predeterminada. Si quieres acceder a datos de más de seis meses, comunícate con el equipo de asistencia de Apigee.
Variables agregadas a Analytics
Las siguientes variables nuevas se pasan a Edge Analytics, visibles en la etapa AX de la ventana de seguimiento del proxy de la API.
- apigee.edge.execution.is_target_error: Te permite identificar si los errores de la API son errores del objetivo (valor “1”) o errores no objetivo de las respuestas HTTP fallidas (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 ninguna política falló en una respuesta HTTP incorrecta (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 hay errores en ninguna política.- apigee.edge.execution.fault_policy_name: El nombre de la política que falló
- apigee.edge.execution.fault_flow_name: El nombre del flujo de la política que falló (como PreFlow, PostFlow o un flujo definido por el usuario)
- apigee.edge.execution.fault_flow_state: 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 APIs, Desarrolladores, Productos y apps para desarrolladores. Antes se mostraban en la parte inferior de las páginas principales de estas entidades. Para acceder a los gráficos, selecciona la pestaña Estadísticas en la parte superior de cada página.
- Esta versión incluye un trabajo importante en estos paneles nuevos o existentes:
- Panel de Apigee (revisado): Incluye tres gráficos de métricas: Tráfico del proxy, Participación de los 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.
- Proxy Performance (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): Aspecto y contenido del panel completamente revisados. Mide la contribución relativa de las APIs, las apps, los desarrolladores y los productos principales a tu programa de API general. Consulta Composición del tráfico.
- Análisis de errores (revisado): Apariencia y contenido completamente revisados. Muestra las tasas de error de los proxies y los destinos de las APIs. Consulta el Panel de análisis del código de error.
-
Se cambió el nombre de estos paneles existentes:
- Se cambió el nombre de Endpoint Performance por Target Performance: Muestra patrones de tráfico y métricas de rendimiento para los objetivos de backend del proxy de la API. Consulta la sección 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 saber quién genera más tráfico de API y más errores. Consulta Participación de los desarrolladores.
Servicios para desarrolladores
A continuación, se presentan 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 retrocompatibilidad con Swagger 1.2. La compatibilidad con objetos de esquemas de seguridad y esquemas centralizados estará disponible en una versión posterior.
Monetización
Estas son 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.
Manejo separado de empresas y desarrolladores
Las empresas y los desarrolladores ahora se manejan por separado, lo que permite tener más flexibilidad a la hora de 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 de filtro cambió de “Desarrolladores” a “Empresas”.
Fallas corregidas
En esta versión, se corrigieron los siguientes errores.
| ID del problema | Descripción |
|---|---|
| OPDK-954 | 4.15.01 El esquema de Cassandra no se actualizó |
| MGMT-1986 | Se produce un error de IU al agregar el desarrollador |
| MGMT-1983 | La API de código de autorización de OAuth 2.0 muestra un estado incorrecto |
| MGMT-1962 | Error al acceder a la IU de administración con una contraseña segura Ya no falla el acceso a la IU con ciertos caracteres especiales, como el signo de porcentaje. |
| MGMT-1894 | La página de apps para desarrolladores nunca termina de cargarse para la columna de desarrollador. |
| MGMT-1872 | No se pueden descargar informes personalizados |
| MGMT-1777 | No se puede agregar a un usuario con una dirección de correo electrónico cuyo TLD sea .acn |
| MGMT-1362 | El correo electrónico 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 la nube privada con direcciones de correo electrónico que contienen un guion bajo. |
| CORERT-613 | Fallas del protocolo de enlace SSL debido a “unKnown_name” |
| APIRT-1346 | OAuth2.0: El valor de hash se muestra 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 | Perímetro para la nube privada |
|---|---|
Errores conocidos
Esta versión tiene los siguientes problemas conocidos.
| ID del problema | Descripción |
|---|---|
| No disponible |
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 de Cassandra o actualiza a fin de completar la instalación o actualización de la 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 tu archivo router.properties:HTTPServer.streaming.buffer.limit=0 (el valor predeterminado es 10) |