Connections

Initialise OAuth 2.0 Connection

InitialiseOAuth2Connection returns a URL to redirect the user to an OAuth 2.0 Provider’s Authorize endpoint.

Only URLs constructed via this API can be used to connect to an OAuth 2.0 connector within Versori, since a state parameter is generated and validated upon redirection to the redirect_uri.

Additional query parameters can be added to the resultant URL via the additionalParams property in the body. In addition to the standard parameters defined in the body, this API adds the following parameters:

redirect_uri: The URI to redirect the user to after the OAuth 2.0 Provider has authenticated the user.
state: A secure string generated by the API to authenticate requests to the redirect URI.
prompt: See documentation on the prompt property of the request body.
scope: See documentation on the scopes property of the request body.
response_type: The response type to use. This is always code for OAuth 2.0.
client_id: The client ID provided by the request body, this must match the client ID which is stored under the provided credentialId otherwise the handling of the redirect request will fail.

Full details on the standard parameters can be found in the OIDC Core specification: https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest

POST

{organisation_id}

connectors

{connector_id}

oauth2

initialise

curl --request POST \
  --url https://platform.versori.com/api/connect/v1/o/{organisation_id}/connectors/{connector_id}/oauth2/initialise \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "credential": {
    "id": "<string>",
    "organisationId": "<string>"
  },
  "authorizeUrl": "<string>",
  "clientId": "<string>",
  "scopes": [
    "<string>"
  ],
  "disableOfflineAccess": true,
  "prompt": "<string>",
  "additionalParams": "<string>"
}'

{
  "url": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer token authentication used by the Versori Platform. External consumers must provide an API key, however internal consumers must provide a JWT id_token issued by our IdP.

Path Parameters

organisation_id

string

required

connector_id

string

required

ID is the unique identifier of the Connector.

Body

application/json

InitialiseOAuth2ConnectionRequest is the payload to initialise an OAuth 2.0 connection.

Response

200

application/json

InitialiseOAuth2ConnectionResponse contains the URL to redirect the user to in order to initiate an OAuth 2.0 authorization_code grant flow.

Delete Connection Create Action

curl --request POST \
  --url https://platform.versori.com/api/connect/v1/o/{organisation_id}/connectors/{connector_id}/oauth2/initialise \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "credential": {
    "id": "<string>",
    "organisationId": "<string>"
  },
  "authorizeUrl": "<string>",
  "clientId": "<string>",
  "scopes": [
    "<string>"
  ],
  "disableOfflineAccess": true,
  "prompt": "<string>",
  "additionalParams": "<string>"
}'

{
  "url": "<string>"
}

API Reference

Connect API

Embedded API

Organisations API

Proxy API

Initialise OAuth 2.0 Connection

Authorizations

Path Parameters

Body

Response