Página de Gestión de Usuarios en la Consola de Administración de Jitterbit

Descripción general

Introducción

Cuando un usuario acepta una invitación para unirse a una organización, lo que puede acceder en Harmony depende de si fue invitado como usuario de Harmony o como usuario externo. Para usuarios de Harmony, el acceso se define por los roles que se les asignan, los permisos que otorga cada rol y los niveles de acceso que esos roles tienen en diferentes entornos. Los usuarios externos no tienen roles y solo pueden acceder al Portal del Administrador de API.

Los administradores de la organización utilizan la página Entornos para gestionar entornos y niveles de acceso, y la página Gestión de Usuarios para gestionar usuarios de Harmony, usuarios externos y roles.

Usuarios de Harmony

Utiliza la pestaña Usuarios de Harmony para gestionar usuarios de Harmony:

Debajo de la barra de pestañas hay una barra de herramientas con lo siguiente:

• Buscar: Ingresa texto y presiona retorno para buscar un usuario.

• Filtrar columnas: Haz clic para abrir el cajón de Columnas.

• Descargar CSV: Haz clic para descargar un conjunto comprimido de archivos CSV que contienen la información de la tabla.

• Agregar usuario: Haz clic para agregar un usuario de Harmony.

Debajo de la barra de herramientas hay una tabla con las siguientes columnas:

• Correo electrónico: La dirección de correo electrónico del usuario.

• Roles: El rol o los roles asignados al usuario.

• Estado: El estado del usuario, ya sea Activo o Inactivo.

• Acciones: Estas acciones están disponibles cuando pasas el cursor sobre la columna Acciones:

  • Eliminar usuario: Haz clic para eliminar el usuario de Harmony.

Agregar un usuario de Harmony

Para agregar un usuario de Harmony:

1. Haz clic en Agregar usuario de Harmony o Agregar usuario. Una fila nueva aparece en la tabla:

   

2. Establece los valores de la siguiente manera:

   • Correo electrónico: Ingresa la dirección de correo electrónico del usuario de Harmony. La dirección de correo electrónico debe ser única para cada región de Harmony a la que el usuario tenga acceso. Si la organización tiene SSO habilitado, la dirección de correo electrónico debe coincidir con la utilizada por el proveedor de identidad SSO.

     Consejo

     Si un usuario necesita acceso en múltiples regiones de Harmony y su proveedor de correo electrónico admite direccionamiento con símbolo más, puedes agregar un símbolo + y una etiqueta (ejemplo: username+tag@domain.com) al nombre de usuario del correo electrónico para crear una subdirección única para propósitos de registro.

     Nota

     Un usuario puede ser invitado a una organización habilitada para SSO, o a una o más organizaciones sin SSO. Un usuario no puede ser miembro de una organización tanto habilitada como deshabilitada para SSO.

   • Roles: Haz clic para abrir el menú y luego selecciona uno o más roles.

3. Haz clic en Enviar invitación para enviar un correo electrónico al usuario. Para cancelar la acción en cualquier momento antes de enviar, haz clic en Cancelar.

Editar un usuario de Harmony

Para asignar, desasignar, activar o desactivar los roles de un usuario, haz clic en cualquiera de los roles en la columna Roles (si está visible). Se abre el cajón User Role Settings:

El cajón tiene los siguientes controles:

• Assigned User Roles: Utiliza los interruptores para desactivar o activar roles para el usuario:

  • Active: El rol asignado está activo. Haz clic para desactivarlo.

  • Inactive: El rol asignado está inactivo. Haz clic para activarlo.

  • Unassign User Role: Desasigna el rol del usuario.

• Unassigned User Roles:

  • Para asignar un rol que existe pero no está asignado, coloca el cursor sobre uno y luego haz clic en Assign.

  • + New Role: Crea un nuevo rol. El título del cajón cambia a Create a New Role:

    • Role Name: Ingresa un nombre para el nuevo rol.

    • Permissions: Selecciona al menos un permiso.

    Haz clic en Save para guardar el nuevo rol.

    Haz clic en para cerrar el cajón Create a New Role y volver al cajón User Role Settings.

Eliminar un usuario de Harmony

Para eliminar un usuario de Harmony, coloca el cursor sobre la columna Actions y luego haz clic en Remove user. Aparece el siguiente diálogo:

Ingresa la palabra REMOVE donde se indica y luego haz clic en el botón Remove.

Usuarios externos

La pestaña External Users es donde los administradores administran el acceso de un usuario externo a sus API asignadas o grupos de API y la página API Portal:

Debajo de la barra de pestañas hay una barra de herramientas con lo siguiente:

• Download CSV: Haz clic para descargar un conjunto comprimido de archivos CSV que contienen la información de la tabla.

• Filter Columns: Haz clic para abrir el cajón Columns.

• Invite external user: Haz clic para agregar un usuario externo.

Debajo de la barra de herramientas hay una tabla con las siguientes columnas:

• Email: La dirección de correo electrónico del usuario.

• Name: El nombre del usuario.

• Company: El nombre de la empresa del usuario.

• Status: El estado de acceso del usuario:

  • Requested: Se envió una invitación pero no ha sido aceptada.

  • Active: El acceso del usuario está activo.

  • Suspended: El acceso del usuario está suspendido.

  • Expired: El acceso del usuario ha caducado.

• Access To: Haz clic en API Portal para abrir el cajón API Portal y luego selecciona a qué grupos de API y API puede acceder el usuario.

• Access Expires: La fecha de vencimiento del acceso del usuario. El acceso vence a las 11:59 p. m. en el día seleccionado en la zona horaria local del usuario.

• Last Login: La fecha del último inicio de sesión del usuario.

• Member Since: La fecha en que el usuario registró su cuenta.

• Actions: Estas acciones están disponibles al pasar el cursor sobre la columna Actions:

  • Resend: Visible cuando la columna Status de un usuario muestra Requested o Expired. Haz clic para reenviar la invitación de registro.

  • Edit: Visible cuando la columna Status de un usuario muestra Active o Suspended. Haz clic para editar la fecha de vencimiento del acceso de un usuario registrado.

  • Delete: Elimina el usuario.

Agregar un usuario externo

Para agregar un usuario externo:

1. Haz clic en Add external user o Invite external user. Aparece una nueva fila en la tabla:

1. Configura los valores de la siguiente manera:

   • Email: Ingresa la dirección de correo electrónico del usuario externo. La dirección de correo electrónico no puede ser la de un usuario de Harmony existente.

   • Access To: Este campo está configurado en APIM (Portal de API Manager) y no se puede cambiar.

   • Access Expires:

     • Never: Con el botón desactivado, el acceso del usuario nunca vence.

     • Set date: Con el botón activado, haz clic en el ícono para abrir un calendario y selecciona una fecha de vencimiento. El acceso vence a las 11:59 pm en el día seleccionado en la zona horaria local del usuario.

2. Haz clic en Submit para enviar un correo electrónico de registro al usuario externo. Al enviar, el correo electrónico de registro incluye un enlace que solicita al destinatario que se registre como usuario del Portal de API Manager.

Edit an external user

Puedes editar la fecha de vencimiento del acceso y los grupos de acceso para usuarios externos registrados:

• Para cambiar la fecha de vencimiento del acceso de un usuario, coloca el cursor en la columna Actions, luego haz clic en Edit external user.

  Configura Access Expires de la siguiente manera:

  • Never: Con el botón desactivado, el acceso del usuario nunca vence.

  • Set Date: Con el botón activado, haz clic en el ícono para abrir un calendario y selecciona una fecha de vencimiento. La hora de vencimiento es las 11:59 pm en la zona horaria de la máquina local del usuario externo. La configuración regional de tu navegador determina cómo se muestran las fechas.

  Haz clic en para guardar, o en para cancelar.

• Para cambiar los grupos de acceso de un usuario, haz clic en el botón API Portal en la columna Access To del usuario. Se abre el cajón de configuración.

  En API Groups, selecciona los grupos a los que deseas que el usuario acceda. En APIs, selecciona un entorno y luego selecciona las APIs a las que deseas que el usuario acceda.

  Nota

  Los usuarios que solo tienen el permiso User Manager tienen acceso a todos los entornos en el cajón API Portal con el propósito de asignar y desasignar APIs a usuarios externos. Este acceso no constituye acceso de rol de entorno y no otorga acceso a ninguna otra aplicación o página de Harmony que requiera acceso de entorno.

  Haz clic en el ícono Close para cerrar el cajón.

Delete an external user

Para eliminar un usuario externo y revocar su acceso al Portal de API Manager, coloca el cursor en la columna Actions del usuario y luego haz clic en Delete external user. Aparece el siguiente diálogo:

Haz clic en el botón Delete para eliminar permanentemente el usuario externo, o haz clic en el botón Cancel para cancelar.

Roles

Usa la pestaña Roles para administrar roles de usuario de Harmony:

Debajo de la barra de pestañas hay una barra de herramientas con lo siguiente:

• Search: Ingresa texto y presiona Retornar para buscar un rol. El texto coincide con cualquier cosa en las columnas Role, Permissions o Status.

• Filter Columns: Haz clic para abrir el cajón Columns.

• Download CSV: Haz clic para descargar un conjunto comprimido de archivos CSV que contiene la información de la tabla.

• Add Role: Haz clic para agregar un rol.

Los encabezados de columna de la tabla son los siguientes:

• Role: El nombre del rol.

• Permissions: Los permisos del rol.

• Status: El estado del rol, ya sea Active o Inactive.

• Actions: Coloca el cursor sobre un rol activo para revelar las siguientes acciones:

  • Edit Role: Haz clic para editar el rol. Solo los roles activos se pueden editar.

• Eliminar Rol: Haz clic para eliminar el rol.

Agregar un rol

Para agregar un rol:

1. Haz clic en el icono Agregar Rol, o en el botón Agregar Rol si no hay roles. Aparece una fila nueva en la tabla:

   

2. Ingresa o selecciona valores de la siguiente manera:

   • Nombre del Rol: Ingresa un nombre único para el rol. El nombre del rol no puede contener caracteres especiales (como @ $ % & / + ( ) : ; ,).

   • Permisos: Haz clic para abrir el menú y selecciona al menos un permiso de la lista.

     Nota

     El permiso App Developer está deprecado y ya no se utiliza.

3. Haz clic en el botón Guardar para guardar el rol.

Editar un rol

Se puede editar un rol para cambiar su estado (activo o inactivo), su nombre y los permisos que otorga. También se puede cambiar el estado de usuarios individuales asignados a un rol, o desasignar usuarios de un rol.

• El estado de un rol es activo de forma predeterminada. Para desactivar un rol, haz clic en el conmutador del rol en la columna Estado. Aparece un diálogo Desactivar Rol:

  Texto del diálogo

  Desactivar Rol
  ¿Estás seguro de que deseas desactivar el rol roleName? Esto desactivará el rol para todos los usuarios asignados.

  Por favor, escribe "DEACTIVATE" para confirmar.

  Ingresa la palabra DEACTIVATE donde se indica y luego haz clic en el botón Desactivar.

  Para reactivar un rol inactivo, haz clic en el conmutador del rol en la columna Estado. No se necesita confirmación adicional para esta acción.

• Para editar el nombre o los permisos de un rol, pasa el cursor sobre la columna Acciones del rol y luego haz clic en Editar Rol. El rol se abre en una fila Editar Rol:

  

  Edita los valores de Nombre del Rol o Permisos.

  Haz clic en Guardar para guardar los cambios.

  Nota

  Los roles Administrador y Usuario no se pueden editar, eliminar ni desactivar.

Eliminar un rol

Para eliminar un rol, pasa el cursor sobre la columna Acciones del rol y luego haz clic en Eliminar Rol. Aparece un diálogo de confirmación.

Si el rol no tiene acceso a proyectos o APIs asignados, el diálogo solicita confirmación sin pasos adicionales. Haz clic en Eliminar para eliminar el rol.

Si el rol tiene acceso a proyectos o APIs asignados, el diálogo incluye una advertencia de que eliminar el rol lo eliminará de todas las APIs y proyectos de Studio asignados:

Selecciona la casilla Desasignar todo el acceso a proyectos y APIs para confirmar que comprendes el impacto y luego haz clic en Eliminar. El botón Eliminar permanece deshabilitado hasta que se seleccione la casilla.

Cajón de Asignaciones de Rol

Cuando se selecciona un rol en la tabla Roles, se abre un cajón en la parte inferior de la pantalla con las siguientes pestañas:

• Usuarios asignados

• Acceso de rol del entorno

• Acceso a proyectos

• Acceso a APIs

La barra de herramientas de pestañas muestra los nombres de las pestañas, el número de elementos en cada una y los siguientes iconos:

• Anterior: Selecciona el rol anterior en la tabla de roles.

• Siguiente: Selecciona el rol siguiente en la tabla de roles.

• Pantalla completa: Expande el panel.

• Cerrar: Cierra el panel.

Pestaña Usuarios Asignados

En la pestaña Usuarios Asignados, puedes ver qué usuarios están asignados a un rol, activar o desactivar el estado del rol de un usuario, desasignar un usuario y asignar un usuario al rol seleccionado:

Utiliza el cuadro de búsqueda encima de la tabla para filtrar la lista por dirección de correo electrónico, con la porción de texto coincidente resaltada.

Para cambiar el estado del rol de un usuario, haz clic en el interruptor User Role Status.

Para desasignar un usuario de un rol, colócate sobre la columna Actions del usuario y luego haz clic en Unassign user. Se abre un diálogo que te pide confirmar la acción.

Para asignar uno o más usuarios, haz clic en Assign user. En el diálogo Assign Harmony Users, selecciona uno o más usuarios y luego haz clic en Assign.

Pestaña Environment Role Access

En la pestaña Environment Role Access, puedes ver y editar los niveles de acceso que tiene el rol en cada uno de los entornos de la organización:

Utiliza el cuadro de búsqueda encima de la tabla para filtrar la lista por nombre de entorno, con la porción de texto coincidente resaltada.

Para cambiar el nivel de acceso de un entorno, haz clic en el interruptor correspondiente a los niveles View Logs, Read, Execute y Write.

Pestaña Project access

En la pestaña Project access, puedes ver y gestionar a qué proyectos de Studio puede acceder el rol. La pestaña lista un proyecto solo cuando se cumplen ambas condiciones siguientes:

• El rol seleccionado tiene al menos acceso de rol de entorno Read al entorno al que pertenece el proyecto.

• Tu propia cuenta de usuario también tiene al menos acceso de rol de entorno Read a ese entorno.

La pestaña muestra las siguientes columnas:

Utiliza el cuadro de búsqueda encima de la tabla para filtrar la lista por nombre de proyecto o entorno, con la porción de texto coincidente resaltada.

• Project Name: El nombre del proyecto de Studio.

• Environment: El entorno al que pertenece el proyecto.

• Access Level: El nivel de acceso otorgado al rol para el proyecto.

• Assign: Un interruptor para asignar o desasignar el acceso del rol al proyecto:

  • Assigned: El rol tiene acceso al proyecto. Haz clic para desasignar.

  • Unassigned: El rol no tiene acceso al proyecto. Haz clic para asignar.

• Actions: Colócate sobre una fila para revelar la acción Unassign. Haz clic para desasignar el rol del proyecto.

Para asignar o desasignar múltiples proyectos a la vez, selecciona las casillas junto a los proyectos y luego utiliza los controles de acciones en lote que aparecen en la barra de herramientas.

Pestaña Acceso a API

En la pestaña Acceso a API, se puede ver y administrar a qué APIs tiene acceso el rol. La pestaña utiliza el mismo alcance basado en entornos que la pestaña Acceso al proyecto: una API se muestra únicamente cuando tanto el rol seleccionado como la propia cuenta de usuario tienen al menos acceso de rol de entorno Lectura a environment role access al entorno de la API.

La pestaña muestra las siguientes columnas:

Utiliza el cuadro de búsqueda encima de la tabla para filtrar la lista por nombre de API o entorno, con la porción de texto coincidente resaltada.

• Nombre de API: El nombre de la API.

• Versión: La versión de la API.

• Entorno: El entorno al que pertenece la API.

• Tipo: El tipo de API.

• Nivel de acceso: El nivel de acceso otorgado al rol para la API.

• Asignar: Un botón de alternancia para asignar o desasignar el acceso del rol a la API:

  • Asignado: El rol tiene acceso a la API. Haz clic para desasignar.

  • Sin asignar: El rol no tiene acceso a la API. Haz clic para asignar.

Para asignar o desasignar múltiples APIs a la vez, selecciona las casillas junto a las APIs y luego utiliza los controles de acción en lote que aparecen en la barra de herramientas.

Permisos de rol

El acceso de un usuario a Harmony depende de los roles asignados y los permisos que otorga cada rol. Se debe asignar al menos un permiso a cada rol. Se puede asignar cualquier combinación de los siguientes permisos:

• Administrador: Este permiso otorga al usuario acceso completo a todas las partes de Harmony que no requieren acceso explícito a nivel de entorno. Cuando se selecciona, se otorgan todos los demás permisos, incluso si no están configurados explícitamente. En organizaciones cuya suscripción de Harmony ha expirado, el permiso Administrador proporciona acceso de solo lectura a las aplicaciones y páginas que se muestran en la tabla inferior.

• Administrador de usuarios: Con este permiso, un usuario puede administrar usuarios y roles que no sean administradores. Puede agregar, editar o eliminar usuarios que no sean administradores, pero no puede cambiar un usuario de no administrador a administrador. También puede administrar usuarios externos. Los usuarios que solo tienen este permiso ven únicamente la página Gestión de usuarios en la navegación de la Consola de administración. Los roles que solo tienen permiso de Administrador de usuarios tienen todos los niveles de acceso de entorno deshabilitados en la pestaña Acceso de rol de entorno. La excepción es el flujo de Usuarios externos: los usuarios que solo tienen este permiso tienen acceso a todos los entornos en el cajón Portal de API con el propósito de asignar y desasignar APIs a usuarios externos. Este acceso no constituye acceso de rol de entorno ni otorga acceso a otras aplicaciones o páginas de Harmony que requieran acceso de entorno.

• Instalación de agentes: Este permiso, cuando se utiliza junto con los niveles de acceso de entorno, permite al usuario instalar agentes en un entorno. Sin niveles de acceso de entorno, este permiso solo permite acceso a la página de destino del portal de Harmony y sus enlaces.

• Consumidor de API: Este permiso, cuando se utiliza junto con los niveles de acceso de entorno, permite al usuario ver la documentación de OpenAPI en un entorno. Sin niveles de acceso de entorno, este permiso permite acceso a la página Portal de API de API Manager. Los usuarios con este permiso también pueden acceder a la página de destino del portal de Harmony y sus enlaces en la organización a la que se accede si tienen roles en otras organizaciones. (Una alternativa al uso de este permiso es agregar usuarios externos.)

• Desarrollador de aplicaciones: Este permiso está obsoleto y ya no está en uso.

• Usuario de EDI: Este permiso permite que un usuario de EDI cree y actualice socios, transacciones y configuraciones de EDI.

• Visor de EDI: Este permiso permite que un usuario de EDI vea socios, transacciones y configuraciones de EDI.

• Usuario de MCP: Este permiso permite que las credenciales de un usuario autentiquen una herramienta Jitterbit Operation en Jitterbit MCP.

• Lectura: Este permiso otorga al usuario acceso mínimo de solo lectura a las aplicaciones y páginas que se muestran en la tabla a continuación.

Los permisos permiten el siguiente acceso a las aplicaciones y páginas de Jitterbit Harmony:

Configuración de tabla

Se puede modificar la configuración de tabla de la siguiente manera:

• Para redimensionar columnas, arrastra la barra Redimensionar de una columna.

• Para reorganizar columnas, haz clic en Filtrar columnas. Se abre el panel Columnas con los siguientes controles:

  • Mostrar todo: Hace visibles todas las columnas.

  • Mover: Arrastra y suelta para cambiar la posición de la columna respecto a las demás.

  • Ocultar: La columna es visible. Haz clic para ocultarla.

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

  • Guardar: Guarda las columnas.

  • Cancelar: Cierra el panel de columnas sin guardar los cambios.

• (Solo pestañas Usuarios de Harmony y Roles.) Para ordenar una tabla en orden ascendente, haz clic en el encabezado de una columna. Haz clic de nuevo para invertir el orden.

Solución de problemas

Para la solución de problemas relacionada, consulta lo siguiente en la guía de solución de problemas de Harmony:

• La adición de un usuario externo falla con un error 409 conflict

• El acceso del usuario externo a API Portal expira en un momento inesperado