Configure OAuth Authentication (User Account)

You must configure OAuth authentication so that the connector can authenticate with Google Cloud Storage. Micro Focus recommends that you use the OAuth configuration tool that is supplied with the connector.

NOTE: Micro Focus recommends that you configure authentication using a Google service account instead. For information about how to do this, see Permissions and Configure OAuth Authentication (Service Account).

To configure OAuth authentication

  1. Open the folder where you installed the connector.
  2. Open the file oauth_tool.cfg in a text editor.
  3. In the [Default] section, specify any proxy settings necessary to connect to Google Cloud Storage:

    ProxyHost The host name or IP address of the proxy server that the connector must use.
    ProxyPort The port of the proxy server that the connector must use.

    For example:

    ProxyHost=proxy.example.com
    ProxyPort=8080
  4. In the [UserAccount] section, ensure that the AuthorizeUrl parameter is set correctly. You must use the value that matches the permissions requested by your OAuth application (see Permissions). Delete or comment-out the other lines.
  5. In the [UserAccount] section, set the following parameters:

    AppKey The application key provided when you created the OAuth application (see Permissions).
    AppSecret The application secret provided when you created the OAuth application (see Permissions).
  6. Open a command-line window and run the OAuth configuration tool:

    oauth_tool.exe oauth_tool.cfg UserAccount

    Your default web browser opens to the Google web site. The web page asks you to authorize the connector to access Google Cloud Storage.

  7. Authorize the application by entering the credentials of the account that you want to use to retrieve data.

    Google provides the OAuth configuration tool with the necessary OAuth tokens. The OAuth tool creates a file named oauth.cfg, which contains the parameters that the connector requires to authenticate with Google Cloud Storage. These parameters are automatically included in the connector configuration file, because the connector configuration file includes the following line to import the parameters into the [MyTask] section:

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

    For more information about including parameters from another file, see Include an External Configuration File. The OAuth tool also prints the parameters it has set to the command-line window so that you can set these directly in the connector's configuration file if you prefer.

  8. You can now configure a task to retrieve data. See Retrieve Information from Google Cloud Storage.