Skip to main content

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.

Single Tenant Bot Creation

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

Secret in Certificates and Secrets

Next Steps​

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