15.05.27: Notas de la versión en la nube de Apigee Edge

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

El martes 2 de junio de 2015, lanzamos una nueva versión en la nube de Apigee Edge.

Si tienes preguntas, visita la 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, presentamos las nuevas funciones y mejoras de esta versión.

Disponibilidad general de SmartDocs

SmartDocs pasará de la versión beta a la disponibilidad general. Entre las actualizaciones y funciones nuevas, se incluyen las siguientes:

  • Compatibilidad con Swagger 2.0, incluida la importación por archivo o URL, y compatibilidad con objetos de seguridad con nombres personalizados.
  • Mejoras en el diseño visual de las plantillas que generan SmartDocs.
  • Mejoras en la usabilidad y el flujo de trabajo del portal para desarrolladores, disponibles en el menú Contenido > SmartDocs de Drupal
  • Lo que se conocía como autenticación de "token personalizado" ahora se denomina "clave de API".
  • Objetos de "seguridad" de autenticación definidos a nivel de la revisión
  • Configuración de la autenticación del cliente a nivel de la plantilla Las revisiones nuevas ya no restablecen ninguna credencial de cliente de SmartDocs preconfigurada.

Para obtener más descripciones de las funciones, consulta esta entrada de blog.

Para obtener documentación de SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.

Nueva versión beta del editor de proxy de API

Hay disponible una nueva versión beta del editor de proxy de API. Para acceder, haz clic en el vínculo “Acceder a la versión beta” cuando edites un proxy de API existente. Puedes alternar entre los editores “clásico” y “beta”.

Nueva política de OAuthV2

La nueva política DeleteOAuthV2Info te permite borrar los códigos de autorización y los tokens de acceso. Para obtener más información, consulta Borra la política de información de OAuthV2.

Nuevas entidades en la política de Access Entity

La política de entidad de acceso proporciona acceso a las siguientes entidades nuevas: consumerkey-scopes, authorizationcode, requesttoken y verifier. Para obtener más información, consulta la política de Access Entity.

Cómo mostrar certificados SSL que están por vencer

La página Certificados SSL en la IU de administración (Administrador > Certificados SSL) indica cuándo los certificados SSL vencerán dentro de 10, 15, 30 o 90 días, según tu selección en el campo desplegable de vencimiento nuevo.

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

Las apps para desarrolladores en Edge tienen un nombre interno que no cambia y un nombre visible que puedes cambiar. En una página de app para desarrolladores en la IU de administración (Publicar > Apps para desarrolladores > nombre de la app), se muestra el "Nombre" interno de la app junto con el "Nombre visible", lo que facilita la identificación visual de las apps por sus nombres internos para solucionar problemas y administrar las APIs.

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 de estadísticas personalizados ya no está disponible en la IU de administración.


Proceso de actualización de SmartDocs

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

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

Ten en cuenta que, si bien puedes renderizar y publicar SmartDocs en tu portal para desarrolladores, estos se generan a partir del modelo de API que se encuentra en los servicios de administración de APIs de Edge de Apigee. Cualquier cambio que realices en un modelo de API en Edge será el mismo en todos tus entornos de Pantheon (similar a la forma en que los desarrolladores existen en todos los entornos de Pantheon).

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

  1. Actualiza y prueba la versión 15.05.27 en tus entornos de dev o prueba en Pantheon.
  2. Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
    • Si has estado importando documentos Swagger o WADL, vuelve a importarlos en una revisión nueva.
    • Si has estado manteniendo tu modelo de API a través del módulo de SmartDocs, expórtalo como JSON de SmartDocs y, luego, impórtalo a tu modelo nuevo con el archivo adjunto.
  3. Establece las propiedades de seguridad de la revisión de tu modelo. En la página Contenido > SmartDocs > modelo, selecciona Configuración de seguridad.
  4. Para verificar la autenticación preconfigurada en la página de configuración del modelo (Contenido > SmartDocs), haz clic en Configuración en la columna Operaciones.
  5. Actualiza las plantillas personalizadas para usar la versión 6 de los recursos de CSS y JS, y realiza cambios para reflejar los nombres de objetos nuevos, como authSchemes y apiSchema. Para obtener información sobre cómo actualizar las plantillas de SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.
  6. Vuelve a renderizar y publica la revisión del modelo.
  7. Después de validar la nueva documentación, actualiza tu portal de producción a la versión 15.05.27.

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

Fallas corregidas

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

ID del problema Descripción
TBD-72 Problema con la política de registro de mensajes
MGMT-2124 Los permisos del rol de cliente se restablecen cuando se guardan los permisos en la IU.
MGMT-2048 El usuario con un rol personalizado que limita los permisos de implementación a un entorno puede implementar en otros
MGMT-2041 Se quitó el elemento FaultRules de la plantilla de archivo adjunto predeterminada
El elemento FaultRules, que no se usa en políticas ni pasos de proxy de API, ya no se agrega automáticamente cuando creas proxies de API o agregas políticas.
MGMT-2034 La recuperación de WSDL muestra un error: “Error de recuperación de WSDL: Error de procesamiento de WSDL”.
MGMT-1812 Agrega la validación de TargetEndpoint durante la importación
Al igual que ProxyEndpoint, TargetEndpoint se validará para el esquema y las expresiones correctos que se usan en las condiciones durante la importación del proxy de API.
MGMT-1345 La importación de WSDL con varios espacios de nombres genera un paso incorrecto de compilación de SOAP
MGMT-800 Crear un recurso con el nombre "default" genera una IU dañada
MGMT-602 Vista de desarrollo del proxy de API: Agregar una política de caché de respuestas cuando el extremo no tiene PreFlow o PostFlow causa un error
MGMT-460 Cambiar el nombre de la política genera un comportamiento defectuoso y una política duplicada que no se puede quitar.
DEVRT-1565 Intervalos de 15 minutos para CHARGES
AXAPP-1728 Cómo ignorar las variables de monetización en Analytics
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
APIRT-52 Informes personalizados: El código de estado de respuesta de muchas APIs es nulo