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

Estás viendo la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Más información

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

Si tiene preguntas, vaya a Asistencia al cliente de Apigee.

Para obtener una lista de todas las notas de la versión de Apigee Edge, consulte las 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.

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 la compatibilidad con objetos de seguridad con nombres personalizados.
  • Mejoras en el diseño visual en las plantillas que generan SmartDocs.
  • Mejoras en la usabilidad y el flujo de trabajo en el portal para desarrolladores, disponibles en el menú Contenido > SmartDocs en Drupal.
  • Lo que se conocía como la autenticación de "Token personalizado" ahora se llama "Clave de API".
  • Objetos de "seguridad" de autenticación definidos a nivel de revisión.
  • Configuración de la autenticación del cliente a nivel de la plantilla. Las revisiones nuevas ya no restablecen las credenciales de cliente de SmartDocs preconfiguradas.

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

Si deseas consultar la documentación de SmartDocs, consulta Cómo usar SmartDocs para documentar las API.

Nueva versión beta del editor de proxy de API

Está 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 códigos de autorización y tokens de acceso. Para obtener más información, consulta Borra la política de información de OAuthV2.

Entidades nuevas en la política de Entidades de acceso

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

Se muestran los certificados SSL próximos a su vencimiento

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

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

Las apps de desarrollador en Edge tienen un nombre interno que no cambia y un nombre visible que puedes cambiar. En la página de apps de desarrollador de 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 la solución de problemas y la administración de la API.

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 beta, las funciones y capacidades nuevas de la versión de disponibilidad general requieren que actualices SmartDocs en tu portal para desarrolladores.

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 procesar y publicar SmartDocs dentro de tu portal para desarrolladores, SmartDocs se generan a partir del modelo de API que se encuentra en los servicios de administración de API de Edge de Apigee. Cualquier cambio que realices en un modelo de API de Edge será el mismo en todos tus entornos de Pantheon (de manera similar a como existen desarrolladores en los entornos de Pantheon).

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

  1. Actualiza y prueba la versión 15.05.27 en tus entornos dev o test en Pantheon.
  2. Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
    • Si importaste documentos de Swagger o WADL, vuelve a importarlos a una revisión nueva.
    • Si mantuviste 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 un archivo adjunto.
  3. Configura las propiedades de seguridad de la revisión de tu modelo. En la página Contenido > SmartDocs > modelo, selecciona Configuración de seguridad.
  4. Verifica cualquier autenticación preconfigurada en la página de configuración del modelo (Contenido > SmartDocs). Para ello, haz clic en Configuración en la columna Operaciones.
  5. Actualiza las plantillas personalizadas para usar la versión 6 de los elementos de CSS y JS, y realiza los cambios necesarios para que reflejen todos los nombres de objeto nuevos, como authSchemes y apiSchema. Si deseas obtener información sobre la actualización de plantillas de SmartDocs, consulta Cómo usar SmartDocs para documentar las API.
  6. Vuelve a renderizar y publica la revisión del modelo.
  7. Después de validar la documentación nueva, actualiza tu portal de production 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, utiliza 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
Por definir-72 Problema con la política de registro de mensajes
MGMT-2124 Los permisos de la función del 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 realizar la implementación en otros
MGMT-2041 Se quitó el elemento FaultRules de la plantilla predeterminada de archivos adjuntos
El elemento FaultRules, que no se usa en las políticas ni en los pasos del proxy de API, ya no se agrega automáticamente cuando creas proxies de API o agregas políticas.
MGMT-2034 El WSDL de recuperación muestra el error: “Error de recuperación de WSDL: Error durante el procesamiento del WSDL”.
MGMT-1812 Agrega la validación de TargetEndpoint durante la importación
Al igual que ProxyEndpoint, el TargetEndpoint se validará para el esquema y las expresiones adecuados que se usan en las condiciones durante la importación del proxy de API.
MGMT-1345 La importación del WSDL con varios espacios de nombres da como resultado un paso de SOAP de compilación incorrecto
MGMT-800 La creación de un recurso con el nombre “predeterminado” genera una IU dañada
MGMT-602 Vista Desarrollo de proxy de la API: Agrega una política de caché de respuesta cuando el extremo no tenga PreFlow/PostFlow que cause errores
MGMT-460 La política de cambio de nombre genera un comportamiento defectuoso, una política duplicada que no se puede quitar
DEVRT‐1565 Intervalos de 15 minutos para CHARGES
AXAPP‐1728 Ignora las variables de monetización en Analytics
AXAPP 1690 "Error de API no válida" en los informes personalizados
AXAPP‐1533 El mapa geográfico de Analytics genera un error de llamada a la API no válida
APIRT-52 Informes personalizados: El código de estado de respuesta para muchas APIs es nulo