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
• 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 Distribución > Desarrolladores, haz lo siguiente:

Ir a Developers

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 + Crear.
3. Ingresa los detalles del desarrollador, incluido el nombre, el apellido, el correo electrónico y el nombre de usuario.
4. Haz clic en Agregar.

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 sus detalles.
3. En la sección Detalles, se muestra la siguiente información. Haz clic en Editar para editar 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
   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 y abrir sus detalles.
3. Haz clic en  Editar.
4. Haz clic en + Agregar atributo en la sección Atributos personalizados.
5. Ingresa el nombre y el valor del atributo.
6. Haz clic en Guardar.
7. Para borrar un atributo personalizado, haz clic en Editar, luego en Borrar y, luego, en Guardar.

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. Haz clic en  Editar.
4. En la sección Detalles, establece el campo Estado como Activo o Inactivo, según sea necesario.
5. Haz clic en Guardar.
6. Repite los pasos si el desarrollador se encuentra en varias organizaciones.

Exporta datos de publicación

En esta sección, se describe cómo exportar los datos de publicación de desarrolladores, apps o productos de API como un archivo de valores separados por comas (CSV) o un archivo JSON.

Requisitos previos:

• Bucket de Cloud Storage
• Acceso de lectura a los datos que exportas
• Acceso de lectura y escritura al bucket de Cloud Storage

Para obtener más información sobre los buckets, consulta lo siguiente:

• Acerca de los buckets de Cloud Storage
• Cree un depósito
• Enumera depósitos

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

1. Crea el bucket de Cloud Storage o obtén el nombre de un bucket existente.
2. Accede a una de las siguientes páginas:

   • En la consola de Google Cloud , ve a la página Distribución > Desarrolladores.

     Ir a Developers

   • En la consola de Google Cloud , ve a la página Distribución > Apps.

     Ve a Apps.

   • En la consola de Google Cloud , ve a la página Distribución > Productos de API.

     Ir a Productos

3. Haz clic en Exportar.
4. Se muestra el diálogo Save table as. Escribe el nombre del bucket de Cloud Storage y especifica el formato de exportación: JSON o CSV.
5. Haz clic en Guardar. Se inicia una operación de larga duración (LRO). El estado de la LRO se muestra en el ícono de Notificación.
6. Cuando se complete la exportación, haz clic en Descargar en la notificación. Se abrirá la página del bucket de Cloud Storage para el archivo.
7. Haz clic en Descargar. El archivo se descargará en tu máquina local.

Notas sobre los datos exportados:

• La estructura de los datos exportados sigue exactamente las definiciones de proto, por lo que la documentación de proto se puede usar como referencia para las estructuras de datos exportados. Consulta lo siguiente:
  • Desarrolladores
  • Apps
  • Productos de API
• A diferencia de la IU clásica de Apigee, cada recurso tiene un botón de exportación independiente y exclusivo.
• Las exportaciones de CSV no muestran ningún campo repetido o anidado del archivo .proto, ya que no se pueden representar correctamente en una estructura de datos de tabla. Para obtener esta información, se debe usar la exportación JSON.
• Los archivos exportados se denominan ExportFinal_{hash}.

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.
3. Haz clic en Más y, luego, en Borrar.
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.