CR1000 Manual - Campbell Scientific

Section 8. Operation
8.6.3.2 Command Syntax
Four levels of access are available through Basic Access Authentication:
• all access denied (Level 0)
• all access allowed (Level 1)
• set variables allowed (Level 2)
• read-only access (Level 3)
Multiple user accounts and security levels can be defined. .csipasswd is created
and edited in the Device Configuration Utility (DevConfig) (p. 92) software Net
Services tab, Edit .csipasswd File button. When in Datalogger .csipasswd File
Editor dialog box, pressing Apply after entering user names and passwords
encrypts .csipasswd and saves it to the CR1000 CPU: drive. A check box is
available to set the file as hidden. If hidden when saved, the file cannot be
accessed for editing.
If access to the CR1000 web server is attempted without correct security
credentials, the CR1000 returns the error 401 Authorization Required. This
error prompts the web browser or client to display a user name and password
request dialog box. If .csipasswd is blank or does not exist, the user name
defaults to anonymous with no password, and the security level defaults to readonly
(default security level can be changed in DevConfig). If an invalid user
name or password is entered in .csipasswd, the CR1000 web server will default to
the level of access assigned to anonymous.
The security level associated with the user name anonymous, affects only API
commands. For example, the API command SetValueEx will not function when
the API security level is set to read-only, but the CRBasic parameter SetValue in
the WebPageBegin() instruction will function. However, if .csipasswd sets a
user name other than anonymous and sets a password, security will be active on
API and CRBasic commands. For example, if a numeric security pass code is set
in the CR1000 Status table (see Security (p. 70) section), and .csipasswd does not
exist, then the security code must be entered to use the CRBasic parameter
SetValue. If .csipasswd does exist, a correct user name and password will
override the security code.
API commands follow the syntax,
where,
ip_adrcommand=CommandName&parameters/arguments
ip_adr = the IP address of the CR1000.
CommandName = the the API command.
parameters / arguments = the API command parameters and associated
arguments.
& is used when appending parameters and arguments to the command
string.
Some commands have optional parameters wherein omitting a parameter results
in the use of a default argument. Some commands return a response code
indicating the result of the command. The following table lists API parameters
373