Proxy Settings

2024.2 Release: Public Preview

The new method for configuring proxy authentication in Designer is in Public Preview.

While in public preview, the new proxy configuration has some limitations. Review these in the Important Notes and Limitations section below.

Please also note that you can continue to use the previous proxy configuration or explore these new options.

Overview

When you use Alteryx Designer, you often need to communicate with the internet. For example, you might use a tool in your workflow (for example, the Download tool) that needs to access the internet to fetch information. While you can connect directly to the internet, this option might not align with your organization’s security requirements.

A proxy server lets you route network traffic between your network and the internet through an intermediary. It lets you add an extra layer of security between your network and the internet.

You can configure proxy settings directly in Designer, via User Settings. Refer to the instructions below to get started.

Configure Proxy Settings in Alteryx Designer

重要

The 2024.2 updates to the proxy configuration are in Public Preview and specific to Alteryx Designer only. The proxy settings in Designer and DCM are not synced with Server.

Alteryx now provides a new method for handling proxy servers in a network and introduces new inputs. You can access these proxy settings via the Designer User Settings. Go to Options > User Settings > Edit User Settings, and select the Proxy tab.

Next, select Enable New Proxy Settings (Preview) to enable the new Public Preview proxy configuration options and configure the following settings.

Proxy Selection

Select the type of proxy that you want to configure. If your proxy requires authentication, configure this via the Proxy Authentication section below. You have several options for proxy selection:

Never Use Proxy: Select this option if you don't want to use a proxy to access the internet.
Use Internet Options Settings: This is the default option. With this option selected, Designer consumes the proxy settings that you define via your computer's Network and Internet settings, including the exceptions list. To set up a proxy for use with this setting, go to your computer’s Network and Internet settings and configure your proxy settings there. When you select this option, you also need to choose a DCM connection via the Proxy Authentication section or create a new connection via DCM. Note that this proxy selection allows for multiple connection methods if needed.
重要
The DCM connections that you use for this setting should leave the Address and Request Protocol fields blank.
Consume PAC file at this location: A PAC file is a JavaScript function with logic that determines whether a network request goes directly to the destination or is forwarded to a proxy server. Enter a path to the location of your PAC script. This can be a full URI path or a full path to a local file. When you select this option, you also need to choose a DCM connection via the Proxy Authentication section or create a new connection via DCM. Note that this proxy selection allows for multiple connection methods if needed.
- Examples of valid URI paths: http://alteryx.com/example.pac or https://alteryx.com/example.pac.
- Example of a valid local file path: C:\ProgramData\Example\example.pac.
重要
The DCM connections that you use for this setting should leave the Address and Request Protocol fields blank.
Manual: Select this option to provide all proxy details manually via Designer. This essentially lets you define the host name of the required proxy directly in Designer. When you select this option, you also need to choose a DCM connection via the Proxy Authentication section or create a new connection via DCM. Note also that the Manual option allows for only one connection via the Proxy Authentication section.
- The Manual option requires that you specify a proxy type (HTTP, HTTPS, or SOCKS5h) and proxy server address via DCM.
- Designer uses the proxy server address (as well as any additional connection settings) that you provide when you configure the DCM connection.
- Exceptions: For use with the above Manual option. Select Bypass Proxy Selection... to add a comma-separated list of host names that should not use a proxy when accessed. You can also enter a single asterisk ('*') to match all hosts. If a host name in the exclusion list starts with a dot (.), then the name matches that entire domain. For example, .example.com matches both www.example.com and home.example.com but not nonexample.com.

Proxy Authentication

Use Proxy Authentication to configure the authentication type (Basic, NTLM, Windows Negotiate) and credentials needed to connect through the proxy or proxies selected above.

Select Connection: Use the dropdown to select existing connections (created via DCM) or select Create New Connection to launch DCM and configure your proxy connection. For more information on this process, refer to Create a New Connection and Credentials for Proxy via DCM.
Selected Connections (topmost preferred): Use the provided field and the up and down arrow icons to rearrange existing connections in order of priority. Your proxy connection uses the connections in the order you set here. Use the – (minus) icon to remove any existing connections that you no longer want to use.

Create a New Connection and Credentials for Proxy via DCM

If your proxy server requires authentication, you need to create a connection and associated credentials. If you are using the Manual proxy option, you need to create a connection that specifies the address/host name of your proxy server, as well as associated credentials, if required. This is done via Data Connection Manager (DCM) in Designer.

In the Proxy Authentication section of Designer’s User Settings, use the Select Connection dropdown to select Create New Connection to launch the Connection Manager window. Alternatively, via Designer’s main menu, go to File > Manage Connections > Proxy Servers and select the + New button.

Once here, you can configure your proxy server and authentication.

Select the proxy server technology via the Technology dropdown. Your options are…
- Any Proxy Type: If you select this option, the proxy type is taken from the PAC file/Internet Options. Always use this option unless you select the Manual proxy or want to fine-tune your proxy settings for different proxy types.
- HTTP Proxy
- HTTPS Proxy
- SOCKS5h Proxy
Enter a name for this Data Source in the Data Source Name field. This label will be used to reference this proxy server later in DCM and the Proxy User Settings, so it’s important to provide a descriptive name that will help you identify this connection later.
Enter the proxy server address via the Address field. This is required when using the Manual option of the Proxy Selection. Otherwise, the proxy server address is provided by the PAC file/Internet Options settings. In that case, this field is optional and is used to match DCM proxy connections to the selected proxy server URL.
- Example proxy host name address: myproxy.example.com:1234
- Example proxy IP address: 158.42.13.3:1234
(Optional) In the Request protocol field, select the request protocol for your proxy server. Use this option if you only want to use this connection for a specific protocol, like FTP. Your options are…
- FTP
- HTTP
- HTTPS
- SFTP
- SMTP
Select Save.

Next, you have the option to create the credentials to authenticate to your proxy server.

Select + Connect Credential to get started.
Select your authentication method via the Authentication Method dropdown. Currently, username and password are the only supported credential types for all of these methods. To do Windows Integrated authentication, select the authentication method and leave the Credential information blank in DCM. These are the authentication methods that are currently supported:
- Basic
- No Authentication
- NTLM
- Windows Negotiate (SPNEGO/Kerberos)
Next, use the Credential dropdown to select Create New Credential. You can also select an existing credential (if previously created).
Enter a Credential Name. Once again, this is a label for you to reference later if needed.
Vault: If no vault connection exists beyond the local DCM storage, the Vault dropdown is not displayed. If a vault connection is established, the dropdown is available, with DCM local storage preselected. If configured, you can then choose your preferred vault, for example, HashiCorp or CyberArk and select the username and password from the vault. For more information, go to DCM External Vaults. Note that your vault itself has to be reachable without the use of a proxy.
Enter the Username and Password associated with the new credential to authenticate to your proxy server.
Select the Create and Link button to finish.

编辑代理连接和凭证

创建代理连接和关联的凭证后，您可以根据需要编辑这些详细信息。您可以通过 DCM 执行此操作。

编辑代理连接

要编辑代理连接，请执行以下操作……

在 Designer 中，依次点击文件 > 管理连接，以打开 DCM。
选择左侧的代理服务器选项卡，以访问已创建的所有代理连接。
找到需要编辑的连接，然后选择其名称以查看连接详细信息。您可以在此处查看创建连接时提供的信息，以及链接的任何凭证。如果需要，您还可以选择连接凭证。
选择编辑按钮以更改连接。根据需要更新数据源名称、地址和请求协议。
选择保存以完成更改，或者选择取消以返回上一个屏幕。

编辑代理凭证

要编辑代理凭证，请执行以下操作……

在 Designer 中，依次点击文件 > 管理连接，以打开 DCM。
选择“连接管理器”窗口左侧的凭证选项卡，以访问您以前创建的所有凭证。这包括所有凭证，而不仅仅是与代理连接相关联的凭证。
找到需要编辑的凭证，然后选择凭证名称以查看其详细信息。您可以在此处查看创建凭证时提供的信息，以及当前使用这些凭证的任何连接。
选择编辑按钮以更新凭证。根据需要更新方法、凭证名称、用户名和密码。
选择保存以完成更改，或者选择取消以返回上一个屏幕。

Migrating from Previous Proxy Configuration

The new proxy configuration is in Public Preview in the 2024.2 release. You can continue to use the previous proxy configuration or explore the new options. To use the new configuration options, you need to select the Enable New Proxy Settings checkbox in the Proxy tab of Designer’s User Settings.

If you want to use the new proxy settings and you previously provided proxy credentials (username and password) via the previous settings, you need to recreate those credentials via DCM (as described above).

Important Notes and Limitations