Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
El martes 2 de junio de 2015, lanzamos una nueva versión de Apigee Edge en la nube.
Si tienes preguntas, ve a 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, se indican las nuevas funciones y mejoras de esta versión.
Disponibilidad general de SmartDocs
SmartDocs pasará de estar beta a 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, así como la 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 en el portal para desarrolladores, disponibles en el menú Contenido > SmartDocs en Drupal.
- Lo que se conoció como la autenticación de "token personalizado" ahora se denomina "clave de API".
- Objetos de “seguridad” de autenticación definidos a nivel de revisión
- Configuración de la autenticación de cliente a nivel de 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 ver la documentación de SmartDocs, consulta Cómo usar SmartDocs para documentar las API.
Nuevo editor de proxy de API beta
Hay una nueva versión beta disponible 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: alcances de claves de consumidor, código de autorización, token de solicitud y verificador. Para obtener más información, consulta la política de Entidad de acceso.
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 vencen los certificados SSL en un plazo de 10, 15, 30 o 90 días, según lo que hayas seleccionado en el nuevo campo desplegable de vencimiento.
Nombre de la app de desarrollador que se muestra en la IU de administración
Las apps para desarrolladores de Edge tienen un nombre interno que no cambia y un nombre visible 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 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 su nombre interno para solucionar problemas y administrar 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 en la versión de disponibilidad general requieren que actualices SmartDocs en tu portal para desarrolladores.
Las páginas de SmartDocs que ya se publicaron en tu portal para desarrolladores seguirán funcionando, pero debes seguir el proceso de actualización antes de editar o publicar cambios en las 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 perimetral de Apigee. Cualquier cambio que realices en un modelo de API en Edge será el mismo en todos tus entornos de Pantheon (de manera similar a como existen los desarrolladores en los entornos de Pantheon).
Cómo actualizar de la versión beta de SmartDocs a disponibilidad general
- Actualiza y prueba la versión 15.05.27 en tus entornos dev o test en Pantheon.
- Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
- Si has estado importando documentos de Swagger o WADL, vuelve a importarlos a una revisión nueva.
- Si has mantenido tu modelo de API mediante el módulo de SmartDocs, exporta como archivo JSON de SmartDocs y, luego, impórtalo a tu modelo nuevo mediante el archivo adjunto.
- Configura las propiedades de seguridad de la revisión de tu modelo. En la página Contenido > SmartDocs > modelo, selecciona Configuración de seguridad.
- Verifica cualquier autenticación preconfigurada en la página de configuración del modelo (Contenido > SmartDocs) haciendo clic en Configuración en la columna Operaciones.
- Actualiza las plantillas personalizadas para usar la v6 de los elementos de CSS y JS, y realiza cambios para que reflejen cualquier nombre de objeto nuevo, como authSchemes y apiSchema. Si quieres obtener información sobre la actualización de plantillas de SmartDocs, consulta Cómo usar SmartDocs para documentar las API.
- Vuelve a renderizar y publica la revisión del modelo.
- Después de validar la documentación nueva, actualiza tu portal de production a la versión 15.05.27.
Si eres cliente de una empresa 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 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 implementación 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 API, ya no se agrega automáticamente cuando creas proxies de API o agregas políticas. |
| MGMT-2034 | El WSDL de la recuperación muestra un error: “Error de recuperación del WSDL: Error de 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 “default” da como resultado una IU dañada |
| MGMT-602 | Vista de desarrollo de proxy de API: Agrega una política de caché de respuesta cuando el extremo no tiene PreFlow/PostFlow causa un error |
| MGMT-460 | El cambio de nombre de la política genera un comportamiento defectuoso; 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 informes personalizados |
| AXAPP-1533 | El mapa geográfico de Analytics arroja un error de llamada a una API no válida |
| APIRT-52 | Informes personalizados: El código de estado de respuesta para muchas APIs es nulo |