Instalar y configurar Blue Prism Digital Worker API

Blue Prism Digital Worker API ofrece una interfaz entre Blue Prism Desktop y la base de datos de Blue Prism, lo cual permite que Blue Prism Desktop obtenga toda la información que necesita para ejecutar procesos automatizados.

Para ver la instalación de Blue Prism Digital Worker API, consulte el video de instalación y configuración de Blue Prism Digital Worker API

Requisitos previos

Digital Worker API requiere que los siguientes componentes se instalen en su entorno de Blue Prism antes de su instalación:

  • SS&C | Blue PrismEdición Enterprise versión 7.2: su licencia de Desktop le otorga acceso a la funcionalidad específica de Desktop disponible en Blue Prism.
  • Las licencias de Desktop y Enterprise se pueden aplicar a la misma base de datos de Blue Prism. No se requiere un entorno de Desktop separado.

  • SS&C | Blue PrismAPI versión 7.2: la API brinda una interfaz para que Desktop se conecte con la base de datos de Blue Prism. También proporciona una serie de capacidades predefinidas que se utilizan para interactuar con Blue Prism programáticamente mediante una API RESTful.
  • Blue Prism API debe instalarse en su entorno de Desktop; sin embargo, no hay un orden recomendado en el que deban instalarse las API.

  • La SS&C | Blue Prismversión 4.7 de Hub:Hub implementa Authentication Server. Authentication Server proporciona un método de autenticación centralizada común para los usuarios a través de los componentes clave de Blue Prism, incluido Desktop.

Requisitos mínimos de hardware

Consulte los requisitos de software y hardware de Blue Prism para obtener detalles de los requerimientos mínimos para el servidor web en el que se instalará Digital Worker API.

Configuración IIS del servidor web

Debe instalarse Digital Worker API como parte de la instalación de Blue Prism Desktop. La API debe instalarse en un servidor habilitado para Internet Information Services que debe tener una conexión de baja latencia a la base de datos de Blue Prism. Se puede instalar Digital Worker API en el mismo servidor que Blue Prism API, si es necesario.

Si está instalando Digital Worker API en un servidor web separado de Blue Prism API, se debe aplicar la siguiente configuración al servidor web que alojará la API. Si está instalando Digital Worker API en el mismo servidor que Blue Prism API y ya ha configurado el servidor web, no es necesario repetir este paso. Esto se puede configurar con el script PowerShell proporcionado o manualmente.

Si es necesario, Digital Worker API se puede instalar en el mismo servidor web que Blue Prism API, Hub y Authentication Server.

Configuración por script

Para configurar el servidor web a través de un script, ejecute el siguiente comando usando el símbolo del sistema PowerShell:

Copiar
Install-WindowsFeature -name Web-Server, Web-Windows-Auth -IncludeManagementTools

Configurar certificados SSL

Se requerirá un certificado SSL en el dispositivo donde se instalará Digital Worker API. Se utilizará para proteger el sitio que se crea. Se admiten certificados SAN y comodín. El certificado debe estar presente en la máquina que aloja la API y debe almacenarse en el almacén de certificados de confianza. Según los requisitos de seguridad de su infraestructura y de la organización de TI, esto podría ser un certificado SSL creado internamente o un certificado adquirido para proteger el sitio web. Consulte Generar un certificado SSL autofirmado para obtener información sobre cómo generar un certificado autofirmado.

Habilitar el Authentication Server

Para habilitar la autenticación contra la API, su entorno de Blue Prism debe estar configurado para usar Authentication Server, y Authentication Server debe estar habilitado en el cliente interactivo.

  • Authentication Server debe instalarse con el instalador de Hub; consulte la Guía de instalación de Hub.
  • Además de la configuración descrita en la Guía de instalación de Hub, primero se debe crear un usuario de Authentication Server en Hub y luego se le debe asignar el rol de usuario de Desktop en Blue Prism. Esto se realiza agregando el usuario de Authentication Server al rol de usuario de Desktop en Sistema > Seguridad > Roles de usuario.

  • Para obtener información sobre cómo configurar su entorno de Blue Prism para usar Authentication Server, consulte la guía de configuración de Authentication Server.

Instalar Digital Worker API

Después de instalar Hub, Authentication Server y Blue Prism Enterprise, podrá instalar Digital Worker API.

Para instalar Digital Worker API, descargue y ejecute el instalador de Blue Prism Digital Worker API, disponible en el portal de Blue Prism, y avance a través del instalador como se muestra a continuación. El instalador se debe ejecutar con derechos de administrador.

Paso

Pantalla del instalador

Detalles

1

Pantalla de bienvenida de la instalación de Digital Worker API

Bienvenido

Si es necesario, seleccione otro idioma para el instalador de la lista desplegable. El idioma predeterminado es el inglés (Estados Unidos).

Haga clic en Siguiente.

2

Pantalla de acuerdo de licencia de la instalación de Digital Worker API Contrato de licencia

Lea el EULA y, si acepta los términos, seleccione la casilla de verificación.

Haga clic en Siguiente.

3

Pantalla de destino de la instalación de Digital Worker API Carpeta de destino

Especifique la carpeta de instalación requerida. La ubicación predeterminada es C:\Archivos de programa (x86)\Blue Prism\Blue Prism Digital Worker API, pero puede elegir otra ubicación con el botón Cambiar.

Haga clic en Siguiente.

4

Pantalla de configuración de IIS de la instalación de Digital Worker API

Configuración de IIS

Configure Internet Information Service (IIS) para Digital Worker API.

  • Nombre del sitio: el valor predeterminado es Blue Prism API DW y no se puede modificar.
  • Nombre de host: ingrese la URL del sitio web de Digital Worker API. Esta URL también debe coincidir con el sitio incluido en el certificado requerido.
  • Puerto: ingrese el número de puerto de la máquina en la que está instalando Digital Worker API. El número del puerto predeterminado es 443.
  • Si Blue Prism API está instalada en el mismo servidor y ya utilizó el número de puerto predeterminado, aquí debe ingresar un número de puerto diferente.

  • Certificado SSL: seleccione el certificado de Secure Sockets Layer (SSL) correspondiente, emitido para el sitio web especificado para el nombre de host.

Haga clic en Siguiente.

5

Pantalla de configuración de SQL de la instalación de Digital Worker API

Configurar conexión SQL

Configure la conexión de la base de datos SQL para Digital Worker API.

  • Servidor SQL: ingrese el nombre de host o la dirección IP del servidor SQL.
  • Si utiliza un puerto SQL no estándar, ingrese el nombre de host del servidor SQL, seguido del puerto. Por ejemplo: SQLSERVER1,1434.

  • Modo de autenticación: seleccione el modo de autenticación para la cuenta que la API utilizará para a fin de conectarse a la base de datos de Blue Prism:
    • Para la autenticación de Windows (predeterminada), esta es la identidad del grupo de aplicaciones de IIS asociado al sitio.
    • Para la autenticación de SQL, ingrese el nombre de usuario y la contraseña.
  • Nombre de la base de datos: ingrese el nombre de su base de datos de Blue Prism.

Se deben otorgar permisos mínimos de SQL al usuario que se conectará a la base de datos de Blue Prism para que la API funcione correctamente.

Haga clic en Evaluar conexión para comprobar si se puede establecer una conexión con el servidor SQL.

Haga clic en Siguiente.

6

Pantalla de configuración de claves de cifrado de la instalación de Digital Worker API

Configurar claves de cifrado

Seleccione la ubicación desde la cual desea cargar las claves de cifrado.

  • Configuración del servidor de Blue Prism (recomendada): seleccione una configuración del servidor de Blue Prism existente desde la cual cargar las claves de cifrado.
  • Las opciones disponibles en la lista desplegable se toman de la configuración del servidor de aplicaciones de Blue Prism. El servidor web no necesita poder comunicarse con un servidor de aplicaciones de Blue Prism en ejecución, pero el archivo de configuración del servidor debe estar presente en el servidor web.

  • Cargar claves de cifrado de la base de datos: seleccione esta opción si las claves de cifrado se almacenan en la base de datos de Blue Prism. Esto suele ser apropiado para escenarios en los que no se implementa ningún servidor de aplicaciones.

Haga clic en Siguiente para instalar Digital Worker API. Aparece una barra de progreso durante la instalación de la API.

7

Pantalla de la instalación completa de Digital Worker API

Instalación completa

Si la instalación se completó correctamente, haga clic en Finalizar para salir del instalador.

Si la instalación falla, haga clic en Ver registro para ver el error que se encontró.

Configurar registro de DNS

Una vez que se haya instalado Digital Worker API, se debe configurar un registro de DNS para asignar la URL de API a la dirección IP relevante.

Para obtener más detalles sobre cómo hacer esto, consulte Resolución de DNS y Conectividad de red de Blue Prism.

Configurar el grupo de aplicaciones IIS para el acceso de la autenticación de Windows a la base de datos

Esta sección se aplica únicamente a la autenticación de Windows.

Después de haber instalado correctamente Digital Worker API, deberá completar la siguiente configuración de Internet Information Services (IIS):

Si se configuró Digital Worker API para usar la autenticación de Windows, el grupo de aplicaciones de Blue Prism Digital Worker en IIS se deberá actualizar para ejecutarse como un usuario con acceso adecuado a la base de datos de Blue Prism. Siga los pasos a continuación cuando utilice la autenticación de Windows para la conexión de la base de datos:

Las identidades del grupo de aplicaciones se establecen más comúnmente en las cuentas de servicio.

  1. Inicie el Administrador de Internet Information Services desde el menú Inicio de Windows.
  2. En el panel Conexiones, haga clic en Grupos de aplicaciones.

    Aparece la ventana Grupos de aplicaciones.

  3. Seleccione Blue Prism API DW.

  4. En el panel Acciones, haga clic en Configuración avanzada.
  5. En el diálogo Configuración avanzada, amplíe Modelo de proceso y haga clic en los puntos suspensivos (...) junto a ApplicationPoolIdentity.

    Configurar IIS para la autenticación de Windows

  6. En el diálogo Identidad del grupo de aplicaciones, seleccione Cuenta personalizada y haga clic en Establecer….
  7. En el diálogo Establecer credenciales, ingrese las credenciales de inicio de sesión de Windows de la cuenta de servicio que tiene acceso a la base de datos de Blue Prism y haga clic en Aceptar.

    El usuario de la base de datos requerido para conectarse a la base de datos de Blue Prism debe tener permisos db_datareader y db_datawriter.

    Configuración del grupo de aplicaciones

  8. En el panel Conexiones, amplíe el nodo Sitios y seleccione Blue Prism API DW.
  9. Aparece la ventana Inicio de Blue Prism API DW.

  10. En el panel de Acciones en Administrar sitio web, haga clic en Reiniciar.
  11. Reiniciar sitio

Después de instalar y configurar correctamente Digital Worker API, debe instalar el cliente de Blue Prism Desktop y configurar una conexión para que la utilicen los usuarios de Desktop. Consulte Instale y conecte el cliente de Desktop para obtener detalles.

Configurar el grupo de aplicaciones de IIS para un uso intensivo (opcional)

Si más de 750 usuarios altamente activos acceden al entorno de Desktop, entonces Digital Worker API puede agotar el tiempo de espera, lo cual genera que aparezcan mensajes de error. Para evitar que esto suceda, se recomienda que la configuración de Intervalos de tiempo regulares (en minutos) en el grupo de aplicaciones del Internet Information Services (IIS) se reduzca de 1740 a 180.

Para modificar esta configuración en IIS:

  1. Inicie IIS desde el menú Inicio de Windows.
  2. En el panel Conexiones, haga clic en Grupos de aplicaciones.

    Aparece la ventana Grupos de aplicaciones.

  3. Seleccione Blue Prism API DW.

  4. En el panel de Acciones, haga clic en Reciclaje.
  5. En el diálogo Editar configuración de reciclaje del grupo de aplicaciones, cambie el valor del campo Intervalos de tiempo regulares (en minutos) a 180.
  6. Configuración de Internet Information Services de Digital Worker API

  7. Haga clic en Siguiente, luego haga clic en Finalizar para aplicar los cambios.