OAuth 2.0 refresh token grant
- Last Updated: July 30, 2025
- 2 minute read
- DataDirect Connectors
- ODBC
- Microsoft SharePoint 8.0
- Documentation
The refresh token grant is used to replace expired access tokens with active ones by exchanging the refresh token at the endpoint specified by the TokenURI property.
Note: As opposed to using a
third-party application such as Postman, you can use the Progress DataDirect SharePoint
Configuration Manager to obtain a refresh token to support the refresh token grant. See
Obtain access and refresh tokens using
the Configuration Manager for details.
This string includes the properties used to connect with OAuth 2.0
authentication.
DRIVER=DataDirect 8.0 Microsoft SharePoint;ServiceURL=serviceurl;ClientID=client_id;
ClientSecret=client_secret;RefreshToken=refresh_token;TokenURI=token_uri;
[property=value[;...]];where:
- serviceurl
- specifies the URL of a SharePoint site (or "site collection"), for example, https://mycorp.sharepoint.com/sites/marketing/global. The URL must include the base URL (https://mycorp.sharepoint.com/), as well as the path to the site (marketing/global). The driver uses the base URL to infer an OData endpoint, and the site path is used to locate the site that will be accessed.
- client_id
- specifies the client ID key for your application.
- client_secret
- specifies the client secret for your application.
Important: The client secret is a confidential value used to authenticate the application to the server. To prevent unauthorized access, this value must be securely maintained.
- refresh_token
- specifies the refresh token used to either request a new
access token or renew an expired access token.
Important: The refresh token is a confidential value used to authenticate to the server. To prevent unauthorized access, this value must be securely maintained.
- token_uri
- specifies the endpoint used to exchange authentication credentials for access tokens.
- property=value
- specifies connection property settings. Multiple properties are separated by a semi-colon.
The following example connection string includes the properties required
for connecting with the OAuth 2.0 refresh token
grant.
DRIVER=DataDirect 8.0 Microsoft SharePoint;
ServiceURL=https://mycorp.sharepoint.com/sites/marketing/global/;
ClientID=2946f-6789-25gh-gd8g-44t1;ClientSecret=12a3=bCD/E4Ijk+LmqR8s=/TuV+Wbcd;
TokenURI=https://login.microsoftonline.com/common/oauth2/v2.0/token;
RefreshToken=12a3=bCD/EfGh4Ijk+Lgd8g-44tk3c527831;