Registra a los desarrolladores de apps

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Registra y administra los desarrolladores de tu app, como se describe en las siguientes secciones (el registro de apps es un proceso independiente, como se describe en Controla el acceso a tus API mediante el registro de aplicaciones).

Introducción

Apigee ofrece muchos beneficios que dependen completamente de saber quién llama a tus API. Por ejemplo, la seguridad de la API, la administración del tráfico y una buena cantidad de datos de estadísticas dependen de saber quién llama. ¿Cómo Apigee sabe quién llama a tus API? Mediante la lectura de información única en cada llamada a la API, como un ID del usuario, una clave de API o un token de OAuth. Esa información única bloquea o desbloquea la funcionalidad que compilas en los proxies de API, lo que te da control total sobre el acceso a la API y el comportamiento.

Por eso, los desarrolladores de apps deben registrarse para usar tus API. Una vez agregadas, los desarrolladores registran sus apps, eligen las API que desean usar y reciben las credenciales de API únicas (claves y secretos del consumidor) necesarias para acceder a tus API.

Advertencia: La seguridad de las API, la administración del tráfico y las estadísticas de los desarrolladores y las apps dependen de la configuración adecuada del proxy de API. Por ejemplo, debes agregar las políticas correctas a los proxies, como la validación de la clave de API o la verificación del token de acceso de OAuth, la aplicación de cuotas y el límite de frecuencia. Esas políticas identifican qué desarrollador y app específicos realiza la llamada, que, a su vez, habilita la aplicación de seguridad de la API, la administración del tráfico específico de las apps o los desarrolladores, la captura de estadísticas de API y otras funcionalidades. Técnicamente, podrías desarrollar API abiertas que no verifiquen claves de API ni tokens de acceso, lo que significa que no necesitarás registrar desarrolladores. Sin embargo, no recomendamos esto, ya que pierdes la seguridad de la API, pierdes el control del rendimiento (mediante una buena administración del tráfico), pierdes los datos de estadísticas y pierdes otros beneficios importantes que brinda Apigee.

Cómo registrar desarrolladores de apps

Registra los desarrolladores de apps mediante uno de los siguientes métodos:

• Si tienes una cuenta paga de Apigee, los desarrolladores pueden realizar el registro mediante un portal para desarrolladores. Para obtener más información, consulta una de las siguientes secciones, en función del tipo de portal para desarrolladores que uses:
  • Portal integrado: Crea una cuenta de usuario en el portal integrado
  • Drupal 10: registra un desarrollador de apps
• Los administradores pueden registrar a los desarrolladores de apps mediante la API.
• Como administrador del portal para desarrolladores, administra los desarrolladores directamente en tu portal, como se describe en las siguientes secciones:
  • Portal integrado: Administra usuarios para controlar cuentas de usuario.
    Nota: Después de que un usuario crea una app en el portal integrado, como se describe en esta sección, la información de la cuenta de usuario se sincroniza y queda disponible en Apigee, en laPágina del desarrollador. El registro de desarrolladores de apps se asocia a la cuenta mediante la dirección de correo electrónico del usuario. Para obtener más información sobre el lugar en el que se almacena la información de la cuenta y la app asociada, consulta Dónde se almacena la información de la cuenta de desarrollador de la app.
  • Drupal 10: comprende cómo interactúan los desarrolladores de apps con el módulo de Apigee Edge
• Como administrador de la organización, administras los desarrolladores con la IU o la API de Apigee, como se describe en las siguientes secciones.

Nota:Cuando los usuarios del portal crean un equipo en el portal integrado, la información del equipo de desarrolladores se almacena en Apigee, y se genera una dirección de correo electrónico única y generada de forma automática para funcionar como la clave primaria que Apigee usa a fin de identificar al equipo de desarrolladores. Para obtener más información, consulta Dónde se almacena la información del equipo de desarrolladores (beta).

Recomendaciones a fin de administrar cuentas de desarrollador en portales para desarrolladores

Apigee recomienda que administres las cuentas de desarrollador directamente en tu portal para desarrolladores.

Si usas el portal integrado, esta es la única forma de garantizar que las cuentas de usuario del portal integrado y de Apigee permanezcan sincronizadas.

Si usas el portal para desarrolladores basado en Drupal, administrar las cuentas de desarrollador directamente en el portal para desarrolladores ofrece las siguientes ventajas:

• Cuando agregas a un desarrollador a través de la interfaz de administrador en el portal, puedes configurar la contraseña del desarrollador para el portal y activar un mensaje de correo electrónico automático que se le envía al desarrollador.

  Cuando se agrega o modifica un desarrollador mediante Apigee, no se envía ningún correo electrónico al desarrollador y no puedes establecer la contraseña para el desarrollador en el portal. Por lo tanto, el desarrollador debe restablecer su contraseña en el portal antes de que pueda acceder a él.

• Los cambios realizados en la cuenta del desarrollador en el portal se envían a Apigee de forma automática.

Si decides administrar cuentas de desarrollador basadas en Drupal con Apigee, debes sincronizar desarrolladores de apps entre el portal y Apigee.

Explora la página Desarrolladores

Accede y explora la página Desarrolladores con la IU de Apigee.

Nota: En el caso de los portales integrados, las cuentas de usuario se administran como se describe en Administra usuarios. Después de que un desarrollador crea una app en el portal integrado, como se describe en Registra apps, se crea un registro de desarrolladores diferente para el seguimiento de las apps asociadas con la cuenta de usuario al que se puede acceder desde la página para desarrolladores El registro de desarrolladores se asocia con la dirección de correo electrónico del usuario.

Para acceder a la página Desarrolladores, haz lo siguiente:

• Si usas la IU de Apigee en la consola de Cloud, selecciona Distribución > Apps.
• Si usas la IU clásica de Apigee, selecciona Publicar > Apps.

La página Desarrolladores te permite hacer lo siguiente:

• Agregar un desarrollador
• Visualizar y editar los detalles de los desarrolladores, incluidos los siguientes:
• Administrar atributos personalizados
• Activar o desactivar un desarrollador
• Exportar datos de publicación
• Borrar un desarrollador
• Buscar en la lista de desarrolladores

Agrega un desarrollador

Para agregar un desarrollador, haz lo siguiente:

1. Accede a la página Desarrolladores.
2. Haz clic en + Desarrollador.
3. Ingresa los detalles del desarrollador, incluido el nombre, el apellido, el correo electrónico y el nombre de usuario.
4. Haga clic en Crear.

Consulta también Administra usuarios.

Visualiza y edita los detalles de losdesarrolladores

Visualiza y edita los detalles de los desarrolladores.

Para ver y editar los detalles del desarrollador, haz lo siguiente:

1. Accede a la página Desarrolladores.
2. Haz clic en la fila del desarrollador que deseas ver y editar para abrir los detalles.
3. En la sección Detalles, se muestra la siguiente información. Edita los detalles del desarrollador, según sea necesario.

   Detalle	Descripción
   Detalles	Nombre y apellido del desarrollador, nombre de usuario, correo electrónico, estado y duración del registro e ID del desarrollador. Para editar los detalles del desarrollador, haz clic en cualquiera de los siguientes campos: Nombre Apellido Correo electrónico Nombre de usuario Modifica el contenido y presiona Intro para confirmar el cambio.
   Atributos personalizados	Se definen atributos personalizados para el desarrollador. Configura los atributos personalizados, según sea necesario. Para obtener más información, consulta: Administra atributos personalizados para un desarrollador.
   Apps	Apps que el desarrollador registró. Consulta Controla el acceso a tus API mediante el registro de aplicaciones.

4. Activa o desactiva al desarrollador en el campo Estado.
   Para obtener más información, consulta Activa y desactiva un desarrollador.

Apigee mantiene las siguientes entidades en caché durante un mínimo de 180 segundos después de acceder a las entidades.

• Tokens de acceso de OAuth. Esto significa que el elemento ExpiresIn de la política OAuth v2 no podrá hacer expirar un token de acceso en menos de 180 segundos.
• Entidades del servicio de administración de claves (KMS) (apps, desarrolladores, productos de API).
• Atributos personalizados de entidades de KMS y tokens de OAuth.

Administra atributos personalizados para un desarrollador

Agrega hasta 18 atributos personalizados para cada desarrollador.

Sigue estos pasos para administrar los atributos personalizados:

1. Accede a la página Desarrolladores.
2. Haz clic en la fila del desarrollador para el que deseas administrar atributos personalizados a fin de abrir sus detalles.
3. Haz clic en + en la sección Atributos personalizados.
4. Ingresa el nombre y el valor del atributo.
5. Haz clic en (Aceptar).
6. Para borrar un atributo personalizado, coloca el cursor sobre el atributo y haz clic en en el menú de acciones.

Activa y desactiva un desarrollador

Cuando un desarrollador de apps se registra por su cuenta en tu portal, puedes configurar si está activo o no de forma predeterminada.

Cuando un desarrollador está inactivo, aún puede acceder al portal para desarrolladores y crear apps, pero ninguna de las claves de API correspondientes funcionará. Las apps del desarrollador siguen manteniendo su estado aprobado (o cualquier otro), al igual que las claves de API, aunque no son válidas mientras el desarrollador está inactivo.

Nota: Cuando desactivas un desarrollador, el cambio puede tardar unos minutos en actualizarse en todos los procesadores de mensajes. Hasta entonces, es posible que algunas llamadas que la app del desarrollador realice tengan éxito.

Para activar o desactivar un desarrollador, haz lo siguiente:

1. Accede a la página Desarrolladores.
2. Haz clic en la fila del desarrollador que deseas activar o desactivar para abrir sus detalles.
3. En la sección Detalles, establece el campo Estado como Activo o Inactivo, según sea necesario.
4. Repite los pasos si el desarrollador se encuentra en varias organizaciones.

Exporta datos de publicación

Exporta los siguientes datos de publicación como un archivo de valores separados por comas (CSV):

• Detalles del desarrollador
• Detalles del producto de API, la aplicación y el desarrollador

Para exportar datos de publicación, sigue estos pasos:

1. Accede a la página Desarrolladores.
2. Haz clic en Exportar CSV….
3. Selecciona Desarrolladores o Desarrolladores, apps y productos en el menú desplegable.

Los datos de publicación seleccionados se descargan como un archivo CSV.

Borra un desarrollador

Advertencia: Si borras a los desarrolladores, se quitarán de tu organización por completo al igual que sus artefactos relacionados (como apps y claves de API). Para evitar borrar de forma permanente a los desarrolladores y sus artefactos, considera desactivar los desarrolladores.

Para borrar un desarrollador, haz lo siguiente:

1. Accede a la página Desarrolladores.
2. Coloca el cursor sobre la fila del desarrollador que quieres borrar para que se muestre el menú de acciones.
3. Haz clic en (Aceptar).
4. Haz clic en Borrar para confirmar esta acción.

Sincroniza los desarrolladores de apps entre el portal y Apigee

Si usas un portal para desarrolladores basado en Drupal para publicar tus API, los cambios realizados a los desarrolladores de apps que usan Apigee no se propagan al portal. Debes acceder al portal como administrador y sincronizar el portal con Apigee para que esos cambios aparezcan en el portal.

Nota: Si usas el portal para desarrolladores basado en Drupal, Apigee recomienda que administres a los desarrolladores de apps directamente en tu portal, sin usar Apigee. Consulta Recomendaciones para administrar las cuentas de usuario en los portales para desarrolladores.

A fin de sincronizar tu portal para desarrolladores con los desarrolladores de apps definidos en Apigee, consulta la siguiente sección:

Drupal 10: sincroniza desarrolladores con Apigee

Administra desarrolladores mediante la API

Administra a los desarrolladores mediante las API para desarrolladores.