Creating a JDBC Data Source

You can create a JDBC data source to connect from your Java application, based on CData JDBC Driver for Suadeo.

Follow these steps:

1. Add the driver JAR file to the classpath. The JAR file is located in the installation directory's lib subfolder. Ensure that the .lic file is located in the same folder as the JAR file.
2. Provide the driver class. For example:
   

   cdata.jdbc.suadeo.SuadeoDriver

3. Provide the JDBC URL. For example:
   

   jdbc:suadeo:User=myusername;Password=mypassword;AuthenticationName=Production;

   Or, if there is a conflict in your application between drivers using the same URL format, use this form to ensure that you are using the CData driver:
   

   jdbc:cdata:suadeo:User=myusername;Password=mypassword;AuthenticationName=Production;

   Ensure that the URL starts with either jdbc:suadeo: or jdbc:cdata:suadeo:. The URL can include any of the connection properties in name-value pairs separated with semicolons.

Connecting to Suadeo

The driver uses the OAuth 2.0 Resource Owner Password Credentials (ROPC) grant for authentication. This method allows you to authenticate with Suadeo using your username and password to obtain an access token.

How Authentication Works

When you connect, the driver automatically:

1. Sends your username and password to the Suadeo OAuth token endpoint
2. Receives an access token in response
3. Uses the access token to authenticate all subsequent API requests
4. Automatically obtains a new access token when needed during the session

Note: Unlike some OAuth implementations, Suadeo does not use a browser-based authorization flow or refresh tokens. Authentication occurs directly using your credentials, and the access token is active only for the duration of the connection session.

Required Connection Properties

To connect to Suadeo, you must set the following properties:

• URL: The base URL of your Suadeo instance.
• User: Your Suadeo username.
• Password: Your Suadeo password.
• AuthenticationName: The name identifier for the authentication configuration in your Suadeo instance. Different authentication names can be configured for different environments or use cases.

Note: The Schema connection property is not required to connect to Suadeo.