# 3.0.7

**Release Date:** January 7, 2026

---

## ✨ New Features

### CLI Tools

#### OAuth Token Cache Management

**Package:** `SAIF.Platform.CLI`

Added new command to clear cached OAuth tokens, improving security and enabling easier token refresh for development workflows.

**New Command:**

```bash
saif token clear
```

**Benefits:**

- 🔐 Clear cached credentials when switching accounts or troubleshooting
- 🔄 Force token refresh without restarting applications
- 🚀 Simplified workflow for testing authentication scenarios

---

### Terraform Modules

#### Entra ID JWT Validation Policy

**Module:** `saif-api-service`

Updated the Entra ID authentication policy template to include role and scope validation checks, improving API security posture.

**Benefits:**

- 🔒 More granular token validation with role-based checks
- ✅ OAuth scope verification for API authorization

---

## 📚 Documentation

This release includes a major documentation expansion with new security guides and migration documentation.

### New Guides

#### Security Configuration Guides

New comprehensive guides for configuring authentication and authorization in Forge applications:

- 📖 [App Permissions](../guides/security/configuration/app-permissions.md) - Configure application-level permissions
- 📖 [Business Roles](../guides/security/configuration/business-roles.md) - Set up Okta business roles for authorization
- 📖 [User Permissions](../guides/security/configuration/user-permissions.md) - Manage user-level access controls
- 📖 [Deployment Workflow](../guides/security/configuration/deployment-workflow.md) - Auth configuration for CI/CD pipelines

---

#### Security Testing Guides

New guides for testing authentication in development and non-production environments:

- 📖 [Create JWT for Testing](../guides/security/testing/create-jwt-for-testing-apis.md) - Generate test tokens for API development
- 📖 [Manage External Test Users](../guides/security/testing/manage-external-test-users.md) - Set up test accounts in external Okta
- 📖 [Non-Production Role Assignment](../guides/security/testing/non-production-role-assignment.md) - Configure roles for testing

---

#### Migration Guides

New guides to help teams migrate from Forge v2 to v3:

- 📖 [MCP-Assisted Migration](../guides/migration/mcp-assisted-migration.md) - Use AI-powered tooling to accelerate migration
- 📖 [Test-Tools V2 to V3](../guides/migration/test-tools-v2-to-v3.md) - Migrate test infrastructure configurations

---

#### Kiota Quick Start

New guide for generating and configuring API clients with Kiota:

- 📖 [Calling APIs](../guides/development/calling-apis.md) - Generate typed API clients from OpenAPI specs
- 📖 [Kiota Reference](../reference/tools/kiota.md) - Tool configuration and troubleshooting

---

### Updated Documentation

- 📝 [Settings and Secrets](../guides/development/settings-and-secrets.md) - Clarified `secretsVariableGroupName` usage
- 📝 [SAIF Tools Installation](../guides/migration/forge-v2-to-v3.md) - Updated installation instructions
- 📝 Documentation reorganization - Improved navigation and consistent title formatting across guides

---

## 📋 Additional Notes

**📊 Release Statistics:**

- 📦 **38 commits** since v3.0.6
- 📁 **70+ files** changed
- ✨ **2 new features**
- 📚 **10+ new documentation pages**
- 👥 **2 contributors**

**👥 Contributors:**

- Emmitt Johnson
- Brian Sheridan

---

### Support

- 📧 Teams Support Channel: [Support](https://teams.microsoft.com/l/channel/19%3Acb611810fb0b42b080cfff5590bdd51c%40thread.tacv2/Support?groupId=514d2dac-2d62-48ce-bf99-0fa0ce39469c&tenantId=a86cb8ed-369b-4df5-ace5-43811f6e08cf)

---