> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subverseai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# JWT Auth Credentials

> How to create and configure JWT authentication credentials for SubverseAI

# JWT Auth Credentials

JWT authentication credentials allow your SubverseAI agents to authenticate with services using JSON Web Tokens for secure API access.

## Overview

JWT credentials provide access to:

* Modern API services using JWT authentication
* Microservices architecture
* Stateless authentication systems
* Token-based APIs
* Secure web services

## Dashboard Screenshot

![JWT Provider Dashboard](https://example.com/screenshots/jwt-dashboard.png)
*Generate JWT tokens in your service provider's dashboard*

## Steps to Create JWT Auth Credentials

### 1. Identify JWT Requirements

Check your API documentation to confirm it uses JWT authentication:

* Look for "JWT" or "JSON Web Token" authentication
* Check for token endpoint and format requirements
* Verify any additional claims needed

### 2. Get JWT Credentials

From your service provider, collect:

* **JWT Token**: Your JSON Web Token
* **Header Name**: Usually "Authorization" (default)
* **Token Prefix**: Usually "Bearer" (default)

### 3. Add to SubverseAI

1. Go to **Credentials** in your SubverseAI dashboard
2. Click **Create New Credential**
3. Select **JWT Auth** from the credential types
4. Enter a name for your credential
5. Fill in the required fields:
   * **JWT Token**: Your JSON Web Token
   * **Header Name**: Header name for the token (default: "Authorization")
   * **Token Prefix**: Token prefix (default: "Bearer")
6. Click **Test Connection** to verify the credentials work
7. Click **Save Credential**

## Required Fields

* **Name**: A descriptive name for your credential
* **JWT Token**: Your JSON Web Token
* **Header Name**: Header name for the token (default: "Authorization")
* **Token Prefix**: Token prefix (default: "Bearer")

## Usage Tips

* Check token expiration and refresh as needed
* Use HTTPS endpoints to protect tokens in transit
* Store JWT tokens securely and rotate regularly
* Verify token claims match service requirements

## Troubleshooting

**Invalid Token**: Verify JWT token is valid and not expired

**Malformed Token**: Check token format and encoding

**401 Unauthorized**: Ensure token has required claims and permissions

**Header Missing**: Verify header name and prefix are correct

## Next Steps

After creating your JWT credentials:

* Set up JWT-based API integrations
* Configure token refresh workflows
* Build secure microservice connections
* Monitor token expiration and renewal
* Implement token validation checks