Ambientes¶

Introducción¶

La página Ambientes de la Management Console permite a los administradores de la organización de Harmony configurar ambientes dentro de una organización para definir y administrar el ciclo de vida de un proyecto de integración. Debe configurar al menos un ambiente para crear proyectos dentro de Harmony.

Miembros de un rol al que se le ha otorgado acceso de al ambiente Lectura también pueden acceder a la página Ambientes. Los miembros de un rol al que se le ha otorgado acceso de Escritura al ambiente tienen acceso de escritura en ese ambiente.

Cada proyecto de integración se implementa en un ambiente de Harmony específico. Los ambientes se pueden utilizar para separar los diferentes estados de un proyecto de integración. Por ejemplo, una configuración de ciclo de vida de proyecto común podría tener tres ambientes: Desarrollo, Prueba y Producción.

El acceso que tienen los usuarios en un ambiente específico depende de la combinación de los permisos de su rol y su acceso al ambiente:

• Los permisos de un rol los definen los administradores de la organización en Administración de usuarios página.
• A un rol se le concede acceso a un ambiente como se describe en Administrar el acceso de rol a ambientes más adelante en esta página.

Para acceder a un ambiente, todos los roles (incluso los roles con permiso_Admin_) deben tener acceso a un ambiente para la mayoría de las aplicaciones. Esto incluye poder acceder a áreas de aplicaciones de Harmony que requieren que se seleccione un ambiente y la capacidad de instalar agentes en un ambiente. Las excepciones son EDI y App Builder aplicaciones que no requieren que se otorgue ningún nivel de acceso al ambiente a los roles; el acceso a estas aplicaciones está regido por permisos de rol solo.

Cuando esté listo para mover un proyecto entre ambientes, como de Desarrollo a Prueba, migre el proyecto. Esto se puede hacer desde Cloud Studio (consulte Migración de proyectos) o Design Studio (en Archivo > Migrar proyecto).

Acceda a la Página de Ambientes¶

Los usuarios pueden ver o editar la página Ambientes dependiendo de la combinación de los permisos de su rol en la organización y su acceso al ambiente:

• Los miembros de un rol con solo permiso de Lectura a cuyo rol se le ha otorgado acceso a un ambiente pueden ver información sobre el ambiente en la página Ambientes, pero no pueden editarla.
• Los miembros de un rol con permiso Admin pueden ver y usar todas las acciones para todos los ambientes en la página Ambientes (incluso si no se les ha otorgado acceso de rol al ambiente).

Para acceder a la página Ambientes, inicie sesión en el portal Harmony, luego use el menú del portal Harmony en la parte superior izquierda para ir a Management Console > Ambientes:

Gestionar Ambientes¶

Los administradores de la organización de Harmony (miembros de un rol con permiso_Admin_) administran cada ambiente y los grupos de agentes asociados a él. Los miembros de un rol con solo permiso Read a cuyo rol se le ha otorgado acceso a un ambiente pueden ver información sobre el ambiente, pero no pueden agregar, editar ni eliminar ambientes.

Ver Ambientes¶

La sección superior de la página Ambientes contiene una tabla que muestra todos los ambientes a los que tiene acceso dentro de la organización seleccionada:

La tabla muestra información para cada ambiente. Estos campos son configurables como se explica en las siguientes secciones:

• Nombre: El nombre del ambiente.

• ID: El identificador del ambiente.

• Clase: La clase del ambiente solo para fines de informes.

• Grupo de Agente: El grupo de agentes asociado con el ambiente. Para obtener más información, consulte Agentes.

• Prefijo de URL: El prefijo de URL del ambiente, que se utilizará con APIs personalizadas, OData y proxy creadas con API Manager.

• Límite de visitas: La cantidad máxima de visitas a la API por minuto dentro del ambiente, para usar con API Manager.

Otros campos de la tabla contienen estadísticas completadas automáticamente sobre su ambiente, incluidos recuentos de estos elementos:

• Proyectos: El número total combinado de proyectos de Cloud Studio y Design Studio proyectos implementados en Harmony por el ambiente.

• Operaciones: El número total combinado de operaciones de Cloud Studio y operaciones del Design Studio implementados en Harmony con el ambiente.

• Conexiones: El número total combinado de conexiones de Cloud Studio y Design Studio fuentes, objetivos, Asistente de conexión Jitterbit, y asistente de conector extremos.

• extremos alojados: El número total combinado de Design Studio extremos HTTP alojados y extremos de servicios web alojados.

• Formatos de archivo: El número total combinado de archivos de esquema de Cloud Studio y Design Studio formatos de archivo.

• Secuencias de Comandos: El número total combinado de secuencias de comandos de Cloud Studio independientes (como componente del proyecto) y secuencias de comandos de Design Studio (como elemento de proyecto).

• Acciones: Pase el cursor sobre una fila para revelar los siguientes controles de acción:

  • Editar: Editar el ambiente.

  • Eliminar: Eliminar el ambiente.

Para ordenar la tabla, haga clic en cualquiera de los encabezados de columna.

Para filtrar la tabla, utilice el cuadro de búsqueda para ingresar criterios de filtro. icono para mostrar un ejemplo de la sintaxis de búsqueda.

Muchas columnas están ocultas cuando abres la página por primera vez. Para cambiar la visibilidad y el orden de las columnas, haz clic en Configuración de columnas. Se abre el cajón lateral Columnas:

• Filtrar columnas: Ingrese parte o la totalidad del nombre de una columna para reducir la lista a aquellas que coincidan con el texto.

• Mostrar todo: Hacer visibles todas las columnas.

• Mover: Arrastre y suelte para cambiar la posición de la columna con respecto a otras.

• Ocultar: La columna está visible. Haz clic para ocultarla.

• Mostrar: La columna está oculta. Haz clic para mostrarla.

• Guardar: Guarda los cambios realizados en las columnas.

• Cancelar y Cerrar: Cierra el editor de columnas sin guardar los cambios.

Agregar Ambientes¶

Se debe definir al menos un ambiente para cada organización. Es posible que tenga un límite en la cantidad de ambientes que puede crear según su plan de suscripción de Harmony. Si necesita ambientes adicionales, comuníquese con su Gerente de éxito del cliente.

Para agregar un ambiente, haga clic en Añadir ambiente. Aparece una nueva fila en la tabla:

• Nombre: El nombre del nuevo ambiente (por ejemplo, Desarrollo, Prueba o Producción).

  Nota

  Estos caracteres especiales no están permitidos:

  < > # % { } | \ / ^ ~ [ ] ` ; , : ? @ = &

• Clase: La clase del nuevo ambiente. Utilice el menú desplegable para seleccionar la clase que mejor describa el ambiente. Este campo es solo para fines de informes y no afecta el funcionamiento de un ambiente.

• Grupo de Agente asociado: El grupo de agentes que desea utilizar para dar servicio al nuevo ambiente. Utilice el menú desplegable para seleccionar un grupo de agentes para el ambiente, eligiendo entre un grupo de agentes privado configurado a través de la página Grupos de agentes (consulte Agentes) o uno de los grupos de agentes de nube Jitterbit (disponibles de forma predeterminada).

• Prefijo de URL: El prefijo de URL del ambiente, que se utilizará con APIs personalizadas, OData y proxy creadas con API Manager. De forma predeterminada, se utiliza el nombre del ambiente. Para obtener más información, consulte URL del servicio API.

  Ya sea que use el ambiente predeterminado o ingrese un nombre personalizado, el prefijo de URL se convierte en una parte integral de una URL del servicio de API. El prefijo URL está limitado a un máximo de 48 caracteres.

  Nota

  Estos caracteres especiales no están permitidos:

  < > # % { } | \ / ^ ~ [ ] ` ; , : ? @ = &

  Además, no se permiten espacios.

• Límite de visitas: La cantidad máxima de visitas a la API personalizada por minuto dentro del nuevo ambiente, para usar con API Manager. Si se deja en blanco, no hay límite para la cantidad de visitas a la API a nivel de ambiente y el límite de visitas por minuto predeterminado es el límite de la organización en todas las APIs en todos los ambientes (como se indica en el contrato de licencia de Jitterbit). Para obtener información adicional, consulte Límite de velocidad a nivel de perfil en Seguridad del API Manager.

• Descripción: Una descripción del nuevo ambiente.

Hacer clic Guardar para guardar la configuración, o Cancelar para cancelar.

Editar Ambientes¶

Para editar un ambiente después de crearlo, pase el cursor sobre una fila y haga clic en el icono botón Editar en la columna Acción:

Los campos editables son los mismos que cuando se agrega un ambiente.

Eliminar Ambientes¶

Para eliminar un ambiente, pase el cursor sobre una fila y haga clic en el botón Eliminar en la columna Acción. Se abre el cuadro de diálogo Eliminar ambiente:

Para continuar con la acción, ingrese la palabra ELIMINAR en el campo de texto y haga clic en el botón Eliminar.

Para abandonar la acción, haga clic en el botón Cancelar.

Administrar el Acceso de Rol a los Ambientes¶

Antes de otorgar acceso de rol a un ambiente, debe definir los roles que pueden tener acceso. La membresía individual para esos roles se define en el nivel de usuario. Una vez definidos los roles, puedes otorgarles diferentes niveles de acceso a un ambiente.

Los niveles de acceso a nivel de ambiente se utilizan en combinación con los permisos de rol para aumentar la capacidad de los administradores de controlar lo que los miembros de un rol específico pueden hacer en un ambiente específico. Por ejemplo, los usuarios con un rol de desarrollador de nivel de entrada pueden tener acceso de Lectura, Ejecución y Escritura en un ambiente de desarrollo, pero solo acceso de Lectura en un ambiente de prueba y ningún acceso en un ambiente de producción.

Niveles de Acceso¶

Al otorgarle a un rol acceso a un ambiente, puede seleccionar uno de los cuatro niveles de acceso en ambiente. Ver registros es el nivel de acceso más bajo, seguido de Lectura, Ejecución y, luego, Escritura como el nivel de acceso más alto. A medida que selecciona un nivel de acceso más alto, todos los niveles de acceso inferiores se seleccionan automáticamente y no se pueden borrar.

Los niveles de acceso son independientes y diferentes de los permisos asignados a un rol. Por ejemplo:

• Un miembro de un rol con permiso de Lectura aún puede realizar ediciones en un ambiente si se le concede acceso de Escritura al rol en el nivel del ambiente.
• Un miembro de un rol con permiso Admin pero que solo tiene acceso Lectura a nivel de ambiente no puede desplegar, ejecutar ni editar proyectos en ese ambiente.
• Un miembro de un rol con permiso Admin pero a quien no se le ha otorgado acceso al ambiente no puede acceder al ambiente en absoluto.

Los cuatro niveles de acceso al ambiente se describen en la siguiente tabla.

Portal del API Manager¶

Estos criterios adicionales deben cumplirse antes de que se pueda acceder a la página Portal de API Manager:

• Para cada API cuya documentación se vuelve accesible desde la página Portal, se debe seleccionar en la configuración de la API un rol de organización al que se le haya otorgado un mínimo de acceso de Lectura en un ambiente (consulte Paso 3: Asignar roles de usuario y perfiles de seguridad en Configuración de API Personalizada).
• La documentación de la API debe haber sido generada y publicada previamente a través del Portal Manager página.

Además del acceso a través de la aplicación API Manager, se puede acceder a la página Portal mediante:

• Un enlace directo para los consumidores de API que tienen permiso ApiConsumer en una organización y un mínimo de acceso Read en un ambiente. Para obtener el enlace directo, copie la URL de la página Portal de API Manager o el enlace a Ver documentación de API en la página Portal Manager.

• Una invitación de un administrador de la organización Harmony a través de la Management Console Administración de usuarios página.

Ver y Editar el Acceso de Rol a un Ambiente¶

Para ver o editar el acceso de rol de un ambiente, seleccione una fila en la tabla. En la sección inferior de la página Ambientes, el panel Acceso de rol muestra todos los roles a los que se les puede otorgar acceso al ambiente seleccionado:

Para seleccionar o borrar un nivel de acceso, habilite o deshabilite el interruptor de nivel de acceso. Se mostrará un cuadro de diálogo de confirmación.

Para borrar todos los niveles de acceso de un rol, haga clic en el nivel de acceso Ver registros de un rol para desactivar la selección.

Los niveles de acceso disponibles en un ambiente se describen en detalle más arriba en Niveles de acceso.

Otorgar a un Rol Acceso a un Ambiente¶

Seleccione un ambiente para revelar el panel Acceso a roles en la parte inferior de la pantalla:

• Buscar: Busca roles que coincidan con el texto. Las búsquedas no distinguen entre mayúsculas y minúsculas. Para mostrar todos los roles, borra el texto.

• Actualizar: Actualiza los roles.

• Anterior: Seleccione el ambiente anterior en la tabla.

• Siguiente: Seleccione el siguiente ambiente en la tabla.

• Pantalla completa: Aumenta el tamaño del panel Acceso a roles para que ocupe toda la ventana del navegador.

• Salir de pantalla completa: Restablecer el tamaño normal del panel Acceso a roles.

• Cerrar: Cierra el panel Acceso a roles.