Creación y uso de grupos para administrar cuentas de desarrollador en Azure API Management

  • Artículo

SE APLICA A: Desarrollador | Básico | Básico v2 | Estándar | Estándar v2 | Premium

En API Management, los grupos se usan para administrar la visibilidad de productos para los desarrolladores. Los productos son visibles en primer lugar para los grupos y luego los desarrolladores de dichos grupos pueden ver y suscribirse a los productos asociados a los grupos.

API Management tiene los siguientes grupos invariables del sistema:

  • Administradores. Los administradores de suscripciones de Azure son miembros de este grupo. Los administradores controlan las instancias del servicio Administración de API y crean las API, las operaciones y los productos que usan los desarrolladores. No se pueden agregar usuarios a este grupo.

    Nota

    Puede cambiar la configuración de correo electrónico del administrador usada en las notificaciones enviadas a los desarrolladores desde su instancia de API Management.

  • Desarrolladores. Los usuarios autenticados del portal para desarrolladores forman este grupo. Los desarrolladores son los clientes que compilan aplicaciones con sus API. Los desarrolladores, después de que se les concede acceso al portal para desarrolladores, crean aplicaciones que llaman a las operaciones de una API.

  • Invitados : a este grupo pertenecen los usuarios del portal para desarrolladores no autenticados como, por ejemplo, clientes potenciales que visitan el portal para desarrolladores de una instancia de API Management. Se les concede determinado acceso de solo lectura, como por ejemplo la posibilidad de ver API pero no llamarlas.

Además de estos grupos del sistema, los administradores pueden crear grupos personalizados o usar grupos externos en inquilinos de Microsoft Entra asociados. Los grupos personalizados y externos pueden usarse junto con grupos del sistema en la concesión a los desarrolladores de visibilidad y acceso a productos de la API. Por ejemplo, podría crear un grupo personalizado para los desarrolladores afiliados a una organización asociada específica y permitirles el acceso a las API a partir de un producto que contenga solo las API relevantes. Un usuario puede ser miembro de más de un grupo.

En esta guía se muestra cómo los administradores de una instancia de API Management pueden agregar nuevos grupos y asociarlos a productos y desarrolladores.

Además de crear y administrar grupos en Azure Portal, puede crear y administrar sus grupos mediante la entidad de grupo de la API REST de API Management.

Requisitos previos

Complete las tareas de este artículo: Creación de una instancia de Azure API Management.

Vaya a la instancia de API Management.

  1. En Azure Portal, busque y seleccione Servicios de API Management.

    Seleccionar servicios de API Management

  2. En la página de servicios API Management, seleccione la instancia de API Management.

    Seleccionar su instancia de API Management

Creación de un grupo

En esta sección se explica cómo agregar un nuevo grupo a la cuenta de API Management.

  1. Seleccione la pestaña Grupos a la izquierda de la pantalla.

  2. Haga clic en +Agregar.

  3. Especifique un nombre único para el grupo y una descripción opcional.

  4. Pulse Crear.

    Captura de pantalla de la creación de un grupo en el portal. Una vez creado el grupo, se agrega a la lista Grupos.

    • Para editar el Nombre o la Descripción del grupo, haga clic en el nombre del grupo y seleccione Configuración.

    • Para eliminar el grupo, haga clic en el nombre del grupo y después en Eliminar.

Ahora que se ha creado el grupo, se puede asociar a productos y desarrolladores.

Asociación de un grupo a un producto

  1. Seleccione la pestaña Productos a la izquierda.

  2. Haga clic en el nombre del producto deseado.

  3. Presione Control de acceso>+ Agregar grupo.

  4. Seleccione el grupo que desea agregar.

    Captura de pantalla de la adición de un grupo a un producto en el portal.

Una vez asociado un producto a un grupo, los desarrolladores del grupo pueden ver el producto y suscribirse a él.

Nota:

Para agregar grupos de Microsoft Entra, vea Autorización de cuentas de desarrollador mediante Microsoft Entra ID en Azure API Management.

Para quitar un grupo del producto, haga clic en Eliminar.

Captura de pantalla de la eliminación de un grupo de un producto en el portal.

Asociación de grupos a desarrolladores

En esta sección se explica cómo asociar grupos con miembros.

  1. Seleccione la pestaña Grupos a la izquierda de la pantalla y, a continuación, seleccione un grupo.

  2. Seleccione Miembros>+ Agregar.

  3. Seleccione un miembro.

    Captura de pantalla de la adición de un miembro a un grupo en el portal.

  4. Haga clic en Seleccionar.

Una vez agregada, la asociación entre el desarrollador y el grupo se puede ver en la pestaña Usuarios .

Pasos siguientes