IBM Cloud Docs
trabalhando com curl

trabalhando com curl

Para simplificar a interação segura com IBM Cloudant, sugerimos criar um alias de " acurl para " curl. Esse alias envia automaticamente seu IBM® Cloudant® for IBM Cloud® ao fazer solicitações HTTP de banco de dados, sem expô-las em seu histórico de terminal ou precisar que sejam digitadas em cada solicitação.

Para usar os exemplos de " curl, siga estas etapas.

Simplificação do uso de credenciais do IAM com " curl

O uso de ' curl com contas IBM Cloudant que usam o IAM para autenticação pode ser frustrante porque as chaves de API precisam ser trocadas por tokens de curta duração que são enviados com as solicitações.

Um engenheiro IBM Cloudant criou a ferramenta ' ccurl para ajudar com isso. Para obter mais informações, consulte ccurl no npm.

Simplificando o uso de IBM Cloudant Credenciais legadas com " curl

Você pode fornecer dados de nome de usuário e senha para uma solicitação de quatro maneiras.

  1. [Recomendado] Você pode definir um arquivo de controle curl que contenha suas credenciais, desative algumas análises de URL curl que podem atrapalhar o uso do IBM Cloudant e garanta que você esteja usando HTTPS. Substitua " ACCOUNT e " PASSWORD por suas credenciais reais.

    	--user "ACCOUNT:PASSWORD"
	--globoff
	--proto "=https"

    Em seguida, é possível definir um "alias" que permite que o comando curl aplique o arquivo de controle, por exemplo:

    	alias acurl="curl -s --config <full_path_and_name_of_control_file> "

    Em seguida, ao fazer solicitações para IBM Cloudant, digite ' acurl no lugar de ' curl.

    Lembre-se de excluir o arquivo de controle dos backups, uma vez que ele inclui a senha em texto não criptografado.

  2. [Recomendado para comandos únicos] Se você usar o parâmetro -u ACCOUNT, o curl solicitará que você digite sua senha interativamente na linha de comando antes de executar a solicitação.

    Esta opção é usada para o curl exemplos na referência da API IBM Cloudant.

  3. [Cuidado: essa opção não é segura] Inserir o parâmetro de combinação -u ACCOUNT:PASSWORD como parte do seu comando significa que não será solicitado que você digite sua senha interativamente.

    No entanto, uma cópia de texto sem formatação de sua senha aparece no log do terminal.

  4. [Cuidado: essa opção não é segura.] Para uma solicitação HTTPS curl, você pode fornecer o nome de usuário e a senha como parte do URL:

    ... https://ACCOUNT:PASSWORD@ACCOUNT.cloudant.com ...

    No entanto, uma cópia de texto sem formatação de sua senha aparece no log do terminal.