orchestrator
2023.4
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
UiPath logo, featuring letters U and I in white
Guia de instalação do Orchestrator
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 5 de dez de 2024

Scripts de Identity Server

Publicar no Identity Server

A tabela a seguir descreve todos os parâmetros que você pode usar com o script Publish-IdentityServer.ps1.

Parâmetro

Description

-action

Obrigatório. Indica o tipo de cenário que você deseja iniciar. As seguintes opções estão disponíveis:

  • Deploy - especifica que é uma instalação limpa.
  • Update- especifica que você está atualizando sua instância de Identity Server.

-azureAccountApplicationId

Obrigatório. O ID principal do serviço do Azure. Observe que o principal de serviço usado precisa ser atribuído à função Colaborador para o serviço do aplicativo no escopo de assinatura.

-azureAccountPassword

Obrigatório. O token de acesso do Azure para o ID principal do serviço.

-azureSubscriptionId

Obrigatório. O ID de assinatura do Azure para o Serviço de Aplicativo que hospeda o Orchestrator.

-azureAccountTenantId

Obrigatório. O ID de tenant do Azure.

-orchestratorUrl

Obrigatório. O URL da instância do Orchestrator.

-identityServerUrl

Obrigatório. A URL do Identity Server.

Importante: o URL deve conter o endereço do Identity Server + o sufixo /identity em letras minúsculas. Exemplo: https://[identity_server]/identity

-resourceCatalogUrl

Obrigatório. A URL do catálogo

de recursos.

-orchDetails

Esse parâmetro é uma tabela de hash que contém os seguintes valores:

  • resourceGroupNameobrigatório. O nome do Grupo de Recursos do Azure que contém o Serviço de Apps do Orchestrator.
  • appServiceNameobrigatório. O nome do Serviço de App do Azure via Orchestrator.
  • targetSlotobrigatório. O slot do Serviço do Aplicativo de Destino definido pelo Azure.

-identityServerDetails

Esse parâmetro é uma tabela de hash que contém os seguintes valores:

  • resourceGroupNameobrigatório. O nome do Grupo de Recursos do Azure que contém o Serviço de Aplicativo do Identity Server.
  • appServiceNameobrigatório. O nome do Serviço de Aplicativo do Azure do Identity Server.
  • targetSlotobrigatório. O slot do Serviço do Aplicativo de Destino definido pelo Azure.

-package

Obrigatório. Indique o caminho completo ou o caminho relativo do arquivamento UiPath.IdentityServer.Web.zip.

-cliPackage

Obrigatório. Indique o caminho completo ou o caminho relativo do arquivamento UiPath.IdentityServer.Migrator.Cli.zip.

-productionSlotName

Opcional. Ele pode ser usado apenas se o slot de implantação do Serviço de Aplicativo do Identity Server for diferente do slot de Serviço de Aplicativo de produção padrão definido pelo Azure.

-stopApplicationBeforePublish

Opcional. Se presente, ele interrompe a aplicação antes da implantação e reinicia após a conclusão da implantação.

-unattended

Opcional. Se presente, a implantação continua sem qualquer confirmação do usuário.

-tmpDirectory

Opcional. Permite a especificação de um diretório em que os arquivos necessários são baixados e descompactados.

-noAzureAuthentication

Opcional. Permite publicar no Serviço de aplicativo do Azure usando sua própria identidade de usuário, sem ter que criar uma entidade de serviço. Se esse parâmetro for usado, o conjunto de parâmetros UseServicePrincipal (que inclui itens como a ID do aplicativo do Azure, senha, ID de assinatura e ID de tenant) não é mais necessário.
O script Publish-IdentityServer.ps1 é usado para a implantação inicial ou atualização do Identity Server. O script pressupõe que o aplicativo da Web já tenha a string de conexão do banco de dados DefaultConnection configurada.
.\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: Após executar o script acima, certifique-se de executar as etapas extras listadas abaixo para uma implantação inicial bem-sucedida.

Após publicar o Identity Server, execute as seguintes etapas:

  1. Acesse o Portal do Azure.
  2. Selecione seu Serviço de Aplicativo do Identity Server.
  3. No menu Certificados, acesse Trazer seus próprios certificados.
  4. Carregue um arquivo de certificado de chave privada .pfx com uma senha válida.
    Observação: Esse certificado é usado para assinar os tokens de acesso e os tokens de ID.
  5. No menu Configuração, adicione as seguintes configurações de aplicativo exatamente como escrito na coluna Configurações do Aplicativo:

    Configuração de aplicativos

    Valor

    Description

    AppSettings__IdentityServerAddress

    https://[identity_server]/identity

    O URL pública do Identity Server.

    Importante: o URL deve conter o endereço do Identity Server + o sufixo /identity em minúsculas.

    AppSettings__SigningCredentialSettings__StoreLocation__Location

    Usuário atual

    Ela deve apontar para CurrentUser.

    AppSettings__SigningCredentialSettings__StoreLocation__Name

    XXXXXXXXXXXXXXXXXXXXXXXXXXXX

    A impressão digital do seu certificado que você carregou anteriormente.

    AppSettings__SigningCredentialSettings__StoreLocation__NameType

    Thumbprint

    Insira Thumbprint como o tipo do campo anterior.

    AppSettings__LoadBalancerSettings__RedisConnectionString

    XXXXXXXXXXXX:XXXX,password=XXXXXX

    A string de conexão necessária para configurar seu servidor do Redis, que contém o URL do servidor, a senha e a porta. Você também pode habilitar as conexões criptografadas por SSL entre os nós do Orchestrator e o serviço do Redis.

    AppSettings__LoadBalancerSettings__SlidingExpirationTimeInSeconds

    Número de segundos

    O tempo de expiração de deslizamento de um item dentro do cache. Esse tempo de expiração aplica-se ao Cache do Redis e ao Cache InMemory.

    AppSettings__RedisSettings__UseRedisStoreCache

    true/false
    Defina seu valor como true para habilitar o cache do Redis dos dados do cliente OAuth. Isso ajuda a evitar problemas de desempenho ao usar o Logon Interativo para conectar um grande número de robôs em um curto período. Este cache usa a mesma string de conexão do Redis especificada na AppSettings__LoadBalancerSettings.
    Observação: não é recomendável se você estiver usando a funcionalidade de Aplicativos Externos, pois essa configuração vincula clientes e as atualizações para Aplicativos Externos não serão refletidas.

    AppSettings__RedisSettings__UseRedisStoreClientCache

    true/false

    Defina seu valor como verdadeiro para habilitar o cache do Redis para clientes da primeira parte (aplicativos do UiPath) ou clientes de terceira parte (aplicativos externos). Se você tiver uma implantação em larga escala, recomenda-se habilitar essa sinalização.

    App__Saml2ValidCertificateOnly

    true/false
    Para implantações do Orchestrator por meio de um aplicativo web do Azure, esse parâmetro deve ser definido para false. Isso ocorre porque o SAML2 requer que sejam adicionados certificados ao seu armazenamento de confiança, mas os aplicativos web do Azure não permitem essa ação. Definir o valor para false significa que a verificação do certificado é ignorada.

    WEBSITE_LOAD_CERTIFICATES

    XXXXXXXXXXXXXXXXXXXXXXXXXXXX

    O valor da impressão digital do seu certificado que você carregou anteriormente.

    WEBSITE_LOAD_USER_PROFILE

    1

    O perfil do usuário.
    -azureUSGovernmentLoginOpcional. Este parâmetro é usado apenas para implantações do Governo dos EUA.  
  6. Salve as alterações.

Veja mais detalhes na documentação do Microsoft Azure.

Substituição do certificado de chave privada

Ao substituir um certificado de chave privada por um novo, certifique-se de seguir estas etapas:
  1. Substitua os valores dos parâmetros AppSettings__SigningCredentialSettings__StoreLocation__Name e WEBSITE_LOAD_CERTIFICATES pela impressão digital do novo certificado.
  2. Reinicie o serviço do aplicativo Identity.
  3. Reinicie o serviço do aplicativo do Orchestrator.

Migrar para o Identity Server

A seguinte tabela descreve todos os parâmetros que podem ser usados com a MigrateTo-IdentityServer.ps1.

Parâmetro

Description

-cliPackage

Obrigatório. Indique o caminho completo ou o caminho relativo do arquivamento UiPath.IdentityServer.Migrator.Cli.zip.

-azureDetails

Esse parâmetro é uma tabela de hash que contém os seguintes valores:

  • azureAccountApplicationId - Obrigatório. O ID principal do serviço do Azure. Observe que o principal de serviço usado precisa ser atribuído à função Colaborador para o serviço do aplicativo no escopo de assinatura.
  • azureSubscriptionIdobrigatório. O ID de assinatura do Azure para o Serviço de Aplicativo que hospeda o Orchestrator.
  • azureAccountTenantIdobrigatório. O ID de tenant do Azure.
  • azureAccountPasswordobrigatório. O token de acesso do Azure para o ID principal do serviço.

-orchDetails

Esse parâmetro é uma tabela de hash que contém os seguintes valores:

  • resourceGroupNameobrigatório. O nome do Grupo de Recursos do Azure que contém o Serviço de Apps do Orchestrator.
  • appServiceNameobrigatório. O nome do Serviço de App do Azure via Orchestrator.
  • targetSlotobrigatório. O slot do Serviço do Aplicativo de Destino definido pelo Azure.

-identityServerDetails

Esse parâmetro é uma tabela de hash que contém os seguintes valores:

  • resourceGroupNameobrigatório. O nome do Grupo de Recursos do Azure que contém o Serviço de Aplicativo do Identity Server.
  • appServiceNameobrigatório. O nome do Serviço de Aplicativo do Azure do Identity Server.
  • targetSlotobrigatório. O slot do Serviço do Aplicativo de Destino definido pelo Azure.

-identityServerUrl

Obrigatório. O endereço público do Identity Server.

Importante: o URL deve conter o endereço do Identity Server + o sufixo /identity em minúsculas. Exemplo: https://[identity_server]/identity

-orchestratorUrl

Obrigatório. O endereço público do Orchestrator.

-tmpDirectory

Opcional. Permite a especificação de um diretório em que os arquivos necessários são baixados e descompactados.

-hostAdminPassword

Obrigatório apenas para novas implantações, quando -action está definido como Deploy. Especifique uma senha personalizada para o administrador do host. Observe que as senhas devem ter pelo menos 8 caracteres, pelo menos um caractere minúsculo e pelo menos um número.

-isHostPassOneTime

Opcional. Permite que você imponha uma redefinição de senha no primeiro logon para o administrador do host. Se este parâmetro for omitido, a senha de administrador do host não será uma senha de uma só vez.

-defaultTenantAdminPassword

Obrigatório apenas para novas implantações, quando -action está definido como Deploy. Especifique uma senha personalizada para o administrador padrão do tenant. Observe que as senhas devem ter pelo menos 8 caracteres, pelo menos um caractere minúsculo e pelo menos um número.

-isDefaultTenantPassOneTime

Opcional. Permite que você imponha uma redefinição de senha no primeiro logon para o administrador padrão do tenant. Se este parâmetro for omitido, a senha de administrador do tenant não será uma senha de uma só vez.

-noAzureAuthentication

Opcional. Permite publicar no Serviço de aplicativo do Azure usando sua própria identidade de usuário, sem ter que criar uma entidade de serviço. Se esse parâmetro for usado, o conjunto de parâmetros UseServicePrincipal (que inclui itens como a ID do aplicativo do Azure, senha, ID de assinatura e ID de tenant) não é mais necessário.
O script MigrateTo-IdentityServer.ps1 é usado para migrar dados do usuário do Orchestrator para o Identity Server e definir as configurações para ambos. Ele define a autoridade de identidade do Orchestrator para o Identity Server e cria a configuração do cliente para o Orchestrator no Identity Server.

O script pressupõe que o Orchestrator e o Identity Server já estejam publicados.

.\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 no Identity Server
  • Substituição do certificado de chave privada
  • Migrar para o Identity Server

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.