Install Box Connector on Windows
To install the Box Connector on Windows, use the following procedure.
To install the Box Connector
-
Run the Box Connector installation program.
The installation wizard opens.
-
Read the installation instructions and click Next.
The License Agreement dialog box opens.
-
Read the license agreement. If you agree to its terms, click I accept the agreement and click Next.
The Installation Directory dialog box opens.
-
Choose an installation folder for Box Connector and click Next.
The Service Name dialog box opens.
-
In the Service name box, type a name to use for the connector’s Windows service and click Next.
The Service Port and ACI Port dialog box opens.
-
Type the following information, and click Next.
Service port The port used by the connector to listen for service actions. ACI port The port used by the connector to listen for actions. The License Server Configuration dialog box opens.
-
Type the following information, and click Next.
License server host The host name or IP address of your License server. License server port The ACI port of your License server. The IDOL database dialog box opens.
-
In the IDOL database box, type the name of the IDOL database into which you want to index documents, and click Next.
The Proxy Server dialog box opens.
-
If a proxy is required to communicate with the repository from the machine on which you are installing the connector, type the following information and then click Next.
Proxy host The host name or IP address of the proxy server to use to access the repository. Proxy port The port of the proxy server to use to access the repository. Proxy username The user name to use to authenticate with the proxy server. Proxy password The password to use to authenticate with the proxy server. The Box connection dialog box opens.
- In the Box user name box, type the user name to use to access the Box repository. If you want to retrieve information from Box Enterprise, this must be the user name of an admin or co-admin.
-
(Optional) If you want to retrieve information from Box Enterprise, select the Box Enterprise check box. You can also use regular expressions to limit the user accounts from which information is retrieved.
"Must Have" regex A regular expression to restrict the user accounts synchronized by the connector. If set, the connector does not synchronize a user account unless the login name matches the regular expression. "Cant Have" regex A regular expression to restrict the user accounts synchronized by the connector. If set, the connector does not synchronize any account where the login name matches the regular expression. -
Click Next.
The OAuth Authentication Parameters dialog box opens.
-
Type the following information and click Next.
AppKey The application key that was provided when you set up an application to represent the connector. AppSecret The application secret that was provided when you set up an application to represent the connector. Redirect URL The URL at which the OAuth tool will run. For example, http://localhost:7878/oauth
.The CFS dialog box opens.
-
Choose whether to install a new CFS or use an existing CFS.
-
To install a new CFS, select the Install a new CFS check box and click Next.
The Installation directory dialog box opens. Go to the next step.
-
To use an existing CFS, clear the Install a new CFS check box and click Next.
The CFS dialog box opens. Type the host name and port of your existing CFS installation. Then, click Next and go to Step 19.
-
-
Choose an installation folder for the Connector Framework Server and then click Next.
The Installation name dialog box opens.
-
In the Service name box, type a unique name for the Connector Framework service and click Next. The name must not contain any spaces.
The CFS dialog box opens.
-
Type the following information, and click Next.
Service port The port used by CFS to listen for service actions.
ACI port The port used by CFS to listen for actions. -
Type the following information and click Next.
IDOL Server hostname The host name or IP address of the IDOL server that you want to index documents into. ACI port The ACI port of the IDOL server. The Pre-Installation Summary dialog box opens.
-
Review the installation settings. If necessary, click Back to go back and change any settings. If you are satisfied with the settings, click Next.
The connector is installed.
-
The installation program can run the OAuth tool, which obtains the token necessary to retrieve information from Box.
-
To run the OAuth tool, select the Run OAuth tool check box, and click Next.
Your default web browser opens to the Box web site, so that you can authorize the connector to access Box. After you authorize the connector, the OAuth tool obtains the access token from Box and writes it to a file named
oauth.cfg
, in the connector's installation folder. The parameters inoauth.cfg
are included in the default connector configuration. - To finish installing the connector without running the OAuth tool, clear the Run OAuth tool check box and click Finish. For information about how to run the OAuth tool at a later time, see Configure OAuth Authentication.
-
-
Click Finish.
The installation is complete.