# UCS OneCloud

Utvecklat med hjälp av Microsoft ASP.NET MVC 5
[](https://asp.net)

UCS OneCloud är en webbapplikation utvecklad för att underlätta konsulters arbetsuppgifter på UCS OneEconomy
Med UCS OneCloud kan kommunikation och dokument delas mellan konsult och kund

# Innehållsförteckning
[TOC]

# Överblick av funktioner

- Inloggning med mejl eller bank-id
- Adminpanel för att kunna hantera, sätta upp och ta bort konton.
- Hämta kunddata från visma advisor

# Språk och ramverk:
- ASP.NET MVC 5
- C#
- JQuery
- Bootstrap
- CSS
- HTML5
- Javascript
- SQL
- JSON
- AJAX
- Data Tables for JQuery
- Microsoft Azure

# Sätt upp projektet

Installera Visual Studio Community, Professional eller Enterprise från https://visualstudio.microsoft.com/downloads/

Kör följande kommando i ett terminalfönster:

git clone https://[e-mail]/UCSOneCloud/onecloud.git

Klicka på .sln filen för att öppna projektet med Visual Studio

# Databasanslutning

I filen Web.config kan man ändra mellan två olika databassträngar.
För utveckling är det lämpligast att använda den lokala databassträngen.

Databassträng för utveckling (lokal)

<connectionStrings>
    <add name="UserModel" connectionString="data source=(LocalDB)\MSSQLLocalDB;attachdbfilename=|DataDirectory|\Database1.mdf;integrated security=True;multipleactiveresultsets=True;application name=EntityFramework" providerName="System.Data.SqlClient" />
    <add name="Database1Entities4" connectionString="metadata=res://*/Models.UserModel.csdl|res://*/Models.UserModel.ssdl|res://*/Models.UserModel.msl;provider=System.Data.SqlClient;provider connection string=&quot;data source=(LocalDB)\MSSQLLocalDB;attachdbfilename=|DataDirectory|\Database1.mdf;integrated security=True;multipleactiveresultsets=True;application name=EntityFramework&quot;" providerName="System.Data.EntityClient"/>
  </connectionStrings>

Databassträng för produktion (Azure)
För att kunna använda azure databasen måste din ip-address finnas med i listan på azure-portalen https://portal.azure.com/#home

<connectionStrings>
    <add name="UserModel" connectionString="data source=(LocalDB)\MSSQLLocalDB;attachdbfilename=|DataDirectory|\Database1.mdf;integrated security=True;multipleactiveresultsets=True;application name=EntityFramework" providerName="System.Data.SqlClient" />
  <add name="Database1Entities4" connectionString="metadata=res://*/Models.UserModel.csdl|res://*/Models.UserModel.ssdl|res://*/Models.UserModel.msl;provider=System.Data.SqlClient;provider connection string=&quot;Server=tcp:oneclouddbserver.database.windows.net,1433;Initial Catalog=OneCloud_db;Persist Security Info=False;User ID=onecloud;Password=aROEZ48X;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;&quot;" providerName="System.Data.EntityClient" />
  </connectionStrings>

# Bank-ID
För att BankID ska fungera i nuläget så måste ett test-certifikat installeras på den maskinen där servern körs. Användaren måste även ha en testverision av bankID för att det ska fungera. Det fungerar inte med den officiela verisionen av bankID eftersom UCS One Economy måste först skaffa ett avtal med en bank för att få använda bankID. När det avtalet har inskaffas så kan man på maskinen istället installera ett officiellt bankID certifikat för att få det att funka med den officiella bankID appen.

Det går att logga in med bankID även om man inte har ett konto ännu, iståfall skapas ett nytt konto, skulle man även vilja koppla en mailaddress till det kontot så går det att göra i inställningar.

`Authenticate(string ssn)` i UserController skapar en inloggnings-request för det personnummret i parametern.
`Collect(OrderResponseType order)` i UserController tar emot det värdet som `Authenticate` returnerar och väntar på att användaren ska legitimera sig. När användaren har legitimerat sig så returnerar funktionen `true`, ifall användaren inte skulle legitimera sig eller misslyckas returnerar funktionen `false`.
`bankIDLogin(string ssn)` i UserController är en funktion som kallas via HttpPost när en användare försöker logga in via bankID. Den kallar i sin tur på `Authenticate` och `Collect` och loggar in användaren ifall allting stämmer.

# File-By-File

## Onecloud/

### Models/
Denna mappen innehåller modeller. Modellerna används både för att spegla databas tabeller och för att ta emot data från front-end och skicka med till back-end.

#### Extended/
#### Users.cs
Denna klassen speglar User tabellen i databasen. Den har funktioner för att toggla ifall en användare är en customer, admin eller konsult samt ändra mail, lösenord och ställa in ett personnummer.

### Views/

#### Admin/

#### AdminRegister.cshtml
Som admin kan man här lägga till användare utan att de själva behöver göra något. Ett bekräftelsemail skickas till den angedda eposten.

#### ListUsers.cshtml
* Styr admin-sidan
* Består av ett Data-Table som listar alla användare i SQL-databasen.
* två knappar som leder vidare till "registrera en användare" samt "Hämta från Visma".

Detta Data-Table kan ändra en användares privilegier. Dessa finns i tre nivåer: Admin, Konsult och Kund. Här kan man också ta bort användare från databasen.

#### vismaApiCall.cshtml
Detta är en View som behövs för att kunna fånga visma API callbacks. För att vi ska kunna fånga dom i Controllern så måste det finnas en view bunden till den.

#### Home/

#### DatabaseError.cshtml
Hit skickas man ifall något gått snett med databasen.

#### Index.cshtml
Styr startsidan för One Cloud. Hit kommer man när man loggar in. Består av ett välkomstmeddelande samt placeholder med text och knappar som inte leder någonstans.

#### Nav.cshtml
Styr Bootstrap-Navbaren. Leder en tillbaka till One Clouds startsida eller vidare till sidorna för Admin, Kunder, Inställningar och Utloggning.

#### Shared/

#### \_Layout.cshtml
Denna bestämmer vad som ska finnas oavsett sida användaren är inne på. Består av scripts, navbar samt footer.

#### \_StartLayout.cshtml
En separat layout som används när man inte är inloggad. består av scripts och en footer.

#### User/

#### Customers.cshtml
Denna sidan ska i framtiden visa den inloggade konsultens kunder (företag) och dom åtgärder som behövs göras på varje kund. I framtiden kommer denna sidan kanske heta Companies.cshtml istället.

#### Login.cshtml
Startsidan man kommer till ifall man inte är inloggad. Här kan man logga in genom epost, bank-id eller gå vidare till sidan för att registrera en ny användare. Man kan också gå till sidan för "glömt lösenord."

#### Register.cshtml
här kan man registrera ett nytt konto genom att fylla i epost, lösenord samt bekräfta lösenord. Om man lyckas skapa ett konto skickas ett bekräftelsemail och man skickas tillbaka till login-sidan.

#### ResetPassword.cshtml
Sida som låter användaren fylla i sin epostadress och bekräfta med ett knapptryck för att få ett mail med ett nytt lösenord. Om en epostadress med giltigt format har fyllts i länkas användaren tillbaka till loginsidan som visar ett meddelande att operationen har lyckats och att användaren har fått ett mail ifall epostadressen är kopplad till ett konto.

#### Settings.cshtml
Sida där användaren kan uppdatera sina kontouppgifter. Innehåller tre fält: epostadress, lösenord och BankID (personnummer), samt en knapp för att spara uppgifterna.

### Classes/

#### MailHandler.cs
Denna filen skickar mail, det är också i denna filen som man kan ändra SMTP-uppgifter samt vilken mailaddress det ska skickas ifrån.

`SendMail(string subject, string body, string mailAddress)` Denna funktionen skickar iväg ett mail med dom angivna parametrarna. Ifall mailet lyckas returnerar funktionen `true`, annars `false`.

#### AuthHelper.cs
Denna filen hanterar visma API anslutningen. Den gör request till API:t och hanterar den data som API:t returnerar.
`generateAuth` funktionen returnerar en url som man kan göra en GET-request till för att få sin Auth-token från Visma.
Den använder `clientID` och `redirectURi` från web-config filen för att få tillåtelse att prata med visma.

`GetAccessToken` funktionen tar in en Auth-token som man har fått från visma och gör om den till en Access-token som används när man hämtar data från visma.
Den använder `clientID` och `clientSecret` från web-config filen för att få tillåtelse att prata med visma.

`getAllCustomers` funktionen returnerar en lista med users (i framtiden ska den returnera en lista med users och companies). Den skapar 20 trådar, varav varje tråd gör en request till visma API:t och får information om 50 stycken kunder och användare.

`getCustomersThread` en hjälpfunktion för trådarna, den kallar på `getCustomersRequest` och lägger till resultaten i dens inparametrar (user-listan och company-listan). Parametrarna in till `getCustomersThread` är referenser.

`getCustomersUrl` är en hjälpfunktion som genererar url:en som ska användas när man hämtar användar- och företagsdata från visma. Den använder en `pageCount` för att hålla koll på vilken sida från visma som ska hämtas. Denna funktionen är trådsäker, dvs att pageCount kan bara ändras av en tråd åt gången. I dennna funktionen står det även hårdkodat vilka fields från visma vi vill ha tillgång till.

`getCustomersRequest` Denna funktionen gör själva API anropet. Den hanterar datan som Visma svarar med och returnerar en lista med alla användare och företag som visma svarade med.

### Controllers/

#### AdminController.cs
AdminController.cs hanterar requests till backend som rör admin
Alla funktioner med returtypen ActionResult kan anropas från front-end
* Adminregister() Kallas på när man sätter upp ett admin konto på adminpanelen
* ListUsers() Kallas på för att hämta ut de användare som visas i listan på adminpanelen
* RemoveUser() Tar bort en användare från databasen, kallas via HttpPost
* ToggleCustomer()
* ToggleConsultant()
* Search() (används inte men är implementerad)
* `VismaApiCall()`
Denna funktionen körs när man trycker på "Hämta från Visma" i admin-panelen. Den redirectar till visma sidan som returnerar en auth-token.
* `VismaCallback()`
Denna funktionen kallas när man har fått svar från `VismaApiCall()`. För att ändra namnet på funktionsnamnet samt view:en som är kopplad till denna måste man kontakta Visma för att ändra RedirectURI. Denna funktionen kallar på `AuthHelper.GetAccessToken()` för att få en access-token och kallar sedan på `AuthHelper.getAllCustomers()` och lägger till alla användare och företag i databasen.

#### HomeController.cs
HomeController.cs hanterar requests till backend som rör index
* Index()
* Nav() returnerar navigationsbaren
* DatabseError()

#### UserController.cs
UserController.cs hanterar requests till backend som rör användarfunktioner
* `Register()` Registrerar en användare, kollar om eposten redan är använd. Om inte skickas ett välkomstmail ut och den nya användaren sparas i databasen.
* `ResetPassword()` Om eposten användaren har angett finns i databasen ändras lösenordet till ett temporärt lösenord och ett mail skickas till användaren med det nya lösenordet.
* `Login()` kollar om användaren finns i databasen, isåfall jämförs lösenordet med det hashade värdet och om värdena stämmer skickas användaren vidare.
* `bankIDLogin()` Loggar in användaren med Bank-ID. Kollar om personnumret finns i databasen, finns det inte skapas en ny användare.
* `Logout()` kör `FormsAuthentication.SignOut();`
* `Settings()` tar emot en `Setting` och sparar de nya värdena för användaren.

### Scripts/

#### AjaxListUser.js
aktiverar Ajax på adminsidan så att privilegier kan ändras utan att sidan laddas om för varje ändring.

#### ListUsersPagination.js
Aktiverar Data-tables funktioner på adminsidan så att t.ex sök och paginering är tillgängliga. Sparar info så som vad som senast är sökt på, eller vilken sida man senast stod på i data-table även om man laddar om sidan.