Storing proxy server credentials for Studio for InDesign and InCopy – Help Center

When accessing Studio Server through a proxy server, credentials such as a username and password need to be provided.

To automate the log in process, the credentials can be stored in one of the following locations:

In the WWSettings.xml file, installed on each system on which Studio for InDesign and InCopy is installed
In the preferences of Studio for InDesign and InCopy

Storing the credentials in the WWSettings.xml file

Notes:

Storing user names and passwords in configuration files can be a potential security issue. A better alternative is to store this information by using the Proxy setting of the preferences of Studio for InDesign and InCopy. (See Storing the credentials in the preferences below.)

When defining the settings in both the WWSettings.xml file and the InDesign or InCopy preferences, those in the WWSettings.xml will be used.

File: WWSettings.xml file
Name of option: Proxy
Location: anywhere between the <Settings> </Settings> tags
Values:
address: address of the proxy server
user: the user name
password: the password
type: (Optional) Defines the proxy type. Use one of the following values:
SOCKS4
SOCKS4A
SOCKS5
SOCKS5_HOSTNAME
HTTP (used when type is not set)
HTTP1.0
httptunnel. (Optional) Set to ‘true’ when HTTP Proxy tunneling should be used.
authorization. (Optional) Defines the proxy authorization protocol. Use one of the following values:
basic
digest
gssnegotiate
ntlm
any (used when authorization is not set)
anysafe
Example:

Default entry without additional arguments:

<SCEnt:Proxy address= "yourserver:8080" user="administrator" password="n@n0m@c"/>

Default entry including additional arguments:

<SCEnt:Proxy address= "yourserver:8080" user="administrator" password="n@n0m@c" type="SOCKS4" httptunnel="true" authorization="any"/>

Important: Make sure to validate the WWSettings.xml file for correct content. See Validating the WWSettings.xml file.

Storing the credentials in the preferences

In this method, the credentials are stored as preferences in InDesign or InCopy and only the address of the proxy server is stored in the configuration file.

Step 1. Access the preferences of Studio for InDesign and InCopy:

On macOS: choose InDesign/InCopy > Preferences > WoodWing Studio...
On Windows: choose Edit > Preferences > WoodWing Studio...

The Proxy settings in the preferences.

Figure: The Proxy preferences of Studio.

Step 2. Fill out the username and password.

Step 3. Add the following option to the WWSettings.xml file:

File: WWSettings.xml file
Name of option: Proxy
Location: anywhere between the <Settings> </Settings> tags
Values:
address: address of the proxy server
type: (Optional) Defines the proxy type. Use one of the following values:
SOCKS4
SOCKS4A
SOCKS5
SOCKS5_HOSTNAME
HTTP (used when type is not set)
HTTP1.0
httptunnel. (Optional) Set to ‘true’ when HTTP Proxy tunneling should be used.
authorization. (Optional) Defines the proxy authorization protocol. Use one of the following values:
basic
digest
gssnegotiate
ntlm
any (used when authorization is not set)
anysafe
Example:

Default entry without additional arguments:

<SCEnt:Proxy address= "yourserver:8080"/>

Default entry including additional arguments:

<SCEnt:Proxy address= "yourserver:8080" type="SOCKS4" httptunnel="true" authorization="any"/>

Important: Make sure to validate the WWSettings.xml file for correct content. See Validating the WWSettings.xml file.

Storing the credentials in the WWSettings.xml file

Storing the credentials in the preferences

Related articles