Estás viendo la documentación de Apigee Edge.
Ir a la documentación de
Apigee X. info
El miércoles 25 de enero de 2017, lanzamos una nueva versión de Apigee Edge para la nube privada.
Desde la versión anterior de Edge para nube privada, se produjeron las siguientes versiones, que se incluyen en esta versión:
- Cloud: 16.08.24.01 (IU), 16.10.05 (IU), 16.09.21, 16.09.21_9, 16.10.26 (IU)
Consulta Acerca de la numeración de versiones para comprender cómo puedes determinar si se incluye una versión de nube específica en tu versión de Edge para la nube privada.
Resumen de la versión
Esta versión incluye varias funciones destacadas que te ayudan a controlar y proteger mejor tus APIs.
Los flujos compartidos y los hooks de flujo te permiten crear un conjunto reutilizable de políticas y comportamientos en varios proxies de API.
Los mapas de pares clave-valor (KVM), que ya eran una función de Edge para la persistencia a largo plazo de pares clave-valor, ahora se pueden encriptar para una mayor seguridad de los datos.
Para tener un control más flexible sobre el acceso de los desarrolladores a tus APIs, la IU de administración de Edge proporciona más opciones para crear y administrar claves y secretos de API (credenciales), revocar apps de desarrolladores y desactivar desarrolladores. Estas mejoras te permiten implementar con mayor facilidad estrategias, como la rotación de claves de API, y te permiten inhabilitar varias claves de API revocando una app de desarrollador (todas sus claves se inhabilitan) o desactivando un desarrollador (todas las apps y claves del desarrollador se inhabilitan).
En cuanto a las bajas, se retiró la función Límites de monetización.
En el resto de este tema, se incluyen detalles sobre todas las funciones nuevas, las actualizaciones y las correcciones de errores que se incluyen en la versión.
Bajas y retiros
Las siguientes funciones dejaron de estar disponibles o se retiraron en esta versión. Consulta la política de baja de Edge para obtener más información.
Retirado: Límites de monetización (IU de Cloud 16.10.26)
Se quitó la función Límites de monetización de la IU de administración (Administrador > Límites). Consulta el aviso de baja para obtener más detalles, incluido qué usar en su lugar: http://docs.apigee.com/monetization/content/limit-feature-deprecation-notice. (DEVRT-3259)
Se quitó la compatibilidad con la versión 6.5 de RedHat/CentOS.
Si actualmente usas la versión 6.5 de RedHat/CentOS, debes actualizar tu sistema operativo a la versión 6.6 o posterior antes de actualizar a Edge 4.17.01.
Nuevas funciones y actualizaciones
A continuación, se indican las nuevas funciones y mejoras de esta versión. Además de las siguientes mejoras, esta versión también contiene varias mejoras de usabilidad, rendimiento, seguridad y estabilidad.
Para obtener más detalles e instrucciones, consulta la documentación de Edge para nube privada.
Nube privada
Ahora se puede mostrar un banner de consentimiento en la IU de Edge
Puedes mostrar un banner de consentimiento cuando un usuario accede por primera vez a la IU de Edge. El banner de consentimiento muestra texto con formato HTML y un botón que el usuario selecciona para continuar a la pantalla de acceso. Consulta Habilita el banner de consentimiento para obtener más información.
La API de BaaS admite varios centros de datos
Ahora puedes instalar API BaaS en varios centros de datos. Consulta Instalación de varios centros de datos para API BaaS para obtener más información.
Parámetros de configuración de la instalación de BaaS de la API nueva
Se agregaron dos parámetros de configuración nuevos al archivo de configuración de la API de BaaS:
- BAAS_CASS_DC_LIST: Especifica los nombres de las regiones de los centros de datos de BaaS. Para un solo centro de datos, especifica el mismo valor que BAAS_CASS_LOCALDC.
- BAAS_CLUSTER_SEEDS: Especifica los nodos de la pila de BaaS que se usan para definir las semillas del clúster de BaaS.
Consulta Actualiza Apigee Edge 4.16.09 a 4.17.01 para obtener más información.
Ya no se ejecuta la opción "deploy" con el comando apigee-service para API BaaS
La opción deploy del comando apigee-service ya no es compatible con la pila y el portal de BaaS de API. En su lugar, usa las opciones configure y restart. Consulta Instalación de BaaS de la API para obtener más información.
Nuevo requisito de puerto para BaaS de API
Todos los nodos de la pila de BaaS ahora deben abrir el puerto 2551 para el acceso desde todos los demás nodos de la pila. Si tienes varios centros de datos de BaaS, se debe poder acceder al puerto desde todos los nodos de Stack en todos los centros de datos.
Consulta Instalación de API BaaS y Requisitos de instalación para obtener más información.
El portal de Servicios para desarrolladores ahora usa Postgres como base de datos y Nginx como servidor web
Para todas las instalaciones nuevas, el portal usa Postgres como su base de datos en lugar de MySQL y MariaDB. Los clientes que actualicen a la versión 4.17.01 desde una versión anterior seguirán usando MySQL o MariaDB.
Las instalaciones nuevas para la versión 4.17.01 también instalan Nginx como el servidor web. Los clientes que actualicen a la versión 4.17.01 desde una versión anterior seguirán usando Apache.
El portal de Servicios para desarrolladores ya no habilita SmartDocs de forma predeterminada
Debes habilitar SmartDocs en el portal. Para obtener más información sobre SmartDocs, consulta Usa SmartDocs para documentar APIs.
El portal de Servicios para desarrolladores ahora se instala desde RPM
La versión 4.17.01 del portal de servicios para desarrolladores se instala desde RPM con el mismo repositorio y las mismas herramientas que Edge y API BaaS. Consulta Instalación del portal de Servicios para desarrolladores para obtener más información.
La instalación basada en RPM y el actualizador basado en .tar usan componentes diferentes:
|
Instalación basada en RPM |
Instalación basada en .tar |
|
|---|---|---|
|
Servidor web |
Nginx |
Apache |
|
Raíz web |
/opt/apigee/apigee-drupal |
/var/www/html |
|
Puerto |
8079 |
80 |
|
Base de datos |
PostgreSQL |
MySQL |
|
PHP |
php-fpm (FastCGI) |
mod_php (en proceso con Apache) |
Se actualizó Qpid a la versión 1.35
Esta versión incluye la versión 1.35 de Qpid.
Se actualizó Cassandra a la versión 2.1.16.
Esta versión incluye la versión 2.1.16 de Cassandra.
Play se actualizó a la versión 2.4
Esta versión incluye el framework de IU de Play 2.4.
Se agregó compatibilidad con la versión 7.3 de RedHat/CentOS
Edge ahora es compatible con RedHat/CentOS versión 7.3.
Actualizaciones del panel de supervisión de la versión beta
La versión beta del panel de supervisión de Edge se actualizó a lo siguiente:
- Incluye paneles nuevos para Cassandra, Zookeeper, OpenLDAP, Postgres y Qpid.
- Se actualizó la versión de Influx en 4.16.09 de 0.11 a 1.0.2.
- Se agregaron varias correcciones de estabilidad.
Consulta Descripción general de la versión beta del panel de Monitoring de Apigee para obtener más información.
Ahora se puede establecer la contraseña de Postgres en el archivo de configuración de la instalación
Usa la propiedad PG_PWD para establecer la contraseña de Postgres en el archivo de configuración de la instalación. Consulta la Referencia del archivo de configuración de Edge para obtener más información.
Habilita el repositorio de EPEL
Debes habilitar los paquetes adicionales para Enterprise Linux (o EPEL) para instalar o actualizar Edge. Consulta los requisitos de instalación para obtener más información.
El comando que uses dependerá de tu versión de RedHat o CentOS:
- Para RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm - Para RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm
Inhabilita la búsqueda de DNS en IPv6 cuando uses NSCD (daemon de almacenamiento en caché del servicio de nombres)
Si instalaste y habilitaste NSCD (daemon de almacenamiento en caché del servicio de nombres), los Message Processors realizan dos búsquedas de DNS: una para IPv4 y otra para IPv6. Debes inhabilitar la búsqueda de DNS en IPv6 cuando uses NSCD. Consulta los requisitos de instalación para obtener más información.
Para inhabilitar la búsqueda de DNS en IPv6, haz lo siguiente:
- En cada nodo de Message Processor, edita /etc/nscd.conf.
- Establece la siguiente propiedad:
enable-cache hosts no
Servicios de APIs
Flujos compartidos y hooks de flujo para poner en funcionamiento proxies de API (Cloud 16.09.21)
Una nueva función de "Flujos compartidos" te permite poner en funcionamiento la funcionalidad en los proxies de API. Si combinas políticas y recursos condicionales en un flujo compartido, puedes hacer referencia a él desde cualquier proxy de API para ejecutar una lógica reutilizable de fuente única. Por ejemplo, un flujo compartido puede verificar la clave de API, proteger contra detenciones de aumentos de tráfico y registrar datos.
Define los flujos compartidos en la IU de administración (APIs > Flujos compartidos) y, luego, haz referencia a ellos de dos maneras diferentes:
- Con una nueva política de texto destacado de flujo en un proxy de API
o -
En un artefacto nuevo llamado hooks de flujo, que se encuentran en las siguientes ubicaciones:
Estos puntos de conexión te permiten ejecutar la lógica operativa antes o después de los puntos de flujo principales del proxy individual. Asigna flujos compartidos a estas ubicaciones de hook de flujo en la IU de administración (APIs > Configuración del entorno > Hooks de flujo).
- Solicitud: Antes del PreFlow de ProxyEndpoint, después del PostFlow de TargetEndpoint
- Respuesta: Antes del PreFlow de TargetEndpoint, después del PostFlow de ProxyEndpoint
Para obtener más información, consulta Flujos compartidos reutilizables y Adjunta un flujo compartido con un hook de flujo.
Mapas de pares clave-valor encriptados (Cloud 16.09.21)
Puedes crear mapas de pares clave-valor (KVM) encriptados para almacenar información sensible, como credenciales o datos de PII o HIPAA. Esta función es diferente del almacén seguro de Edge existente (vault) y está diseñada para reemplazarlo, ya que solo se puede acceder a los valores de vault con Node.js (además de la API de administración). Puedes acceder a los valores de KVM encriptados con Node.js o la política de operaciones de mapa de pares clave-valor.
Crea KVM encriptados
- Usa las APIs de administración de KVM existentes. Cuando incluyes
“encrypted”: “true”en la definición de la carga útil cuando creas un KVM, Edge genera una clave de encriptación que tiene el mismo alcance que el KVM y encripta el KVM con esa clave. - No puedes usar la política de operaciones de mapas de pares clave-valor para crear un KVM encriptado. Debes crear un KVM encriptado con las APIs de administración de KVM antes de usarlo en la política.
- No puedes encriptar un KVM existente sin encriptar.
Usa KVM encriptados
- Usa la política de operaciones de mapa de clave-valor para obtener y actualizar los valores de KVM encriptados.
- Cuando obtengas un valor de clave encriptado, agrega el prefijo "private." a la variable para que contenga el valor. Por ejemplo:
<Get assignTo="private.secretVar">. Esa variableprivate.secretVarcontiene el valor desencriptado. - Cuando actualizas un valor con la política, no necesitas hacer nada especial. El valor se encriptará automáticamente en los KVM encriptados.
- También puedes acceder al valor desencriptado con el módulo apigee-access en el código de Node.js. Usa
la función
getKeyValueMap()para recuperar un KVM según el nombre y el alcance. Hay dos funciones disponibles en el objeto que se muestra:getKeys(callback)para obtener un array de nombres de claves yget(key, callback)para obtener el valor de una clave en particular. Por ejemplo, con el siguiente comando, se obtiene un KVM con alcance deapiproxyllamadoVerySecureKVMy se recupera el valor encriptado dekey1:var apigee = require('apigee-access'); var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy'); encryptedKVM.get('key1', function(err, secretValue) { // use the secret value here });
Para obtener más información, consulta Trabaja con mapas de pares clave-valor y Accede a mapas de pares clave-valor en Node.js.
(APIRT-1197)
Crea mapas de pares clave-valor encriptados en la IU (IU 16.10.26)
Cuando creas un mapa de pares clave-valor (KVM) con alcance de entorno en la IU de administración (APIs > Configuración del entorno > Mapas de pares clave-valor), una nueva casilla de verificación Encriptado te permite crear una KVM encriptada. Después de agregar claves al KVM, los valores encriptados aparecen en la IU de administración como asteriscos (*****). Agrega claves y valores a un KVM encriptado exactamente como lo haces para los KVM no encriptados. La compatibilidad completa con el backend para las KVM encriptadas estuvo disponible en la versión de la nube 160921. (EDGEUI-764)
Inclusión de URLs de especificaciones de OpenAPI en los metadatos del proxy de API (Cloud 16.09.21)
Cuando creas un proxy de API basado en una especificación de OpenAPI, la ubicación de la especificación de OpenAPI se almacena en los metadatos del proxy de API. Por ejemplo, si usas la API de administración para obtener los detalles de una revisión de proxy, los metadatos incluyen la ruta de acceso a la especificación de OpenAPI en el siguiente formato:
"spec" :
"https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml"
Esta mejora admite la versión de nueva generación de Edge, que vincula las especificaciones de OpenAPI con los proxies de API, los productos de API y los documentos de referencia de la API en el nuevo portal para desarrolladores. (MGMT-2913)
Generación de especificaciones de OpenAPI para proxies de SOAP (IU de Cloud 16.10.05)
Cuando creas un proxy de "REST a SOAP a REST" basado en un WSDL, Edge genera automáticamente una
especificación de OpenAPI alojada basada en los recursos del proxy. Puedes acceder a la especificación en
http(s)://[edge_domain]/[proxy_base_path]/openapi.json. Sin embargo, la conversión no siempre es precisa, ya que no todas las reglas de un esquema XML se pueden representar en una especificación de OpenAPI. (EDGEUI-718)
WSDL alojado en Edge para proxies de SOAP de transferencia (IU de Cloud 16.10.05)
Cuando creas un proxy de "SOAP de transferencia" basado en un WSDL, Edge aloja el WSDL y crea un
flujo en el proxy para que puedas acceder a él. Puedes acceder al WSDL alojado en
http(s)://[edge_domain]/[proxy_base_path]?wsdl, que es la URL del extremo de servicio nuevo
para los clientes que llaman al servicio SOAP a través del proxy. (EDGEUI-718)
Nuevo WSDL de cotización de acciones de muestra en el asistente de proxy de API (Cloud 16.08.24.01)
Cuando creas una API de servicio de SOAP con el asistente de proxy de API, hay un WSDL de cotización de acciones de reemplazo disponible en los ejemplos: https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL. (EDGEUI-655)
Servicios para desarrolladores
Mejoras en la administración de apps para desarrolladores en la IU (IU de Cloud 16.10.05)
La administración de apps para desarrolladores en la IU de Edge se volvió más potente con una serie de mejoras:
- Puedes revocar y aprobar apps (en el modo de edición) en un nuevo campo "Estado de la app". En el modo de vista, el campo también muestra el estado actual de la app. Si se revoca una app, ninguna de sus claves de API es válida para las llamadas a la API. Las claves en sí no se revocan y vuelven a estar disponibles para su uso si se vuelve a aprobar al desarrollador. La etiqueta "Aprobada" para las claves de API se muestra en texto tachado mientras una app está en estado revocado.
- Las fechas de vencimiento de las claves de API ahora se muestran en la página de detalles de la app para desarrolladores, y las claves se organizan por fechas de vencimiento en una sección "Credenciales". Por ejemplo, una clave sin vencimiento se muestra en un grupo con sus productos de API asociados, y una clave que vence en 90 días se muestra en otro grupo con sus productos asociados. No puedes cambiar el vencimiento de una credencial existente.
- Con un nuevo botón para agregar credenciales en el modo de edición de la app para desarrolladores, puedes generar claves de API con
fechas o tiempos de vencimiento específicos (o sin vencimiento). A medida que creas una credencial (o después),
puedes agregarle productos de API.
Esta funcionalidad reemplaza el botón "Regenerar clave" en la página de detalles de la app para desarrolladores. Se quitó ese botón.
Estas mejoras agregan funciones en la IU que ya estaban disponibles en la API de administración. (EDGEUI-104)
Activa o desactiva el desarrollador de apps en la IU (IU de Cloud 16.10.05)
Puedes cambiar el estado de un desarrollador de apps entre activo e inactivo en la IU de Edge (página de detalles del desarrollador, modo de edición, botón Activar/Desactivar). Cuando un desarrollador está inactivo, ninguna de las claves de API de su app de desarrollador ni los tokens de OAuth generados con esas claves son válidos en las llamadas a los proxies de API. (EDGEUI-304)
Indicadores de desarrollador inactivo en la IU (IU 16.10.26)
Cuando un desarrollador de apps se establece como "Inactivo", las apps y las credenciales del desarrollador ya no son válidas, aunque permanezcan en el estado "Aprobado". Ahora, cuando se ven las apps y las credenciales de un desarrollador inactivo en la IU de administración, la etiqueta de estado "Aprobado" en las apps y las credenciales se muestra en texto tachado, y un cuadro de información sobre la etiqueta indica que el desarrollador está inactivo. Si se restablece el estado "Activo" de la desarrolladora, sus apps y credenciales aprobadas volverán a ser válidas, y se quitará el texto tachado de la etiqueta "Aprobado". (EDGEUI-728)
Servicios de estadísticas
Se cambió el nombre del panel "Análisis de códigos de errores" (IU 16.10.26)
Se cambió el nombre del panel "Análisis de errores" a "Análisis de códigos de errores". El panel incluye llamadas a la API con códigos de estado HTTP 4xx y 5xx. (EDGEUI-738)
Datos de TPS en los paneles de proxy (IU 16.10.26)
Se agregaron los datos de las transacciones promedio por segundo ("TPS promedio") al panel principal de tráfico del proxy. Además, cuando colocas el cursor sobre los datos individuales en los gráficos de tráfico y rendimiento del proxy, se muestra el TPS para ese intervalo de tiempo en la información sobre la herramienta. (EDGEUI-668)
Visualización de errores de Analytics (IU de la versión 16.10.26)
Cuando un panel de estadísticas recibía un error 500, la IU de administración mostraba "Se agotó el tiempo de espera del informe", independientemente del error. Para proporcionar mejores capacidades de solución de problemas, la IU ahora muestra el error real. (EDGEUI-753)
Correcciones de errores
En esta versión, se corrigieron los siguientes errores. Esta lista está dirigida principalmente a usuarios que verifican si sus tickets de asistencia se corrigieron. No está diseñada para proporcionar información detallada a todos los usuarios.
Edge para nube privada 4.17.01
| ID del problema | Descripción |
|---|---|
| APIBAAS-1990 | La pila de API BaaS ya no intenta autenticarse en SMTP cuando smtp.auth es falso |
| APIRT-3032 |
Ahora, cuando ejecutas el comando "apigee-service baas-usergrid restart", también se ejecuta "configure" Ya no tienes que ejecutar "apigee-service baas-usergrid configure" seguido de "apigee-service baas-usergrid restart" para la pila de BaaS. |
| APIRT-3032 |
No realizar la búsqueda de DNS si el nombre de host es una dirección IP. |
| DOS-4070 |
"apigee-all -version" ahora muestra la versión de los RPM de edge-mint-* |
| DOS-4359 |
Se agregó la opción "pdb" para instalar solo la base de datos de Postgres. Se usa solo cuando se instala el portal de servicios para desarrolladores. Consulta Instalación del portal de Servicios para desarrolladores. |
Cloud 16.10.26 (IU)
| ID del problema | Descripción |
|---|---|
| EDGEUI-768 | La creación del proxy con el WSDL de StockQuote falla |
Cloud 16.09.21_9
| ID del problema | Descripción |
|---|---|
| MGMT-3674 | No se pueden crear KVM o Vaults encriptados para organizaciones que cumplen con la HIPAA |
| MGMT-3647 | El acceso de Userrole para los usuarios con correos electrónicos con mayúsculas arroja un error 403 |
Cloud 16.09.21
| ID del problema | Descripción |
|---|---|
| APIRT-3507 | Errores intermitentes (como errores de SNI) en textos destacados de servicios de JavaScript |
| APIRT-3408 | Versión 160817 de MP: El módulo de estadísticas de apigee-access procesa los mensajes de manera diferente |
| APIRT-3390 |
Cambio en la respuesta de error que devuelve la política de actualización del token de acceso |
| APIRT-3389 | |
| APIRT-3381 | Latencias altas en los proxies de producción de los clientes |
| APIRT-3366 | Las políticas de JavaScript fallan en todas las organizaciones de prueba nuevas |
| APIRT-3363 | El análisis de una URL no válida devuelve un estado 500 con ApplicationNotFound |
| APIRT-3356 | Mensaje de token no válido de OAuth |
| APIRT-3355 | Error 403 intermitente en el proxy de OAuth |
| APIRT-3285 | |
| APIRT-3261 | Las credenciales se validan con otra app para desarrolladores en producción |
| APIRT-3234 | La app de Node.js devuelve NPE |
| APIRT-3223 | Problema de caché inactiva de Apigee |
| APIRT-3193 | El servidor de destino de Node.js se bloquea después de pasar a ASG |
| APIRT-3152 | La llamada de administración de cachedlogs hace que los mensajes de registro se dividan |
| APIRT-3117 | El MP alcanzó el 100% de uso de CPU y dejó de entregar tráfico |
| APIRT-3064 | Router: Mensaje de error 503 personalizado del router |
| APIRT-2620 | Grupo de subprocesos independiente para algunos pasos de bloqueo para mejorar el manejo de la carga |
| CORESERV-774 | El acceso con una clave válida con una referencia de apiproduct no válida provoca un error interno del servidor |
Cloud 16.10.05 (IU)
| ID del problema | Descripción |
|---|---|
| EDGEUI-697 | Botón de exportación de la página Informes Se quitó el botón Exportar de la página principal de Informes personalizados. La exportación de informes está disponible en cada página de informes personalizados. |
Cloud 16.08.24.01
| ID del problema | Descripción |
|---|---|
| EDGEUI-663 | El proxy generado para el puerto WeatherHttpGet de Weather.wsdl falla en el entorno de ejecución con el error 500 Cuando se genera un proxy de API para un servicio de SOAP, los puertos WSDL sin una vinculación de protocolo SOAP ya no son visibles en el asistente de proxy de API. Esto es así por diseño, ya que el asistente solo genera solicitudes SOAP. |
| EDGEUI-658 | Problema con el nombre de la operación de transferencia de WSDL de SOAP |
| EDGEUI-653 | Error cuando se crea el proxy de API de Node.js cuando se selecciona la opción Habilitar CORS |
| EDGEUI-648 | Las llamadas desde la IU que tardan entre 2 y 3 minutos se agotan |
| EDGEUI-623 | El botón para cambiar la fecha del historial de la organización no funciona en Firefox |