Integraciones en Workspace ONE Intelligence

Autorice a Workspace ONE Intelligence para que se conecte y comparta datos con servicios de terceros en el área de Integraciones. Los servicios incluyen la conexión a otros sistemas en su implementación de Workspace ONE, los servicios de automatización y los servicios de Trust Network. Busque información acerca de Workspace ONE UEM, Slack, ServiceNow y las aprobaciones de aplicaciones.

Workspace ONE UEM

Introduzca las credenciales de comunicación de la API de Workspace ONE UEM en Workspace ONE Intelligence de modo que pueda utilizar el servidor de la API de Workspace ONE UEM para comunicarse con otros servicios de terceros para los flujos de trabajo.

Aviso: Use OAuth 2.0, siempre que esté disponible, para la comunicación con la API. El proceso para configurar la autenticación de OAuth 2.0 se describe en Procedimiento de autenticación de OAuth 2.0.

Requisitos previos

Genere una clave de API en Workspace ONE UEM Console. Consulte Flujos de trabajo para obtener más información.

Procedimiento

  1. Acceda a la interfaz de usuario de Workspace ONE Intelligence.
  2. Desplácese hasta Integraciones > Orígenes de datos.
  3. Seleccione Configurar para el proceso de Workspace ONE UEM.
  4. Seleccione Proporcionar credenciales y configure los ajustes.
    • URL base: introduzca la URL de REST API de Workspace ONE UEM.
      • Incluya el protocolo (https://) al principio.
      • Elimine /API de la URL.
      • Por ejemplo, si la URL se muestra como xxxx.xxxx.com/API, agregue https:// y elimine /API para introducir https://xxxx.xxxx.com.
    • Nombre de usuario de API: introduzca el nombre de usuario del administrador específico que creó para la automatización de los flujos de trabajo.
    • Contraseña de usuario de API: introduzca la contraseña para el administrador.
    • Código de tenant de Workspace ONE UEM: introduzca la clave de API que Workspace ONE UEM Console ha generado al habilitar las comunicaciones de REST API.

Slack

Aviso: Actualizamos la integración con Slack, pero este proceso heredado sigue funcionando. Para ver el proceso de integración más reciente, consulte Integración de la API web de Slack

Configure Slack para la comunicación de API para que pueda registrarlo con Workspace ONE Intelligence y usar acciones de flujo de trabajo de Slack.

Procedimiento

  1. En la ayuda de Slack, busque WebHooks entrantes.
  2. En Slack, configure una integración con Webhook entrante para que pueda conectarse a la API de Slack y enviar mensajes.
  3. Defina un canal predeterminado para los mensajes. Puede reemplazar este canal cuando cree un mensaje.
  4. En Workspace ONE Intelligence, desplácese hasta Integraciones > Conectores de flujo de trabajo > Slack > Configurar.
  5. En la pestaña Proporcionar credenciales, introduzca la Slack WebHook URL en el campo URL base.
  6. Seleccione Sin autenticación como el Tipo de autenticación.

ServiceNow

Configure su cuenta de ServiceNow para la comunicación de API para que pueda registrar ServiceNow con Workspace ONE Intelligence y usar acciones de flujo de trabajo de ServiceNow.

Consulte el [sitio de documentación de productos de ServiceNow] (https://docs.servicenow.com/bundle/paris-application-development/page/build/applications/concept/api-rest.html) para obtener más información sobre cómo trabajar con las funciones de REST API.

Procedimiento

  1. En su cuenta de ServiceNow, agregue la función snc_platform_rest_api_access a la cuenta de ServiceNow. Esta API controla la API de tabla para las operaciones de REST de entrada.
  2. En Workspace ONE Intelligence, desplácese hasta Integraciones > Conectores de flujo de trabajo > ServiceNow > Configurar.
  3. En la pestaña Proporcionar credenciales, escriba las credenciales de autenticación e introduzca https://instance.service-now.com para URL base.

Aprobaciones de aplicaciones

Puede controlar el coste de las licencias de aplicaciones con la integración del flujo de trabajo de aprobaciones de aplicación en Workspace ONE Intelligence.

Muchas licencias de aplicaciones Win32 son costosas. Puede usar las aprobaciones de aplicación para restringir quién puede instalar estas aplicaciones y controlar el coste de administración de estos recursos.

La integración reúne varios sistemas para procesar las solicitudes de aprobación de aplicación.

  • Workspace ONE UEM: administra la aplicación y la distribuye a los catálogos y dispositivos de Workspace ONE Intelligent Hub.
  • VMware Workspace ONE Intelligence: comunicación entre su entorno de ServiceNow y su implementación de Workspace ONE UEM.
  • ServiceNow: administra el proceso de solicitud y aprobación.

Proceso para aprobaciones de aplicaciones

Las aprobaciones de aplicaciones comienzan con la solicitud por parte de un usuario para instalar una aplicación en un dispositivo Windows.

  1. Los usuarios solicitan instalar aplicaciones a través de la aplicación Workspace ONE Intelligent Hub en sus dispositivos. Utilizan el elemento de menú Solicitud del catálogo. De ser necesario, los usuarios podrán introducir una justificación para iniciar el proceso de solicitud de la aplicación.
  2. VMware Workspace ONE Intelligence envía solicitudes a ServiceNow. Las solicitudes contienen información sobre los usuarios, los dispositivos y las aplicaciones solicitadas.
  3. ServiceNow procesa las solicitudes de acuerdo con los flujos de trabajo (configurados en ServiceNow) y según las políticas de la empresa.
  4. ServiceNow vuelve a enviar respuestas a VMware Workspace ONE Intelligence. Las respuestas incluyen las aprobaciones o los rechazos.
    • Las aprobaciones dan lugar a la instalación automática de aplicaciones.
    • Los rechazos dan como resultado la vuelta a los estados de Solicitud en Workspace ONE Intelligent Hub.
  5. Si se aprueba, Workspace ONE UEM envía la aplicación a Workspace ONE Intelligent Hub para instalarla en el dispositivo.

Configurar aprobaciones de aplicaciones

Utilice Workspace ONE Intelligence y su servicio de ServiceNow para solicitar y aprobar la instalación de aplicaciones. Inicie la configuración en ServiceNow y, a continuación, añada información a su conexión de ServiceNow en Workspace ONE Intelligence y finalice con la edición de la asignación de aplicaciones en Workspace ONE UEM.

Requisitos previos

Configure las integraciones, los sistemas y los ajustes de la lista antes de usar las aprobaciones de aplicaciones.

  • Utilice la versión de Workspace ONE UEM requerida para Workspace ONE Intelligence.
  • Registre Workspace ONE UEM con Workspace ONE Intelligence.
  • Cree una instancia de ServiceNow con el complemento del Hub de integración de ServiceNow y Register ServiceNow con Workspace ONE Intelligence.
  • Utilice los servicios del Hub y use la aplicación Intelligent Hub como catálogo de aplicaciones.
  • Utilice dispositivos Windows.
  • Utilice aplicaciones nativas administradas en Workspace ONE UEM (internas, públicas y adquiridas).
  • Conozca las asignaciones de aplicaciones en Workspace ONE UEM. Acceda a Agregar asignaciones y exclusiones a las aplicaciones para obtener información sobre las asignaciones de aplicaciones.

Configurar ServiceNow para gestionar las solicitudes de aplicaciones entrantes

Configure ServiceNow para que controle las solicitudes de aplicaciones entrantes para que pueda personalizar su instancia y las políticas de aprobación. Este proceso utiliza la función REST API generada por script de ServiceNow.

Para iniciar el proceso de solicitud, Workspace ONE Intelligence envía una solicitud como código de muestra a ServiceNow. Las solicitudes incluyen detalles sobre los usuarios, los dispositivos y las aplicaciones solicitadas para la instalación.

{
  "RequestId": "bffb4469-56fb-4141-9ab0-0897f65143ba",
  "RequestFor": {
    "UserId": "15",
    "UserAttributes": {
      "user_name": "username",
      "last_name": "user",
      "first_name": "name",
      "email": "username@example.com"
    }
  },
  "Domain": "${domain}",
  "DeviceId": 123,
  "DeviceProperties": {
    "name": "Device Name",
    "device_udid": "F11C43E8307092418D7D5B0D9B48F235",
    "platform": "Windows 10"
  },
  "Notes": "Notes",
  "CatalogItem": {
    "Id": "267",
    "Name": "App Name",
    "Categories": null,
    "Properties": {
      "package_id": "{12345A78-40C1-2702-0000-000004000000}",
      "version": "9.20.0",
      "platform": "WinRT"
    }
  },
  "DueDate": 1568989813956,
  "Links": {
    "ApprovalNotify": {
      "Url": "<CallbackURL>"
    }
  }
}
  1. Inicie sesión en ServiceNow y busque Scripted REST APIs.
  2. Agregue una REST API generada por script.
  3. Introduzca un nombre descriptivo, tal como Workspace ONE App Approval, en el cuadro de texto Nombre.
  4. Introduzca el ID de API como appapproval y registre su Espacio de nombres de API, ya que lo introducirá en Workspace ONE Intelligence más adelante en este proceso. En ServiceNow, al agregar una API de REST generada por script, consulte los elementos de menú de ID de API y de espacio de nombres de API para la aprobación de la aplicación de Workspace ONE Intelligence.
  5. Vaya a la sección Recursos y agregue un Recurso.
  6. Introduzca el Nombre del recurso como Request.
  7. Utilice POST para el Método HTTP.
  8. Compruebe que la ruta relativa es /request. La ruta de acceso del recurso se muestra como /api/<namespace>/appapproval/request. Si la ruta de acceso no tiene este formato, se producirá un error en la solicitud. Para solucionarlo, compruebe que la REST API generada por script y el recurso tienen los nombres correctos.
  9. Configure el script para que coincida con su entorno. Almacene los valores como parte de la solicitud de ServiceNow. El almacenamiento de los valores compila la solicitud saliente de la API después de que se haya aprobado o rechazado el ticket de solicitud. Puede personalizar el código de muestra para su implementación. Puede crear un elemento de carrito dentro de una solicitud o vincular el nombre de usuario al SYSID del sistema.
(function process(/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {
    var RequestID = request.body.data.RequestId;
    var CallbackURL = request.body.data.Links.ApprovalNotify.Url;
    var DeviceID = request.body.data.DeviceId;
    var Notes = request.body.data.Notes;
    var AppName = request.body.data.CatalogItem.Name;
    var UserID = request.body.data.RequestFor.UserId;
    var UserName = request.body.data.RequestFor.UserAttributes.user_name;
    var FirstName = request.body.data.RequestFor.UserAttributes.first_name;
    var LastName = request.body.data.RequestFor.UserAttributes.last_name;
    gs.info("Request Recieved");
    var create = new GlideRecord('sc_request');
    create.initialize();
    create.setValue('short_description',"Request for Installation of " + AppName);
    create.setValue('description',FirstName + " " + LastName + " Requests Installation of " + AppName);
    create.setValue('u_uem_callback_url',CallbackURL);
    create.setValue('u_uem_notes',Notes);
    create.setValue('u_uem_device_id',DeviceID);
    create.setValue('u_uem_request_id',RequestID);
    create.setValue('u_uem_user_id',UserID);
    create.setValue('u_requesting_user',UserName);
     
    create.insert();
     
    response.setStatus(200);
})(request, response);

Agregar campos personalizados al ticket de solicitud de ServiceNow

Agregue campos personalizados al Ticket de solicitud con tablas en ServiceNow. Los campos personalizados ayudan a compilar las solicitudes de la API de rechazo y aprobación salientes en Workspace ONE Intelligence.

  1. Busque Tables en la barra de navegación de ServiceNow y seleccione Definición de sistema > Tablas.
  2. Busque el nombre de tabla sc_request y abra para ver los detalles de la columna. Si busca en la etiqueta de la tabla, la etiqueta de la tabla será Request.
    1. Agregue columnas añadiendo los valores Agrega requeridos que el sistema devuelve a Workspace ONE Intelligence y agregue su valor correspondiente en la solicitud de API.
    2. ApprovalNotify.URL = URL de devolución de llamada de UEM
    3. DeviceId = ID de dispositivo de UEM
    4. RequestId = ID de solicitud de UEM
  3. Agregue valores opcionales. Si cambia el Nombre de columna predeterminado, actualice el script para utilizar el nombre de columna actualizado.

    • UserId = ID de usuario de UEM
    • user_name = Usuario solicitante
    • Notes = Notas de UEM
    Tipo Etiqueta de la columna Nombre de la columna Longitud máxima
    Cadena URL de devolución de llamada de UEM u_uem_callback_url 2048
    Número entero Identificador de dispositivo de UEM u_uem_device_id NA
    Cadena ID de solicitud de UEM u_uem_request_id 40
    Número entero ID de usuario de UEM u_uem_user_id NA
    Cadena Usuario solicitante u_requesting_user 40
    Cadena Notas de UEM u_uem_notes 4000
  4. Seleccione Actualizar y guarde la tabla.

  5. De manera opcional, puede utilizar Secciones del formulario en la IU del sistema para ocultar columnas y valores de la interfaz de usuario. Al ocultar columnas y valores solamente se utilizarán en solicitudes de API.

Configurar una acción en ServiceNow

  1. En ServiceNow, vaya a Diseñador de flujos > Nuevo > Acción para configurar una acción para un flujo de trabajo. Los flujos de trabajo de ServiceNow envían una respuesta de aprobación o rechazo a Workspace ONE Intelligence.
  2. Introduzca un nombre y metadatos en Propiedades de la acción. En la interfaz de usuario de ServiceNow, configure la ventana Propiedades de acción para la aprobación de la aplicación Workspace ONE Intelligence.
  3. Defina las Entradas para la acción.
    • Solicitar ID
    • ID del dispositivo
    • Actualizada por
    • Notas
    • Fecha de actualización
    • URL de devolución de llamada
    • Aprobación En la interfaz de usuario de ServiceNow, consulte la pestaña Entradas para la acción en la aprobación de la aplicación Workspace ONE Intelligence.
  4. Agregue un Paso de script seleccionando el signo más (+) en la sección Esquema de acción. A continuación, vaya a Utilidades > Paso de script. El paso de script convierte la cadena de estado de aprobación en mayúsculas para prepararla para la llamada de API.
    • Defina la variable de entrada como approval_status y arrástrela al valor de aprobación.
    • Agregue el código de muestra que convierte el estado de aprobación en mayúsculas.
    • Defina la variable de salida como ApprovalStatus.
(function execute(inputs, outputs) {
var  approval_lc = inputs.approval_status;
 
outputs.ApprovalStatus = approval_lc.toUpperCase();
})(inputs, outputs);

En la interfaz de usuario de ServiceNow, consulte la pestaña Paso de script con el código de entradas y salidas en el campo de texto Script.

  1. Agregue un paso de REST a la acción.
    • Utilice la variable URL de devolución de llamada como el valor de URL base.
    • Utilice POST como el Método HTTP.
    • Agregue el encabezado Content-Type =application/json.
    • Defina el Tipo de solicitud como Text.
    • Introduzca la carga útil del Cuerpo de la solicitud como el código de muestra. Reemplace los valores del código de muestra por sus variables de datos.
    • Guarde la acción.
{
"data":{
    "request_id": "action-Request ID", 
    "device_id": "action-Device ID", 
    "approval_status": "step-Script step-ApprovalStatus", 
    "updated_by": "action-Updated By", 
    "notes" : "action-Notes", 
    "updated_at" : "action-Updated At"
    }
}

En la interfaz de usuario de ServiceNow, consulte la pestaña Paso de Rest con el código del cuerpo de la solicitud en la sección Contenido de la solicitud.

Crear un flujo de trabajo en ServiceNow

  1. En ServiceNow, cree un flujo de trabajo con la acción de aprobación en función de las directivas de aprobación de su organización.
  2. En el Diseñador de flujo, seleccione Nuevo.
  3. Rellene los metadatos que incluyen las propiedades para Flujo, Aplicación y Ejecutar como.
  4. Para crear un activador, utilice Actualizados para buscar cambios en los estados de los tickets. En la interfaz de usuario de ServiceNow, consulte la pestaña Actualizado que muestra los tipos de activador.
  5. Seleccione Solicitud[sc_request] como la Tabla.
  6. Defina una Condición como [Approval - is one of - Approved, Rejected] and [UEM Callback URL - is not empty].
  7. Seleccione Una vez para Ejecutar el activador. En la interfaz de usuario de ServiceNow consulte el campo Ejecutar activador después de la condición en la actualización de la solicitud.
  8. Agregue la acción AppApproval. En la interfaz de usuario de ServiceNow, busque la aprobación de la aplicación y agréguela a la acción del flujo.
  9. Agregue los valores adecuados de la tabla de solicitud que coincidan con las entradas de acción requeridas. En la interfaz de usuario de ServiceNow, vea la tabla de solicitudes de ejemplo que coincide con las entradas de acción.
  10. Guarde y active el flujo de trabajo.

Agregar un espacio de nombres de REST API generado por script a Intelligence

  1. En Workspace ONE Intelligence, vaya a Integraciones > Orígenes de datos > ServiceNow.
  2. Edite la conexión para incluir el espacio de nombres de la API. Ya ha registrado este valor al agregar la REST API generada por script a ServiceNow.

Solicitar aprobación

  1. Para solicitar la aprobación, edite la asignación de aplicaciones en Workspace ONE UEM. La edición de una asignación de aplicaciones para solicitar aprobación permite que los usuarios soliciten la instalación de aplicaciones con Workspace ONE Intelligent Hub en dispositivos Windows.
  2. En Workspace ONE UEM Console, desplácese hasta la aplicación adecuada y edite la asignación.
  3. Habilite Requiere aprobación para instalar. En Workspace ONE UEM Console, configure la aplicación para que requiera una aprobación antes de la instalación.
    En Workspace ONE Intelligent Hub en el dispositivo, los usuarios seleccionan el elemento de menú Solicitud del catálogo. Los usuarios podrán introducir una justificación para iniciar el proceso de solicitud de la aplicación. Una vez que la solicitud sea aprobada por la persona correspondiente a través de ServiceNow, se instalará la aplicación.

Estados de aprobación de aplicaciones

Los estados en Workspace ONE UEM Console y en Workspace ONE Intelligent Hub en los dispositivos representan pasos específicos del proceso de solicitud y aprobación de las aprobaciones de aplicación.

Estados de aprobación de aplicaciones de Workspace ONE UEM

Los administradores pueden ver el estado de la aprobación de una aplicación en Workspace ONE UEM Console en Aplicaciones y libros y en la pestaña Detalles de dispositivos > Aplicaciones.

Estado Descripción
Aprobación pendiente El usuario solicitó instalar una aplicación. Mediante Workspace ONE Intelligence, ServiceNow creó un ticket para que el administrador apruebe la instalación. El ticket espera la aprobación en el sistema ServiceNow.
Se envió el comando de instalación El administrador aprobó la instalación. A través de Workspace ONE Intelligence, Workspace ONE UEM envió un comando de instalación a la base de datos. El dispositivo consumió el comando.
Instalado El dispositivo informó a Workspace ONE UEM de que la aplicación se instaló correctamente.
Rechazada El administrador rechazó el ticket de ServiceNow para la instalación. El usuario debe solicitar volver a instalar la aplicación.
Caducado El administrador no ha aprobado ni rechazado el ticket de ServiceNow en un período de 14 días. El usuario debe solicitar volver a instalar la aplicación.
Error El sistema de aprobación de aplicaciones encontró un error en alguna parte del proceso. El error ha detenido el proceso. El usuario debe solicitar volver a instalar la aplicación.

Estados de aprobación de la aplicación Workspace ONE Intelligent Hub

Los usuarios acceden a la aplicación a través de Workspace ONE Intelligent Hub. Seleccionan Solicitud para iniciar una instalación. Después de iniciar una solicitud, Workspace ONE Intelligent Hub muestra un estado para identificar en qué parte del proceso se encuentra la solicitud de instalación.

Estado Descripción
Solicitud El administrador cargó la aplicación y habilitó el elemento Requiere aprobación para instalar en la asignación de aplicación.
Pendiente Workspace ONE Intelligence recibió una solicitud de Workspace ONE UEM y la envió a ServiceNow. ServiceNow creó un ticket para la aprobación de la instalación. El sistema espera la aprobación del administrador.
Instalando El administrador aprobó el ticket de ServiceNow para la instalación y la base de datos de Workspace ONE UEM inició un comando de instalación.
Instalado El dispositivo informó de vuelta a Workspace ONE UEM de que la aplicación se instaló correctamente.
check-circle-line exclamation-circle-line close-line
Scroll to top icon