esppasswd (registers, changes, and deletes passwords)
- Organization of this page
Format
esppasswd {{-a | -c | -d }-s password-identification-name -o authentication-target -u user-name | -l [ -f file-name ]}
Function
-
Use this command for measuring Web transactions.
-
This command adds, changes, and deletes passwords in the password file (i.e. the password utility).
-
This command outputs a list of password keys (password identification name, authentication target, and user name) to the standard output or to a specified file.
Execution permission
Administrator permissions
Storage folder
installation-folder\agtv\probe\bin
Arguments
-a
Specifies that a password is to be added.
-c
Specifies that a password is to be changed.
-d
Specifies that a password is to be deleted.
-s password-identification-name
Specifies the identification name of the processing that requires the password.
-o authentication-target
Specifies the target that requires authentication.
-u user-name
Specifies the user requiring a password.
-l
Specifies that a list of keys is to be output.
-f file-name
Specifies the file to which the list of keys is to be output. If the -l option is specified but this option is omitted, the list of keys is output to the standard output only.
The following table lists the values to be specified for the password identification name, authentication target, and user name.
|
Service |
Password identification name (value to be specified) |
Authentication target |
User name |
|---|---|---|---|
|
HTTP(S) Web authentication |
HTTP-W |
URL#1 |
User name#2 |
|
HTTP(S) Proxy authentication |
HTTP-P |
Proxy server host name#2 |
User name#2 |
|
HTTPS client authentication |
HTTPS-C |
Client certificate file name#2,#3 |
A user name is not needed, and is ignored if specified. |
|
SMTP, POP3 |
POP3 |
POP3 server host name#2 |
User name#2 |
|
IMAP4 |
IMAP4 |
IMAP4 server host name#2 |
User name#2 |
|
FTP |
FTP |
FTP server host name#2 |
User name#2 |
- #1
-
You must not include a protocol identifier (http:// or https://) in the URL that you specify. Note also that the URL to be authenticated during the measurement of an HTTP(S) service must match the URL specified by the <URL> tag in the measurement condition registration file.
- #2
-
Make sure that the value specified as an argument matches the value specified in esptask.xml.
- #3
-
Specify a file name (without including its path) that is located in installation-folder\agtv\probe\cert.
Notes
-
If the specified key already exists, the password cannot be added.
-
If the specified key does not exist, the password cannot be changed, added, or deleted.
-
Of the names that can be specified as the authentication target, the following names are not case sensitive:
-
Host name (including a host name included in the URL)
-
Return values
|
0 |
Normal termination |
|
1 |
The same key was found when a password was to be added. |
|
2 |
The specified key was not found when a password was to be changed or deleted. |
|
Other value |
Abnormal termination |
Examples
-
Add a Web authentication password for the Web authentication user name hitachi with the URL www.hitachi.co.jp/index.html
esppasswd -a -s HTTP-W -o www.hitachi.co.jp/index.html -u hitachi
-
Change the POP3 password for the user name hitachi with the POP3 server name pop3.hitachi.co.jp
esppasswd -c -s POP3 -o pop3.hitachi.co.jp -u hitachi
-
Delete the POP3 password for the user name hitachi with the POP3 server name pop3.hitachi.co.jp
esppasswd -d -s POP3 -o pop3.hitachi.co.jp -u hitachi
-
Output a list of keys to the standard output
esppasswd -l
![[Figure]](GRAPHICS/ZUV10010.GIF)
-
Output a list of keys to the file pwdkey
esppasswd -l -f pwdkey