Atualizando Credenciais

Diretrizes

Para atualizar credenciais para os diferentes componentes do Automation Suite , execute as seguintes etapas:

1. Gere o arquivo input.json .
2. Forneça as novas credenciais para os componentes determinados no input.jsonconforme descrito na seção de cada componente.
3. Execute a CLI uipathctl conforme descrito em cada seção do componente.

Geração do arquivo input.json

Generate the latest input.json file as follows:

• A: execute o seguinte comando para obter a revisão mais recente do seu arquivo input.json :

  uipathctl manifest get-revision
  

• B: execute o seguinte comando para listar todos os arquivos input.json passados e determinar o que você deseja escolher:

  uipathctl manifest list-revisions
  

Como atualizar as strings de conexão SQL

Existem vários cenários em que você pode querer atualizar a string de conexão usada pelos produtos Automation Suite para se conectar ao banco de dados SQL, como o seguinte:

• Ao rotacionar periodicamente a senha usada para se conectar ao banco de dados, por segurança e conformidade
• Ao alterar o FQDN para o SQL Server
• Ao migrar o banco de dados para outro SQL Server para fins de manutenção
• Ao adicionar, modificar ou remover um ou mais atributos de conexão, como MultiSubnetFailover
• Ao alternar da autenticação básica para a autenticação integrada usando o Kerberos e o AD
  Importante:

  Os produtos no Automation Suite não criam tabelas ou esquema no momento de atualização da string de conexão do banco de dados SQL. Certifique-se de que sua nova string de conexão se refere ao mesmo banco de dados que você usa atualmente. Para evitar tempo de inatividade durante o processo de atualização, certifique-se de que sua string de conexão atual seja válida no momento do processo de atualização. Você pode revogar sua string de conexão antiga após a atualização.

Atualizando as strings de conexão para produtos instalados

Para atualizar a string de conexão para produtos instalados no Automation Suite, conecte-se a qualquer um dos nós do servidor e execute as seguintes operações.

1. Gere o arquivo input.json .
2. Forneça as novas strings de conexão para os produtos instalados no input.json.
3. Execute uipathctl.

Fornecer as novas strings de conexão para produtos instalados

Há duas maneiras de fornecer strings de conexão para produtos em execução no Automation Suite:

• R: Forneça um modelo de string de conexão que seja comum a todos os produtos em execução no Automation Suite. Essa abordagem assumirá os nomes de banco de dados padrão para todos os produtos.
• B: Fornece conexão de strings específica para cada produto.

Importante:

Certifique-se de escapar das senhas NET, JDBC ou ODBC da seguinte maneira:

• para NET: adicione ' no início e no final da senha, e duplique qualquer outro '.
• para JDBC/ODBC: adicione { no início da senha e } no final, e duplique qualquer outro }. Não duplique {.

Se você definir TrustServerCertificate=False, talvez seja necessário fornecer um certificado de CA adicional para o SQL Server. Isso é necessário se o certificado do SQL Server for autoassinado ou assinado por uma CA interna. Para obter detalhes, consulte Atualizando os certificados de CA.

Para codificar ou decodificar strings Base64 usando o PowerShell, você pode usar os seguintes comandos:

• decodificar string Base64: [System.Text.Encoding]::Default.GetString([System.Convert]::FromBase64String('<base64_string>'))
• codificar string Base64: [System.Convert]::ToBase64String([System.Text.Encoding]::Default.GetBytes('<plain_text>'))

R: Fornecimento de uma string de conexão comum para todos os produtos

All the products running in Automation Suite refer to a common template connection string. One use case for choosing this method would be when you want to change the password for all the products at once. Note that, in this case, the password will be the same for all the products.

Nesses cenários, os nomes do banco de dados para todos os produtos devem ser os padrão, conforme exigido pelo Automation Suite. Se os nomes do banco de dados configurados não atenderem aos requisitos do Automation Suite, siga a próxima etapa.

Dica:

Verifique a lista de bancos de dados e seus nomes padrão no banco de dados SQL.

A tabela a seguir explica qual formato de modelo os serviços do produto aceitam:

Parâmetro	Description	Produtos
sql_connection_string_template	String de conexão completa do ADO.NET onde o nome do catálogo é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços da suíte instalada.	Platform, Orchestrator, Automation Suite Robots, Test Manager, Automation Hub, Automation Ops, Insights, Task Mining, Data Service, Process Mining
sql_connection_string_template_jdbc	String de conexão completa do JDBC onde o nome da base de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços da suíte instalada.	AI Center
sql_connection_string_template_odbc	String de conexão completa de ODBC onde o nome do banco de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços da suíte instalada.	Document Understanding, Apps
sql_connection_string_template_sqlalchemy_pyodbc	String de conexão SQL alchemy PYODBC completa em que o nome do banco de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços do pacote instalado.	Document Understanding, Process Mining
postgresql_connection_string_template_sqlalchemy_pyodbc	String de conexão SQL alchemy PSYCOPG2 completa na qual o nome do banco de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços do pacote instalado.	Process Mining (2024.10.3 ou posterior)

Exemplo do sql_connection_string_template

Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net:1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=testadmin;Password=***;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;

Exemplo do sql_connection_string_template_jdbc

jdbc:sqlserver://sfdev1804627-c83f074b-sql.database.windows.net:1433;database=DB_NAME_PLACEHOLDER;user=testadmin;password=***;encrypt=true;trustServerCertificate=false;Connection Timeout=30;hostNameInCertificate=sfdev1804627-c83f074b-sql.database.windows.net"

Exemplo do sql_connection_string_template_odbc

SERVER=sfdev1804627-c83f074b-sql.database.windows.net,1433;DATABASE=DB_NAME_PLACEHOLDER;DRIVER={ODBC Driver 17 for SQL Server};UID=testadmin;PWD=***;MultipleActiveResultSets=False;Encrypt=YES;TrustServerCertificate=NO;Connection Timeout=30;"

Exemplo do sql_connection_string_template_sqlalchemy_pyodbc

"mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:<password>@sfdev4515230-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

Exemplo postgresql_connection_string_template_sqlalchemy_pyodbc (Process Mining 2024.10.3 ou superior)

"postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/DB_NAME_PLACEHOLDER"

Observação:

Update the input.json with the new connection string template you want to update.

B: Fornecimento de strings de conexão específicas para cada produto

Plataforma

O serviço de plataforma fornece recursos administrativos, como organização e gerenciamento de locatários, gerenciamento de licenciamento, gerenciamento de usuários, etc. O serviço de plataforma é ativado por padrão e não pode ser removido. Seu nome de banco de dados padrão é AutomationSuite_Platform.

Para fornecer uma string de conexão para o serviço Platform, adicione ou atualize a seguinte seção no arquivo input.json :

"platform": {
  "sql_connection_str": "***" // dotnet connection string 
}

Orchestrator

O nome do banco de dados padrão para Orchestrator é AutomationSuite_Orchestrator.

Para fornecer um string de conexão para o serviço do Orchestrator, adicione ou atualize a seguinte seção no arquivo input.json:

"orchestrator": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Suite Robots

Automation Suite Robots and Orchestrator share the same database by default. The database name is AutomationSuite_Orchestrator.

To provide a connection string for Automation Suite Robots, add or update the following section in the input.json file:

"asrobots": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Hub

O nome do banco de dados padrão para o Automation Hub é AutomationSuite_Automation_Hub.

Para fornecer um string de conexão para o serviço do Automation Suite, adicione ou atualize a seguinte seção no arquivo input.json:

"automation_hub": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Ops

O nome padrão de banco de dados para o Automation Ops é AutomationSuite_Platform.

Para fornecer um string de conexão para o serviço do Automation Ops, adicione ou atualize a seguinte seção no arquivo input.json:

"automation_ops": {
  "sql_connection_str": "***" // dotnet connection string
}

AI Center

O nome padrão para o banco de dados do AI Center é AutomationSuite_AICenter.

Para fornecer um string de conexão para o serviço do AI Center, adicione ou atualize a seguinte seção no arquivo input.json:

"aicenter": {
  "sql_connection_str": "***" // jdbc connection string
}

Apps

O nome padrão para o banco de dados do Apps é AutomationSuite_Apps.

Para fornecer um string de conexão para o serviço do Apps, adicione ou atualize a seguinte seção no arquivo input.json:

"apps": {
  "sql_connection_str": "***" // odbc connection string
}

Data Service

O nome padrão para o banco de dados do Data Service é AutomationSuite_DataService.

Para fornecer um string de conexão para o serviço do Data Service, adicione ou atualize a seguinte seção no arquivo input.json:

"dataservice": {
  "sql_connection_str": "***" // dotnet connection string
}

Document Understanding

O nome do banco de dados padrão para Document Understanding é AutomationSuite_DU_Datamanager.

Para fornecer um string de conexão para o serviço do Document Understanding, adicione ou atualize a seguinte seção no arquivo input.json:

"documentunderstanding": { 
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"datamanager": {
 "sql_connection_str": "***" // odbc connection string
 "pyodbc_sql_connection_str": "***" // python sql connection string
 }
}

Insights

O nome padrão para o banco de dados do Insights é AutomationSuite_Insights.

Para fornecer um string de conexão para o serviço do Insights, adicione ou atualize a seguinte seção no arquivo input.json:

"insights": {
  "sql_connection_str": "***" // dotnet connection string
}

Process Mining

The default database name for Process Mining is AutomationSuite_ProcessMining_Metadata.

To provide a connection string for the Process Mining service, add or update the following section in the input.json file:

Para o PostgreSQL:

"process_mining": {
    "enabled": true,
    "sql_connection_str": "***", // dotnet connection string
    "airflow": {
        "metadata_db_connection_str": ""
    },
    "warehouse": {
        "sql_connection_str": "",
        "master_sql_connection_str": "",
        "sqlalchemy_pyodbc_sql_connection_str": ""
    }
}

Para o Microsoft SQL Server:

"process_mining": {
  "enabled": true,
  "sql_connection_str": "***" // dotnet connection string
  "sqlalchemy_pyodbc_sql_connection_str": "", 
  "warehouse": {
     "sql_connection_str": "",
     "master_sql_connection_str": "",
     "sqlalchemy_pyodbc_sql_connection_str": ""
  }
}

Task Mining

The default database name for Task Mining is AutomationSuite_Task_Mining.

Para fornecer um string de conexão para o serviço do Task Mining, adicione ou atualize a seguinte seção no arquivo input.json:

"task_mining": {
  "sql_connection_str": "***" // dotnet connection string
}

Test Manager

O nome padrão para o banco de dados do Test Manager é AutomationSuite_Test_Manager .

Para fornecer um string de conexão para o serviço do Test Manager, adicione ou atualize a seguinte seção no arquivo input.json:

"test_manager": {
  "sql_connection_str": "***" // dotnet connection string
}

Execução do instalador do uipathctl

Para concluir a atualização, execute o instalador uipathctl usando o seguinte comando:

uipathctl manifest apply input.json --versions versions.json

Atualização de credenciais do Redis

Fornecimento das novas credenciais para o Redis

Atualize a seguinte seção no arquivo input.json com a nova senha e/ou nome de host:

"fabric": {
  "redis": {
    "hostname": "new_hostname",
    "password": "new_password",
    "port": 6380,
    "tls": true
  }

Execução do instalador do uipathctl

Para concluir a atualização das credenciais do Redis, execute o instalador uipathctl usando o seguinte comando:

uipathctl manifest apply input.json --only redis --versions versions.json

Observação:

Você pode usar o sinalizador de simulação com uipathctl para imprimir o resultado do comando sem aplicá-lo.

Atualização de credenciais da objectstore

Atualize a seção a seguir no arquivo input.json com o novo access_key, secret_key ou acount_key e account_name:

"external_object_storage": {
  "enabled": false, // <true/false>
  "create_bucket": true, // <true/false>
  "storage_type": "s3", // <s3,azure,aws>
  "fqdn": "",  // <needed in case of aws non instance profile>
  "port": 443, // <needed in case of aws non instance profile>
  "region": "", 
  "access_key": "", // <needed in case of aws non instance profile>
  "secret_key": "", // <needed in case of aws non instance profile>
  "use_managed_identity": false, // <true/false>
  "bucket_name_prefix": "",
  "bucket_name_suffix": "",
  "account_key": "", // <needed only when using non managed identity>
  "account_name": "",
  "azure_fqdn_suffix": "core.windows.net",
  "client_id": "" // <optional field in case of managed identity>
},

Execução do instalador do uipathctl

Para concluir a atualização das credenciais do armazenamento de objetos, execute o instalador uipathctl usando o seguinte comando:

uipathctl manifest apply input.json --versions versions.json

Observação:

Você pode usar o sinalizador de simulação com uipathctl para imprimir o resultado do comando sem aplicá-lo.

Atualização das credenciais de registro

Quando o registro de contêiner em uso requer autenticação para extrair imagens, os pods devem usar um segredo chamado uipathpullsecret. Para atualizar uipathpullsecret, siga as seguintes etapas:

1. Atualize a seção de registro do arquivo input.json:

     "registries": { 
       "docker": { 
         "url": "yourContainerRegistryUrl", 
         "username": "username", 
         "password": "newpassword" 
       }, 
       "helm": { 
         "url": "yourContainerRegistryUrl", 
         "username": "username", 
         "password": "newpassword" 
       } 
     }
   

2. Exclua o uipathpullsecret existente:

   kubectl delete secret uipathpullsecret -n <uipath>
   kubectl delete secret uipathpullsecret -n <uipath-installer>
   

3. Execute novamente o comando de instalação:

   uipathctl manifest apply input.json --versions versions.json