Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
En esta sección, se proporciona orientación para planificar y ejecutar la migración de los recursos del portal de Drupal 7 al portal integrado.
Paso 1: Crea un portal integrado
Antes de migrar los elementos del portal de Drupal 7, debes crear un portal integrado.
Para crear un portal integrado, haz lo siguiente:
- Asegúrate de tener los roles de portal adecuados para administrar un portal integrado.
- Crea un portal integrado.
Cuando creas un portal integrado, se proporciona un conjunto de páginas de inicio para que uses 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 Información sobre el portal de muestra.
Paso 2: Compila tu portal integrado
Compila tu portal integrado, como se describe en Pasos para compilar tu portal.
Deberás realizar como mínimo los pasos que se indican en la siguiente tabla.
| Step | Descripción |
|---|---|
| Desarrolla contenido del portal | Por ejemplo, información conceptual y de primeros pasos. Puedes elegir 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 se adapten a tus requisitos de desarrollo de la marca: |
| Agrega secuencias de comandos personalizadas | Agrega el código JavaScript personalizado a tu portal, según sea necesario. |
| Configura el correo electrónico | Configura tu servidor 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 híbridos. |
| Administra la visibilidad predeterminada | Administra la visibilidad predeterminada de recursos específicos. |
| Configura una política de seguridad del contenido | Configura una política de seguridad del contenido (CSP) para todas las páginas de tu portal a fin de protegerte contra la secuencia de comandos entre sitios (XSS) y otros ataques de inyección de código, si lo deseas.
Nota: En este momento, esta función no está disponible para los portales integrados de Apigee híbridos. |
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/contraseña) | Configura el proveedor de identidad integrado en el portal integrado. |
| Inicio de sesión único (SSO) mediante SAML | Configura el proveedor de identidad de SAML (Beta) en el portal integrado.
Notas:
|
Una vez que los desarrolladores accedan al portal, podrás administrar sus cuentas como se describe en Cómo administrar cuentas de desarrollador.
Paso 4: Controla el acceso a los recursos mediante públicos
Si usas roles en Drupal 7 para controlar el acceso a un conjunto de recursos, como la documentación de API o la creación de claves de API para un producto de API, puedes lograr esta misma funcionalidad con públicos en el portal integrado.
Específicamente, puedes controlar el acceso al siguiente recurso en el portal integrado usando públicos:
- Páginas en tu portal
- Productos de API publicados
Para agregar un público y administrar las asignaciones de usuarios individuales y equipos de desarrolladores, consulta Cómo administrar públicos. Cuando un usuario nuevo crea una cuenta y accede 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 a tus públicos los nombres de los roles de Drupal que reemplazarán.
- 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 pertenencia a un equipo.
Paso 5: Publica tus APIs
Para publicar API y generar automáticamente la documentación de referencia de las API mediante SmartDocs en el portal integrado, necesitas acceso a la OpenAPI Specification 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 con 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 el almacén de especificaciones de Apigee Edge.
Luego, publica una API en tu portal. Prepárate para lo siguiente:
- Especifica la especificación de OpenAPI para usarla como fuente de documentación desde el almacén 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).
- Si es necesario, configura una URL de devolución de llamada.
- Si lo deseas, agrega una imagen a la visualización de tu catálogo de API
Paso 6: Comparte la responsabilidad de una app con equipos de desarrolladores
Si tus desarrolladores usan apps empresariales en Drupal 7 para compartir la responsabilidad de una app, pueden lograr esta misma funcionalidad mediante los equipos de desarrolladores en el portal integrado.
Los desarrolladores crean equipos de desarrolladores para compartir la responsabilidad de sus apps y administrar las membresías, tal como se describe en Cómo compartir la responsabilidad de una app con los equipos de desarrolladores (versión beta).
Recomendamos que eduques a tu comunidad de desarrolladores sobre los equipos de desarrolladores y los motives a migrar sus apps para que compartan sus responsabilidades y hagan 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 apps empresariales a apps del equipo de desarrolladores, tal como se describe en el siguiente artículo de la comunidad: Migra 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 que se definen en la siguiente tabla.
| Step | Descripción |
| Personaliza tu dominio | Proporciona tu propio nombre de dominio personalizado para personalizar tu sitio. Nota: En este momento, esta función no está disponible para los portales integrados de Apigee híbridos. |
| 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 |