Consumers

" Gestiona el acceso a tus servicios de manera segura "

¿Por qué son importantes los Consumers? Los Consumers son clave para administrar quién puede acceder a los servicios de tu API y con qué permisos. Te permiten asignar diferentes tipos de autenticación, como claves API o tokens, y gestionar la seguridad y el control de acceso a nivel individual. Esto garantiza que solo usuarios autorizados interactúen con tus servicios, proporcionando un acceso seguro y personalizado.

La interfaz Consumers está diseñada para visualizar, crear y editar los consumers (consumidores) en la instancia de Kong seleccionada. Los consumers representan las identidades de los clientes o usuarios que acceden a los servicios a través del gateway.

A través de esta interfaz, los usuarios pueden gestionar completamente los consumers, incluyendo la creación de nuevos, la edición de perfiles, la asignación de credenciales (como claves de API, tokens o certificados) y la configuración de permisos específicos. Además, permite vincular los consumers con plugins de autenticación y control de acceso, garantizando que solo los usuarios autorizados puedan interactuar con los servicios administrados por el gateway.

Esta funcionalidad facilita un control granular sobre quién puede acceder a las APIs, proporcionando una administración eficiente y segura de los consumidores en la plataforma.

La interfaz despliega una lista de los consumers, mostrando la siguiente información clave:

• Name: Es el identificador único del consumer. Este campo permite distinguir a los diferentes usuarios o clientes que interactúan con los servicios a través del gateway. El nombre es esencial para la administración y asignación de credenciales o permisos.
• Custom ID: Es un identificador personalizado opcional que puede ser asignado al consumer. Este campo es útil cuando se necesita asociar a un consumer con un sistema externo o base de datos, brindando flexibilidad para enlazar identidades entre diferentes sistemas.
• Tags: Son etiquetas opcionales que se pueden asignar a cada consumer. Las etiquetas permiten organizar y clasificar a los consumers de acuerdo con diferentes criterios, lo que facilita su gestión y búsqueda, especialmente cuando hay un gran número de usuarios en la plataforma.
• Created: Indica cuándo fue creado el consumer en la instancia de Kong. Este campo es útil para fines de auditoría, permitiendo saber cuándo se añadió un usuario específico al sistema y facilitando el seguimiento de cambios o accesos.
• Actions: Mostrar, Editar, Eliminar

Estos campos permiten gestionar de manera detallada y organizada a los consumers, facilitando la administración eficiente del acceso a los servicios en la plataforma.

Opciones sobre los Consumers:

• Create

  La interfaz de Consumers ofrece la funcionalidad de Crear, permitiendo a los usuarios añadir nuevos consumers (consumidores) a la instancia de Kong. Al seleccionar esta opción, se abre un formulario en el que se pueden ingresar los detalles necesarios como:

  • Username: Nombre del consumidor

  • Custom ID: identificador personalizado

  • Tags: etiquetas que se deseen asignar

    

  Además, se pueden configurar credenciales y permisos específicos, asegurando que el nuevo consumer tenga el acceso adecuado a los servicios gestionados por el gateway. Esta funcionalidad facilita la administración de usuarios y el control de acceso dentro de la plataforma.

• Show Consumers

  La opción Show permite visualizar los detalles completos del consumer seleccionado en un recuadro.

  Esta funcionalidad facilita la revisión y gestión de la configuración del consumer dentro de la instancia de Kong, proporcionando un control completo sobre su acceso a los servicios.

  La información que se despliega incluye:

  • username: El nombre de usuario asignado al consumer.
  • id: Identificador único del consumer en la instancia de Kong.
  • created_at: Fecha de creación del consumer, útil para auditoría y seguimiento.
  • custom_id: Identificador personalizado opcional, utilizado para asociar al consumer con sistemas externos.
  • tags: Etiquetas asignadas al consumer para organizar y clasificarlo.

  Tal como se visualiza en la siguiente figura:

  

  Estos detalles proporcionan una visión completa de los consumers y facilitan la administración eficiente de su acceso a los servicios gestionados por el gateway.

• Remove Consumers (Eliminar)

  La opción "Remove" permite eliminar consumers de la instancia de Kong. Al seleccionar esta opción, el consumer específico se quita de la lista de usuarios activos, revocando sus credenciales y permisos asociados. Esto facilita la gestión del gateway, permitiendo eliminar usuarios que ya no necesitan acceso a los servicios administrados, asegurando un control eficiente y actualizado del acceso.

  Cuando se elige esta opción para un consumers específico de la lista, se desplegará un mensaje solicitando confirmación para la eliminación, asegurando que el usuario revise y confirme la acción antes de proceder.

  

• Editar Consumers (Edit)

  La opción Editar Consumers permite visualizar y modificar la información relevante del consumer seleccionado de la lista, para la instancia de Kong seleccionada.

  

  Al acceder a esta opción, los usuarios pueden actualizar detalles como: Username, Custom ID y Tags.

  Además, esta interfaz Edit permite gestionar Credenciales y Plugins asociados, asegurando que el consumer esté correctamente configurado para interactuar con los servicios del gateway. Esta funcionalidad facilita la personalización y administración completa de los accesos del consumer, garantizando una integración eficiente y segura con las APIs gestionadas por Kong.

  • Credentials

    Esta funcionalidad permite crear o remover credenciales de distintos tipos, proporcionando flexibilidad en la gestión de acceso y autenticación de los consumers en Kong, tal como se muestra en la siguiente figura:

    

    Los tipos de credenciales que se pueden administrar incluyen:

    • BASIC: Autenticación básica mediante usuario y contraseña. donde se solicita la siguiente información:

      • Username: Nombre de usuario
      • Password: Contraseña del usuario.

    • KEY: Autenticación mediante claves API. donde se solicita la siguiente información:

      • API key: Clave API que se asigna al consumer

    • HMAC: Autenticación basada en Hash-based Message Authentication Code (HMAC).

      • Username: Nombre de usuario para HMAC
      • Secret Key: Clave secreta utilizada para generar los códigos HMAC

    • OAUTH: Autenticación a través del protocolo OAuth.

      • Name: Nombre de la aplicación OAuth
      • Client ID: ID del cliente OAuth
      • Client Secret Key: Clave secreta del cliente
      • Redirect Url: URL de redirección autorizada para la aplicación

    • JWT: Autenticación mediante JSON Web Tokens (JWT).

      • Secret Key: Clave secreta utilizada para firmar el token JWT
      • Algorithm: Algoritmo de firma utilizado (por ejemplo, HS256)
      • RSA Public Key: Clave pública RSA para verificación del token
      • Secret: Clave adicional para la validación del token

    Estos tipos de credenciales permiten a Kong manejar múltiples métodos de autenticación para garantizar que los consumers accedan a los servicios de manera segura y adecuada según los requisitos del sistema.

    Todas estos tipos de credenciales tienes la funcionalidad de poder ser removidas. Si se solicita remover, se desplegará un mensaje solicitando confirmación para la eliminación, asegurando que el usuario revise y confirme la acción antes de proceder.

  • Plugins

    Se entiende como Plugins a los componentes que extienden las capacidades del gateway, añadiendo funcionalidades como autenticación, control de acceso, monitoreo y limitación de velocidad, personalizables por servicio, ruta o consumidor.

    Al seleccionar la opción indicada, permitirá gestionar y configurar los plugins aplicables a los consumidores dentro de la instancia de Kong.

    

    El funcionamiento de estas opciones sobre los plugins se detalla en la sección "Gateway Plugins", que se encuentra más adelante. Allí se explican en profundidad las acciones disponibles, para facilitar su gestión y configuración dentro de la instancia de Kong.