Autenticação e escopos

Todos os comandos de solução exigem autenticação por meio de um aplicativo externo configurado no Orchestrator. Ao contrário das tarefas de projeto independentes, as soluções não são compatíveis com métodos de autenticação de máquina ou interativos.

Requisitos de autenticação

Os comandos de soluções autenticam-se exclusivamente por meio do OAuth2 com Apps externos.

Você deve configurar um aplicativo externo no Administrador do Orchestrator com os escopos apropriados antes de executar qualquer comando do Solution CLI.

Escopos do OAuth exigidos

As soluções usam um conjunto dedicado de escopos de aplicativos que diferem dos escopos padrão do Orchestrator. Configure seu aplicativo externo com os seguintes escopos para todas as operações de solução:

Formato copiar-colar para segredos do CI/CD:

AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write

Esse formato de linha única separado por espaço pode ser usado diretamente em:

• Grupos de variáveis do Azure DevOps
• Segredos do repositório do GitHub
• Armazenamento de credenciais do Jenkins

Observação: as seguintes operações não exigem autenticação, pois são executadas localmente:

• restore - Restaura dependências localmente
• analyze - Valida projetos localmente
• pack - Cria pacotes localmente

Parâmetros de autenticação comuns

Todos os comandos de solução que interagem com o Orchestrator exigem esses parâmetros:

Parâmetro	Description	Exemplo
-U	URL do Orchestrator	https://cloud.uipath.com/
-T	Nome do tenant do Orchestrator	DefaultTenant
-A	Nome da Organização	myorg
-I	ID do aplicativo externo	12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-S	Segredo do aplicativo externo	**** (manter seguro)
--applicationScope	Lista de escopos separada por espaços	Ver escopos acima
--traceLevel	Nível de Registros de Log	Information, Verbose, Warning

Observação:

When using external application authentication without specifying the --applicationScope parameter, the CLI automatically applies these default AutomationSolution scopes:

Solutions.Packages Solutions.Deployments OR.Execution

Como configurar um aplicativo externo

Para criar um aplicativo externo para soluções:

1. Faça login no Orchestrator como administrador. . Administr
2. Navegue até Administrador → Aplicativos externos.
3. Clique em Adicionar aplicativo.
4. Forneça um nome (por exemplo, CI-CD-Solutions).
5. Selecione Aplicativo confidencial como o Tipo de aplicativo.
6. Adicione os escopos necessários listados acima.
7. Copie o ID do aplicativo e o Segredo e armazene-os com segurança no seu gerenciador de segredo do CI/CD.

Para obter instruções detalhadas sobre como configurar aplicativos externos, consulte Gerenciamento de aplicativos externos do OAuth.

Uso de feeds personalizados do Orchestrator

Ao usar feeds de atividades personalizados do Orchestrator durante as operações de restauração, use estes parâmetros alternativos:

Parâmetro padrão	Parâmetro de Feed Personalizado
--applicationScope	--libraryOrchestratorApplicationScope
-T (tenant)	--libraryOrchestratorTenant
-U (URL)	--libraryOrchestratorUrl
(pasta)	--libraryOrchestratorFolder

Exemplo:

uipcli solution restore <solution-path> \  -A myorg \  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \  -S **** \  --libraryOrchestratorApplicationScope "OR.Folders OR.Settings.Read" \  --libraryOrchestratorTenant DefaultTenant \  --libraryOrchestratorUrl https://cloud.uipath.com/ \  --libraryOrchestratorFolder MyFolder

Melhores práticas de segurança

• Nunca codificar segredos no pipeline YAML ou scripts.
• Use o gerenciamento de segredos da sua plataforma de CI/CD:
  • Azure DevOps: grupos de variáveis com variáveis secretas.
  • Actions do GitHub: segredos do repositório ou da organização.
  • Jenkins: Armazenamento de credenciais.
• Faça a rotação de segredos de aplicativos externos regularmente.
• Use aplicativos externos separados para diferentes ambientes (Dev, Test, Prod).
• Aplique escopos de privilégio mínimo — conceda apenas o que for necessário para cada pipeline.