Prerequisites for Creating a Connection

To use the Facebook Adapter, you must have access to the Facebook Graph API for your integration. To access the Graph API, you must create a Facebook application.

Note:

Create a separate Facebook application for every Oracle Integration instance.

Note:

Before creating a Facebook connection, you must upload the trusted Facebook public certificate to Oracle Integration. The Facebook public certificate can be downloaded from https://developer.facebook.com.

1. In your browser, click the lock icon to the left of the https://www.developer.facebook.com URL.

2. Select Secure Connection > More Information to access and download the certificate.

3. Rename the FacebookCertificate.txt file extension to .cer.

4. To upload the certificate, see Upload a Certificate to Connect with External Services.

To create a Facebook application:

1. Go to https://developers.facebook.com.
2. Log in with your Facebook credentials or create an account if you do not currently have one.
   1. Under News, click Meta for Developers page.
   2. Click Create new account.
   3. Follow the instructions to create an account.
3. Click Get Started.

   https://developers.facebook.com/docs/development/create-an-app

4. On the new page to which you are redirected, click Create App to create your first Facebook application or, if you previously created an application, click My Apps > Add a New App.
   The Create a New App ID dialog is displayed.
   1. Provide a name for the application.
   2. Provide a contact email address.
   3. Select a category for your application.
   4. Click Create App ID.
   5. Enter the requested value when prompted in the Security Check dialog and click Submit.

   You are redirected to the Facebook developer Dashboard page. The application ID and application secret are displayed.
   
   Description of the illustration dashboard_tab.png
   

5. Copy and paste these values because you need them later when creating a Facebook Adapter connection. The application ID represents the client ID and the application secret represents the client secret that you must specify when creating the connection. These keys are sensitive data, and must be kept secret.

   You also need to configure your Facebook application with the callback URL.

6. Perform the following steps:
   1. Click the Add Product tab on the left side.
   2. In the Facebook Login section, click Get Started.
      The Client OAuth Settings page is displayed.
   3. Under this section, find the Valid OAuth redirect URIs input field.
   4. Enter the callback URL using the following format, then click Save Changes:

      Note:

      If you don't know the following information, check with your administrator:

      • If your instance is new or upgraded from Oracle Integration Generation 2 to Oracle Integration 3.
      • The complete instance URL with the region included (required for new instances).

      For Connections…	Include the Region as Part of the Redirect URL?	Example of Redirect URL to Specify…
      Created on new Oracle Integration 3 instances	Yes.	https://OIC_instance_URL.region.ocp.oraclecloud.com/icsapis/agent/oauth/callback
      Created on instances upgraded from Oracle Integration Generation 2 to Oracle Integration 3	No. This applies to both: New connections created after the upgrade Existing connections that were part of the upgrade	https://OIC_instance_URL.ocp.oraclecloud.com/icsapis/agent/oauth/callback