Skicka och ta emot mail med Microsoft 365

Uppdaterad

Den här guiden visar hur ni kopplar en inkorg i Kundo till en postlåda i Microsoft 365. Kundo hämtar och skickar mailen genom Microsoft Graph API, med en app som ni registrerar i Microsoft Entra ID. Med RBAC for Applications i Exchange Online kommer appen bara åt de postlådor som ni väljer.

Alla mail ligger kvar i postlådan i Microsoft 365, både de som kommer in och de som skickas från Kundo.

Förutsättningar

Den här uppsättningen fungerar endast för inkorgar driftade i molnet - Microsoft har tyvärr inte Graph API-stöd för egendriftade "on-premise" inkorgar.

Instruktioner

1. Lägg till en Appregistrering

  1. Gå till Microsoft Entra admin center och välj Entra ID > Appregistreringar > Ny registrering.
  2. Fyll i namn: Kundo Mail och klicka sedan på Registrera. Ni behöver inte fylla i Omdirigerings-URI
  3. En sammanfattning för appregistreringen visas nu. Kopiera följande två värden och spara på sidan av:
    -Program-ID (klient)
    -Katalog-ID (klientorganisation)
  4. Gå till Certifikat och hemligheter > Ny klienthemlighet
  5. Lägg till en ny klienthemlighet och sätt "Upphör att gälla" till 24 månader.  Kopiera klienthemlighetens värde för användning senare i guiden. Kundo visar när hemligheten går ut och mailar inkorgen innan den går ut. Läs hur ni byter den under Förnya klienthemligheten längre ner.
  6. Föregående värden används för att sätta upp integrationen i Kundo under inkorgens inställningar > Skicka & ta emot
  7. Om ni inte ser följande formulär längst ned på sidan: kontakta er Success Manager.
  8. Fyll i formuläret och klicka på "Spara". Vid det här tillfället kan Kan skicka mail och Kan ta emot mail visa röda kryss i stället för gröna bockar. Det är ok och löses av de kommande stegen i guiden.


2. Lägg inte till API-behörigheter

Ge inte appen några Mail-behörigheter under API-behörigheter i Entra, och godkänn inga sådana. En behörighet som ges där gäller alla postlådor i organisationen. Appen får i stället sina behörigheter i Exchange i steg 5, och då bara för de postlådor som ni väljer.

Har appen redan Mail.Send eller Mail.ReadWrite under API-behörigheter, klicka på Återkalla administratörsmedgivande och ta sedan bort behörigheterna med Ta bort behörighet.


3. Lägg till en Appregistreringslogotyp (frivilligt)

Gå till Anpassning och egenskaper och lägg till en Kundologa till Appregistreringen, vilket gör det enklare att känna igen den.



Det går bra att använda den här loggan:


4. Skapa en e-postaktiverad säkerhetsgrupp

För att endast ge tillgång till de inkorgar som ansluts till Mail behöver ni sätta upp en säkerhetsgrupp som valda konton kan ingå i. Mer information finns i Microsofts guide Manage mail-enabled security groups.

  1. I Exchange admin center, gå till Recipients > Groups > Mail-enabled security.

  2. Klicka på Add a group och följ instruktionerna i detaljvyn.

    • Under Choose a group type, välj Mail-enabled security och klicka Next.

    • Under Set up the basics, fyll i namn och e-postadress för gruppen och klicka på Next.

  3. Vid inställningarna för Assign owners, klicka + Assign owners och välj en ägare i listan. Klicka sedan på Next.
  4. Vid inställningarna för Add members, klicka + Add members och välj sedan de konton som ska användas med Kundo Mail. Klicka sedan på Next. Lägg till kontona direkt. Ett konto som bara är med via en annan grupp får ingen åtkomst.


5. Ge appen åtkomst till postlådorna

Appen får läsa och skicka mail i postlådorna i säkerhetsgruppen från steg 4, och inga andra. Det görs med RBAC for Applications i Exchange Online PowerShell.

  1. Hämta två värden från Entra. Program-ID (klient) har ni sparat i steg 1. Objekt-ID hittar ni under Entra ID > Företagsprogram > Kundo Mail. Använd objekt-ID:t från Företagsprogram, inte det som står under Appregistreringar.
  2. Anslut till Exchange Online PowerShell med ett administratörskonto. Se Connect to Exchange Online PowerShell.
    Connect-ExchangeOnline -UserPrincipalName <administratörens e-postadress>
  3. Skapa ett scope som omfattar medlemmarna i säkerhetsgruppen:
    $dn = (Get-DistributionGroup "<säkerhetsgruppens namn>").DistinguishedName
    New-ManagementScope -Name "Kundo Mail" -RecipientRestrictionFilter "MemberOfGroup -eq '$dn'"
  4. Registrera appen i Exchange:
    New-ServicePrincipal -AppId <program-id> -ObjectId <objekt-id> -DisplayName "Kundo Mail"
  5. Ge appen rätt att läsa och skicka mail i scopet:
    New-ManagementRoleAssignment -App <program-id> -Role "Application Mail.ReadWrite" -CustomResourceScope "Kundo Mail"
    New-ManagementRoleAssignment -App <program-id> -Role "Application Mail.Send" -CustomResourceScope "Kundo Mail"
  6. Testa med en adress i gruppen och en utanför:
    Test-ServicePrincipalAuthorization -Identity <program-id> -Resource <e-postadress>
    För en adress i gruppen ska båda rollerna ha InScope satt till True. För en adress utanför gruppen ska de ha False.

Testet i punkt 6 svarar direkt. Exchange behöver däremot mellan 30 minuter och 2 timmar innan ändringen gäller för appen, så Kundo kan visa röda kryss under den tiden.

Senare ändringar görs i gruppen: ett konto som läggs till i gruppen kommer appen åt, också det efter upp till 2 timmar.

6. Aktivera integrationen

OBS! Aktivera endast Skicka & Ta emot när ni är redo att börja arbeta i Kundo. När ni aktiverar nedan inställningar så börjar mail komma in i Kundo. 

Gå nu tillbaka till Kundo och inkorgens Inställningar och Skicka & ta emot, där både Kan skicka mail och Kan ta emot mail bör ha gröna bockar. Har någon av dem ett rött kryss står orsaken under raderna. Vanliga orsaker är:

  • Exchange har ännu inte börjat använda ändringarna från steg 5. Det kan ta upp till 2 timmar.
  • Något av värdena i formuläret är fel. Det är lätt att ta klienthemlighetens id i stället för dess värde.
  • Inkorgens mailadress är inte direkt medlem i säkerhetsgruppen från steg 4.
  • En av rollerna i steg 5 saknas. Kontrollera med Test-ServicePrincipalAuthorization.
  • Appen har Mail-behörigheter under API-behörigheter i Entra. Då gäller de för alla postlådor. Ta bort dem, se steg 2.

När båda har gröna bockar kan ni aktivera integrationen genom att välja Microsoft 365 för inkommande och utgående mail på samma sida.

Om ni har några som helst frågor om uppsättningsprocessen eller problem uppstår, tveka inte att kontakta oss via support@kundo.se.

Förnya klienthemligheten

Klienthemligheten gäller i högst 24 månader. När den har gått ut kan Kundo varken skicka eller ta emot mail i inkorgen. Kundo visar utgångsdatumet under inkorgens inställningar > Skicka & ta emot. 30, 14 och 7 dagar innan får inkorgen ett ärende om det, och er tekniska kontakt får ett mail.

  1. Gå till Entra ID > Appregistreringar > Kundo Mail > Certifikat och hemligheter och skapa en ny klienthemlighet, som i steg 1.
  2. Kopiera värdet och klistra in det i fältet för klienthemligheten under inkorgens inställningar > Skicka & ta emot. Klicka på Spara.
  3. Kontrollera att Kan skicka mail och Kan ta emot mail har gröna bockar och att utgångsdatumet är nytt.
  4. Ta bort den gamla hemligheten i Entra.

Åtkomsten från steg 5 gäller appen och påverkas inte av en ny hemlighet.

Gå över från Application Access Policy till RBAC

Har ni kopplat inkorgen med en Application Access Policy enligt en äldre version av den här guiden fungerar kopplingen som förut. Microsoft rekommenderar RBAC for Applications i stället, och ni kan byta utan avbrott: appen behåller åtkomsten från Entra tills RBAC gäller.

  1. Gör steg 5 med samma säkerhetsgrupp som er Application Access Policy använder.
  2. Vänta 2 timmar. Så lång tid kan det ta innan Exchange använder RBAC för appen.
  3. Gå till API-behörigheter i Entra och klicka på Återkalla administratörsmedgivande. Ta sedan bort både Mail.Send och Mail.ReadWrite med Ta bort behörighet, på en gång. Se steg 2.
  4. Ta bort policyn i Exchange Online PowerShell. Det första kommandot visar policyns Identity:
    Get-ApplicationAccessPolicy
    Remove-ApplicationAccessPolicy -Identity <policyns Identity>
  5. Kontrollera att Kan skicka mail och Kan ta emot mail har gröna bockar under inkorgens inställningar > Skicka & ta emot.

GDPR

Är ni kund hos oss har vi ett personuppgiftbiträdesavtal tecknat som reglerar hur personuppgifter hanteras.
Detta gäller oavsett vilken integration ni väljer att göra.

Guide taggad med: integration M365
warning Warning.