Configuring the Adapter
The adapter can be configured for OAuth in three ways using the InitiateOAuth property.
Set InitiateOAuth to OFF
In this configuration the adapter uses the OAuthAccessToken for authorization without initiating the OAuth flow. When the OAuthAccessToken expires, the user must obtain a new OAuthAccessToken.
This configuration is suitable for one-time use or when the OAuthAccessToken has a long life. This is the simplest way of configuring OAuth if the OAuthAccessToken can be obtained using other means. For example, with the help of the API or developer console.
Set InitiateOAuth to REFRESH
The REFRESH configuration does not require user interaction. This configuration is suitable for scenarios where the studio and server are not on the same machine.
The adapter will refresh the OAuthAccessToken when it expires. The adapter will store the new OAuthAccessToken in the OAuthSettingsLocation configured in the data source.
The following connection properties need to be set:
OAuthRefreshToken
OAuthClientId
OAuthClientSecret
OAuthSettingsLocation
Set InitiateOAuth to GETANDREFRESH
This configuration requires interaction between the adapter, user, and Facebook.
The adapter will launch the browser to allow the user to log in and grant permissions. Since this configuration requires browser interaction, there are limitations on when this configuration can be used. For example, this configuration cannot be used when the TDV monitor is used to start the server.
The following connection properties need to be set:
OAuthClientId
OAuthClientSecret
CallbackURL
OAuthSettingsLocation