Preguntas frecuentes sobre el portal para desarrolladores de Drupal 7

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

En esta sección, se proporcionan respuestas a las preguntas más frecuentes, que se recopilaron de las preguntas publicadas en la comunidad de Apigee o la asistencia de Apigee.

Categoría Preguntas frecuentes
Configura un portal para desarrolladores de Drupal
Administra el entorno del portal
Personaliza la apariencia 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
Configurar el correo electrónico y las notificaciones
Solucionar 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 los portales basados en Drupal. Si quieres obtener información para configurar un portal para desarrolladores existente, consulta Cómo crear un portal para desarrolladores.

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

Consulta Software y 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 Trabaja 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 Trabaja 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 Apigee Edge Private Cloud, deberás administrar el entorno del portal por tu cuenta. Para obtener recomendaciones, consulta las prácticas recomendadas sobre el entorno de servidor y desarrollo de Drupal.

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

Si deseas aplicar actualizaciones de Apigee al portal para desarrolladores en la nube pública, sigue estos pasos:

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

    Nota: En el área de estado de un entorno, a la que puedes acceder desde el elemento de menú Estado en el lado izquierdo del panel, es posible que veas que hay actualizaciones disponibles para los módulos de Drupal. Ignora estas actualizaciones. Apigee incorpora automáticamente actualizaciones a los módulos de Drupal en la próxima versión del portal. Cuando permites que Apigee actualice los módulos de Drupal por ti, Apigee se asegura 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 normal de lanzamiento del portal de Apigee, es posible que encuentres problemas imprevistos.

  • Acquia: Apigee actualiza de manera periódica los módulos y temas de tu portal a la versión más reciente de forma automática. Las actualizaciones se realizan solo en el entorno de desarrollo y están etiquetadas para indicar que deben migrarse 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 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 Actualiza el portal de servicios para desarrolladores.

Entre las versiones de Apigee Edge Private Cloud, es posible que recibas una notificación de que hay una versión nueva de Drupal disponible. Una versión nueva puede implicar la actualización de una función, un parche, una actualización de seguridad o algún otro tipo de actualización de Drupal de Drupal. En el caso de una actualización de seguridad, te recomendamos actualizar la instalación de Drupal lo antes posible para asegurarte de que tu sitio siga siendo seguro. Para obtener más información, consulta Actualiza la versión de Drupal de una instalación de nube privada.

Personaliza la apariencia del portal

¿Cómo personalizo el aspecto del portal?

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

Nota: Existe una curva de aprendizaje para implementar las personalizaciones más avanzadas de Drupal. Puedes decidir contratar a un tercero con experiencia de Drupal para lograr la apariencia que deseas en el plazo deseado.

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

¿Cómo agrego 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 en función de si usas Patheon o Acquia para administrar tu portal:

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

Si deseas obtener información y prácticas recomendadas para 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 agrego 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. Si deseas obtener información y prácticas recomendadas para 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 del directorio /sites/all. Si modificas contenido que está fuera del directorio /sites/all, es posible que experimentes conflictos de combinación cuando verifiques 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 los campos de nombre, apellido, nombre de usuario, dirección de correo electrónico y contraseña. Como proveedor de API, tal vez quieras modificar este formulario para solicitarle al usuario que proporcione información adicional, como el nombre de una empresa, la dirección de correo postal o alguna otra información. Para obtener más información, consulta lo siguiente:

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

Cuando un desarrollador registra una app, el portal muestra un formulario predeterminado. Como proveedor de API, es posible que desees modificar 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 u otra información. Para obtener más información, consulta:

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

Las siguientes fuentes describen 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, usa tus credenciales de Google o Twitter a fin de acceder al portal para desarrolladores de Apigee. El portal admite el acceso federado mediante credenciales de varios proveedores comunes, incluidos GitHub, Google, OpenID y Twitter. Para obtener más información, consulta Usa credenciales federadas en el portal para desarrolladores.

¿Cómo aplico un flujo de trabajo para la aprobación manual de la clave de API?

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

Si quieres obtener recomendaciones sobre cómo 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 en el portal para desarrolladores a fin de aplicar un flujo de trabajo para la aprobación manual de claves de API?

Copia de seguridad, recuperación y alta disponibilidad

¿Cómo creo una copia de seguridad y restablezco mi portal 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 y restablezco mi portal en la nube privada?

Crea una copia de seguridad y restablece el portal en la nube privada con los comandos pg_dump y pg_restore de Postgres. Para obtener más información, consulta Crea una copia de seguridad del portal.

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

Las herramientas de administración Pantheon y Acquia Dupal garantizan una disponibilidad del 99.5% para los portales que alojan. Para obtener más información, consulta:

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

No existe un enfoque único para garantizar una alta disponibilidad en el portal para desarrolladores. Te recomendamos que solicites la asistencia de alguien con experiencia en los siguientes temas:

  • Configurar sistemas de archivos y bases de datos en una configuración de alta disponibilidad
  • Desarrollo del portal 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 cuando compiles tu portal. Consulta Cómo proteger tu portal para obtener más información.

¿Cómo configuro el portal para usar 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 se pasan entre el servidor web y el cliente permanezcan privados. Para obtener información sobre cómo configurar TLS con el portal, consulta Usa TLS en el portal.

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

Para clientes de la nube pública de Apigee Edge:

  • Pantheon: Cuando Apigee publica una versión nueva del portal, aparece un mensaje en el panel de Pantheon. Debes buscar actualizaciones de forma periódica y aplicar actualizaciones de seguridad de inmediato. Para obtener más información, consulta Aplica una actualización de Apigee a tu portal.
  • Acquia: Apigee actualiza de manera periódica los módulos y temas de tu portal a la versión más reciente de forma automática. Las actualizaciones se realizan solo en el entorno para desarrolladores y están etiquetadas para indicar que deben migrarse 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 nube privada recibirán una notificación sobre la disponibilidad de una versión nueva de Drupal. Una versión nueva puede implicar la actualización de una función, un parche, una actualización de seguridad o algún otro tipo de actualización de Drupal de Drupal. En el caso de una actualización de seguridad, te recomendamos actualizar la instalación de Drupal lo antes posible para asegurarte de que tu sitio siga siendo seguro. Para obtener más información, consulta Actualiza la versión de Drupal de una instalación de nube privada.

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

Regístrate para recibir actualizaciones de Drupal y Apigee:

Si eres cliente 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 nombre de usuario?

La enumeración de los nombres de usuario hace referencia a un método que los atacantes usan para identificar los nombres de usuario que existen con el formulario de olvido de contraseñas, que indica de forma predeterminada si la contraseña especificada existe o no. Los atacantes pueden seguir probando los nombres de usuario hasta que encuentran un usuario válido. Para evitar la enumeración del nombre 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 API 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?

Las siguientes fuentes 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 del contenido al portal?

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

Comunidad de Apigee:

Documentación de Drupal:

¿Cómo controlo el acceso a los productos de API por función?

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

Configurar el correo electrónico y las notificaciones

¿Cómo especifico un servidor de correo electrónico 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 usarán el servidor SMTP. Entre estos mensajes, se incluyen los que se envían a desarrolladores nuevos, los que se envían a los desarrolladores que pierden sus contraseñas y los que se envían a los desarrolladores con cuentas bloqueadas. Para obtener más información, consulta Configura el correo electrónico.

¿Cómo envío un correo electrónico cuando un desarrollador registra una app (o algún 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 con la generación de 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 más información, consulta Cómo generar un correo electrónico cuando se produce un evento.

¿Cómo personalizo los mensajes de 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 particulares, como el registro, la eliminación, el bloqueo y el desbloqueo de cuentas de desarrollador. Para obtener más información, consulta Configura y da formato a las notificaciones por correo electrónico.

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

Una forma de evitar el spam en el portal es habilitar los módulos de CAPTCHA y reCAPTCHA de Drupal para agregar un CAPTCHA a la página de acceso y a otras páginas. Para obtener más información, consulta los siguientes vínculos:

Solucionar problemas

¿Cómo veo 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 mensajes de registro recientes.

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

Accede al código

¿Cómo accedo 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 hosting, como se describe en las siguientes secciones:

Puede acceder al repositorio de código fuente de Drupal 7 directamente en https://github.com/apigee/drupal7-drops. Los sitios de Pantheon y Acquia usan este repositorio para su código fuente ascendente.