xref: /aosp_15_r20/external/curl/docs/cmdline-opts/proxy-user.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: proxy-user
5*6236dae4SAndroid Build Coastguard WorkerShort: U
6*6236dae4SAndroid Build Coastguard WorkerArg: <user:password>
7*6236dae4SAndroid Build Coastguard WorkerHelp: Proxy user and password
8*6236dae4SAndroid Build Coastguard WorkerCategory: proxy auth
9*6236dae4SAndroid Build Coastguard WorkerAdded: 4.0
10*6236dae4SAndroid Build Coastguard WorkerMulti: single
11*6236dae4SAndroid Build Coastguard WorkerSee-also:
12*6236dae4SAndroid Build Coastguard Worker  - proxy-pass
13*6236dae4SAndroid Build Coastguard WorkerExample:
14*6236dae4SAndroid Build Coastguard Worker  - --proxy-user smith:secret -x proxy $URL
15*6236dae4SAndroid Build Coastguard Worker---
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard Worker# `--proxy-user`
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard WorkerSpecify the username and password to use for proxy authentication.
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard WorkerIf you use a Windows SSPI-enabled curl binary and do either Negotiate or NTLM
22*6236dae4SAndroid Build Coastguard Workerauthentication then you can tell curl to select the username and password from
23*6236dae4SAndroid Build Coastguard Workeryour environment by specifying a single colon with this option: "-U :".
24*6236dae4SAndroid Build Coastguard Worker
25*6236dae4SAndroid Build Coastguard WorkerOn systems where it works, curl hides the given option argument from process
26*6236dae4SAndroid Build Coastguard Workerlistings. This is not enough to protect credentials from possibly getting seen
27*6236dae4SAndroid Build Coastguard Workerby other users on the same system as they still are visible for a moment
28*6236dae4SAndroid Build Coastguard Workerbefore cleared. Such sensitive data should be retrieved from a file instead or
29*6236dae4SAndroid Build Coastguard Workersimilar and never used in clear text in a command line.
30