Note: To use OAuth2 authentication, you must first register your application with Aha!. Refer to the Aha! documentation for more information.
The access token authentication flow passes the access token directly from the client to the Aha! service for authentication. Unlike other grant types, authentication credentials, such as authorization codes, are not exchanged in return for the access code. Instead, the access token has been obtained from sources external to the flow and specified using the Access Token (AccessToken) option.
Note: Access tokens are temporary and must be replaced to maintain the session without interruption. The life of an access token is typically one hour.

To configure the driver to use an access token flow:

  • Set the Host Name (HostName) option to the base URL of the base URL of the Aha! service to which you want to issue requests. For example, company.aha.io.
  • Set the Authentication Method (AuthenticationMethod) option to 24 (OAuth2).
  • Set the Access Token (AccessToken) options to the value of the access token obtained from external sources.
  • Optionally, specify values for any additional properties you want to configure.

The following examples show the connection information required to establish a session using the access token flow.

Connection string

DRIVER=DataDirect 8.0 Aha;HostName=company.aha.io;
AccessToken=abc12cd34efg5678h9ij87klm6543no32pqr10;AuthenticationMethod=24;

odbc.ini file

[Aha]
Driver=ODBCHOME/lib/ivaha28.so
Description=DataDirect 8.0 Aha
...
AccessToken=abc12cd34efg5678h9ij87klm6543no32pqr10
...
AuthenticationMethod=24
...
HostName=company.aha.io
...