How to run the completed project

Prerequisites

To run the completed project in this folder, you need the following:

• Python (with pip) installed on your development machine. If you do not have Python, visit the previous link for download options. (Note: This application was written with Python version 3.8.2 and Django version 3.0.4. The steps in this guide may work with other versions, but that has not been tested.)
• Either a personal Microsoft account with a mailbox on Outlook.com, or a Microsoft work or school account.

If you don't have a Microsoft account, there are a couple of options to get a free account:

• You can sign up for a new personal Microsoft account.
• You can sign up for the Office 365 Developer Program to get a free Office 365 subscription.

Register a web application with the Azure Active Directory admin center

1. Open a browser and navigate to the Azure Active Directory admin center. Login using a personal account (aka: Microsoft Account) or Work or School Account.

2. Select Azure Active Directory in the left-hand navigation, then select App registrations under Manage.

3. Select New registration. On the Register an application page, set the values as follows.

   • Set Name to TAMTT.
   • Set Supported account types to Accounts in any organizational directory and personal Microsoft accounts.
   • Under Redirect URI, set the first drop-down to Web and set the value to http://localhost:8000/callback.

4. Choose Register. On the TAMTT page, copy the value of the Application (client) ID and save it, you will need it in the next step.

5. Select Certificates & secrets under Manage. Select the New client secret button. Enter a value in Description and select one of the options for Expires and choose Add.

6. Copy the client secret value before you leave this page. You will need it in the next step.

   [!IMPORTANT] This client secret is never shown again, so make sure you copy it now.

Configure the sample

1. Rename the oauth_settings.yml.example file to oauth_settings.yml.

2. Edit the oauth_settings.yml file and make the following changes.

   1. Replace YOUR_APP_ID_HERE with the Application Id you got from the App Registration Portal.
   2. Replace YOUR_APP_PASSWORD_HERE with the password you got from the App Registration Portal.

3. In your command-line interface (CLI), navigate to this directory and run the following command to install requirements.

   pip3 install -r requirements.txt

   Windows subsystem

   apt update
   apt install python3-pip
   pip3 install -r requirements.txt

4. In your CLI, run the following command to initialize the app's database.

   python3 manage.py migrate

Run the timesheet server

1. Run the following command in your CLI to start the application.

   python3 manage.py runserver

2. Open a browser and browse to http://localhost:8000.

Install as a local service

1. Update the microsoft-graph.service file with the relevant folder names.

   ./install.sh