Autenticação HTTP

Pré-requisitos

Para criar uma conexão usando o conector HTTP, você deve fornecer os detalhes necessários para o tipo de autenticação selecionado. Consulte as seções a seguir para obter informações sobre os detalhes necessários para cada tipo de autenticação. Para obter informações sobre como recuperar esses detalhes, consulte a documentação do provedor de API.

Token de acesso do usuário da UiPath

Estabeleça uma conexão por meio de serviços da UiPath compatíveis. Nenhuma configuração necessária.

Código de autorização do OAuth 2.0

Forneça os seguintes detalhes:

• Nome da conexão — um nome descritivo para ajudar você a identificar essa conexão.
• URL base - A URL base de sua API (por exemplo https://api.example.com).
• ID do cliente - O identificador exclusivo do seu aplicativo conforme fornecido pelo seu provedor do OAuth durante o registro do aplicativo.
• Segredo do cliente - A chave secreta confidencial do seu aplicativo conforme fornecida pelo seu provedor OAuth.
• URL de autorização - O URL completo do endpoint de autorização conforme fornecido pelo seu provedor OAuth (por exemplo https://login.example.com/oauth2/authorize).
• URL do token – A URL do endpoint do token onde os códigos de autorização ou credenciais são trocados por tokens de acesso conforme fornecido pelo seu provedor OAuth (por exemplo https://login.example.com/oauth2/token).
• Escopo - Os escopos do OAuth necessários com base no seu provedor de API ou necessidades de integração.

Configuração adicional:

• URL de atualização do token – A URL do endpoint do token de atualização conforme fornecida pelo seu provedor do OAuth (por exemplo https://example.com/docs/oauth/refresh)
• URL de revogação do token — o URL do endpoint de revogação do token conforme fornecido pelo seu provedor do OAuth (https://example.com/docs/oauth/revoke).
• Intervalo de atualização - Tempo em segundos entre as tentativas de atualização do token do OAuth.
• Cabeçalho básico do OAuth — habilite para enviar o ID e o segredo do cliente como um cabeçalho de autenticação básico durante a troca de tokens do OAuth. A maioria dos provedores precisa disso habilitado.

Código de autorização do OAuth 2.0 com PKCE

Forneça os seguintes detalhes:

• Nome da conexão — um nome descritivo para ajudar você a identificar essa conexão.
• URL base - A URL base de sua API (por exemplo https://api.example.com).
• ID do cliente - O identificador exclusivo do seu aplicativo conforme fornecido pelo seu provedor do OAuth durante o registro do aplicativo.
• Segredo do cliente - A chave secreta confidencial do seu aplicativo conforme fornecida pelo seu provedor OAuth.
• URL de autorização - O URL completo do endpoint de autorização conforme fornecido pelo seu provedor OAuth (por exemplo https://login.example.com/oauth2/authorize).
• URL do token – A URL do endpoint do token onde os códigos de autorização ou credenciais são trocados por tokens de acesso conforme fornecido pelo seu provedor OAuth (por exemplo https://login.example.com/oauth2/token).
• Escopo - Os escopos do OAuth necessários com base no seu provedor de API ou necessidades de integração.

Configuração adicional:

• URL de atualização do token – A URL do endpoint do token de atualização conforme fornecida pelo seu provedor do OAuth (por exemplo https://example.com/docs/oauth/refresh)
• URL de revogação do token — o URL do endpoint de revogação do token conforme fornecido pelo seu provedor do OAuth (https://example.com/docs/oauth/revoke).
• Intervalo de atualização - Tempo em segundos entre as tentativas de atualização do token do OAuth.
• Cabeçalho básico do OAuth — habilite para enviar o ID e o segredo do cliente como um cabeçalho de autenticação básico durante a troca de tokens do OAuth. A maioria dos provedores precisa disso habilitado.

Credenciais do cliente OAuth 2.0

Forneça os seguintes detalhes:

• Nome da conexão — um nome descritivo para ajudar você a identificar essa conexão.
• URL base - A URL base de sua API (por exemplo https://api.example.com).
• ID do cliente - O identificador exclusivo do seu aplicativo conforme fornecido pelo seu provedor do OAuth durante o registro do aplicativo.
• Segredo do cliente - A chave secreta confidencial do seu aplicativo conforme fornecida pelo seu provedor OAuth.
• URL do token – A URL do endpoint do token onde os códigos de autorização ou credenciais são trocados por tokens de acesso conforme fornecido pelo seu provedor OAuth (por exemplo https://login.example.com/oauth2/token).
• Escopo - Os escopos do OAuth necessários com base no seu provedor de API ou necessidades de integração.

Configuração adicional:

• Intervalo de atualização - Tempo em segundos entre as tentativas de atualização do token do OAuth.
• Cabeçalho básico do OAuth — habilite para enviar o ID e o segredo do cliente como um cabeçalho de autenticação básico durante a troca de tokens do OAuth. A maioria dos provedores precisa disso habilitado.

Senha do OAuth 2.0

Forneça os seguintes detalhes:

• Nome da conexão — um nome descritivo para ajudar você a identificar essa conexão.
• URL base - A URL base de sua API (por exemplo https://api.example.com).
• Nome de usuário — a credencial de nome de usuário do usuário final para autenticação.
• Senha - A credencial de senha do usuário final para autenticação.
• ID do cliente - O identificador exclusivo do seu aplicativo conforme fornecido pelo seu provedor do OAuth durante o registro do aplicativo.
• Segredo do cliente - A chave secreta confidencial do seu aplicativo conforme fornecida pelo seu provedor OAuth.
• URL de autorização - O URL completo do endpoint de autorização conforme fornecido pelo seu provedor OAuth (por exemplo https://login.example.com/oauth2/authorize).
• URL do token – A URL do endpoint do token onde os códigos de autorização ou credenciais são trocados por tokens de acesso conforme fornecido pelo seu provedor OAuth (por exemplo https://login.example.com/oauth2/token).
• Escopo - Os escopos do OAuth necessários com base no seu provedor de API ou necessidades de integração.

Configuração adicional:

• URL de atualização do token – A URL do endpoint do token de atualização conforme fornecida pelo seu provedor do OAuth (por exemplo https://example.com/docs/oauth/refresh).
• URL de revogação do token — o URL do endpoint de revogação do token conforme fornecido pelo seu provedor do OAuth (https://example.com/docs/oauth/revoke).
• Intervalo de atualização - Tempo em segundos entre as tentativas de atualização do token do OAuth.
• Cabeçalho básico do OAuth — habilite para enviar o ID e o segredo do cliente como um cabeçalho de autenticação básico durante a troca de tokens do OAuth. A maioria dos provedores precisa disso habilitado.

Autenticação básica

Forneça os seguintes detalhes:

• Nome da conexão — um nome descritivo para ajudar você a identificar essa conexão.
• URL base - A URL base de sua API (por exemplo https://api.example.com).
• Nome de usuário — a credencial de nome de usuário para sua conta de API.
• Senha — a credencial de senha para sua conta de API.

Configuração adicional:

• API de validação de autenticação - Insira o caminho relativo que será usado para verificar suas credenciais de autenticação (por exemplo /api/v1/me, /user/profile, /auth/validate). Esta rota de API deve retornar uma resposta de sucesso quando suas credenciais forem válidas.

Chave de API

Forneça os seguintes detalhes:

• Nome da conexão — um nome descritivo para ajudar você a identificar essa conexão.
• URL base - A URL base de sua API (por exemplo https://api.example.com).
• Nome do parâmetro - O nome exato do parâmetro da chave de API conforme exigido por sua API (por exemplo X-API-Key, api_key, Authorization). Isso será usado como um nome de cabeçalho ou nome de parâmetro de consulta com base em sua seleção.
• Valor — Seu valor completo da chave de API conforme fornecido pelo seu provedor de API. Ele será armazenado com segurança e usado para autenticação.

Configuração adicional:

• Adicionar a — selecione se deseja adicionar a chave de API no cabeçalho da solicitação ou como um parâmetro de consulta. Cabeçalho é recomendado para melhor segurança.
• API de validação de autenticação - Insira o caminho relativo que será usado para verificar suas credenciais de autenticação (por exemplo /api/v1/me, /user/profile, /auth/validate). Esta rota de API deve retornar uma resposta de sucesso quando suas credenciais forem válidas.

Portador do JWT do OAuth 2.0

Forneça os seguintes detalhes:

• Nome da conexão — um nome descritivo para ajudar você a identificar essa conexão.
• URL base - A URL base de sua API (por exemplo https://api.example.com).
• ID do cliente - O identificador exclusivo do seu aplicativo conforme fornecido pelo seu provedor do OAuth durante o registro do aplicativo.
• Segredo do cliente - A chave secreta confidencial do seu aplicativo conforme fornecida pelo seu provedor OAuth.
• Chave codificada JWT base64 - Sua chave privada codificada com Base64. Certifique-se de seguir as instruções do seu provedor de API para geração e codificação de chaves.
• URL de autorização - O URL completo do endpoint de autorização conforme fornecido pelo seu provedor OAuth (por exemplo https://login.example.com/oauth2/authorize).
• URL do token – A URL do endpoint do token onde os códigos de autorização ou credenciais são trocados por tokens de acesso conforme fornecido pelo seu provedor OAuth (por exemplo https://login.example.com/oauth2/token).
• Escopo - Os escopos do OAuth necessários com base no seu provedor de API ou necessidades de integração.

Configuração adicional:

• URL de atualização do token – A URL do endpoint do token de atualização conforme fornecida pelo seu provedor do OAuth (por exemplo https://example.com/docs/oauth/refresh).
• URL de revogação do token — o URL do endpoint de revogação do token conforme fornecido pelo seu provedor do OAuth (https://example.com/docs/oauth/revoke).
• Intervalo de atualização - Tempo em segundos entre as tentativas de atualização do token do OAuth.
• Cabeçalho básico do OAuth — habilite para enviar o ID e o segredo do cliente como um cabeçalho de autenticação básico durante a troca de tokens do OAuth. A maioria dos provedores precisa disso habilitado.

Token de acesso pessoal

Forneça os seguintes detalhes:

• Nome da conexão — um nome descritivo para ajudar você a identificar essa conexão.
• URL base - A URL base de sua API (por exemplo https://api.example.com).
• Prefixo do token - O prefixo do token (por exemplo Bearer, Token, Basic). Isso será combinado com seu token no cabeçalho Autorização. Deixe vazia se nenhum prefixo for necessário.
• Token - O valor completo do token de acesso pessoal. Isso será combinado com o tipo de token no cabeçalho de autorização (por exemplo Bearer your-token-here).

Configuração adicional:

• API de validação de autenticação - Insira o caminho relativo que será usado para verificar suas credenciais de autenticação (por exemplo /api/v1/me, /user/profile, /auth/validate). Esta rota de API deve retornar uma resposta de sucesso quando suas credenciais forem válidas.

Adicione a conexão HTTP

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Selecione Adicionar conexão.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Na tela de conexão, forneça os detalhes necessários.
6. Select Connect.
7. Sua conexão foi adicionada.