Home

Adding a new deployment slot, browsing Cosmos DB using Robo 3T, registering a new subscription. You name it... It's all here.

📖 Table of Contents

➤ Table of Contents

• ➤ Creating your own app registration in the Azure Portal
• ➤ Adding a new deployment slot
• ➤ Roles and permissions
• ➤ Registering new subscription
• ➤ Browsing Cosmos DB Mongo DB using Robo 3T
  • Installation
  • Setup
• ➤ Usage with Google calendar
  • Introduction
  • Calendars in Google
  • Tagging events in Google calendar
  • Creating a new calendar for a project in Did
  • Support ignore

➤ Creating your own app registration in the Azure Portal

• Log on to portal.azure.com with your subscription
• Navigate to Azure Active Directory -> App registrations
• Create a New registration
  • With multi tenant support.
  • Note down the App id - this is your MICROSOFT_CLIENT_ID env variable
• Authentication
  • Set the redirect URIs
    • http://localhost:port/auth/azuread-openidconnec/callback for developing locally
    • yourwebsite_.azurewebsites.net/auth/azuread-openidconnect/callback if you've created an enterprise app
  • Enable Implicit grant flow using both Access tokens and ID tokens
  • Ensure Supported account types are set to Multitenant
• Certificates & secrets
  • Create a new Client secret and note it down - this is your MICROSOFT_CLIENT_SECRET environment variables
• API permissions - all delegated
  • Calendars.Read
  • User.Read
  • offline_access
  • openid
• Exposed APIs
  • Add a scope for Calendar.Read

➤ Adding a new deployment slot

Some branches might contain breaking changes but should still be available for testing on www.

This is a quick guide showing you how to make a new deployment slot for your app in Azure.

1. Go to your app in Azure (Did 365 App)
2. Under Deployment find Deployment slots
3. Click Add slot
4. Pick a good name, e.g. the PR number (e.g. 212)
5. Under Clone settings from: pick did365-dev
6. When you're new slot is created go to Settings => Configuration => Application settings
7. Change OAUTH_REDIRECT_URI to correspond with the URL of your slot. Note the value of OAUTH_APP_ID.
8. Go to https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/{OAUTH_APP_ID}/. Replace OAUTH_APP_ID with the ID from 7
9. Go to Manage => Authentication
10. Under Redirect URIs add the URL of your slot. Remember to append /auth/callback.
11. Your new slot should be good to go!

➤ Roles and permissions

Id	Name	Description
f5a82c37	ACCESS_TIMESHEET	Access Timesheet page
e18a7c45	ACCESS_CUSTOMERS	Access Customers page
289a64ab	ACCESS_PROJECTS	Access Projects page
2653c3aa	ACCESS_ADMIN	Access Admin page
a031c42f	ACCESS_REPORTS	Access Reports page
ef4032fb	MANAGE_PROJECTS	Manage projects
c5439319	DELETE_PROJECTS	Delete projects
09909241	MANAGE_CUSTOMERS	Manage customers
8b39db3d	DELETE_CUSTOMER	Delete customers
15e40e99	MANAGE_USERS	Manage users
cd52a735	MANAGE_ROLESPERMISSIONS	Manage roles and permissions
67ba6efc	MANAGE_SUBSCRIPTION	Manage subscriptions

➤ Registering new subscription

Registering new subscriptions is now done with the did-cli.

➤ Browsing Cosmos DB Mongo DB using Robo 3T

Installation

Download Robo 3T (freeware) from robomongo

Setup

Navigate to the Cosmos DB storage account in the Azure portal.

Set up the connection in Robo 3T. You will find Username and password under 2. from the image above

After adding the details click "Test", if everything is working you should see something like this

➤ Usage with Google calendar

Introduction

Did can also be used with Google calendar, but is in experimental mode at the moment. We don't currently support separate subscriptions for Google Workspace.

Categories is not supported in Google calendar - instead it's very simple to create new calendars.

Calendars in Google

You can create calendars for the most common Did projects and tag the rest (occasional work) with a tag in the subject or body.

You can use your primary calendar for all events that you don't have a separate calendar for. Creating too many calendars can cause a mess - so be careful.

Tagging events in Google calendar

Connect/tagging events that have a corresponding calendar in Google is very easy, and a supersmooth experience.

Just select the project from the calendar dropdown:

For events that you don't have a calendar for use the primarycalendar and add a tag to the subject or body.

Creating a new calendar for a project in Did

When creating a new calendar in Google, decide a good name for it and add the project tag in the description field. Here I've created a vacation calendar for our vacation Did project with tag IAM VAC.

Support ignore

It's also recommended to create a calendar for ignoring event. Add the tag IGNOREto the calendar description.