Preguntas frecuentes sobre el portal para desarrolladores de Drupal 7

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

En esta sección, se proporcionan respuestas a las preguntas más frecuentes, compiladas a partir de las preguntas publicadas en la Comunidad de Apigee o en el equipo de asistencia de Apigee.

Categoría Preguntas frecuentes
Configura un portal para desarrolladores de Drupal
Administra el entorno del portal
Personaliza el aspecto del portal
Personaliza el registro de usuarios y apps
Copia de seguridad, recuperación y alta disponibilidad
Protege el portal
Cómo controlar el acceso al contenido
Configura el correo electrónico y las notificaciones
Solución de problemas
Accede al código

Configura un portal para desarrolladores de Drupal

¿Cómo configuro un portal para desarrolladores de Drupal?

A partir del 31 de mayo de 2020, finalizó el hosting patrocinado por Apigee para portales basados en Drupal. Para obtener información sobre la configuración de un portal para desarrolladores existente, consulta Cómo crear un portal para desarrolladores.

¿Qué navegadores y versiones de navegadores son compatibles con el portal?

Consulta la página sobre el software compatible y las versiones compatibles.

Administra el entorno del portal

¿Cómo administro mi entorno de portal en la nube pública?

Apigee usa Pantheon, un servicio de administración de sitios web, para alojar versiones basadas en la nube del portal de servicios para desarrolladores. Para obtener más información, consulta Cómo trabajar con Pantheon.

Apigee usa Acquia, un servicio de administración de sitios web, para alojar versiones basadas en la nube del portal de servicios para desarrolladores en la Unión Europea (UE). Para obtener más información, consulta Cómo trabajar con Acquia.

Pantheon y Acquia proporcionan herramientas para desarrollar, probar y publicar tu portal basado en Drupal en un entorno seguro.

¿Cómo administro mi entorno de portal en la nube privada?

Como cliente de la nube privada de Apigee Edge, deberás administrar tu entorno de portal por tu cuenta. Para obtener recomendaciones, consulta las prácticas recomendadas de desarrollo y entorno de servidor de Drupal.

¿Cómo aplico las actualizaciones de Apigee a mi portal para desarrolladores en la nube pública?

Para aplicar actualizaciones de Apigee al portal para desarrolladores en la nube pública, haz lo siguiente:

  • Pantheon: Cuando Apigee publica una nueva versión del portal, aparece un mensaje en el panel de Pantheon. Debes buscar actualizaciones con regularidad y aplicar las actualizaciones de seguridad de inmediato. Para obtener más información, consulta Cómo aplicar una actualización de Apigee a tu portal.

    Nota: En el área Estado de un entorno, al que se accede desde el elemento de menú Estado a la izquierda del panel, es posible que veas que hay actualizaciones disponibles para los módulos de Drupal. Ignora estas actualizaciones. Apigee incorpora automáticamente las actualizaciones de los módulos de Drupal en la próxima versión del portal por ti. Si permites que Apigee actualice los módulos de Drupal por ti, Apigee se asegurará de que estas actualizaciones se hayan probado con el código más reciente del portal. Si actualizas un módulo de Drupal fuera del ciclo de lanzamiento normal del portal de Apigee, es posible que encuentres problemas imprevistos.

  • Acquia: De forma periódica, Apigee actualiza los módulos y temas de tu portal a la versión más reciente automáticamente. Las actualizaciones solo se realizan en el entorno de dev y se etiquetan para indicar que se deben migrar a otros entornos del portal. Para obtener más información, consulta Cómo aplicar actualizaciones de módulos y temas al portal.

¿Cómo aplico las actualizaciones de Apigee a mi portal para desarrolladores en la nube privada?

En el caso de los clientes de Apigee Edge para la nube privada, cuando Apigee publique una nueva versión del portal, podrás actualizar tu portal para desarrolladores a la versión más reciente, como se describe en Cómo actualizar el portal de servicios para desarrolladores.

Entre los lanzamientos de Apigee Edge para la nube privada, es posible que recibas una notificación de que hay una versión nueva de Drupal disponible. Una versión nueva puede ser una versión de función, un parche, una actualización de seguridad o algún otro tipo de actualización de Drupal. En el caso de una actualización de seguridad, debes actualizar tu instalación de Drupal lo antes posible para asegurarte de que tu sitio siga siendo seguro. Para obtener más información, consulta Cómo actualizar la versión de Drupal de una instalación de nube privada.

Personaliza el aspecto del portal

¿Cómo puedo personalizar el diseño del portal?

Con Drupal, puedes crear un portal altamente personalizado ajustando el tema de Drupal y agregando módulos personalizados.

Nota: Hay una curva de aprendizaje para implementar las personalizaciones más avanzadas de Drupal. Puedes contratar a un tercero con experiencia en Drupal para lograr el aspecto deseado en el plazo que desees.

A continuación, se incluyen algunos recursos que te ayudarán a personalizar tu portal con Drupal:

¿Cómo puedo agregar módulos y temas personalizados a mi portal en la nube pública?

Puedes expandir la funcionalidad del portal agregando tus propios módulos y temas personalizados.

Para agregar módulos y temas personalizados a tu portal basado en la nube, consulta una de las siguientes secciones según si usas Patheon o Acquia para administrar tu portal:

Nota: Solo modifica el contenido dentro del directorio /sites/all. Si modificas contenido fuera del directorio /sites/all, es posible que experimentes conflictos de combinación cuando revises los cambios en Git.

Para obtener prácticas recomendadas y más información sobre cómo agregar y actualizar módulos personalizados, consulta Cómo agregar módulos y temas y Cómo actualizar módulos, respectivamente, en la documentación de Drupal.

¿Cómo puedo agregar módulos y temas personalizados a mi portal en la nube privada?

Puedes expandir la funcionalidad del portal agregando tus propios módulos y temas personalizados. Para obtener prácticas recomendadas y más información sobre cómo agregar y actualizar módulos personalizados, consulta Cómo agregar módulos y temas y Cómo actualizar módulos, respectivamente, en la documentación de Drupal.

Nota: Solo modifica el contenido dentro del directorio /sites/all. Si modificas contenido fuera del directorio /sites/all, es posible que experimentes conflictos de combinación cuando revises los cambios en Git.

Personaliza el registro de usuarios y apps

¿Cómo puedo personalizar la página de registro de usuarios nuevos?

Cuando el usuario se registra para obtener una cuenta en el portal, este muestra la página de registro predeterminada con campos para el nombre, apellido, nombre de usuario, dirección de correo electrónico y contraseña. Como proveedor de la API, te recomendamos que modifiques este formulario para solicitarle al usuario que proporcione información adicional, como el nombre de la empresa, la dirección de correo postal y otra información. Para obtener más información, consulta los siguientes recursos:

¿Cómo personalizo la página de registro de la app?

Cuando un desarrollador de apps registra una app, el portal muestra un formulario predeterminado. Como proveedor de la API, te recomendamos que modifiques el formulario de registro de la app para solicitarle al desarrollador que proporcione información adicional, como un ID de cliente, la plataforma de destino de la app o cualquier otra información. Para obtener más información, consulte:

¿Cómo uso LDAP para la autenticación en el portal para desarrolladores?

En las siguientes fuentes, se describe cómo usar LDAP para la autenticación:

Comunidad de Apigee

Documentación de Drupal

¿Cómo accedo al portal con mis credenciales de Twitter, Google o GitHub?

El acceso federado es el proceso en el que usas credenciales de un sistema de administración de identidades, llamado sistema de registro, para acceder a otro sistema. Por ejemplo, usas tus credenciales de Google o Twitter para acceder al portal para desarrolladores de Apigee. El portal admite el acceso federado con credenciales de varios proveedores comunes, como GitHub, Google, OpenID y Twitter. Para obtener más información, consulta Cómo usar credenciales federadas en el portal para desarrolladores.

¿Cómo puedo aplicar un flujo de trabajo para la aprobación manual de claves de API?

Puedes configurar la aprobación manual de claves de API para el registro de apps cuando creas un producto de API. En este caso, debes aprobar manualmente una clave de API cuando un desarrollador de apps la registra.

Si deseas obtener recomendaciones para aplicar un flujo de trabajo para la aprobación manual de claves de API, consulta el siguiente artículo de la comunidad: ¿Cuál es la mejor manera de aplicar un flujo de trabajo para la aprobación manual de claves de API en el portal para desarrolladores?.

Copia de seguridad, recuperación y alta disponibilidad

¿Cómo creo una copia de seguridad de mi portal y lo restablezco en la nube pública?

Los pasos para crear una copia de seguridad de un portal en la nube pública son diferentes según si usas Pantheon o Acquia para administrar tu portal:

¿Cómo creo una copia de seguridad de mi portal y lo restablezco en la nube privada?

Creas una copia de seguridad del portal y lo restableces en la nube privada con los comandos pg_dump y pg_restore de Postgres. Para obtener más información, consulta Cómo crear una copia de seguridad del portal.

¿Cómo garantizo la alta disponibilidad del portal para desarrolladores en mi nube pública?

Las herramientas de administración de Pantheon y Acquia Drupal garantizan el 99.5% de disponibilidad para los portales que alojan. Para obtener más información, consulte:

¿Cómo garantizo la alta disponibilidad del portal para desarrolladores en mi nube privada?

No existe un enfoque "único para todos" que garantice la alta disponibilidad del portal para desarrolladores. Te recomendamos que solicites la asistencia de alguien con experiencia en lo siguiente:

  • Cómo configurar sistemas de archivos y bases de datos en una configuración de alta disponibilidad
  • Desarrollo de portales de Drupal 7

Comunícate con el equipo de Éxito del cliente de Apigee si necesitas asistencia. Además, consulta los siguientes artículos de la comunidad:

Protege el portal

¿Cómo configuro la seguridad del portal?

Drupal también tiene muchas funciones de seguridad con las que debes familiarizarte a medida que compilas tu portal. Consulta Cómo proteger tu portal para obtener más información.

¿Cómo configuro el portal para que use TLS/HTTPS?

TLS (seguridad de la capa de transporte, cuyo predecesor es SSL) es la tecnología de seguridad estándar para establecer un vínculo encriptado entre un servidor web y un cliente web, como un navegador o una app. Un vínculo encriptado garantiza que todos los datos que pasan entre el servidor web y el cliente permanezcan privados. Para obtener información sobre la configuración de TLS con el portal, consulta Cómo usar TLS en el portal.

¿Cómo aplico los parches de seguridad de Drupal?

Para clientes de Apigee Edge Public Cloud:

  • Pantheon: Cuando Apigee publica una nueva versión del portal, aparece un mensaje en el panel de Pantheon. Debes buscar actualizaciones con regularidad y aplicar las actualizaciones de seguridad de inmediato. Para obtener más información, consulta Cómo aplicar una actualización de Apigee a tu portal.
  • Acquia: De forma periódica, Apigee actualiza los módulos y temas de tu portal a la versión más reciente automáticamente. Las actualizaciones solo se realizan en el entorno de dev y se etiquetan para indicar que se deben migrar a otros entornos del portal. Para obtener más información, consulta Cómo aplicar actualizaciones de módulos y temas al portal.

Los clientes de Apigee Edge para la nube privada recibirán una notificación de que hay una versión nueva de Drupal disponible. Una versión nueva puede ser una versión de función, un parche, una actualización de seguridad o algún otro tipo de actualización de Drupal. En el caso de una actualización de seguridad, debes actualizar tu instalación de Drupal lo antes posible para asegurarte de que tu sitio siga siendo seguro. Para obtener más información, consulta Cómo actualizar la versión de Drupal de una instalación de nube privada.

¿Cómo me registro para recibir actualizaciones de seguridad?

Regístrate para recibir actualizaciones de Drupal y Apigee:

En el caso de los clientes de la nube pública, también puedes registrarte con el host de tu sitio web de Drupal:

¿Cómo evito la enumeración de nombres de usuario?

La enumeración de nombres de usuario hace referencia a un método que los atacantes usan para identificar nombres de usuario que existen mediante el formulario para recuperar contraseñas, que de forma predeterminada indica si existe o no la contraseña especificada. Los atacantes pueden seguir probando nombres de usuario hasta que encuentren un usuario válido. Para evitar la enumeración de nombres de usuario, instala el módulo de prevención de enumeración de nombres de usuario.

¿Cómo habilito la autenticación de dos factores?

No habilites la autenticación de dos factores en Apigee Edge si publicas tus APIs con un portal para desarrolladores de Apigee. De lo contrario, el portal para desarrolladores no podrá comunicarse con Edge.

¿Cómo se almacenan y encriptan las credenciales de Edge en el portal de Drupal?

En las siguientes fuentes, se proporcionan detalles sobre cómo se almacenan y encriptan las credenciales de Edge en el portal de Drupal:

Comunidad de Apigee:

Cómo controlar el acceso al contenido

¿Cómo controlo el acceso al contenido del portal?

En las siguientes fuentes, se describe cómo controlar el acceso al contenido del portal:

Comunidad de Apigee:

Documentación de Drupal:

¿Cómo controlo el acceso a los productos de la API según el rol?

En las siguientes fuentes, se describe cómo controlar el acceso a los productos de la API por rol:

Configura el correo electrónico y las notificaciones

¿Cómo puedo especificar un servidor de correo SMTP para el portal?

El portal para desarrolladores requiere que configures un servidor SMTP para enviar mensajes de correo electrónico. Después de configurar el servidor SMTP, todos los correos electrónicos que envía el portal para desarrolladores usan el servidor SMTP. Estos correos electrónicos incluyen correos electrónicos enviados a desarrolladores nuevos, correos electrónicos enviados a desarrolladores que pierden su contraseña y correos electrónicos enviados a desarrolladores con cuentas bloqueadas. Para obtener información, consulta Cómo configurar el correo electrónico.

¿Cómo envío un correo electrónico cuando un desarrollador registra una app (o cuando ocurre otro evento)?

Las reglas de Drupal te permiten definir acciones del portal en respuesta a ciertos eventos. Un uso común de las reglas es generar correos electrónicos en respuesta a un evento. El portal tiene compatibilidad integrada para generar correos electrónicos para eventos predefinidos, como cuando un desarrollador nuevo registra una cuenta. Sin embargo, puedes agregar tus propias reglas para generar correos electrónicos. Por ejemplo, puedes generar un correo electrónico cuando el desarrollador agrega, quita o modifica una app. Para obtener información, consulta Cómo generar un correo electrónico cuando se produce un evento.

¿Cómo personalizo los mensajes por correo electrónico que se envían desde el portal?

Puedes configurar varias notificaciones por correo electrónico que se envían en respuesta a actividades específicas, como el registro, la eliminación, el bloqueo y el desbloqueo de cuentas de desarrollador. Para obtener información, consulta Cómo configurar y dar formato a las notificaciones por correo electrónico.

¿Cómo puedo evitar el SPAM en el portal?

Una forma de evitar el SPAM en el portal es agregar un CAPTCHA a la página de acceso y a otras páginas habilitando los módulos de CAPTCHA y reCAPTCHA de Drupal. Para obtener información, consulta los siguientes recursos:

Solución de problemas

¿Cómo puedo ver los archivos de registro del portal?

Selecciona Informes en el menú de Drupal para ver una lista de registros y otros informes. Por ejemplo, selecciona Informes > Mensajes de registro recientes para ver una tabla de los mensajes de registro recientes.

Video: Mira un video breve para obtener más información sobre los informes de registro y la configuración de depuración.

Accede al código

¿Cómo puedo acceder al código fuente del portal para desarrolladores de Drupal 7?

En el caso de los sitios alojados en Pantheon o Acquia, puedes acceder al código fuente del portal para desarrolladores de Drupal 7 a través del panel de tu sitio de alojamiento, como se describe en las siguientes secciones:

Puedes acceder al repositorio de código fuente de Drupal 7 directamente en https://github.com/apigee/drupal7-drops. Tanto los sitios de Pantheon como los de Acquia usan este repositorio para su código fuente upstream.