Automation Suite
2023.4
falso
Authentication - Automation Suite 2023.4
Imagem de fundo do banner
Logotipo
Guia da API do Automation Suite
Última atualização 22 de nov de 2023

Autenticação

Autenticação x Autorização

As APIs do Automation Suite exigem que seu aplicativo envie um token de autenticação a cada solicitação. O token permite que o servidor verifique sua identidade.

Para acessar os recursos do Automation Suite, você precisa autenticar seu aplicativo por:

  • registrando seu aplicativo, gerando assim um ID de cliente e um segredo de cliente usado para recuperar um token de autorização ,
  • fornecendo as credenciais do proprietário do recurso no corpo da solicitação do endpoint authentication
    Importante: Use o método de autenticação acima apenas se o aplicativo que acessa os recursos for altamente confiável.
Após uma autenticação bem-sucedida, você precisa ser autorizado (ou seja, ter as permissões corretas) para acessar recursos específicos. Você concede acesso ao seu aplicativo por meio do cabeçalho APIs Authorization .

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 Aplicativos Externos.

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:
  • Autenticação x Autorização
  • Autenticação ROPC
Ícone de suporte e serviços
Obtenha a ajuda que você precisa
Ícone do UiPath Academy
Aprendendo RPA - Cursos de automação
Ícone do Fórum do UiPath
Fórum da comunidade da Uipath
Logotipo branco da Uipath
Confiança e segurança
© 2005-2024 UiPath. All rights reserved.