RUCKUS One API - Obtain JWT token using OAuth2 Standard | Knowledge Base

RUCKUS One API - Obtain JWT token using OAuth2 Standard

Summary

This Knowledge Base Article explains how to authenticate with the RUCKUS One APIs using the OAuth2 client credentials flow. It describes how to create an Application Token and use it to obtain a JSON Web Token (JWT), which is required to securely access RUCKUS One API endpoints. This method replaces the legacy /token authentication API.

Question

How can you obtain a JWT token using the OAuth2 standard in RUCKUS One for initiating API calls?

Customer Environment

RUCKUS One

Resolution

Part I: Create an Application Token in RUCKUS One

Navigate to Account Management
- Log in to RUCKUS One.
- Go to Administration > Account Management > Settings.
- Scroll down to the bottom of the page and click Add Application Token.
Create and Save the Application Token
- Enter the required details to create a new Application Token.
- Save the displayed Application Token information.
- Make sure to securely store the following values:
  - Client ID
  - Client Secret (listed under the Shared Secret column)

?? Note: The Client Secret is required to authenticate when requesting a JWT token and should be handled securely.

Part II: Obtain the JSON Web Token (JWT) Using Postman

1. Configure the API Request

Method: POST
URL: https://<cloud-region>/oauth2/token/<tenantId>

Replace the placeholders as follows:
- <cloud-region> with your RUCKUS One region:
  - US: ruckus.cloud
  - EU: eu.ruckus.cloud
  - Asia: asia.ruckus.cloud
- <tenantId> with your actual RUCKUS One tenant ID

2. Configure the Request Body

In Postman, select the Body tab.
Choose x-www-form-urlencoded.

Add the following key-value pairs:

Key	Value
grant_type	Enter this string: client_credentials
client_id	Enter the Client ID of the Application Token generated in RUCKUS One.
client_secret	Enter the Client Secret of the Application Token generated in RUCKUS One.

Example:

3. Send the Request and Retrieve the Token

Click Send to submit the API request.
If the request is successful, the response will include an access_token.
This access_token is a JWT, which must be included in the Authorization header (Bearer <token>) when making subsequent RUCKUS One API calls.

Article Number:
000014355

Updated:
January 21, 2026 05:41 AM (2 months ago)

Tags:
Configuration, Security, Ruckus Cloud Switch, Ruckus Cloud WiFi

Votes:
1

This article is:
helpful
not helpful