Home » Managing the server and licenses » Configuring the BlackBerry Administration Service to use a proxy server » Configuring the BlackBerry Administration Service to authenticate with a proxy server

Configuring the BlackBerry Administration Service to authenticate with a proxy server

If your organization's proxy server requires authentication, you must configure the BlackBerry® Administration Service to authenticate with the proxy server.

If the proxy server uses Windows® authentication, you must configure the proxy server to authenticate the Windows account that runs the BlackBerry Administration Service.

If your proxy server uses HTTP basic authentication, you can configure the user name and password for HTTP basic authentication using the BlackBerry Enterprise Trait Tool. You can specify the credentials for either the entire BlackBerry Domain or for individual BlackBerry Administration Service instances. The BlackBerry Administration Service tries the credentials that you specify for the BlackBerry Administration Service instance first and then tries the credentials that you specify for the BlackBerry Domain.

Configure the BlackBerry Administration Service to use HTTP basic authentication

You use the BlackBerry® Enterprise Trait Tool to configure the BlackBerry Administration Service to use HTTP basic authentication to authenticate with a proxy server. HTTP basic authentication requires a user name and password for authentication.

On the computer that hosts the BlackBerry Administration Service, at the command prompt, navigate to the folder that contains the TraitTool.exe file.

Perform one of the following tasks:

Task	Steps
Specify the credentials for HTTP basic authentication that your organization's BlackBerry Domain uses.	Type `traittool -global -trait BASProxyBasicAuthUID -set <user_name>`, where `<user_name>` is the user name (for example, user01@blackberry.com or blackberry.com\user01). Type `traittool -global -trait BASProxyBasicAuthPassword -set <password>`, where `<password>` is the password.
Specify the credentials for HTTP basic authentication that a specific BlackBerry Administration Service instance uses.	Type `traittool -BASServer <name> -trait BASProxyBasicAuthUID -set <user_name>`, where `<name>` is the host name of the computer that hosts the BlackBerry Administration Service instance and `<user_name>` is the user name (for example, user01@blackberry.com or blackberry.com\user01) for that computer. Type `traittool -BASServer <name> -trait BASProxyBasicAuthPassword -set <password>`, where `<name>` is the host name of the computer that hosts the BlackBerry Administration Service instance and `<password>` is the password for the computer.

Task

Steps

Specify the credentials for HTTP basic authentication that your organization's BlackBerry Domain uses.

Type traittool -global -trait BASProxyBasicAuthUID -set <user_name>, where <user_name> is the user name (for example, user01@blackberry.com or blackberry.com\user01).
Type traittool -global -trait BASProxyBasicAuthPassword -set <password>, where <password> is the password.

Specify the credentials for HTTP basic authentication that a specific BlackBerry Administration Service instance uses.

Type traittool -BASServer <name> -trait BASProxyBasicAuthUID -set <user_name>, where <name> is the host name of the computer that hosts the BlackBerry Administration Service instance and <user_name> is the user name (for example, user01@blackberry.com or blackberry.com\user01) for that computer.
Type traittool -BASServer <name> -trait BASProxyBasicAuthPassword -set <password>, where <name> is the host name of the computer that hosts the BlackBerry Administration Service instance and <password> is the password for the computer.

Delete credentials for HTTP basic authentication

On the computer that hosts the BlackBerry® Administration Service, at the command prompt, navigate to the folder that contains the TraitTool.exe file.

Perform one of the following tasks:

Task	Steps
Delete the user name and password that all of the BlackBerry Administration Service instances in your organization's BlackBerry Domain use for HTTP basic authentication.	Type `traittool -global -trait BASProxyBasicAuthUID -erase`. Type `traittool -global -trait BASProxyBasicAuthPassword -erase`.
Delete the user name and password for the computer that a single BlackBerry Administration Service instance in your organization's BlackBerry Domain uses for HTTP basic authentication.	Type `traittool -BASServer <name> -trait BASProxyBasicAuthUID -erase`. Type `traittool -BASServer <name> -trait BASProxyBasicAuthPassword -erase`.