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

All Solution commands that interact with Orchestrator require these parameters. You can use either the short form or the long form (alternative) for each:

Short form	Long form (alternative)	Description	Exemplo
-U	N/A	URL do Orchestrator	See Orchestrator URL below
-T	N/A	Nome do tenant do Orchestrator	DefaultTenant
-A	--accountForApp	Organization (account) name	myorg
-I	--applicationId	ID do aplicativo externo	12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-S	--applicationSecret	Segredo do aplicativo externo	**** (manter seguro)
--applicationScope	N/A	Scope list (see above)	Above
--traceLevel	N/A	Nível de Registros de Log	Information, Verbose, Warning

Example with long-form parameters:

uipcli solution upload-package ./packages/MySolution.1.0.0.zip \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  --accountForApp myorg \
  --applicationId 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  --applicationSecret **** \
  --applicationScope "AutomationSolutions Solutions.Packages Solutions.Packages.Write"

URL do Orchestrator

Use the base URL only for the Orchestrator instance. Do not include organization, tenant, or path segments (for example, do not use https://cloud.uipath.com/myorg/DefaultTenant/orchestrator_). Organization and tenant are passed separately with -A and -T.

• UiPath Automation Cloud: Use the cloud base URL (for example https://cloud.uipath.com/ or https://staging.uipath.com/).
• Automation Suite (on-premises or private cloud): Use the base URL of your Automation Suite instance (for example https://uipath.yourcompany.com/). The URL is the same as for package commands. Only the base address of your Orchestrator (or Automation Suite) differs from the public cloud.

Observação:

When using external application authentication without specifying the --applicationScope parameter, the CLI automatically applies the required scopes for Solution commands.

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.