Com o conector HTTP Request, você pode usar os comandos em uma cadeia para executar solicitações de protocolo de transferência de hipertexto (HTTP) GET, POST, PUT e DELETE para um determinado URL. Por exemplo, você pode usar esse conector em uma cadeia para conectar e automatizar outras soluções por meio de seus respectivos conectores.
Para ver como uma Solicitação HTTP é estruturada, consulte nossa lista de exemplos do Conector HTTP .
Nota: Embora esteja etiquetado como solicitação HTTP, o HTTPS (HTTP seguro) é suportado (e recomendado).
Requisitos
- Embora a conexão não tenha recursos específicos do OData, você pode adicionar quaisquer componentes necessários da solicitação por meio dos parâmetros Headers ou Query string.
- Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização deve habilitá-lo primeiro.
Configure o conector de solicitação HTTP
- Em Construtor de Cadeias, clique em Conexões e, em seguida, Criar no canto superior direito.
- Em Conexão do conector, selecione Solicitação HTTP e o CloudRunner padrão.
- Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.
- Selecione os ambientes para usar a conexão e clique em Save.
- Para testar a conexão, crie e execute uma cadeia com o comando Get Sites do conector 2 e verifique se ele retorna uma saída válida.
Gerenciar credenciais para solicitações HTTP seguras
Para proteger as solicitações HTTP do conector, você pode configurar seus comandos com:
- Autenticação básica de nome de usuário e senha
-
Certificações codificadas por Privacy-Enhanced Mail (PEM), como para autenticação mútua Transport Layer Security (mTLS)
Nota: A Workiva não gera certificados para solicitações HTTP em e sim em. Para usar certificados codificados por PEM, forneça o par de chaves públicas/privadas a ser enviado com as solicitações e um certificado opcional de autoridade de certificação (CA).
Para configurar um comando com credenciais:
- Em Chain Builder, carregue os certificados como recursos do espaço de trabalho.
- Quando você configurar o comando do conector, selecione os certificados como propriedades:
- Para autenticação básica, insira ou selecione as credenciais em Nome de usuário e Senha.
- Para o par de chaves pública/privada, selecione seus recursos em Certificate e Certificate private key, respectivamente.
- Para um certificado de CA opcional, selecione seu recurso em Certificado de CA.
Solução de problemas
- Se um erro for retornado, revise o URL de origem e a estrutura da solicitação. Nosso artigo Exemplos de conectores HTTP detalha cada componente necessário.
- Verifique se a string de consulta está codificada.