# Establishing Azure AD SSO Authentication in CData API Server

**URL:** <https://community.cdata.com/t/establishing-azure-ad-sso-authentication-in-cdata-api-server/1268>\
**Category:** Data Sources\
**Tags:** article, azure, sso, api-server\
**Created:** [February 3, 2026, 2:21pm UTC](https://community.cdata.com/t/establishing-azure-ad-sso-authentication-in-cdata-api-server/1268 "2026-02-03T14:21:51Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Sudarshan](https://sea3.discourse-cdn.com/cdata/user_avatar/community.cdata.com/sudarshan/32/109_2.png) [@Sudarshan](https://community.cdata.com/u/Sudarshan)\
**Post date:** [February 3, 2026, 2:21pm UTC](https://community.cdata.com/t/establishing-azure-ad-sso-authentication-in-cdata-api-server/1268/1 "2026-02-03T14:21:51Z")

</div>

Single Sign-On (SSO) with Azure Active Directory (Azure AD) improves security, simplifies access management, and enhances the login experience for CData API Server users. By integrating Azure AD using the OpenID Connect (OIDC) standard, users can authenticate using corporate credentials while API Server securely&nbsp;validates&nbsp;identity tokens issued by Azure AD.&nbsp;  
&nbsp;  
**Overview** &nbsp;  
&nbsp;  
CData API Server supports Single Sign-On (SSO) via the OpenID Connect (OIDC) standard. Identity providers that implement OpenID, such as Azure Active Directory, can be configured as the SSO platform for API Server.&nbsp;  
&nbsp;  
Once SSO is configured:&nbsp;  
- Users are redirected to Azure AD for authentication&nbsp;  
- Azure AD issues a signed JWT token&nbsp;  
- API Server validates the token signature and issuer&nbsp;  
- Users are authenticated using a Federation ID mapping&nbsp;  
&nbsp;  
Note:&nbsp;Currently, API Server supports only individual users, not groups of users. If an SSO platform provides access for a group of users, each individual user within that group must be added as a user on the API Server  **Settings**  page&nbsp;in order to&nbsp;log in. Each user should reference the federation Id from the identity provider.&nbsp;  
&nbsp;  
**Configuration Overview** &nbsp;  
&nbsp;  
The configuration process consists of three main sections:&nbsp;  
&nbsp;  
1. Configuring Azure Active Directory&nbsp;  
2.&nbsp;Configuring SSO in CData API Server&nbsp;  
2. Configuring Users in CData API Server&nbsp;  
&nbsp;  
**Section 1: Configuring Azure Active Directory** &nbsp;  
&nbsp;  
**Step 1: Register an Application** &nbsp;  
&nbsp;  
1. Log in to the Azure Portal&nbsp;  
2. Navigate to Azure Active Directory&nbsp;  
3. Select App registrations and click&nbsp;_New_&nbsp;registration&nbsp;  
4. Enter a name (for example, CData API Server)&nbsp;  
5. Choose the&nbsp;appropriate supported&nbsp;account type&nbsp;  
6. Under Redirect URI, configure:&nbsp;  
&nbsp;  
&nbsp;&nbsp; https://\<your\_apiserver\_host\>:\<port\>/src/ssoCallback.rst&nbsp;  
&nbsp;  
&nbsp;&nbsp; Example:&nbsp;[http://localhost:8080/src/ssoCallback.rst](http://localhost:8080/src/ssoCallback.rst)&nbsp;  
&nbsp;&nbsp;&nbsp;Note: Please check the localhost port as per your instance.

 ![b1a44f6b-2b39-4b35-acb6-f526f3af21e9.png](https://us1.discourse-cdn.com/cdata/original/2X/a/a1af56d1ccd001285c62288ae1ec3f827a467c95.png)

7. Click Register&nbsp;  
&nbsp;  
**Step 2: Copy Application (Client) ID**&nbsp;  
&nbsp;  
After registration, copy the Application (Client) ID. This value is used in CData API Server as:&nbsp;  
- Audience URI&nbsp;  
- OAuth Client ID

 ![dbc28c05-d9cf-41e0-b1f9-95941997ac4c.png](https://us1.discourse-cdn.com/cdata/original/1X/9ae53ed83b3b93163a8e159807eb96475830c604.png)

**Step 3: Generate a Client Secret** &nbsp;  
&nbsp;  
1. Navigate to Certificates & secrets&nbsp;  
2. Click New client secret&nbsp;  
3. Provide a description and expiration&nbsp;  
4. Copy and securely store the client secret value&nbsp;  
&nbsp;  
_Important_: This value is displayed only once and is&nbsp;required&nbsp;for OAuth configuration.&nbsp;  
&nbsp;  
**Step 4: Retrieve OpenID Metadata Document** &nbsp;  
&nbsp;  
1. Navigate to Endpoints in the Azure AD application&nbsp;  
2. Copy the OpenID Connect metadata document URL&nbsp;  
3. Replace ‘common’ with your Tenant ID&nbsp;  
&nbsp;  
This URL will be used as the Import Settings URL in CData API Server.&nbsp;  
&nbsp;  
**Step 5: Copy User Object ID** &nbsp;  
&nbsp;  
1. Navigate to&nbsp;to  **Owners**  in the left pane of the window&nbsp;  
2. Select the user who will access API Server&nbsp;  
3.&nbsp;Click on owner to copy and save its Object ID.&nbsp;  
&nbsp;  
This value will be used as the Federation ID in API Server.

**Section 2: Configuring SSO in CData API Server** &nbsp;  
&nbsp;  
1. Navigate to Settings → SSO&nbsp;  
2. Enable Single Sign&nbsp;On&nbsp;Settings&nbsp;  
3. Click Configure&nbsp;  
&nbsp;  
SSO Settings for Azure AD&nbsp;  
&nbsp;  
Audience URIs:&nbsp;  
- Azure AD Application (Client) ID&nbsp;  
&nbsp;  
Key Claim:&nbsp;  
-&nbsp;oid&nbsp;  
&nbsp;  
OAuth Client ID:&nbsp;  
- Azure AD Application (Client) ID&nbsp;  
&nbsp;  
OAuth Client Secret:&nbsp;  
- Azure AD Client Secret&nbsp;  
&nbsp;  
Import Settings URL:&nbsp;  
- Azure AD OpenID Metadata Document URL&nbsp;&nbsp;  
&nbsp; (After&nbsp;setting the Import Settings URL, click the&nbsp; **Import** &nbsp;button. The system will automatically create the certificate and use it in the next setting,&nbsp; **Issuer Certificate**.)&nbsp;  
&nbsp;  
Issuer Certificate:&nbsp;  
-&nbsp;Automatically generated when you click the&nbsp; **Import** &nbsp;button (for example,&nbsp;_SSOIssuerCertificate.cer_) and used for SSO authentication.&nbsp;  
&nbsp;  
Authorization URL:&nbsp;  
- [Sign in to your account](https://login.microsoftonline.com/%5C)/oauth2/v2.0/authorize&nbsp;  
&nbsp;  
Default Scopes:&nbsp;  
-&nbsp;openid&nbsp;profile email&nbsp;offline\_access&nbsp;  
&nbsp;  
Token Issuer Identifier:&nbsp;  
- [Sign in to your account](https://login.microsoftonline.com/%5C)/v2.0&nbsp;  
&nbsp;  
Token Signature Algorithm:&nbsp;  
- RS256&nbsp;  
&nbsp;  
Token URL:&nbsp;  
- [Sign in to your account](https://login.microsoftonline.com/%5C)/oauth2/v2.0/token&nbsp;  
&nbsp;  
Logoff URL:&nbsp;  
- [Sign in to your account](https://login.microsoftonline.com/%5C)/oauth2/v2.0/logout&nbsp;  
&nbsp;  
Callback URL:&nbsp;  
- https://\<your\_apiserver\_host\>:\<port\>/src/ssoCallback.rst&nbsp;  
&nbsp;  
Save the configuration to complete the Azure AD SSO setup.

**Section&nbsp;3: Configuring Users in CData API Server** &nbsp;  
&nbsp;  
1. Open CData API Server&nbsp;  
2. Navigate to Users&nbsp;  
3.&nbsp;Click Add or use an Admin user.&nbsp;  
4. Enter:&nbsp;  
&nbsp;&nbsp; - Username: Azure AD user name&nbsp;  
&nbsp;&nbsp; - Password: Any value (not used for SSO authentication)&nbsp;  
&nbsp;&nbsp; - Role: As required&nbsp;  
&nbsp;&nbsp; - Federation ID: Azure AD Object ID&nbsp;  
5. Click&nbsp;Save&nbsp;and refresh the page

**Verification** &nbsp;  
&nbsp;  
After configuration:&nbsp;  
- The login page displays the SSO option&nbsp;  
- Users are redirected to Azure AD&nbsp;  
- Successful authentication redirects users back to API Server

 ![bd4d2fea-9ef9-479d-8c88-453642fd7e15.png](https://us1.discourse-cdn.com/cdata/original/2X/3/3cf4a822ec8af515f5de778e1e16bee6fa6d5383.png)

**Free Trial and Support** &nbsp;  
&nbsp;  
CData API Server is a lightweight web application that enables you to create and publish data APIs quickly, without the need for custom development. With the application’s intuitive point-and-click interface, you can easily configure access for popular clients such as Microsoft Power BI, Salesforce Lightning Connect, SharePoint External Lists, Microsoft Excel, Microsoft PowerPivot, and more. Available to install on-premises or in the cloud, the easy-to-use interface means that you can build and publish enterprise-ready REST APIs in minutes!&nbsp;  
&nbsp;  
Start a free 30-day trial of&nbsp;[CData API Server](https://www.cdata.com/apiserver/download/). If you have questions, the&nbsp;[CData Support](https://www.cdata.com/support/)&nbsp;Team is available to assist.
