OAuth 2.0 Handler

Connect to OAuth 2.0 services using Flowgear's generic OAuth 2.0 Handler. Generate access and refresh tokens, and expose them to the design canvas for use by our generic connectors.

Revision History

1.0.0.1 - First release.

Properties

Connection

Type: Connection Input

GetCodeUrl
Type: String
Specifies the url Flowgear is expected to redirect to for the user login. Example, https://login.microsoftonline.com/{TenantId}/oauth2/v2.0/authorize

GetCodeParameters
Type: Multiline Text
Query string parameters to be passed for the initial login redirect.
client_id=ClientID
&response_type=code
&redirect_uri=https://app.flowgear.net/r/auth
&response_mode=query
&scope=offline_access Mail.Send
&state=1234

GetTokenUrl
Type: String
Specifies the url Flowgear is expected to invoke for the first token exchange. Example, https://login.microsoftonline.com/{TenantId}/oauth2/v2.0/token

GetTokenParameters
Type: Multiline Text
Application/x-www-form-urlencoded parameters to be passed for the first token exchange.
client_id=ClientID
&scope=offline_access Mail.Send
&code=
&redirect_uri=https://app.flowgear.net/r/auth
&grant_type=authorization_code
&client_secret=

RefreshTokenUrl
Type: String
Specifies the url Flowgear is expected to invoke for the refresh token exchange. Example, https://login.microsoftonline.com/{TenantId}/oauth2/v2.0/token

RefreshTokenUrlParameters
Type: Multiline Text
Application/x-www-form-urlencoded parameters to be passed for the refresh token process.
client_id=ClientID
&scope=offline_access Mail.Send
&refresh_token=
&grant_type=refresh_token
&client_secret=

Secret
Type: Password
Safely store the value which will be passed into the variable. Used for client_secret and similar parameters.

InternalAccessToken
Type: Password
Generated by connecting your account.

InternalRefreshToken
Type: Password
Generated by connecting your account.

Node Properties

Action

Type: List Input
Specifies the node Action.

RetrieveAccessToken - Simply retrieves the access token from the connection.
RetrieveAccessTokenConditionalRefresh - First attempts to determine if the access token has expired, if it has, it will be refreshed and returned. Otherwise simply returns the access token. New access and refresh tokens are stored.
RetrieveAccessTokenForceRefresh - Forces a refresh on the access token and returns it. New access and refresh tokens are stored.

AccessToken

Type: String Output
Access token retrieved from the connection. To be used in subsequent calls in Flowgear's generic connectors.

Remarks

Example

See Sample Workflow for an example.