# Retrieve Information from Confluence

To automatically retrieve content from Confluence, create a new fetch task by following these steps. The connector runs each fetch task automatically, based on the schedule that is configured in the configuration file.

To create a new Fetch Task

1. Stop the connector.
2. Open the configuration file in a text editor.

3. In the `[FetchTasks]` section of the configuration file, specify the number of fetch tasks using the `Number` parameter. If you are configuring the first fetch task, type `Number=1`. If one or more fetch tasks have already been configured, increase the value of the `Number` parameter by one (1). Below the `Number` parameter, specify the names of the fetch tasks, starting from zero (0). For example:

       [FetchTasks]
       Number=1
       0=MyTask

4. Below the `[FetchTasks]` section, create a new TaskName section. The name of the section must match the name of the new fetch task. For example:

       [FetchTasks]
       Number=1
       0=MyTask

       [MyTask]

1. In the new section, set the following parameters:

   `ConfluenceHost` | The host name or IP address of the machine that hosts the Confluence instance.
   `ConfluencePort` | The port to use to connect to Confluence.
   `UseSecureConnection` | Specifies whether to connect to Confluence using HTTPS. To use HTTPS, rather than HTTP, set this parameter to `TRUE`.
   `MappedSecurity` | Specifies whether to enable mapped security. To extract security information from the repository and add an Access Control List (ACL) to each document, set this parameter to `TRUE`.

2. Specify the information required by the connector to authenticate with Confluence.

   - To use HTTP basic authentication, set the following parameters:

     `BasicUsername` | The user name to use to retrieve data from Confluence.
     `BasicPassword` | The password to use to retrieve data from Confluence.

   - To use OAuth authentication, follow the instructions in Configure OAuth Authentication. After using the OAuth configuration tool to generate the file `oauth.cfg`, import the parameters into the connector configuration file:

         [MyTask] < "oauth.cfg" [OAUTH]

     For more information about including parameters from another file, see Include an External Configuration File.

3. (Optional) You can set additional parameters to choose which information to ingest. For example:

   `SpaceMustHaveRegex` | A regular expression to restrict the spaces that are ingested. Unless the title of a space matches the regular expression, the space and all of its child pages and blog posts are ignored.
   `SpaceCantHaveRegex` | A regular expression to restrict the spaces that are ingested. If the title of a space matches the regular expression, the space and all of its child pages and blog posts are ignored.

   For a complete list of configuration parameters that you can use, refer to the Confluence REST Connector Reference.

4. Save and close the configuration file.

_FT_HTML5_bannerTitle.htm