Estás viendo la documentación de Apigee Edge.
Ve a la
documentación de Apigee X. info
En esta sección, se proporciona orientación para planificar y ejecutar la migración de los recursos de tu portal de Drupal 7 al portal integrado.
Paso 1: Crea un portal integrado
Antes de migrar los recursos de tu portal de Drupal 7, debes crear un portal integrado.
Para crear un portal integrado, sigue estos pasos:
- Asegúrate de tener los roles del portal adecuados para administrar un portal integrado.
- Crea un portal integrado.
Cuando creas un portal integrado, se proporciona un conjunto de páginas de partida para que puedas usarlas como punto de partida. Las páginas de inicio incluyen contenido de demostración que te ayuda a inspirar el desarrollo de tu propio portal a medida que reemplazas el texto y las imágenes con tu contenido único. Para obtener más información, consulta Acerca del portal de muestra.
Paso 2: Compila tu portal integrado
Compila tu portal integrado, como se describe en Pasos para compilar tu portal.
Como mínimo, deberás realizar los pasos que se indican en la siguiente tabla.
| Paso | Descripción |
|---|---|
| Desarrolla el contenido del portal | Como información conceptual y de introducción. Puedes crear páginas y, luego, copiar y pegar el contenido de la página directamente desde tu portal de Drupal 7 existente. |
| Configura la navegación | Crea la navegación necesaria para que coincida con tu estructura existente. |
| Personaliza un tema | Como mínimo, personaliza los siguientes componentes para que coincidan con tus requisitos de desarrollo de la marca: |
| Agrega secuencias de comandos personalizadas | Agrega código JavaScript personalizado a tu portal, según sea necesario. |
| Configura el correo electrónico | Configura el servidor de SMTP y el contenido de las notificaciones por correo electrónico. Nota: En este momento, la configuración de notificaciones por correo electrónico no está disponible para los portales integrados de Apigee Hybrid. |
| Administra la visibilidad predeterminada | Administra la visibilidad predeterminada de recursos específicos. |
| Configura una política de seguridad del contenido | Si lo deseas, configura una política de seguridad del contenido (CSP) para todas las páginas de tu portal para protegerte contra las secuencias de comandos entre sitios (XSS) y otros ataques de inyección de código.
Nota: Por el momento, esta función no está disponible para los portales integrados de Apigee Hybrid. |
Paso 3: Configura el proveedor de identidad
Configura el proveedor de identidad en el portal integrado según el tipo de autenticación, como se describe en la siguiente tabla.
| Autenticación | Descripción |
|---|---|
| Proveedor de identidad integrado (nombre de usuario y contraseña) | Configura el proveedor de identidad integrado en el portal integrado. |
| Inicio de sesión único (SSO) con SAML | Configura el proveedor de identidad de SAML (beta) en el portal integrado.
Notas:
|
Después de que los desarrolladores accedan al portal, podrás administrar sus cuentas, como se describe en Administra cuentas de desarrollador.
Paso 4: Controla el acceso a los recursos con públicos
Si usas roles en Drupal 7 para controlar el acceso a un conjunto de recursos, como la documentación de la API o la creación de claves de API para un producto de API, puedes lograr esta misma funcionalidad con los públicos en el portal integrado.
Específicamente, puedes controlar el acceso al siguiente recurso en el portal integrado con los públicos:
- Páginas en tu portal
- Productos de API publicados
Para agregar un público y administrar las tareas del usuario individual y del equipo de desarrolladores, consulta Administra públicos. Cuando un usuario nuevo cree una cuenta y acceda a tu portal, deberás asignarlo a uno o más públicos, según sea necesario, como se describe en Administra las asignaciones de un público.
Para simplificar la migración, puedes considerar las siguientes sugerencias:
- Asigna un nombre a tus públicos según los roles de Drupal que reemplazan.
- Administra la membresía del público con los equipos de desarrolladores. Los desarrolladores crean equipos para compartir la responsabilidad de sus apps y administrar la membresía de los equipos.
Paso 5: Publica tus APIs
Para publicar APIs y generar automáticamente la documentación de referencia de la API con SmartDocs en el portal integrado, necesitas acceso a la especificación de OpenAPI asociada con la API.
Aunque es posible que hayas usado una especificación de OpenAPI para generar automáticamente los SmartDocs en Drupal 7, en última instancia, el contenido se almacena en un formato interno sin ninguna asociación con la especificación de OpenAPI original. Los equipos de API que usan Apigee Edge suelen almacenar las especificaciones de OpenAPI en la tienda de especificaciones de Apigee Edge.
Luego, publica una API en tu portal. Prepárate para lo siguiente:
- Especifica la especificación de OpenAPI que se usará como fuente de documentación desde la tienda de especificaciones, tu directorio local o una URL.
- Configura la visibilidad de la documentación (público, usuarios de autenticación o públicos seleccionados)
- Configura una URL de devolución de llamada, si es necesario
- Si lo deseas, agrega una imagen a la pantalla de tu catálogo de la API.
Paso 6: Comparte la responsabilidad de una app con equipos de desarrolladores
Si tus desarrolladores usan apps de la empresa en Drupal 7 para compartir la responsabilidad de una app, pueden lograr esta misma funcionalidad con los equipos de desarrolladores en el portal integrado.
Tus desarrolladores crean equipos de desarrolladores para compartir la responsabilidad de sus apps y administrar la membresía del equipo, como se describe en Comparte la responsabilidad de una app con equipos de desarrolladores (beta).
Te recomendamos que eduques a tu comunidad de desarrolladores sobre los equipos de desarrolladores y los animes a migrar sus apps para usar equipos de desarrolladores y compartir la responsabilidad y la transición al uso de las nuevas claves de API. Luego, puedes quitar todas las apps de la empresa y los artefactos relacionados con las APIs de Edge.
Como alternativa, puedes migrar las apps de la empresa a las apps de equipos de desarrolladores, como se describe en el siguiente artículo de la comunidad: Cómo migrar apps de la empresa a equipos de desarrolladores.
Paso 7: Prepárate para lanzar tu portal integrado
Antes de lanzar tu portal integrado a producción, considera realizar los pasos definidos en la siguiente tabla.
| Step | Descripción |
| Personaliza tu dominio | Proporciona tu propio nombre de dominio personalizado para personalizar tu sitio. Nota: Por el momento, esta función no está disponible para los portales integrados de Apigee Hybrid. |
| Configura el seguimiento de estadísticas | Configura el seguimiento de estadísticas con Google Analytics o tu propio servicio personalizado de seguimiento de estadísticas. |
| Crea una página de búsqueda personalizada | Crea una página de búsqueda personalizada e incorpora un motor de búsqueda personalizado de Google |