Herramienta Blue Prism Data Protector

Haga clic en este ícono en la barra de herramientas para ver y descargar una versión en PDF de esta guía.

La herramienta Blue Prism Data Protector se utiliza para descifrar y cifrar cadenas de conexión almacenadas en el archivo appsettings.json. Por razones de seguridad, las cadenas de conexión se cifran y la herramienta Blue Prism Data Protector permite descifrar las cadenas, de modo que se puedan alterar si es necesario y luego cifrarse de nuevo.

La herramienta BluePrismDataProtector.Console es una herramienta de línea de comandos y debe utilizarse con Windows PowerShell ejecutándose como administrador.

Descifrar una cadena de conexión

Para utilizar la herramienta para descifrar una cadena de conexión:

  1. Descargue el archivo BluePrismDataProtector.Console.exe del Portal de Blue Prism y guárdelo en una ubicación conveniente de su dispositivo.
  2. Abra PowerShell como administrador en la carpeta donde se encuentra BluePrismDataProtector.Console.exe.

    Aparece la ventana Administrador: Windows PowerShell.

    3. Si escribe .\BluePrismDataProtector.Console.exe en la línea de comandos y presiona Intro, aparecerá una lista de comandos posibles.

  3. Desde el Explorador de Windows, abra el archivo appsettings.json que contiene la cadena que desea descifrar y cópielo. Por ejemplo:

  4. En PowerShell, escriba lo siguiente:

    Copiar 
    .\BluePrismDataProtector.Console.exe unprotect -v "[string]" -p "[path]"

    Donde:

    [string] = la cadena copiada del archivo

    [path] = la ruta a DataProtectionKeys. Normalmente, C:\Archivos de programa (x86)\Blue Prism\DataProtectionKeys

    Por ejemplo:

    Copiar 
    .\BluePrismDataProtector.Console.exe unprotect -v "CfDJ8LadX9spUNhMhvbxTcsxZYTHFA3m8Tyl-Z_EZ0Znl6mYfv_23Q2D2waPDTBXaz4-viNO2Akk-S5C73dNjOdGHifGCxSIftwExJ3O4FuDXHpbNo0be-xyQtlD1-j7rosuYw" -p "C:\Archivos de programa (x86)\Blue Prism\DataProtectionKeys" 
  5. Presione Intro.
    La cadena se descifra y el valor no cifrado se muestra en PowerShell.

Cifrar una cadena de conexión

Para utilizar la herramienta para cifrar una cadena de conexión:

  1. Abra PowerShell como administrador en la carpeta donde se encuentra BluePrismDataProtector.Console.exe.
    Aparece la ventana Administrador: Windows PowerShell.

    2. Si escribe .\BluePrismDataProtector.Console.exe en la línea de comandos y presiona Intro, aparecerá una lista de comandos posibles.

  2. En PowerShell, escriba lo siguiente:

    Copiar 
    .\BluePrismDataProtector.Console.exe protect -v "[string]" -p "[path]"

    Donde:

    [string] = la cadena que desea cifrar

    [path] = la ruta a DataProtectionKeys. Normalmente, C:\Archivos de programa (x86)\Blue Prism\DataProtectionKeys

    Por ejemplo:

    Copiar 
    .\BluePrismDataProtector.Console.exe protect -v "Str0ngP@SsW0rD" -p "C:\Archivos de programa (x86)\Blue Prism\DataProtectionKeys" 
  3. Presione Intro.
    La cadena se cifra y el valor se muestra en PowerShell, por ejemplo:
    CfDJ8LadX9spUNhMhvbxTcsxZYTHFA3m8Tyl-Z_EZ0Znl6mYfv_23Q2D2waPDTBXaz4-viNO2Akk-S5C73dNjOdGHifGCxSIftwExJ3O4FuDXHpbNo0be-xyQtlD1-j7rosuYw
  4. Copie la cadena cifrada en la ubicación adecuada del archivo appsettings.json y guarde el archivo.
  5. Abra el administrador de Internet Information Services y reinicie el grupo de aplicaciones correspondiente para asegurarse de que utilice la nueva cadena de conexión.

Si hay caracteres en su cadena que están asociados con comandos en PowerShell en sí, deberá agregar un carácter de escape a su cadena para que PowerShell cumpla con la cadena según lo previsto. Por ejemplo:

  • ` y $ necesitarán un ` (tilde aguda) antes del carácter, por ejemplo, Str0ng`P@$$W0rD deberá ingresarse como “Str0ng``P@`$`$$W0rD” en la línea de comandos.
  • " necesitará \` antes, por ejemplo, P@$"W0rD tendría que ingresarse como “P@`$\`"W0rD” en la línea de comandos.

Estos caracteres de escape adicionales mantienen la integridad de la cadena. Si el valor cifrado resultante se descifra nuevamente, el valor coincidiría con la cadena original en lugar de la versión de la línea de comandos.