Skip to main content
English (United States) Nederlands

Storing proxy server credentials for Studio for InDesign and InCopy

Updated

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.

Related articles

Comments

0 comments