Zebra Technologies P1071336-002 manual When Http Authentication is Necessary

Configuring Printers with WebLink

Configuring Weblink

•The proxy server port (optional)

•The username and password for the proxy (optional)

To supply the address of the proxy server (assuming a default port and no username/password), configure the proxy setting as follows:

! U1 setvar "weblink.ip.conn1.proxy" "https://my.internal.proxy/"

In this scenario, the proxy address is my.internal.proxy and the scheme is HTTPS. The default port (1080) will be used. No username or password will be used to authenticate with the proxy.

To specify an alternate port, configure the proxy as follows:

! U1 setvar "weblink.ip.conn1.proxy" "https://my.internal.proxy:3128/"

To specify a username and password configure the proxy as follows:

! U1 setvar "weblink.ip.conn1.proxy" "https://user:pass@my.internal.proxy/"

The proxy username, password, and the rest of the URL must follow the rules specified in RFC3986 (http://www.ietf.org/rfc/rfc3986.txt).

33

When HTTP Authentication is Necessary

Use this configuration when, for example, a firewall requires a username and/or password.

It may be necessary to specify a username and password to various routers and servers along the path to the remote server. Typically, when using a browser to access the server, the authentication request will be presented in the form of a dialog window that asks for the username and password.

Because the printer’s connection to the remote server is headless and non-interactive, the Weblink configuration allows a user to enter in a server name/username/password triplet. The triplet will be used in the event that the printer is presented with an authentication request (for example, this typically is requested via the HTTP/1.1 401 Unauthorized request).

To specify authentication credentials, issue the following:

!U1 setvar "weblink.ip.conn1.authentication.add" "servername.com username password"

In this scenario, the server requesting authentication is servername.com. The username and password to be supplied are ‘username’ and ‘password’. The server name can be either a DNS name or an IP address. The username and password cannot be retrieved from SGD, SNMP, or JSON once added. Only the server name will be returned.

More than one set of authentication triplets can be added. The printer will only use the credentials as they are needed. In other words, the printer will only use the credentials for servername.com if it receives a HTTP/1.1 401 Unauthorized request from servername.com.

To see what authentication triplets are specified issue:

! U1 getvar "weblink.ip.conn1.authentication.entries"

To remove authentication credentials issue the following:

! U1 setvar "weblink.ip.conn1.authentication.remove" "servername.com"

1/20/15 P1071336-002