4.15.07.00: Notas de la versión de Apigee Edge para nube privada

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X.
información

El martes 8 de septiembre de 2015, lanzamos un lanzamiento de funciones importante de Apigee Edge para canales de Google Cloud.

Desde el lanzamiento trimestral anterior de Edge para la nube privada (4.15.04.00), los siguientes de versiones y se incluyen en esta versión trimestral:

¿A qué versiones de Edge puedes actualizar? 4.15.07.00

Según tu versión actual de Edge, puedes hacer lo siguiente:

  • Actualizar directamente a la versión 4.15.07.00
  • Actualización incremental, lo que significa que debes actualizar de tu versión actual a otra de Edge y, luego, actualízalo a la 4.15.07.00.

Para obtener más información, consulta A qué versiones de la nube privada puedes actualizar el perímetro 4.15.07.00.

Antes de actualizar de la versión 4.15.01.x o de una versión anterior

Antes de realizar la actualización, asegúrate de haber actualizado Cassandra SSTable en cada nodo de Cassandra:
  1. Verifica la versión de SSTable de Cassandra:
    1. Cambia el directorio a /<install-root>/apigee4/data/cassandra/data.
    2. Ejecuta un comando find,
      > buscar . -name *-ic-*
      Los resultados deberían mostrar un conjunto de archivos .db si ejecutas Cassandra 1.2 SSTable.
    3. Ejecuta este comando find:
      > buscar . -name *-hf-*
      Los resultados deben estar vacíos, lo que significa que ningún archivo .db está en formato hf. Si no ves ningún archivo en la hf, es decir, y puede actualizarse a la versión 4.15.07.00.

      El formato hf es para SSTables de Cassandra 1.0. Si tienes archivos *.db en formato hf, debes hacer lo siguiente: actualiza SSTable como se describe en el resto de este procedimiento.
  2. Si encuentras archivos *.db en formato hf, actualiza SSTable. ejecutando el siguiente comando en cada nodo de Cassandra hasta que actualices nodos:
    &gt; /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradestables −a
  3. Repite el paso 1 para comprobar que todos los archivos *.db estén en formato ic para Cassandra 1.2. versión.
  4. Repite los pasos del 1 al 3 en cada nodo de Cassandra en tu instalación de Edge.
  5. Actualiza a Edge 4.15.07.00.
  6. Después de la actualización 4.15.07.00, verifica los archivos *.db para asegurarte de que todos se hayan actualizado. al estable de estilo C* 2.0:
    &gt; cd /&lt;install-root&gt;/apigee4/data/cassandra/data
    &gt; buscar . -nombre *-jb-*

    Este comando debería mostrar un conjunto de archivos .db si ejecutas Cassandra 2.0.

Nuevas funciones y mejoras

A continuación, se detallan las nuevas funciones y mejoras de esta versión.

Instalación y actualización

Actualización y desinstalación de componentes selectivos

Las secuencias de comandos apigee-upgrade.sh y apigee-uninstall.sh ahora te permiten seleccionar los componentes de Edge para actualizarlas o desinstalarlas. Anteriormente, actualizaba o desinstalaba todos los componentes del nodo. (OPDK-1377 y OPDK-1175)

Reversión de la actualización

Si apigee-upgrade.sh falla durante una actualización, ahora puedes usar apigee-rollback.sh de comandos para revertir la actualización. Después de solucionar los problemas de actualización, puedes volver a intentarlo. (OPDK-1275)

Opciones abreviadas de la secuencia de comandos del instalador

Las secuencias de comandos de instalación ya no adoptan la forma larga de opciones, como --help. Ahora solo opciones de una sola letra, como -h. (OPDK-1356)

Instalación de SmartDocs

Al instalar SmartDocs con la secuencia de comandos setup-smartdocs.sh, se te indica que ingreses organización, entorno y host virtual, lo que garantiza que SmartDocs esté instalado ubicación esperada. Anteriormente, esos valores estaban codificados en la secuencia de comandos. (OPDK-1310)

Cómo ejecutar update-cass-pwd-in-config.sh sin mensajes

La secuencia de comandos update-cass-pwd-in-config.sh puede ejecutarse sin mensajes si estableces la Variables de entorno ENABLE_CASS_AUTH, CASS_USERNAME y CASS_PASSWORD. (OPDK-1309)

Plataforma Edge

A continuación, se detallan las funciones nuevas de la plataforma Edge que se incluyen en esta versión.

OpenJDK 1.7 compatible con la nube privada perimetral

Esta versión de Edge es compatible con Oracle JDK 1.7 y OpenJDK 7, y quitó la compatibilidad con JDK 1.6. (OPDK-1187)

Compatibilidad con SO

Apigee Edge para la nube privada amplió su compatibilidad con sistemas operativos para incluir Red Hat Enterprise Linux 6.6 y 7.0 (64 bits), CentOS 6.5, 6.6 y 7.0 (64 bits) y Oracle Linux 6.5

Cassandra 2.0.15 se incluye en OPDK 15.07

Esta versión instala Cassandra 2.0.15. Si estás actualizando para una versión anterior, tu una versión actualizada de Cassandra. (OPDK-1197)

Compatibilidad con SHA2 para el hash de token de OAuth

Para proteger mejor los tokens de OAuth en caso de una violación de la seguridad de la base de datos, Edge admite SHA2 para los tokens de OAuth (además de SHA1). Con nuevos niveles de puedes habilitar y configurar la codificación hash de tokens nuevos, además de conservar el hash heredado en cualquier token que existía antes de esta nueva función. Anteriormente, en Edge para la nube privada, un llamada hash.oauth.tokens.enabled en el archivo keymanagement.properties (en tu servidor de administración y procesadores de mensajes) habilitaron el hash SHA1 automático de los tokens de OAuth. Esta quedó obsoleta.

Si usaste la propiedad hash.oauth.tokens.enabled para habilitar el hash SHA1, el La secuencia de comandos de actualización de esta versión genera automáticamente las nuevas propiedades a nivel de la organización. Para que realices para verificar después de la actualización, realiza un GET como administrador del sistema con esta API: https://{host}:{port}/v1/o/{your_org}.

  • Para obtener información sobre cómo habilitar la codificación hash de tokens en tu organización con las nuevas propiedades, consulta "Hashing de tokens en la base de datos" consulta la sección Solicita tokens de acceso en el tema.
  • Para obtener información sobre la codificación hash masiva de tokens existentes, consulta Edge for Private Cloud Guía de operaciones. (APIRT-1389)

Estructura de directorios plana para archivos de registro

Puedes configurar Edge para que almacene archivos de registro en una estructura de directorios plana si configuras un nuevo La propiedad enable.flat.directory.structure como true en message-logging.properties . Para obtener más información, consulta la política de Registro de mensajes. (APIRT-1394)

Rendimiento de la caché del entorno

Para una mejor administración y uso de la caché en la memoria, la columna "Cantidad máxima de elementos en la memoria" de los recursos de caché del entorno dejó de estar disponible. El total de elementos presentes en todos los recursos de caché (incluida la caché predeterminada) dependen de la memoria total asignada al la caché. De forma predeterminada, la memoria total asignada al almacenamiento en caché en memoria en un procesador de mensajes determinado corresponde al 40% de la memoria total disponible, determinada por la configuración de la propiedad de la caché en tu mensaje. cache.properties del procesador. Los elementos se expulsarán de la memoria caché solo cuando haya memoria caché insuficiente o los elementos caducan.

Volver al comportamiento anterior de usar la "Cantidad máxima de elementos en la memoria" propiedad de administración de caché, establece la propiedad overrideMaxElementsInCacheResource=false en cache.properties. (APIRT-1140)


Servicios de APIs

A continuación, se incluyen las nuevas funciones de los servicios de API que se incluyen en esta versión.

Nuevo editor de proxy como predeterminado

El nuevo editor de proxy de API está habilitado de forma predeterminada en la IU de administración. El nuevo editor incluye muchas mejoras de usabilidad, como vistas más completas de los flujos condicionales y en la página de Resumen, toda la configuración en la página Desarrollo, la adición de flujos condicionales, extremos y políticas, vistas XML más completas en lugar de fragmentos pequeños que rastrea texto y nombres de archivo, y mucho más. (MGMT-2279)

Nueva política de eliminación de información de OAuth v2.0

Se muestra una nueva sección sobre cómo borrar información de OAuth v2.0 te permite borrar los tokens de acceso y la autorización de OAuth v2 en la nube. La política reemplaza la funcionalidad que antes proporcionaba la API de Management. Para ver más información, consulta Borrar Política de información de OAuthV2. (MGMT-2257)

Nueva política de información para borrar OAuth v1.0

Se muestra un nuevo mensaje de “Borrar información de OAuth v1.0” permite borrar tokens de solicitudes de OAuth v1.0, acceder tokens y códigos de verificador. La política reemplaza la funcionalidad proporcionada anteriormente por el Management de Google. Para obtener más información, consulta Borrar política de información de OAuth V1. (APIRT-1351)

Política de control de acceso

Mejoramos la política de control de acceso para permitir una evaluación más precisa de las direcciones IP para incluir direcciones IP en la lista de entidades permitidas o en las listas de bloqueo Encabezado HTTP X-FORWARDED-FOR.

Con la verificación de varias direcciones IP habilitada en el encabezado (comunícate con el equipo de asistencia para definir feature.enableMultipleXForwardCheckForACL), un El nuevo elemento <ValidateBasedOn> en la política te permite verificar la primera IP, la última o todas las IP del encabezado. Para obtener más información, consulta Política de control de acceso.

Entidades nuevas en la política de Entidad de acceso

La política de entidades de acceso proporciona acceso a las siguientes entidades nuevas: consumerkey-scopes, autorizacióncode, requesttoken y verificador. Para obtener más información, consulta la política de Entidad de acceso.

Política del Recopilador de estadísticas: Conversión automática del nombre de las estadísticas a minúsculas

Cuando se crea una colección de estadísticas personalizadas en el editor de proxy de API (página Desarrollar > Herramientas &gt; Custom Analytics Collection), la variable de recopilador (estadísticas) "Name" debe estar en minúscula. Si ingresas el nombre con letras mayúsculas, la herramienta convertirá automáticamente el nombre de la estadística. a minúsculas en la política Statistics Collector. (MGMT-740)

Eliminación de Trace clásico en el editor de proxy de API

La versión más reciente de la funcionalidad de Trace en el editor de proxy de API pasó de beta a disponibilidad general. Acceso al "seguimiento clásico" con la opción "Acceder a la versión clásica de Trace" ya no está disponible.

Acceso a la comunidad de Apigee desde el menú de ayuda de la IU de administración

Puedes acceder a la comunidad de Apigee desde el menú de ayuda de la IU de administración.

Mensajes de error en la IU de administración

A continuación, se detallan las mejoras para los mensajes de error en la IU de administración:

  • La IU de administración que se usa para agrupar y mostrar todos los mensajes de error en la IU para toda la de acceso a menos que los hayas descartado. Con esta actualización, se borran los mensajes de error automáticamente cuando sales de la página en la que se produjeron. (MGMT-2254)
  • La IU de administración ya no elimina los mensajes de error duplicados. (MGMT-2242)

Mejoras en el rendimiento y los errores de la IU

Se realizaron mejoras generales en diferentes áreas de la IU de administración, incluida la visualización de la página rendimiento y la limpieza de mensajes de error.

En la página Usuarios de la organización, en la IU de administración (Administrador > Usuarios de la organización), el rol ahora tienen hipervínculos, lo que te permite navegar rápidamente a las páginas de los roles. (MGMT-1055)

Nuevas variables de destino en el flujo de mensajes

Las nuevas variables en los flujos de mensajes proporcionan información de URL más completa para los extremos de destino y servidores de destino:

  • TargetEndpoint: request.url reemplaza a target.basepath.with.query.
  • TargetServer: loadbalancing.targetserver reemplaza a targetserver.name. Además, target.basepath solo se completa cuando el elemento <Path> se usa en la interfaz de HTTPTargetConnection elemento <LoadBalancer>.

Compatibilidad con la indicación de nombre del servidor (SNI)

Edge admite el uso de indicación de nombre del servidor en dirección sur (del procesador de mensajes al destino extremos). Si deseas usar SNI, comunícate con el equipo de Asistencia de Apigee.

Se requiere Java 1.7.

Con SNI, que es una extensión de TLS/SSL, se pueden entregar múltiples destinos HTTPS desde el mismo dirección IP y puerto sin requerir que todos esos destinos usen el mismo certificado.

No se requiere una configuración específica de Edge. Si tu entorno está configurado para dirección sur SNI (la nube perimetral es la opción predeterminada), admite Edge.

Edge extrae automáticamente el nombre de host de la URL de la solicitud y la agrega a la solicitud de protocolo de enlace SSL. Por ejemplo, si el host de destino es https://example.com/request/path, entonces Edge agrega la extensión server_name como se muestra. a continuación:

Para obtener más información sobre SNI, consulta http://en.wikipedia.org/wiki/Server_Name_Indication.

"Algoritmo de firma" en los detalles de los certificados SSL

Un nuevo "algoritmo de firma" se agregó a los detalles del certificado SSL, visible en de administración (Administrador > Certificados SSL) y la API de administración (Obtener detalles del certificado de un almacén de claves o un almacén de confianza). El campo muestra “sha1WithRSAEncryption” o “sha256WithRSAEncryption”, según el tipo de algoritmo de hash usado para generar la certificado.

Se muestran certificados SSL que están por vencer

La página Certificados SSL de la IU de administración (Administrador > Certificados SSL) indica cuándo Los certificados SSL vencen en un plazo de 10, 15, 30 o 90 días, según lo que selecciones en la nuevo campo desplegable de vencimiento.

Configuración de errores de protección contra amenazas

De forma predeterminada, Edge muestra un código de estado HTTP 500 Internal Server Error y un error ExecutionFailed si un mensaje no supera una política de protección contra amenazas de JSON o XML. Puedes cambiar ese comportamiento de error con una nueva propiedad a nivel de la organización. Al establecer la organización la propiedad features.isPolicyHttpStatusEnabled como true, se produce el siguiente comportamiento:

  • Solicitud: Con una política de protección contra amenazas adjunta a cualquier flujo de solicitud, los mensajes no válidos devolverá un código de estado 400, junto con el mensaje de error de la política correspondiente.
  • Respuesta: Con una política de protección contra amenazas adjunta a cualquier flujo de respuesta, los mensajes no válidos siguen mostrando un código de estado 500 y se arroja uno de los mensajes de error de política correspondientes (en lugar de solo ExecutionFailed).

Los clientes de Cloud deben comunicarse con el equipo de Asistencia de Apigee para configurar la propiedad de la organización. Esta función estará disponible para los clientes de la nube privada perimetral en la próxima Lanzamiento trimestral de la nube privada.

Esquemas actualizados para extremos, proxies y otras entidades

Se actualizaron los esquemas de referencia para entidades que no son de política, como TargetEndpoint, ProxyEndpoint, APIProxy y muchos más Consulta https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)


Servicios para desarrolladores

A continuación, se detallan las nuevas funciones de los Servicios para desarrolladores que se incluyen en esta versión.

Disponibilidad general de SmartDocs

SmartDocs está pasando de la versión beta a la de disponibilidad general. Actualizaciones y funciones nuevas incluyen:

  • Compatibilidad con Swagger 2.0, incluida la importación por archivo o URL, incluida la compatibilidad con objetos de seguridad con nombres personalizados.
  • Se realizaron mejoras en el diseño visual de las plantillas que generan SmartDocs.
  • Mejoras en la usabilidad y el flujo de trabajo en el Portal para desarrolladores, disponible en la sección Contenido &gt; Menú de SmartDocs en Drupal.
  • Lo que se conoce como "Token personalizado" la autenticación ahora se llama “Clave de API”.
  • "Seguridad" de la autenticación de objetos definidos a nivel de revisión.
  • Configuración de autenticación de clientes a nivel de plantilla. Ya no se restablecen las revisiones nuevas ninguna credencial de cliente de SmartDocs preconfigurada.

Para obtener más descripciones de las funciones, consulta este blog publicación.

Para ver la documentación de SmartDocs, consulte Cómo usar SmartDocs para documentar APIs.

Nombre de la app de desarrollador que se muestra en la IU de administración

Las apps de desarrolladores en Edge tienen un nombre interno que no cambia y un nombre visible que que puedes cambiar. En la página de una app de desarrollador en la IU de administración (Publicar > Apps de desarrollador > nombre de la aplicación), el "nombre" interno de la aplicación junto con el "Nombre visible", lo que hace que para identificar visualmente las apps por sus nombres internos con el objetivo de solucionar problemas y administrar API.


Servicios de estadísticas

A continuación, se detallan las nuevas funciones de los Servicios de Analytics que se incluyen en esta versión.

Límite de tiempo de datos conservado

Cuando se generan informes de estadísticas con la IU o API de administración, datos con más de seis meses de antigüedad a partir de la fecha actual no es accesible de forma predeterminada. Si quieres acceder a datos con más de seis comunícate con el equipo de asistencia de Apigee.

Se quitará la versión clásica de los informes personalizados de la IU de administración

La versión clásica opcional de los informes personalizados de estadísticas ya no está disponible en el de administración de identidades y accesos.

Rendimiento del widget de participación de los desarrolladores

Se mejoró el widget de embudo en el panel principal de estadísticas (sección Participación de los desarrolladores). para brindar un mejor rendimiento.


Monetización

A continuación, se detallan las nuevas funciones de monetización que se incluyen en esta versión.

Notificaciones por correo electrónico del plan de tarifas

Un nuevo tipo de notificación por correo electrónico del plan de tarifas te permite notificar a los desarrolladores cuando llegan a un de transacción o en dólares en los planes de tarifas por paquetes o por banda de volumen que compraron. Para más detalles, consulta Cómo configurar notificaciones con plantillas de notificaciones.

Sincronización de tarifas recurrentes y períodos de base de agregación

En un plan de tarifas, es posible que haya dos períodos de tiempo vigentes:

  • Período de tarifa recurrente, configurado en la pestaña Tarifas de un plan de tarifas, que determinaba el a los desarrolladores se les cobraba una tarifa recurrente.
  • El período de base de agregación, definido en la hoja de tarifas para planes por volumen o paquetes cuándo se restableció el uso del paquete para los desarrolladores.

Esos dos períodos ahora están sincronizados. Cuando se cobra una tarifa recurrente distinta de cero y una o una hoja de tarifas de paquete se incluye en un plan de tarifas, se usa el período de tarifa recurrente para ambos. Por ejemplo: si existe una tarifa mensual recurrente, los paquetes de hojas de tarifas también se restablecen mensualmente (de forma predeterminada, en a principios de mes).

Si no existe una tarifa recurrente, los paquetes se restablecen según la base de agregación definida en el hoja de tarifas. Por ejemplo, si un desarrollador comienza a usar una hoja de tarifas el día 19 del mes y La base de agregación es cada mes; luego, el uso de paquetes se restablece un mes después del día 19.

La base de agregación dejará de estar disponible y se quitará de la monetización en el futuro. lanzamiento. Para obtener más información, consulte Cómo especificar el plan de la hoja de tarifas más detallados.

Atributos personalizados en el resumen de informes de ingresos

Las políticas de registro de transacciones permiten capturar datos de atributos personalizados de de transacciones, y ahora puedes incluir esos atributos de transacción personalizados en el resumen de ingresos informes. Si agregas una propiedad MINT.SUMMARY_CUSTOM_ATTRIBUTES a tu organización, puedes indican qué atributos personalizados se agregan a las tablas de la base de datos para su uso en informes.

Los clientes de Apigee Edge para la nube privada pueden configurar la marca mediante la siguiente llamada a la API y Credenciales de administrador del sistema.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

Ten en cuenta que el array de atributos personalizados en la llamada a la API está codificado para URL.


Proceso de actualización de SmartDocs

Si ya usaste SmartDocs durante el período beta, las nuevas funciones y capacidades en la versión de disponibilidad general requieren que actualices SmartDocs en tu desarrollador portal.

Las páginas de SmartDocs que ya se hayan publicado en tu portal para desarrolladores seguirán pero debes seguir el proceso de actualización antes de editar o publicar cambios en o páginas nuevas.

Recuerde que, si bien puede renderizar y publicar SmartDocs dentro de su portal para desarrolladores, Los SmartDocs se generan a partir del modelo de API que se encuentra en la administración de API de Edge de Apigee. Servicios. Cualquier cambio que realices en un modelo de API en Edge será el mismo en todo tu Pantheon (similar a la forma en que existen los desarrolladores en los entornos de Pantheon).

Cómo actualizar de la versión beta de SmartDocs a la disponibilidad general

  1. Actualiza y prueba la versión 15.05.27 en tus entornos dev o test en Panteón.
  2. Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
    • Si has importado documentos Swagger o WADL, impórtalos nuevamente a una nueva a los cambios en el software.
    • Si has estado manteniendo tu modelo de API a través del módulo SmartDocs, expórtalo como JSON de SmartDocs y, luego, importarlos a su nuevo modelo mediante archivos adjuntos.
  3. Establece las propiedades de seguridad de la revisión de tu modelo. En la pestaña Contenido > SmartDocs > de modelos de AA, selecciona Configuración de seguridad.
  4. Comprueba cualquier autenticación preconfigurada en la página de configuración del modelo (Contenido > SmartDocs) haciendo clic en Configuración en el menú de operaciones .
  5. Actualiza las plantillas personalizadas para que usen la v6 de los recursos de CSS y JS y realiza cambios para reflejar cualquier nombre de objeto nuevo, como authSchemes y apiSchema. Para obtener información sobre la actualización de SmartDocs plantillas, consulta Cómo usar SmartDocs a APIs de documentos.
  6. Vuelve a renderizar y publica la revisión del modelo.
  7. Luego de validar la nueva documentación, actualiza tu portal de producción a la versión 15.05.27.

Si eres cliente de Edge Enterprise y tienes preguntas o inquietudes sobre la actualización envía un correo electrónico a marsh@apigee.com y cnovak@apigee.com. De lo contrario, utiliza la comunidad de Apigee para obtener respuesta.


Mejoras y cambios futuros de las funciones

En esta sección, se muestra una vista previa de las mejoras y los cambios futuros esperados en las funciones:

Cambiar a Comportamiento de la política de caché de respuestas

Próximamente en una versión futura (por determinar), el comportamiento predeterminado del &lt;ExcludeErrorResponse&gt; de la política de Caché de respuesta cambiará.

Comportamiento actual: el elemento <ExcludeErrorResponse> en la la política de caché de respuestas es falsa de forma predeterminada. Esto significa que, de forma predeterminada, las respuestas con cualquier los códigos de estado HTTP posibles (incluido el 3xx) se almacenan en caché a través de la política de Caché de respuesta.

Comportamiento futuro: El elemento <ExcludeErrorResponse> en la La política de Caché de respuesta se establecerá de forma predeterminada como verdadera. Esto significa que, de forma predeterminada, solo las respuestas con HTTP Los códigos de estado del 200 al 205 se almacenarán en caché. Para anular este comportamiento y almacenar en caché las respuestas de todas los códigos de estado, deberás establecer el elemento <ExcludeErrorResponse> a true de manera explícita.

Solución alternativa actual: Para la nube privada 4.15.07.00 y versiones anteriores, si si quieres almacenar en caché respuestas solamente con los códigos de estado 200 a 205, debes definir explícitamente la elemento <ExcludeErrorResponse> como true.


Fallas corregidas

En esta versión, se corrigieron los siguientes errores.

ID del problema Descripción
OPDK-1521 Problema de encriptación de contraseña
OPDK-1201 No se pueden restablecer los datos de la IU
OPDK-1112 La política de contraseñas de LDAP personalizada no se aplica al administrador de Apigee usuario
OPDK-1097 Excepción de espacio de claves durante la actualización de OPDK
OPDK-1068 Poder cambiar la contraseña de administrador si falla durante la instalación
OPDK-1053 Zookeeper se ejecuta como raíz
OPDK-967 Cuando configuras OpenLDAP para que se inicie automáticamente con set-autostart.sh, all-status.sh lo informa como muerto
OPDK-905 La producción de Smartdocs ya se registró en el grupo axgroup001
OPDK-899 Se produjo un error durante la integración
OPDK-847 El usuario creado durante la integración no recibe un correo electrónico para restablecerlo contraseña
OPDK-817 Las secuencias de comandos init.d arrojan un error
OPDK-815 La secuencia de comandos "ax-purge.sh" requiere que se borren definitivamente las tablas de muestreo.
MGMT-2246 La página Crear informe personalizado no se muestra correctamente en la administración. IU
MGMT-2235 En el caso de los certificados SSL que vencen, el tiempo relativo de vencimiento puede generar confusión redondeado
En el caso de los certificados SSL que vencen, la hora relativa de la fecha de vencimiento siempre se muestra en días en lugar de redondearse a meses, cuando el certificado vence en 90 días o menos.
MGMT-2193 Cómo cargar el ícono giratorio cuando se edita una API
MGMT-2173 La IU de Trace no admite URLs legales
La IU de Trace ahora permite enviar solicitudes con valores de parámetros de consulta que contienen parámetros de consulta.
MGMT-2162 Problema de compilación de JavaScript
MGMT-2124 Los permisos del rol del cliente se restablecen al guardar los permisos en IU
MGMT-2114 La IP de Syslog no válida en la política de MessageLogging debería arrojar un error adecuado implementación
MGMT-2067 Trace: Si la revisión del proxy de API se implementa en 2 entornos, selecciona Revisar y el entorno no funciona correctamente
MGMT-2061 Si olvidaste la contraseña, solo se deberían enviar correos electrónicos a los usuarios registrados
El mensaje "¿Olvidaste la contraseña?" vínculo en la página de acceso de la IU de administración solo envía los correos electrónicos a los usuarios registrados Usuarios de Apigee.
MGMT-2048 Los usuarios con un rol personalizado que limitan los permisos de implementación a un entorno pueden realizar implementaciones en otros
MGMT-2041 Quita el elemento FaultRules de la plantilla de archivos adjuntos predeterminada
El elemento FaultRules, que no se usa en las políticas ni en los pasos del proxy de la API, ya no es automáticamente cuando creas proxies de API o agregas políticas.
MGMT-2034 La recuperación de WSDL muestra un error: “Fetch WSDL Error: Error processing WSDL".
MGMT-1986 Se produjo un error en la IU al agregar el desarrollador
MGMT-1983 Obtener una API de código de autorización de OAuth 2.0 devuelve un estado incorrecto
MGMT-1962 Se produjo un error al acceder a la IU de administración con una contraseña segura
Ya no se podrá acceder a la IU con ciertos caracteres especiales, como el signo de porcentaje. falla.
MGMT-1947 Funciones poco intuitivas en la IU de administración
Si un usuario no tiene permiso para crear o editar una Política de registro de transacciones, la IU los botones para crear y editar una política de registro de transacciones ahora están inhabilitados.
MGMT-1899 Las rutas de acceso a los recursos se borran después de guardar la configuración del producto
Cuando se edita un producto de API, las rutas de acceso a los recursos del producto podrían borrarse si el usuario haz doble clic en el botón Guardar. Ya corregimos el problema.
MGMT-1894 La página Apps para desarrolladores nunca termina de cargarse para el desarrollador. Columna
MGMT-1882 El nuevo proxy de API de WSDL solo muestra los detalles del último parámetro
MGMT-1878 Si se implementan varias revisiones en un entorno, Trace solo muestra uno de ellos
MGMT-1872 No puedo descargar los informes personalizados
MGMT-1863 Los registros de Node.js no se pueden ver en la IU de administración
MGMT-1843 El proxy de API no se abre
MGMT-1833 El usuario administrador del sistema no debería tener la opción de cambiar la contraseña en la IU para OPDK
MGMT-1825 Errores de secuencia de comandos entre sitios (XSS)
MGMT-1824 Recupera el error WSDL mientras importas un archivo WSDL con extensión .xml
MGMT-1812 Agrega la validación de TargetEndpoint durante la importación
Al igual que ProxyEndpoint, el TargetEndpoint se validará para determinar si tiene el esquema adecuado y las expresiones que se usan en las condiciones durante la importación del proxy de API.
MGMT-1804 La API de Node.js envía archivos JSON no válidos en algunos casos
La pantalla de registros de Node.js que se usa para mostrar registros sin formato si los datos JSON no eran válidos caracteres. Esto se corrigió en esta versión, y la IU ahora muestra node.js con el formato correcto. los registros del sistema operativo.
MGMT-1802 URL de restablecimiento de contraseña #118
Si la IU de administración está detrás de un servidor de finalización SSL, la IU de administración ahora genera un correo electrónico de restablecimiento de contraseña con un vínculo a una URL HTTPS en lugar de una URL HTTP.
MGMT-1799 Solicitud de envío de vulnerabilidades de seguridad de la IU en Trace
MGMT-1777 No se puede agregar un usuario con una dirección de correo electrónico que tenga el TLD ".acn"
MGMT-1735 Desarrollo de la marca "Error al recuperar W"
A partir de este momento, quitamos la compatibilidad con el desarrollo de la marca personalizado en Edge OPDK. Si bien reconoces que esto podría decepcionar a pocos clientes que lo usaron, no es un que mejora directamente las capacidades de Edge en torno a la administración de API.
MGMT-1569 Problema al adjuntar el proxy de API al producto de API existente
Se corrigió la conexión de un proxy de API con un producto de API en la IU de administración cuando el proxy de API tenía un recurso para el símbolo "/" ruta de acceso.
MGMT-1563 El botón de envío de Trace permanece inhabilitado si se produce un error.
MGMT-1362 El correo electrónico de olvido de contraseña no funciona si la dirección de correo electrónico contiene “_”
Se solucionó el problema de restablecimiento de contraseña en OPDK con direcciones de correo electrónico que incluían guiones bajos.
MGMT-1345 La importación de WSDL con varios espacios de nombres genera un SOAP de compilación incorrecto Paso
MGMT-1193 Guardar el proxy como una revisión nueva cambia de forma inesperada la regla de enrutamiento
MGMT-1061 SmartDocs: no se muestra la descripción del parámetro de tipo de cuerpo en la definición de Swagger. en la IU del documento
MGMT-800 Creando un recurso con el nombre “default” genera una IU dañada
MGMT-787 Problema de usabilidad de la alerta de la IU
En la IU de administración, cuando hace clic en + Proxy de API y aparece el diálogo Nuevo proxy de API, puede puedes presionar Esc para cerrar el cuadro de diálogo.
MGMT-619 Activa la paginación en la página de la IU del proxy de API
MGMT-602 Vista de desarrollo de proxy de API: Agrega una política de Caché de respuesta cuando el extremo no tiene El flujo previo o posterior causa errores
MGMT-460 Si se cambia el nombre de la política, se genera un comportamiento erróneo, la política duplicada no se puede quitada
DEVRT-1644 La búsqueda de notificaciones por nombre provoca que se envíen correos electrónicos incorrectos.
DEVRT-1583 En la IU de monetización, se muestra "Future" insignia de un plan de tarifas actual
DEVRT-1546 Los límites del plan no funcionan
DEVRT-1511 Error mint.resource DoesNotExist para un desarrollador existente
CORERT-639 TCPSysLogSocket debe ser asíncrono
CORERT-613 Fallas del protocolo de enlace SSL debido a "unrecognized_name"
AXAPP-1728 Ignora las variables de monetización en Analytics
AXAPP-1708 Al parecer, la API de Analytics produce diferentes cifras para la misma estadística según cómo pregunto
AXAPP-1707 Mejora el rendimiento gratuito de las estadísticas de Pods
AXAPP-1690 "Error de API no válido" en los informes personalizados
AXAPP-1533 El mapa geográfico de Analytics muestra un error de llamada a la API no válida
AXAPP-1493 Estadísticas de rendimiento de la caché incorrectas
APIRT-1436 Crea una herramienta o una secuencia de comandos para generar un hash de los tokens sin codificación hash
APIRT-1425 continueOnError cuando se establece en "true" No tiene efecto en JavaReferencia. política
APIRT-1346 OAuth2.0: se muestra un valor hash en la respuesta del token de acceso cuando hash.oauth.tokens.enabled es verdadero
APIRT-1206 target_ip no se registra en la tabla de hechos para los números 503 y la mayoría de los 504
APIRT-1170 Falta un archivo de recursos y hace que MP no pueda cargar un entorno.
APIRT-1148 El GET de la variable {message.version} en ResponseFlow, para un objetivo de Node.js, arroja NPE
APIRT-1054 El registro de mensajes falla cuando se intenta acceder a un directorio diferente que no sea predeterminada
APIRT-387 Haz que OrganizationService se ejecute en el tipo "otros" en MP
APIRT-67 La política GenerateAccessToken de OAuth no establece la variable oauthV2.failed correctamente
APIRT-52 Informes personalizados: El código de estado de la respuesta de muchas APIs es nulo

Problemas conocidos

Esta versión tiene los siguientes problemas conocidos.

ID del problema Descripción
OPDK-1586

El portal de BaaS de la API no se inicia si la compatibilidad con IPv6 no está habilitada
La solución alternativa es marcar como comentario la siguiente línea de IPV6 en /&lt;install-dir&gt;/apigee4/conf/nginx/conf.d/loadbalancer.conf para ejecutar el portal de BaaS de la API o habilitar la compatibilidad con IPv6:

# listen [::]:8080;

OPDK-1785

Instala el componente de monetización en una versión actualizada de Edge instalada. entorno
Si actualizas una instalación de Edge a la 4.15.07.00 y aún no la usabas la monetización antes de la actualización, no puedes instalar la monetización el 15/4/07/00 versión de Edge de Edge.

La solución alternativa es configurar la versión de monetización correcta en el archivo apigee-env.sh antes de intentar instalar la función. Para obtener la versión de monetización en 4.15.07 (después de haber actualizado a Edge 4.15.07), ejecuta el siguiente comando:
> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 
De forma predeterminada, el valor de install-dir es /opt.
El valor de VER anterior se debe configurar en apigee-env.sh:
> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 
Si intentaste instalar la función de monetización sin realizar los pasos anteriores, la la instalación falla y es probable que haya un symlink inactivo en el directorio para compartir. Necesitas para quitar ese symlink:
> rm /install-dir/apigee4/share/monetization 
Después de quitar el symlink, sigue los pasos anteriores para configurar la versión de monetización. y, luego, vuelve a intentar la instalación de la monetización.
OPDK-1857 Versión hard-coded de Python 2.6 en bin/qpid-stat.sh y bin/qpid-config.sh

En CentOS y Red Hat 7.0, se pueden encontrar varias secuencias de comandos en bin/qpid-stat.sh y bin/qpid-config.sh están hard-coded para que usen la versión 2.6 de Python.

La solución para este problema es cambiar la línea que exporta PYTHONPATH en qpid-stat.sh y qpid-config.sh en el directorio apigee4/bin.

export PYTHONPATH="${QPID_DIR}/lib/python2.6/site-packages"

Para determinar la versión de Python en tu sistema, verifica la versión de Python en la /opt/apigee4/share/apache-qpid/lib. Lo más probable es que el directorio sea python2.7.

Debes actualizar la configuración de PYTHONPATH en qpid-stat.sh y qpid-config.sh con la ruta correcta. Por ejemplo:

export PYTHONPATH="${QPID_DIR}/lib/python2.7/site-packages"

DEVRT-1574 Saldo y uso incoherentes para desarrolladores con varias tarifas activas planes
Durante la monetización, si un desarrollador está activo en más de un plan de tarifas que incluye una llamada por API cargos, el uso del saldo monetario a veces puede ser inconsistente.
APIBAAS-1647 Después de acceder como administrador del sistema, la IU de BaaS muestra el mensaje "Error al obtener los roles". mensaje
Este mensaje de error aparece la primera vez que el administrador del sistema accede al sistema, después de actualizar de 4.15.01 a 4.15.07 Puedes ignorar este mensaje.
DEVRT-1834 Actualización de monetización a la versión 4.15.07
La secuencia de comandos apigee-upgrade.sh imprime el siguiente mensaje al final, en el cual se te indica ejecutar otra secuencia de comandos:
************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

Puedes ignorar este mensaje. Esa secuencia de comandos no es obligatoria y no se puede ejecutar.

DEVRT-1951 Falta la configuración de notificaciones de la instalación reciente de monetización
En una instalación nueva de Apigee Edge para la nube privada versión 4.15.07.00, se Faltan los siguientes parámetros de configuración para las notificaciones de monetización. Corresponden a a los tipos de notificaciones en Administrador > Página Notificaciones en la IU de administración.
mint.scheduler.${ORG_ID}.adhocnotify@@@management
mint.scheduler.${ORG_ID}.expiringrateplannotify@@@management
mint.scheduler.${ORG_ID}.newpkgnotify@@@management
mint.scheduler.${ORG_ID}.newproductnotify@@@management
mint.scheduler.${ORG_ID}.newrateplannotify@@@management
mint.scheduler.${ORG_ID}.tncacceptancenotify@@@management
Para solucionar este problema, sigue estos pasos. Necesitarás la dirección IP de tu Instancia de Cassandra. Para encontrarla, busca en <instalar-root>/apigee4/conf/cassandra/cassandra.yaml o &lt;installation-root&gt;/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Ejecute los siguientes comandos: Dejar la variable {ORG_ID} como está, pero reemplazarla <org_name>, < installation-root> y <cassandra_ip_address>.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/ui/mint-org-specific-ui-schedulers.txt > /tmp/mint-org-specific-ui-schedulers.txt
    
    <installation-root>/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-ui-schedulers.txt
    
  2. Reinicia el servidor de administración.
DEVRT-1952 Falta la notificación de actualización de la monetización de la versión 4.14.07.00 parámetros de configuración
En una actualización de Apigee Edge para la nube privada de la versión 4.14.07.00 a la 4.15.07.00, el faltan los siguientes parámetros de configuración para las notificaciones de monetización, los informes de monetización no funcionen correctamente.
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
Para solucionar este problema, sigue estos pasos. Necesitarás la dirección IP de tu Instancia de Cassandra. Para encontrarla, busca en <instalar-root>/apigee4/conf/cassandra/cassandra.yaml o &lt;installation-root&gt;/apigee4/conf/cassandra/cassandra-topology.properties.
  1. Ejecute los siguientes comandos: Dejar la variable {ORG_ID} como está, pero reemplazarla <org_name>, < installation-root> y <cassandra_ip_address>.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/system/mint-org-specific-system-schedulers.txt > /tmp/mint-org-specific-system-schedulers.txt
    
    <installation-root>/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-system-schedulers.txt
    
  2. Reinicia el servidor de administración.
OPDK-1878 No se puede establecer el nombre del Pod en una instalación de varios centros de datos
En la guía de instalación de Edge, se especifica que se deben configurar los nombres de Pods como “gateway-1” y “gateway-2” en la archivos de instalación silenciosos para una instalación de varios centros de datos. Sin embargo, cambiar el nombre del Pod impide que los routers y procesadores de mensajes se registren correctamente y accesible. Este problema también evita que la secuencia de comandos setup-org.sh pueda para buscar procesadores de mensajes disponibles.

La solución alternativa es establecer el nombre del Pod, mediante la propiedad MP_POD, como "gateway" en la un archivo de instalación silenciosa para ambos centros de datos.
OPDK-1886

El nodo no puede acceder a las direcciones IP locales, como 192.168.x.y
Aparece el error "connect EINVAL". cuando intenta acceder a una dirección IP local.
La solución alternativa es editar /&lt;install_dir&gt;/apigee4/conf/apigee/message-processor/nodejs.properties en los nodos de Message Processor para comentar la siguiente línea:

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

Luego, reinicia los nodos de Message Processor:

<install_dir>/apigge4/bin/apigee-service message-processor restart 
OPDK-1958 Cuando se realiza la actualización, todos los nodos requieren acceso al puerto 8080 en Management Servidor
En el entorno de ejecución, los siguientes componentes requieren acceso al puerto 8080 en el servidor de administración: Router, procesador de mensajes, IU, Postgres y Qpid. Sin embargo, durante la actualización, todos los nodos requieren acceso al puerto 8080 en el servidor de administración, incluidos Cassandra y Zookeeper nodos.
OPDK-1962 Se debe volver a configurar SSL para la API de Edge después de la actualización
Si configuraste la API de Edge para que use SSL antes de actualizar a la versión 4.15.07.00, entonces tendrás que reconfigurar SSL después de la actualización. Consulta la guía de operaciones de Edge para obtener para configurar SSL para la API de Edge.