Edit

Share via


Client Secret Authentication Setup

Client Secret authentication is the simplest method, using a password-like secret to authenticate your bot. While easy to set up, secrets need to be rotated periodically and kept secure.

Prerequisites

Before you begin, ensure you have:

  • An Azure subscription
  • Permissions to create App Registrations and Azure Bot Services

Setup Steps

Step 1: Create Azure Bot with Single Tenant

When creating your Azure Bot Service, you must select Single Tenant for the Type of App.

alt-text for single-tenant-bot.png

Step 2: Create Client Secret

  1. Navigate to your App Registration in the Azure Portal
  2. Go to Certificates and Secrets
  3. Click New client secret
  4. Add a description and select an expiration period
  5. Click Add
  6. Important: Copy the secret value immediately - it won't be shown again

alt-text for client-secret.png

Next Steps

After completing the Azure setup, configure your application code with the appropriate environment variables. See the App Authentication Essentials Guide for details.