Create People Bot

This folder contains a Bot Project created with Bot Framework Composer.

The full documentation for Composer lives here: https://github.com/microsoft/botframework-composer

To test this bot locally, you will need to complete the following steps:

1. Provision your Azure resources for local development
2. Configure your authentication settings

1. Provision Azure Resources

In order to test this bot locally, you will need the following services provisioned in Azure:

• Azure Bot Registration
• Language Understanding (LUIS)

Configure Microsoft App Password

1. Open your Azure Bot Channels Regisration in the Azure Portal
2. In the Configuration tab, click Manage next to your Microsoft App ID
3. In the Certificates & secrets tab, click New client secret
4. Assign a name and an expiration period, then click Add
5. Copy the secret value and save for later use along with your Microsoft App ID

2. Configure Authentication

You must configure an authentication connection on your Azure Bot Registration in order to log in and access Microsoft Graph resources. You can configure these settings either through the Azure Portal or via the Azure CLI.

Option 1: Using the Azure Portal

1. Open your Bot Channels Registration resource and go to the Configuration tab

2. Click Add OAuth Connection Settings

3. Assign your connection setting a name (save this value for later)

4. Select Azure Active Directory v2 from the Service Provider dropdown.

5. Fill in the following fields and click Save:

   • Client id: your Bot App Id
   • Client secret: your Bot App Password
   • Tenant ID: your Azure Active Directory tenant ID, or "common" to support any tenant
   • Scopes: Contacts.Read Directory.Read.All People.Read People.Read.All User.ReadBasic.All User.Read.All

6. In the Configuration tab, click Manage next to your Microsoft App ID

7. In the API permissions tab, click Add a permission

8. Click Microsoft Graph > Delegated Permissions and add the following scopes:

   • Contacts.Read
   • Directory.Read.All
   • People.Read
   • People.Read.All
   • User.ReadBasic.All
   • User.Read.All

9. In the Authentication tab, click Add a platform

   1. Select Web
   2. Set the URL to https://token.botframework.com/.auth/web/redirect

10. In Bot Framework Composer, open your Project Settings and toggle the Advanced Settings View

11. Set the following property to the value from Step 3:

    {
      "oauthConnectionName": "Outlook",
    }
    

Option 2: Using Azure CLI

1. Get your Microsoft App Object ID (used in later steps):

   az ad app show --id <bot-app-id> --query objectId
   

2. Set the Redirect URL on your Microsoft App:

   az rest --method patch --url https://graph.microsoft.com/v1.0/applications/<objectId> --body "{'web': {'redirectUris': ['https://token.botframework.com/.auth/web/redirect']}}"
   

3. Add the required Microsoft Graph scopes to your Microsoft App:

   az rest --method patch --url https://graph.microsoft.com/v1.0/applications/<objectId> --body "{ 'requiredResourceAccess': [{'resourceAppId': '00000003-0000-0000-c000-000000000000','resourceAccess': [{ 'id': 'b89f9189-71a5-4e70-b041-9887f0bc7e4a', 'type': 'Scope' }, { 'id': 'b340eb25-3456-403f-be2f-af7a0d370277',	'type': 'Scope'	}, { 'id': 'a154be20-db9c-4678-8ab7-66f6cc099a59',	'type': 'Scope'	}, { 'id': '06da0dbc-49e2-44d2-8312-53f166ab848a', 'type': 'Scope' }, { 'id': 'ff74d97f-43af-4b68-9f2a-b77ee6968c5d', 'type': 'Scope'	}, { 'id': 'ba47897c-39ec-4d83-8086-ee8256fa737d', 'type': 'Scope' } ]}	]}"
   

4. Add your OAuth setting to your Azure Bot Service:

   az bot authsetting create  --name <bot-name> --resource-group <bot-rg> --client-id <bot-app-id> --client-secret <bot-app-secret>  --service "Aadv2" --setting-name "Outlook" --provider-scope-string "Contacts.Read Directory.Read.All People.Read People.Read.All User.ReadBasic.All User.Read.All" --parameters clientId="<bot-app-id>" clientSecret="<bot-app-secret>" tenantId=common
   

5. Update your Bot settings with your OAuth Connection name in the Advanced Settings View:

   {
     "oauthConnectionName": "Outlook",
   }