Automation Suite
2022.4
falso
- Introdução
- Autenticação
- Escopos e permissões
- APIs de gestão de plataforma
Autenticação ROPC
Guia da API do Automation Suite
Última atualização 19 de abr de 2024
Autenticação ROPC
Importante:
Oferecemos suporte à autenticação por meio de ROPC para compatibilidade com versões anteriores de instâncias do Orchestrator que foram migradas de implantações autônomas para o Automation Suite.
Somente os administradores de host devem autenticar usando o ponto de extremidade
/api/account/authenticate/
.
Os usuários empresariais devem se autenticar usando o .
O método de autenticação de credenciais de senha do proprietário do recurso tem escopo de locatário, portanto, o aplicativo externo não poderá ser autenticado usando esse método, pois um aplicativo externo não pode ser criado no nível do locatário.
Para recuperar o token de acesso, faça uma solicitação POST para o terminal
BaseURL/[OrgName]/[TenantName]/api/account/authenticate
com a seguinte carga útil:
{
"TenancyName": "{account_tenant_name}",
"UsernameOrEmailAddress": "{account_username}",
"Password": "{account_password}"
}
{
"TenancyName": "{account_tenant_name}",
"UsernameOrEmailAddress": "{account_username}",
"Password": "{account_password}"
}
No pedido acima:
{account_tenant_name}
— é o nome do locatário em sua conta do Automation Suite{account_username}
— é o nome de usuário da sua conta do Automation Suite{account_password}
— é a senha usada para fazer login em sua conta do Automation Suite
Dica:
Para localizar o valor TenancyName de sua instância do Orchestrator, faça uma solicitação GET para /odata/Users/UiPath.Server.Configuration.OData.GetCurrentUser.
O corpo da resposta retorna o token do portador, usado por seu aplicativo para autorizar outras chamadas de API. Portanto, no cabeçalho de autorização de uma chamada de API, anexe
Bearer xxxx
e substitua xxxx
pelo valor {access_token}
(por exemplo, Authorization: Bearer eyJhbG ... LnVxjA
).
{
"result": "{access_token}",
"targetUrl": null,
"success": true,
"error": null,
"unAuthorizedRequest": false,
"__abp": true
}
{
"result": "{access_token}",
"targetUrl": null,
"success": true,
"error": null,
"unAuthorizedRequest": false,
"__abp": true
}
Importante:
- Por padrão, o token de acesso é válido por 30 minutos. Para gerar um novo, faça outra chamada para o terminal
api/account/authenticate
. - Se sua organização do Automation Suite usar o modelo do Azure Active Directory, você deve registrar aplicativos externos no Automation Suite e usar o .