Registrar desarrolladores de aplicaciones

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

Consulta la documentación de Apigee Edge.

Registra y gestiona a los desarrolladores de tu aplicación, tal como se describe en las siguientes secciones. El registro de aplicaciones es un proceso independiente, tal como se describe en el artículo Controlar el acceso a las APIs registrando aplicaciones.

Introducción

Apigee ofrece muchas ventajas que dependen por completo de saber quién llama a tus APIs. Por ejemplo, la seguridad de las APIs, la gestión del tráfico y una cantidad considerable de datos analíticos dependen de saber quién está llamando. ¿Y cómo sabe Apigee quién llama a tus APIs? Leyendo información única en cada llamada a la API, como un ID de usuario, una clave de API o un token de OAuth. Esta información única bloquea o desbloquea las funciones que creas en tus proxies de API, lo que te permite controlar por completo el acceso y el comportamiento de las APIs.

Por eso, los desarrolladores de aplicaciones deben registrarse para usar tus APIs. Una vez añadidas, los desarrolladores registran sus aplicaciones, eligen las APIs que quieren usar y reciben las credenciales de API únicas (claves y secretos de consumidor) necesarias para acceder a tus APIs.

Advertencia: La seguridad de las APIs, la gestión del tráfico y las analíticas de desarrolladores o aplicaciones dependen de que el proxy de API esté configurado correctamente. Por ejemplo, debes añadir las políticas adecuadas a tus proxies, como la validación de claves de API o la verificación de tokens de acceso de OAuth, la aplicación de cuotas y la limitación de la frecuencia. Estas políticas identifican qué desarrollador y aplicación específicos están haciendo la llamada, lo que a su vez permite aplicar la seguridad de las APIs, gestionar el tráfico específico de desarrolladores o aplicaciones, registrar las analíticas de las APIs y otras funciones. Técnicamente, podrías desarrollar APIs abiertas que no comprueben las claves de API ni los tokens de acceso, lo que significa que no necesitarías registrar a los desarrolladores. Sin embargo, no lo recomendamos, ya que perderás la seguridad de las APIs, el control sobre el rendimiento (mediante una buena gestión del tráfico), los datos analíticos y otras ventajas importantes que ofrece Apigee.

Cómo registrar desarrolladores de aplicaciones

Registra a los desarrolladores de aplicaciones con uno de los siguientes métodos:

• Si tienes una cuenta de Apigee de pago, los desarrolladores pueden registrarse por su cuenta a través de 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:
  • Portal integrado: crear una cuenta de usuario en el portal integrado
  • Drupal 10: registrar un desarrollador de aplicaciones
• Los administradores pueden registrar desarrolladores de aplicaciones mediante la API.
• Como administrador del portal para desarrolladores, puedes gestionar a los desarrolladores directamente en tu portal, tal como se describe en las siguientes secciones:
  • Portal integrado: Gestión de usuarios para gestionar las cuentas de usuario.
    Nota: Después de que un usuario cree una aplicación en el portal integrado, tal como se describe en esta sección, la información de la cuenta de usuario se sincroniza y está disponible en Apigee en la página Desarrolladores. El registro de desarrollador de la aplicación se asocia a la cuenta mediante la dirección de correo del usuario. Para obtener más información sobre dónde se almacena la información de la cuenta y de la aplicación asociada, consulta el artículo Dónde se almacena la información de la cuenta de desarrollador de aplicaciones.
  • Drupal 10: Información sobre cómo interactúan los desarrolladores de aplicaciones con el módulo de Apigee
• Como administrador de una organización, puedes gestionar desarrolladores mediante la interfaz de usuario o la API de Apigee, tal 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 única y automática que sirve como clave principal que usa Apigee para identificar al equipo de desarrolladores. Para obtener más información, consulta Dónde se almacena la información del equipo de desarrollo (beta).

Recomendaciones para gestionar cuentas de usuario en portales para desarrolladores

Apigee recomienda que gestione las cuentas de usuario directamente en su portal para desarrolladores.

Si usas el portal integrado, esta es la única forma de asegurarte de que las cuentas de usuario del portal integrado y de Apigee estén sincronizadas.

Si usas el portal para desarrolladores basado en Drupal, gestionar las cuentas de usuario directamente en el portal te ofrece las siguientes ventajas:

• Cuando añades un desarrollador a través de la interfaz de administrador del portal, puedes definir la contraseña del desarrollador para el portal y enviar un correo automático al desarrollador.

  Cuando se añade o se modifica un desarrollador con Apigee, no se envía ningún correo al desarrollador y no se puede definir la contraseña del desarrollador en el portal. Por lo tanto, el desarrollador debe restablecer su contraseña en el portal antes de poder iniciar sesión en él.

• Los cambios que se hagan en la cuenta del desarrollador en el portal se envían automáticamente a Apigee.

Si decides gestionar las cuentas de usuario basadas en Drupal con Apigee, debes sincronizar los desarrolladores de aplicaciones entre el portal y Apigee.

Explorar la página para desarrolladores

Accede a la página Desarrolladores y explórala mediante la interfaz de Apigee.

Nota: En los portales integrados, las cuentas de usuario se gestionan como se describe en el artículo Gestionar usuarios. Cuando un desarrollador crea una aplicación en el portal integrado, tal como se describe en Registrar aplicaciones, se crea un registro de desarrollador independiente para hacer un seguimiento de las aplicaciones asociadas a la cuenta de usuario, al que se puede acceder desde la página Desarrolladores. El registro de desarrollador se asocia mediante la dirección de correo del usuario.

Para acceder a la página Distribución > Desarrolladores, siga estos pasos:

Ir a Desarrolladores

La página Desarrolladores te permite hacer lo siguiente:

• Añadir un desarrollador
• Consulta y edita los detalles del desarrollador, incluidos los siguientes:
• Gestionar atributos personalizados
• Activar o desactivar un desarrollador
• Exportar datos de publicación
• Eliminar un desarrollador
• Buscar en la lista de desarrolladores

Añadir un desarrollador

Para añadir un desarrollador, sigue estos pasos:

1. Accede a la página para desarrolladores.
2. Haz clic en + Crear.
3. Introduce los detalles del desarrollador, como el nombre, los apellidos, el correo electrónico y el nombre de usuario.
4. Haz clic en Añadir.

Consulta también Gestionar usuarios.

Ver y editar los detalles del desarrollador

Ver y editar los detalles del desarrollador.

Para ver y editar los detalles del desarrollador, sigue estos pasos:

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

   Detalles	Descripción
   Detalles	Nombre y apellidos del desarrollador, nombre de usuario y correo electrónico; estado y duración del registro; e ID del desarrollador.
   Atributos personalizados	Atributos personalizados definidos por el desarrollador. Configura los atributos personalizados que necesites. Para obtener más información, consulta el artículo Gestionar atributos personalizados de un desarrollador.
   Aplicaciones	Aplicaciones que ha registrado el desarrollador. Consulta Controlar el acceso a las APIs registrando aplicaciones.

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

Apigee mantiene las siguientes entidades en la caché durante un mínimo de 180 segundos después de que se acceda a ellas.

• Tokens de acceso OAuth. Esto significa que el elemento ExpiresIn de la política de OAuth v2 no podrá hacer que un token de acceso caduque en menos de 180 segundos.
• Entidades de Key Management Service (KMS) (aplicaciones, desarrolladores y productos de API).
• Atributos personalizados en tokens de OAuth y entidades de KMS.

Gestionar atributos personalizados de un desarrollador

Añade hasta 18 atributos personalizados por desarrollador.

Para gestionar atributos personalizados, sigue estos pasos:

1. Accede a la página para desarrolladores.
2. Haz clic en la fila del desarrollador cuyos atributos personalizados quieras gestionar para abrir sus detalles.
3. Haz clic en Editar.
4. En la sección Atributos personalizados, haga clic en + Añadir atributo.
5. Introduzca el nombre y el valor del atributo.
6. Haz clic en Guardar.
7. Para eliminar un atributo personalizado, haz clic en Editar, luego Eliminar y, a continuación, en Guardar.

Activar y desactivar un desarrollador

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

Cuando un desarrollador está inactivo, puede seguir iniciando sesión en el portal para desarrolladores y crear aplicaciones, pero ninguna de las claves de API correspondientes funcionará. Las aplicaciones del desarrollador conservan su estado aprobado (u otro), al igual que las claves de API, aunque no sean válidas mientras el desarrollador esté inactivo.

Nota: Cuando desactives a un desarrollador, el cambio puede tardar unos minutos en aplicarse en todos los procesadores de mensajes. Hasta entonces, es posible que la aplicación del desarrollador pueda realizar algunas llamadas.

Para activar o desactivar a un desarrollador, sigue estos pasos:

1. Accede a la página para desarrolladores.
2. Haz clic en la fila del desarrollador que quieras activar o desactivar para abrir sus detalles.
3. Haz clic en Editar.
4. En la sección Detalles, asigna al campo Estado el valor Activo o Inactivo, según sea necesario.
5. Haz clic en Guardar.
6. Repite los pasos si el desarrollador pertenece a varias organizaciones.

Exportar datos de publicación

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

Requisitos previos:

• Segmento de Cloud Storage
• Acceso de lectura a los datos que va a exportar
• Acceso de lectura y escritura al segmento de Cloud Storage

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

• Acerca de los segmentos de Cloud Storage
• Crear un segmento
• Mostrar segmentos

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

1. Crea el segmento de Cloud Storage o consigue el nombre de uno que ya tengas.
2. Accede a una de las siguientes páginas:

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

     Ir a Desarrolladores

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

     Ir a Aplicaciones

   • 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 cuadro de diálogo Guardar tabla como. Escribe el nombre del segmento 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. El estado de la LRO se muestra en el icono Notificación.
6. Cuando la exportación se haya completado, haz clic en Descargar en la notificación. Se abrirá la página del segmento de Cloud Storage del archivo.
7. Haz clic en Descargar. El archivo se descarga 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 exportadas. Consulta:
  • Desarrolladores
  • Aplicaciones
  • API Products
• A diferencia de la interfaz de usuario clásica de Apigee, cada recurso tiene un botón de exportación independiente y específico.
• En las exportaciones CSV no se incluyen los campos repetidos ni anidados del proto, ya que no se pueden representar correctamente en una estructura de datos de tabla. Para obtener esta información, debe usar la exportación JSON.
• Los archivos exportados se denominan ExportFinal_{hash}.

Eliminar un desarrollador

Advertencia: Si eliminas a un desarrollador, se eliminará por completo junto con sus artefactos relacionados (como aplicaciones y claves de API) de tu organización. Para evitar que se eliminen de forma permanente los desarrolladores y sus artefactos, te recomendamos que desactives a los desarrolladores.

Para eliminar un desarrollador, sigue estos pasos:

1. Accede a la página para desarrolladores.
2. Coloca el cursor sobre la fila del desarrollador que quieras eliminar.
3. Haz clic en Más y, a continuación, en Eliminar.
4. Haz clic en Eliminar para confirmar la acción.

Sincronizar desarrolladores de aplicaciones entre el portal y Apigee

Si utilizas un portal para desarrolladores basado en Drupal para publicar tus APIs, los cambios que hagas en los desarrolladores de aplicaciones mediante Apigee no se propagarán al portal. Para que los cambios se reflejen en el portal, debes iniciar sesión en él como administrador y sincronizarlo con Apigee.

Nota: Si usas el portal de desarrollo basado en Drupal, Apigee recomienda que gestiones a los desarrolladores de aplicaciones directamente en tu portal, no a través de Apigee. Consulta las recomendaciones para gestionar cuentas de usuario en portales para desarrolladores

.

Para sincronizar tu portal para desarrolladores con los desarrolladores de aplicaciones definidos en Apigee, consulta la siguiente sección:

Drupal 10: sincronizar desarrolladores con Apigee

Gestionar desarrolladores con la API

Gestionar desarrolladores con las APIs Developer.