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
Las siguientes son 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 instalaciones nuevas y actualizaciones.
Servicios de APIs
Las siguientes son las nuevas funciones y mejoras de los servicios de API de Edge.
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 Para obtener información sobre cómo configurar y usar WebSockets en Edge, consulta la guía Apigee 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 tus usuarios administrativos de la API. Para obtener más información, consulta la guía Configuración de la autenticación externa de Edge para la Nube privada.
Asociación de marcas en la IU de administración
Puedes asociar 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 proxies de API de Node.js, puedes habilitar la función de registro de Node.js en la vista de Trace del editor de proxy de API. Para habilitar la función, establece
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
Depura y soluciona 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 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 quedó bloqueado en Edge.
Cuando actualizas a 4.15.04.00, el valor predeterminado cambia para que las contraseñas no venzan. Si
es necesario, puedes configurar las contraseñas de Edge para que venzan con la
/opt/apigee4/bin/apigee-enable-pwlockout.sh secuencia de comandos. Para obtener más información, consulta el
Guía de operaciones de Apigee Edge para la Nube privada.
Limita el acceso de sysadmin a dominios de correo electrónico específicos
Puedes restringir la membresía en las funciones de sysadmin o sysadmin 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 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 fallas:
- oauthV2.<policy-name>.failed : Se establece en 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 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, el botón Borrar se reemplazó por un botón Quitar. Esto es para ayudar a 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 filtros 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 filtros disponibles para la búsqueda.
Herramienta de Trace 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 Usa la herramienta de Trace sin conexión.
Funciones 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 las funciones del usuario.
Mejoras en la IU de administración de Edge
Esta versión incluye varias mejoras pequeñas en la usabilidad y la coherencia de la IU de administración de Edge.
Servicios de estadísticas
Las siguientes son las nuevas funciones y mejoras de los servicios de estadísticas de Edge.
Se incluyen los datos de los seis meses anteriores
Cuando generas informes de estadísticas con la IU de administración o la API, 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 las estadísticas
Las siguientes variables nuevas se pasan a las estadísticas de Edge, que 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 respuestas HTTP sin éxito (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. 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. Antes, se mostraban en la parte inferior de las páginas principales de estas entidades. Ahora, puedes acceder a los gráficos si seleccionas la pestaña Estadísticas en la parte superior de cada página.
- Esta versión incluye un trabajo importante en estos paneles existentes o nuevos:
- Panel de Apigee (revisado): Incluye tres gráficos de métricas: Tráfico de proxy , Interacció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 Panel de Apigee.
- Rendimiento del proxy (nuevo): Muestra los patrones de tráfico del proxy de 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, contenido y diseño del panel completamente revisados. 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): Aspecto, contenido y diseño completamente revisados. Muestra las tasas de error de los destinos y proxies de API. Consulta Panel de análisis de código de error Dashboard.
-
Se cambió el nombre de estos paneles existentes:
- Rendimiento del extremo se cambió 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 rendimiento.
- Interacción de socios se cambió a Interacción de desarrolladores: Te indica 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 de desarrolladores.
Servicios para desarrolladores
Las siguientes son 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 retrocompatibilidad con Swagger 1.2. La compatibilidad con objetos de esquema de seguridad y esquemas centralizados estará disponible en una versión posterior.
Monetización
Las siguientes son 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.
Manejo por separado de empresas y desarrolladores
Ahora, las empresas y los desarrolladores se manejan por separado, lo que permite una 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 la IU cuando se agrega un desarrollador |
| MGMT-1983 | La API para obtener un 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 Apps para desarrolladores nunca termina de cargarse para 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 corrige el problema de restablecer la 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 muestra un valor 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 usa el instalador en la monetización instalación o actualizació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 | 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 (la configuración predeterminada es 10). |