Microsoft 365 / Outlook + Timerling

Hitta Tenant, Client ID och Client Secret Value för Office

Följ stegen nedan för att registrera Timerling i Microsoft Entra och få fram uppgifterna som behövs för API-kopplingen på sidan Email.

Cirka 5–10 minuter OAuth 2.0 Microsoft Entra
Innan du börjar

Du behöver kunna logga in i Microsoft Entra admin center och ha rättighet att registrera en app. I vissa organisationer måste en Microsoft 365-administratör även godkänna de e-postbehörigheter som appen begär.

1
Microsoft Entra

Registrera en ny app

Öppna App registrations

Gå till Identity → Applications → App registrations och välj New registration. Ge appen ett tydligt namn, exempelvis Timerling Email.

  • Name: exempelvis “Timerling Email”.
  • Supported account types: välj den kontotyp som motsvarar vilka Microsoft-konton som ska få ansluta.
  • Redirect URI kan läggas till i nästa steg om du inte anger den direkt.

Microsofts aktuella instruktion för appregistrering finns i Microsoft Learn .

2
Overview

Kopiera Tenant ID och Client ID

När appen är skapad öppnar Microsoft sidan Overview. Där finns de två första värdena som ska läggas in i Timerling.

I Microsoft Entra Directory (tenant) ID
I Timerling Tenant
I Microsoft Entra Application (client) ID
I Timerling Client ID
Använd ID-värdena, inte namnen.

Tenant ska vara GUID-värdet från Directory (tenant) ID. Client ID ska vara GUID-värdet från Application (client) ID.

3
Authentication

Lägg till Timerlings Redirect URI

Microsofts guide

Öppna Authentication för appen. Välj Add a platform → Web och lägg in följande adress exakt:

Redirect URI https://timerling.codova.se/email/auth/
Platform Web
Typ OAuth 2.0 authorization code
Adressen måste matcha exakt.

En extra slash, annan domän eller annan sökväg gör att Microsoft kan neka inloggningen med ett redirect URI-fel.

4
API permissions

Lägg till behörighet för IMAP och SMTP

Microsofts OAuth-guide

Timerlings Office-koppling autentiserar IMAP och SMTP via OAuth. Öppna API permissions → Add a permission och välj de delegerade e-postbehörigheterna som motsvarar:

  • IMAP.AccessAsUser.All – läsa och arbeta med den inloggade användarens mailbox via IMAP.
  • SMTP.Send – skicka e-post som den inloggade användaren.
  • offline_access begärs av Timerling vid inloggningen så att anslutningen kan förnyas utan att du loggar in varje gång.

För Microsoft 365-arbetskonton kan behörigheterna hittas under APIs my organization uses → Office 365 Exchange Online. Beroende på organisationens policy kan administratörsgodkännande krävas.

Kan du inte välja eller godkänna behörigheterna?

Be er Microsoft 365-administratör att hjälpa till med appregistreringen eller consent. Microsofts organisationer kan begränsa vilka OAuth-behörigheter användare får godkänna själva.

5
Certificates & secrets

Skapa ett Client Secret och kopiera Value direkt

Microsofts guide

Gå till Certificates & secrets → Client secrets → New client secret. Ange en beskrivning och giltighetstid och klicka på Add.

Secret IDxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Valuexxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Kopiera “Value” direkt.

Microsoft visar normalt secret-värdet bara när det precis har skapats. Om du lämnar sidan utan att spara värdet behöver du skapa ett nytt Client Secret.

I Timerling är det Client secret value som används vid OAuth-autentiseringen. Fältet Client secret kan fyllas med Secret ID så att du även sparar vilket secret som hör till kopplingen.

Timerling

Lägg in uppgifterna på sidan Email

Gå tillbaka till Email → API-kopplingar, välj Microsoft / Outlook / Hotmail och fyll i värdena från Microsoft Entra.

  • 1Tenant = Directory (tenant) ID
  • 2Client ID = Application (client) ID
  • 3Client secret = Secret ID
  • 4Client secret value = Value

När du sparar kopplingen skickas du vidare till Microsoft för att logga in och godkänna åtkomsten till e-postkontot.

Skapa API-koppling

Vanliga problem

Om Microsoft-inloggningen fungerar men e-posten ändå inte kan ansluta kan organisationens Exchange-inställningar eller SMTP AUTH-policy blockera anslutningen. Se Microsofts dokumentation för OAuth med IMAP/SMTP .