UiPath Documentation
orchestrator
2023.4
false
Guía de instalación de Orchestrator
Importante :
Este contenido se ha localizado parcialmente a partir de un sistema de traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Scripts de Identity Server

Publicar en Identity Server​

La tabla siguiente describe todos los parámetros que puedes usar con el script Publish-IdentityServer.ps1.

Parámetro Descripción

-action

Obligatorio. Indica el tipo de escenario que quieres iniciar. Las siguientes opciones están disponibles:

  • Deploy: especifica que se trata de una instalación limpia.
  • Update: especifica que actualizas tu instancia de Identity Server.

-azureAccountApplicationId

Mandatory. The Azure service principal ID. Please note that the used service principal needs to be assigned the Contributor role to the app service at the subscription scope.

-azureAccountPassword

Obligatorio. La contraseña de token de Azure para el ID principal de servicio.

-azureSubscriptionId

Obligatorio. El ID de suscripción de Azure para el App Service que aloja Orchestrator.

-azureAccountTenantId

Obligatorio. El ID de tenant de Azure.

-orchestratorUrl

Obligatorio. La URL de la instancia de Orchestrator.

-identityServerUrl

Obligatorio. La URL de Identity Server.

The URL must contain the Identity Server address + the suffix /identity in lowercase. Example: https://[identity_server]/identity

-resourceCatalogUrl

Obligatorio. La URL del recurso

Catálogo.

-orchDetails

Este parámetro es una tabla hash que contiene los siguientes valores:

  • resourceGroupName: Obligatorio. El nombre del grupo de recursos de Azure que contiene Orchestrator App Service.
  • appServiceName: Obligatorio. El nombre de Orchestrator Azure App Service.
  • targetSlot: Obligatorio. La ranura del servicio de aplicaciones de destino establecida por Azure.

-identityServerDetails

Este parámetro es una tabla hash que contiene los siguientes valores:

  • resourceGroupName: Obligatorio. El nombre del grupo de recursos de Azure que contiene el servicio de aplicaciones de Identity Server.
  • appServiceName: Obligatorio. El nombre del servicio de aplicaciones de Azure del Identity Server.
  • targetSlot: Obligatorio. La ranura del servicio de aplicaciones de destino establecida por Azure.

-package

Obligatorio. Indica la ruta completa o relativa del archivo UiPath.IdentityServer.Web.zip.

-cliPackage

Obligatorio. Indica la ruta completa o relativa del archivo UiPath.IdentityServer.Migrator.Cli.zip.

-productionSlotName

Opcional. Solo puede utilizarse si la ranura de la implementación de servicio de aplicaciones de Identity Server es distinta a la ranura del servicio de aplicaciones predeterminado de producción establecida por Azure.

-stopApplicationBeforePublish

Opcional. Si está presente, detiene la aplicación antes de su implementación y la inicia después de que esta finalice.

-unattended

Opcional. Si está presente, la implementación continúa sin confirmación del usuario.

-tmpDirectory

Opcional. Habilita la especificación de un directorio donde se descargan y descomprimen los archivos necesarios.

-noAzureAuthentication

Opcional. Te permite publicar en el Servicio de aplicaciones de Azure confiando en tu propia identidad de usuario sin tener que crear un director de servicio. Si se usa este parámetro, el conjunto de parámetros UseServicePrincipal (que incluye elementos como la ID de aplicación de Azure, la contraseña, la ID de suscripción y la ID de tenant) ya no es necesario.

El script Publish-IdentityServer.ps1 se usa para la implementación inicial o la actualización de Identity Server. El script supone que la aplicación web ya tiene configurada la cadena de conexión de la base de datos DefaultConnection.

.\Publish-IdentityServer.ps1 `
    -action Deploy `
    -orchestratorUrl "<orchestrator_address>" `
    -identityServerUrl "https://<identity_server_url>/identity" ` // must be in lowercase
    -resourceCatalogUrl "<resource_catalog_address>" `
    -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>";  targetSlot = "Production" } `
    -identityServerDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } `
    -azureSubscriptionId "<subscription_id>" `
    -azureAccountTenantId "<azure_tenant_id>" `
    -azureAccountApplicationId "<azure_application_id>" `
    -azureAccountPassword "<azure_account_password>" `
    -package "UiPath.IdentityServer.Web.zip" `
    -cliPackage "UiPath.IdentityServer.Migrator.Cli.zip" `
    -stopApplicationBeforePublish `
    -unattended
.\Publish-IdentityServer.ps1 `
    -action Deploy `
    -orchestratorUrl "<orchestrator_address>" `
    -identityServerUrl "https://<identity_server_url>/identity" ` // must be in lowercase
    -resourceCatalogUrl "<resource_catalog_address>" `
    -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>";  targetSlot = "Production" } `
    -identityServerDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } `
    -azureSubscriptionId "<subscription_id>" `
    -azureAccountTenantId "<azure_tenant_id>" `
    -azureAccountApplicationId "<azure_application_id>" `
    -azureAccountPassword "<azure_account_password>" `
    -package "UiPath.IdentityServer.Web.zip" `
    -cliPackage "UiPath.IdentityServer.Migrator.Cli.zip" `
    -stopApplicationBeforePublish `
    -unattended
Importante:

Después de ejecutar el script anterior, comprueba que realizas los pasos adicionales que se indican a continuación para una correcta implementación inicial.

Después de publicar Identity Server, realiza los siguientes pasos:

  1. Dirígete al portal de Azure.

  2. Selecciona tu Servicio de aplicaciones de Identity Server.

  3. En el menú Certificados, ve a Traer tus propios certificados.

  4. Carga un archivo de certificado de clave privada .pfx con una contraseña válida.

    Nota:

    Este certificado se utiliza para firmar los tokens de acceso y los tokens de ID.

  5. En el menú de Configuración, añade los siguientes ajustes de la aplicación exactamente como se describe en la columna Configuración de aplicaciones:

    Configuración de la aplicaciónValorDescripción
    AppSettings__IdentityServerAddresshttps://[identity_server]/identityLa URL pública de Identity Server.

    The URL must contain the address of Identity Server + the suffix /identity in lowercase.
    AppSettings__SigningCredentialSettings__StoreLocation__LocationUsuario actualEsta debe señalar a CurrentUser.
    AppSettings__SigningCredentialSettings__StoreLocation__NameXXXXXXXXXXXXXXXXXXXXXXXXXXLa huella digital del certificado que has cargado anteriormente.
    AppSettings__SigningCredentialSettings__StoreLocation__NameTypeThumbprintIntroduce Thumbprint como el tipo del campo anterior.
    AppSettings__LoadBalancerSettings__RedisConnectionStringXXXXXXXXXXXX:XXXX,password=XXXXXXLa cadena de conexión necesaria para configurar tu servidor Redis, que contiene la URL del servidor, la contraseña y el puerto. También puedes habilitar las conexiones cifradas SSL entre los nodos de Orchestrator y el servicio Redis.
    AppSettings__LoadBalancerSettings__SlidingExpirationTimeInSecondsNúmero de segundosEl tiempo de vencimiento deslizable de un elemento dentro de la caché. Este tiempo de vencimiento se aplica tanto a la caché de Redis como a la de InMemory.
    AppSettings__RedisSettings__UseRedisStoreCachetrue/false: establece su valor en true para habilitar la caché de Redis de los datos del cliente de OAuth. Esto ayuda a evitar problemas de rendimiento cuando se utiliza el inicio de sesión interactivo para conectar una gran cantidad de robots en un breve periodo de tiempo. Esta caché utiliza la misma cadena de conexión de Redis especificada en AppSettings__LoadBalancerSettings.

    Esto no se recomienda si utilizas la característica Aplicaciones externas, ya que esta configuración almacena en caché a los clientes y las actualizaciones de las aplicaciones externas no se reflejarán.
    AppSettings__RedisSettings__UseRedisStoreClientCachetrue/falseEstablece su valor como verdadero para habilitar la caché de Redis para clientes de primera mano (aplicaciones de UiPath) o clientes de terceros (aplicaciones externas). Si tienes una implementación a gran escala, se recomienda habilitar esta bandera.
    App__Saml2ValidCertificateOnlytrue/falsePara implementaciones de Orchestrator a través de una aplicación web de Azure, este parámetro debe establecerse como false. Eso se debe a que SAML2 requiere que los certificados se añadan a su tienda de confianza, pero las aplicaciones web de Azure no permiten dicha acción. Al establecer el valor como false evitamos la verificación del certificado.
    WEBSITE_LOAD_CERTIFICATESXXXXXXXXXXXXXXXXXXXXXXXXXXEl valor de la huella digital del certificado que has cargado anteriormente.
    WEBSITE_LOAD_USER_PROFILE1El perfil de usuario.
    -azureUSGovernmentLoginOpcional. Este parámetro solo se utiliza para las implementaciones del gobierno de EE. UU.

  6. Guarda los cambios.

Consulta más información en la documentación de Microsoft Azure.

Reemplazar el certificado de clave privada​

Al reemplazar un certificado de clave privada por uno nuevo, asegúrate de seguir estos pasos:

  1. Reemplaza los valores de los parámetros AppSettings__SigningCredentialSettings__StoreLocation__Name y WEBSITE_LOAD_CERTIFICATES por la huella digital del nuevo certificado.
  2. Reinicia el servicio de la aplicación Identity.
  3. Reinicia el servicio de aplicación de Orchestrator.

Migra a Identity Server​

La siguiente tabla describe todos los parámetros que se pueden utilizar con MigrateTo-IdentityServer.ps1.

Parámetro Descripción

-cliPackage

Obligatorio. Indica la ruta completa o relativa del archivo UiPath.IdentityServer.Migrator.Cli.zip.

-azureDetails

Este parámetro es una tabla hash que contiene los siguientes valores:

  • azureAccountApplicationId - Mandatory. The Azure service principal ID. Please note that the used service principal needs to be assigned the Contributor role to the app service at the subscription scope.
  • azureSubscriptionId: Obligatorio. El ID de suscripción de Azure para el App Service que aloja Orchestrator.
  • azureAccountTenantId: Obligatorio. El ID de tenant de Azure.
  • azureAccountPassword: Obligatorio. La contraseña de token de Azure para el ID principal de servicio.

-orchDetails

Este parámetro es una tabla hash que contiene los siguientes valores:

  • resourceGroupName: Obligatorio. El nombre del grupo de recursos de Azure que contiene Orchestrator App Service.
  • appServiceName: Obligatorio. El nombre de Orchestrator Azure App Service.
  • targetSlot: Obligatorio. La ranura del servicio de aplicaciones de destino establecida por Azure.

-identityServerDetails

Este parámetro es una tabla hash que contiene los siguientes valores:

  • resourceGroupName: Obligatorio. El nombre del grupo de recursos de Azure que contiene el servicio de aplicaciones de Identity Server.
  • appServiceName: Obligatorio. El nombre del servicio de aplicaciones de Azure del Identity Server.
  • targetSlot: Obligatorio. La ranura del servicio de aplicaciones de destino establecida por Azure.

-identityServerUrl

Obligatorio. La dirección pública de Identity Server.

The URL must contain the address of Identity Server + the suffix /identity in lowercase. Example: https://[identity_server]/identity

-orchestratorUrl

Obligatorio. La dirección pública del Orchestrator.

-tmpDirectory

Opcional. Habilita la especificación de un directorio donde se descargan y descomprimen los archivos necesarios.

-hostAdminPassword

Mandatory only for fresh deployments, when -action is set to Deploy. Specify a custom password for the host administrator. Please note that passwords have to be least 8 characters long, and must have at least one lowercase character and at least one digit.

-isHostPassOneTime

Opcional. Te permite aplicar un restablecimiento de la contraseña en el primer inicio de sesión para el administrador del host. Si se omite este parámetro, la contraseña de administrador del host no será una contraseña de un solo uso.

-defaultTenantAdminPassword

Mandatory only for fresh deployments, when -action is set to Deploy. Specify a custom password for the default tenant administrator. Please note that passwords have to be least 8 characters long, and must have at least one lowercase character and at least one digit.

-isDefaultTenantPassOneTime

Opcional. Te permite aplicar un restablecimiento de la contraseña en el primer inicio de sesión para el administrador del tenant predeterminado. Si se omite este parámetro, la contraseña de administrador del tenant no será una contraseña de un solo uso.

-noAzureAuthentication

Opcional. Te permite publicar en el Servicio de aplicaciones de Azure confiando en tu propia identidad de usuario sin tener que crear un director de servicio. Si se usa este parámetro, el conjunto de parámetros UseServicePrincipal (que incluye elementos como la ID de aplicación de Azure, la contraseña, la ID de suscripción y la ID de tenant) ya no es necesario.

El script MigrateTo-IdentityServer.ps1 se utiliza para migrar los datos de usuario desde Orchestrator a Identity Server y establecer las configuraciones para ambos. Establece Identity Server como la autoridad de identidad de Orchestrator y crea la configuración de cliente para Orchestrator en Identity Server.

El script supone que ya se han publicado Orchestrator e Identity Server.

.\MigrateTo-IdentityServer.ps1 `
    -cliPackage "UiPath.IdentityServer.Migrator.Cli.zip" `
    -azureDetails @{azureSubscriptionId = "<subscription_id>"; azureAccountTenantId = "<azure_tenant_id>"; azureAccountApplicationId = "<azure_application_id>"; azureAccountPassword = "<azure_account_password>" } `
    -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>";  targetSlot = "Production" } `
    -identityServerDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } `
    -identityServerUrl "https://<identity_server_url>/identity" ` // must be in lowercase
    -orchestratorUrl "https://<OrchestratorURL>" `
    -hostAdminPassword "12345qwert" `
    -defaultTenantAdminPassword "12345qwert"
.\MigrateTo-IdentityServer.ps1 `
    -cliPackage "UiPath.IdentityServer.Migrator.Cli.zip" `
    -azureDetails @{azureSubscriptionId = "<subscription_id>"; azureAccountTenantId = "<azure_tenant_id>"; azureAccountApplicationId = "<azure_application_id>"; azureAccountPassword = "<azure_account_password>" } `
    -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>";  targetSlot = "Production" } `
    -identityServerDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } `
    -identityServerUrl "https://<identity_server_url>/identity" ` // must be in lowercase
    -orchestratorUrl "https://<OrchestratorURL>" `
    -hostAdminPassword "12345qwert" `
    -defaultTenantAdminPassword "12345qwert"
  • Publicar en Identity Server​
  • Reemplazar el certificado de clave privada​
  • Migra a Identity Server​

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado