Registra a los desarrolladores de apps

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

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 Registra apps y administra claves de API).

Introducción

Edge ofrece muchos beneficios que dependen completamente de saber quién llama a tus APIs. 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 Edge sabe quién llama a tus APIs? 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.

Cómo registrar desarrolladores de apps

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

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 desarrollador en el portal integrado y Edge 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 Edge, 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 Edge de forma automática.

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

Explora la página Desarrolladores

Accede y explora la página Desarrolladores con la IU de Edge y la IU clásica de Edge.

Edge

Para acceder a la página Desarrolladores con la IU de Edge, haz lo siguiente:

  1. Accede a apigee.com/edge.
  2. Selecciona Publicar > Desarrolladores en la barra de navegación izquierda.

Se mostrará la página para desarrolladores.

Como se destaca en la figura, la página Desarrolladores te permite hacer lo siguiente:

Edge clásico (nube privada)

Para acceder a la página Desarrolladores con la IU clásica de Edge, haz lo siguiente:

  1. Accede a http://ms-ip:9000, donde ms-ip es la dirección IP o el nombre de DNS del nodo del servidor de administración.
  2. Selecciona Publicar > Desarrolladores en la barra de navegación superior.

Se mostrará la página para 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.

Visualiza y edita los detalles de losdesarrolladores

Visualiza y edita los detalles de los desarrolladores. En el caso de las organizaciones con la monetización habilitada, puedes editar los atributos personalizados de monetización definidos en Configura los atributos de monetización.

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 los siguientes vínculos:
    Aplicaciones Apps que el desarrollador registró. Consulta Cómo registrar apps.
  4. Activa o desactiva al desarrollador en el campo Estado.
    Para obtener más información, consulta Cómo activar y desactivar un desarrollador.

Con Apigee Edge para la nube pública, Edge 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 un token revocado puede tener éxito hasta por tres minutos, hasta que su límite de caché caduque.
  • 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, incluidos los atributos de monetización que se describen en Configura los atributos de monetización.

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. Haga clic en .
  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.

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

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. Haga clic en .
  4. Haz clic en Borrar para confirmar esta acción.

Sincroniza los desarrolladores de apps entre el portal y Edge

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

Para sincronizar tu portal para desarrolladores con los desarrolladores de apps definidos en Edge, consulta las siguientes secciones:

Agrupa desarrolladores en empresas

Con la monetización, una empresa es un conjunto de desarrolladores administrados como una sola entidad. Una compañía puede ser cualquier agrupación que sea apropiada para tu organización, como una unidad de negocio, una línea de productos o una división. Agrupa desarrolladores en empresas cuando necesites tener varios desarrolladores asociados a una sola entidad corporativa. Por ejemplo, es posible que necesites configurar diferentes empresas para la facturación. Sin embargo, los desarrolladores de tu organización no es necesario que estén asociados con una empresa. Ten en cuenta que un desarrollador siempre es una sola entidad, que se identifica de forma inequívoca con el elemento de correo electrónico. Si un desarrollador forma parte de una empresa, verás el nombre de la empresa en la página Desarrolladores.

Para obtener más información sobre cómo administrar empresas y desarrolladores para la monetización, consulta Administra empresas y desarrolladores.

Cómo configurar los atributos de monetización

Cuando edites un desarrollador con la IU o lo crees o edites con la API, podrás configurar las propiedades de monetización que se definen en la siguiente tabla. Inicialmente, configuras las propiedades de monetización de la organización cuando editas el perfil de la organización.

Nombre del campo Nombre del atributo personalizado Descripción
Dirección MINT_DEVELOPER_ADDRESS

Dirección del desarrollador, incluidos los siguientes campos: dirección (líneas 1 y 2), ciudad, estado, código postal y país
Perfil de facturación MINT_BILLING_PROFILE

Ciclo de facturación de tu organización Estos son algunos de los valores válidos:

  • PRORATED: La facturación se basa en la cantidad de días que se usa un producto de API en un mes calendario.
  • CALENDAR_MONTH: La facturación se realiza mensualmente.
Tipo de facturación MINT_BILLING_TYPE

Es el modelo de pago del desarrollador que se usa para la facturación. El valor puede ser uno de los siguientes:

  • PREPAID: El desarrollador paga por adelantado el uso de un producto de API. Los fondos se deducen del saldo del desarrollador cuando se usa el producto de API. El desarrollador debe mantener un saldo prepago suficiente para comprar el producto de API.
  • POSTPAID: Se le factura mensualmente (a través de una factura) al desarrollador por el uso de los productos de la API. El desarrollador paga por el uso de los productos de API según las condiciones de pago establecidas por los planes incluidos en la factura.
  • BOTH: Admite cualquier tipo de facturación. El valor predeterminado es PREPAID.

Consulta Configura los tipos de facturación prepago y pospago con la API.

Categoría MINT_DEVELOPER_CATEGORY Es la categoría de desarrollador a la que quieres agregar al desarrollador. Una categoría de desarrollador es una agrupación de desarrolladores o empresas con características similares. Para obtener más información, consulta Administra las categorías de desarrolladores.
ID de la empresa MINT_COMPANY_ID ID de la empresa, si corresponde Para obtener más información, consulta Cómo agrupar desarrolladores en empresas.
Tipo de desarrollador MINT_DEVELOPER_TYPE Apigee no utiliza esta propiedad.

Tipo de desarrollador Entre los valores válidos, se incluyen TRUSTED o UNTRUSTED.
Es agente MINT_IS_BROKER Marca que especifica si los ingresos se basan en la cantidad neta.
Nombre legal MINT_DEVELOPER_LEGAL_NAME Es el nombre legal del desarrollador que se usará en todos los informes.
Nota: Este atributo es obligatorio si el desarrollador no está agrupado con una empresa y desea suscribirse a un plan de tarifas publicado.
Facturación automática MINT_HAS_SELF_BILLING Marca que especifica si se habilitaron las facturas de facturación automática. Si está habilitada (true), la monetización genera una factura de facturación automática en lugar de una declaración de porcentaje de ingresos. Una factura de autofacturación es un documento financiero que detalla el importe que se le debe al desarrollador. Actúa como una factura para el proveedor de la API en nombre del desarrollador.
Número de autorización de exención de impuestos MINT_TAX_EXEMPT_AUTH_NO Número de exención de impuestos del Gobierno, si corresponde
Tasa impositiva MINT_APPROX_TAX_RATE Es la tasa impositiva aproximada para el desarrollador. Especifica un valor decimal con una cantidad máxima de 3 caracteres antes del punto decimal y 4 caracteres después del punto decimal.

Administra desarrolladores mediante la API

Administra a los desarrolladores mediante las API para desarrolladores.

Cuando crees y actualices un desarrollador con la API, puedes configurar los atributos de monetización que se describen en Configuración de atributos de monetización, según sea necesario.