¿Qué son las organizaciones y cómo las puedo gestionar?

Una organización es como un espacio privado dentro del API Portal donde los equipos pueden trabajar juntos para crear, gestionar y compartir las aplicaciones que los identifican como consumidores de las APIs. Cuando un usuario ingresa por primera vez al portal, éste le crea por defecto una organización consumidora usando su mismo nombre de usuario, desde ese momento puedes empezar a crear tus primeras aplicaciones, también puedes crear nuevas organizaciones que representen cada una de las integraciones que realiza tu equipo.

Ahora bien, recordemos que una organización puede contener una o más aplicaciones y una aplicación no puede crearse sí no pertenece a una organización, es decir, siempre debe tener una casa. Además, puedes tener aplicaciones creadas bajo el mismo nombre en diferentes organizaciones y ambientes.

La posibilidad que ofrecen las organizaciones consumidoras para trabajar de manera colaborativa se convierte en una de sus principales ventajas pues puedes compartirlas con personas de tu equipo para acceder a las credenciales de las aplicaciones con las que se está probando las APIs, así usan las mismas llaves para el consumo. 

Aquí te compartimos la información que puedes ver o las acciones que puedes ejecutar con respecto a las organizaciones:

• Crear una organización: podrás crear un espacio al que le asocies las aplicaciones de un proyecto en específico. 

• Ver todas las organizaciones: te permitirá listar todas las organizaciones que tenga asociadas a tu usuario, bajo los siguientes escenarios: 
  • Organización que se genera automáticamente luego del primer acceso al portal. 
  • Organizaciones nuevas creadas por el usuario.  
  • Organizaciones que fueron creadas por otros usuarios y a las cuáles fuiste invitado. 

• Añadir usuarios: podrás invitar nuevos usuarios a tus organizaciones y ellos podrán hacer pruebas con las aplicaciones que están asociadas a esta organización. A cada usuario que invites puedes asignarle algunos de los siguientes roles:
  • Visor:
    Puede ver:  
    • • Nombre de la organización. 
      • Las aplicaciones creadas bajo esta organización.  
      • Las asociaciones a productos de las aplicaciones creadas, con la opción de ingresar a esos productos asociados.  
      • Acciones:  
        • Ninguna 
          
          
  • Desarrollador de aplicaciones:
    Puede ver: 
    • • Nombre de la organización. 
      • Las aplicaciones creadas bajo esta organización. 
      • Las asociaciones a productos de las aplicaciones creadas, con la opción de ingresar a esos productos asociados. 
      • Acciones:  
        • Crear nuevas aplicaciones bajo esta organización. 
        • Asociar productos a las aplicaciones creadas. 
           
• Delegar o cambiar propietario de tu organización: te permite delegar la propiedad de tu organización a otro usuario en caso de que te retires del proyecto o de la compañía. De esta manera se podrán seguir gestionando las aplicaciones creadas bajo esta organización. Ver ¿qué debes tener en cuenta para delegar una organización?
• Editar organización: podrás cambiar el nombre de la organización, el propietario y modificar las funcionalidades de añadir/eliminar usuarios. 
   
• Eliminar organización: te permite eliminar la organización.
  Importante: ten en cuenta que, al eliminar una organización, también serán eliminadas las aplicaciones creadas bajo la misma y se perderán las suscripciones a los productos que estabas consumiendo.

Buenas prácticas para la gestión de organizaciones y sus aplicaciones

Sigue estas recomendaciones para mantener el orden, el control y una administración responsable de tus integraciones en nuestro portal de APIs.

1. Asigna los permisos adecuados a los integrantes de tu equipo
   Si eres el administrador de las credenciales de una aplicación consumidora, es importante que:
   • Identifiques quiénes en tu equipo necesitan acceso a la organización.
   • Asignes los roles correctos (administrador, desarrollador, etc.) para garantizar que cada persona tenga solo los permisos necesarios.
   • Esto evitará accesos no autorizados o cambios accidentales que puedan afectar las integraciones.
     
     
2. Actualiza y delega la administración en caso de ausencia prolongada
   • Si planeas ausentarte por un largo periodo (vacaciones, cambios de rol, etc.) o ya no estarás a cargo de la organización:
   • Asegúrate de transferir la administración de la organización a un compañero o líder responsable.
   • Este paso es fundamental para garantizar la continuidad segura de las integraciones entre las aplicaciones y las APIs.
     
     
3. Organiza tus suscripciones por equipos o proyectos
   • Si gestionas múltiples aplicaciones, separa las suscripciones en diferentes organizaciones. Esto te ayudará a mantener un mejor control y administración.
   • Evita acumular demasiadas integraciones en una sola aplicación consumidora. Lo ideal es que cada aplicación tenga solo 1 o 2 suscripciones.
   • ¿Por qué es importante? Si una aplicación tiene un problema, todas las conexiones asociadas a ella también se verán afectadas. ¡Evita riesgos innecesarios!

¡Tenemos novedades para ti!

Actualmente contamos con dos tipos de portales de APIs:

1. Portales de IBM: Estos incluyen todas las funcionalidades completas para gestionar organizaciones.
2. Portales propios: Estamos trabajando arduamente para implementar todas las funcionalidades en nuestros portales propios, que muy pronto reemplazarán completamente a los de IBM.

Estamos así de cerca 🤏 de lanzar una nueva versión con las herramientas completas de gestión de organizaciones. ¡Mantente atento para conocer las novedades!

¿Tienes dudas adicionales o necesitas ayuda con la gestión de tu organización o aplicaciones? ¡Nuestro equipo de soporte está aquí para ayudarte!