Microsoft Exchange 2010-2019-integrasjon

Følgende konfigurasjon av Exchange 2010-2019 er nødvendig for å la GoBright kommunisere med kalenderne i Exchange.

1. Forutsetninger

• Minimum påkrevd Exchange Server-versjon:
  • Exchange Server 2010 versjon 14.3.468.0 ( sammendrag 29 SP3 – 9. juli 2019 )
  • Exchange Server 2013
  • Exchange Server 2016
  • Exchange Server 2019
• Administratortilgang til Exchange-miljøet
• Tilgang til Exchange Management Shell
• De EWS bør være eksternt tilgjengelig, dette er sannsynligvis tilfellet hvis webmailen (OWA) er tilgjengelig eksternt.
• Exchange-serveren skal kunne sende push-varsler (web-hooks, enkle HTTPS-anrop) til https://*.brightbooking.eu & https://*. gobright .com og https://*. gobright .cloud (port 443).

Konfigurasjonsmanualen går gjennom følgende trinn:

• Start Exchange Management Shell
• Opprett en tjenestekonto i Exchange
• Lag romkalenderne i Exchange
• Gi tjenestekontoen tilgang til rommets postkasse
• Lag en 'romliste' i Exchange
• Konfigurer brukernes standardtilgang til rommets postbokser
• Konfigurer oppførselen til rompostkassene
• Finn EWS-adressen

2. Start Exchange Management Shell

Å koble til Exchange Management Shell er den enkleste måten å utføre flere konfigurasjonskommandoer på.

Logg på Exchange-serveren din, start Exchange Management Shell via startmenyen:

• Start > Microsoft Exchange Server 2007/2010/2013/2016/2019 > Exchange Management Shell

3. Opprett en tjenestekonto i Exchange

3.1 Oppretting av tjenestekonto:

GoBright trenger en tjenestekonto for å få tilgang til kalenderne, for å kunne synkronisere romkalenderne.

Utfør følgende kommandoer via Exchange Management Shell.

Utfør nå følgende kommando for å opprette tjenestekontoen, vennligst endre UserPrincipalName til ditt eget navn/domene og YourPasswordHere for passordet du vil bruke for tjenestekontoen:

New-Mailbox -UserPrincipalName [email protected] -Alias 'GoBright' -Name GoBright-Password (ConvertTo-SecureString -String YourPasswordHere -AsPlainText -Force) -FirstName 'GoBright' -DisplayName 'GoBright' -ResetPasswordOnNextLogon $false

Om nødvendig kan du angi en spesifikk 'Exchange Database' via parameteren -Database , og angi Organisasjonsenhet via parameteren -OrganizationalUnit . Eksempelkommandoen ovenfor forutsetter standard Exchange-database og organisasjonsenhet.

Sjekk nå om tjenestekontoen er opprettet riktig ved å utføre følgende kommando. Resultatet av kommandoen skal vise postboksen til den nyopprettede tjenestekontoen, hvis ingen postboks dukker opp, bør du sannsynligvis koble en lisens til postboksen i Office Admin Center. Utfør følgende kommando, erstatt ID- parameteren til e-postadressen til tjenestekontoen:

Get-Mailbox -Identity [email protected]

Vennligst merk: sørg for at du konfigurerer tjenestekontoen på en slik måte at dens legitimasjon ikke utløper!

3.2 Etterligning:

Etterligning må konfigureres på grunn av strupekvotekonfigurasjoner for Exchange. Det er to nivåer for å konfigurere dette, vennligst les de to alternativene nedenfor.

For mer informasjon om hvorfor etterligning brukes, se følgende MSDN-artikkel .

New-ManagementScope -Name "GoBrightResourceMailboxes" -RecipientRestrictionFilter { RecipientTypeDetails -eq "RoomMailbox" -or RecipientTypeDetails -eq "EquipmentMailbox" }

New-ManagementRoleAssignment –Name "ResourceImpersonation" –Role ApplicationImpersonation –User [email protected] –CustomRecipientWriteScope "GoBrightResourceMailboxes"

Get-ManagementRoleAssignment -RoleAssignee [email protected] -Role ApplicationImpersonation -RoleAssigneeType user

New-ManagementRoleAssignment –Name:GoBrightImpersonation –Role:ApplicationImpersonation –User:[email protected]

Get-ManagementRoleAssignment -RoleAssignee [email protected] -Role ApplicationImpersonation -RoleAssigneeType user

3.3 Fullføre opprettelsen av tjenestekontoen:

Tjenestekontoen er nå opprettet:

• Som konto med postkasse
• Med et passord som ikke utløper (sjekk dette, dette er en manuell handling, sannsynligvis i ActiveDirectory)
• Med etterligningsrettigheter

Skriv ned følgende, da du trenger dem senere i GoBright portal:

• Påloggingsinformasjonen til tjenestekontoen (e-postadresse og passord)

4. Lag romkalenderne i Exchange

Med trinnene nedenfor kan du opprette rom i Exchange-miljøet ditt. Dette vil publisere rommene i Exchange, og gi en kalender inn for hvert rom.

Hvis du allerede har romkalendere i Exchange-miljøet ditt, fortsett med neste trinn, men sørg for at du har e-postadressene til rommene, for du vil trenge dem senere.

Utfør følgende kommandoer via Exchange Management Shell.

Utfør følgende kommando, endre UserPrincipalName til rommets e-postadresse du ønsker, og oppgi et riktig navn , DisplayName og for dette rommet:

New-Mailbox -Room -UserPrincipalName [email protected] -Name Room1 -DisplayName 'Room 1'

Om nødvendig kan du angi en spesifikk 'Exchange Database' via parameteren -Database , og angi Organisasjonsenhet via parameteren -OrganizationalUnit . Eksempelkommandoen ovenfor forutsetter standard Exchange-database og organisasjonsenhet.

Utfør denne kommandoen for hvert rom du vil opprette.

5. Gi tjenestekontoen tilgang til rommets postbokser

Tjenestekontoen trenger FullAccess-rettigheter til rompostkassen, slik at den kan bruke rompostkassen til å administrere bestillingene.

Utfør følgende kommandoer via Exchange Management Shell.

Utfør følgende kommando, endre identiteten til rommets e-postadresse og endre brukeren til e-postadressen til tjenestekontoen:

Get-User -Identity [email protected] | Add-MailboxPermission -User [email protected] -AccessRights FullAccess

Utfør denne kommandoen for hvert rom du vil opprette.

Vennligst merk: Generelt sett vil det ta 15 til 30 minutter før dette behandles, men dette kan legge til opptil 48 timer, Exchange vil ikke gi deg noen indikasjon på når dette er behandlet. Hvis du fortsetter når dette ikke er aktivt i Exchange, er det noe funksjonalitet i GoBright vil ikke fungere ordentlig (f.eks. endre/lagre et rom, forlenge/stoppe et møte osv.)

6. Lag en 'romliste' i Exchange

For å få rompostkassene enkelt publisert, bør du opprette en eller flere 'Distribusjonsgrupper' av typen 'Romliste'.
Det kan være lurt å lage flere "romlister", for eksempel per bygning, per etasje osv.

Det er mulig å hoppe over dette trinnet, men da må du opprette rommene manuelt GoBright , i stedet for å synkronisere dem.

Utfør følgende kommandoer via Exchange Management Shell.

Opprett først romlisten, endre navn hvis du vil gi romlisten et annet navn:

New-DistributionGroup -Name 'BrightBooking Rooms' –RoomList

Legg nå til hver rompostboks med følgende kommando, endre identiteten til navnet på listen, og endre medlemmet til e-postadressen til rommet:

Add-DistributionGroupMember -Identity 'BrightBooking Rooms' -Member [email protected]

Utfør denne kommandoen for hver rompostboks, slik at hver rompostkasse legges til i listen.

7. Konfigurer brukernes standardtilgang til rommets postbokser

Nå skal brukernes tilgang til rommets postkasse konfigureres.

Utfør følgende kommandoer via Exchange Management Shell.

Med følgende kommando setter du standardtilgangen for hver rompostkasse til "skrivebeskyttet, med begrensede detaljer", dette er vanligvis best, slik at brukere ikke kan endre direkte i rommets postkasse. Endre verdien av Identity til e-postadressen til rommet.

Set-MailboxFolderPermission -Identity [email protected]:Calendar -User Default -AccessRights LimitedDetails

Merk: mappenavnet 'Kalender' er avhengig av kulturinnstillingene til rommets postkasse, så 'Kalender' kan også være en oversatt verdi som 'Agenda'. Kommandoen vil mislykkes med en feilmelding hvis du bruker feil mappenavn.

Utfør følgende kommando for å få mappenavnet (f.eks. når kommandoen ovenfor mislykkes):

Get-MailboxFolderStatistics -Identity [email protected] | Where-Object {$_.FolderType -eq "Calendar"} | Select Name,FolderType,Identity

8. Konfigurer oppførselen til rompostboksene

Standardoppførselen til en rompostboks endrer emnet for avtalen, og fjerner det private flagget hvis det er angitt. Via følgende kommando konfigureres rompostkassen til å automatisk behandle (godta/avslå) møteforespørsler, og holder møtedataene på plass.

Utfør følgende kommando via Exchange Management Shell.

Konfigurer oppførselen til rommets postkasse, endre identitetsparameteren til e-postadressen til e-postadressen til rommet:

Set-CalendarProcessing -Identity [email protected] -AutomateProcessing AutoAccept -DeleteSubject $False -DeleteComments $False -AddOrganizerToSubject $False -RemovePrivateProperty $False -AllowConflicts $False

Utfør denne kommandoen for hver rompostkasse.

Ved behov kan du endre denne beste fremgangsmåten for å få annen oppførsel. Følgende parametere er de viktigste:

• AutomateProcessing: AutoAccept vil gjøre rommets postkasse til å behandle møter automatisk (godta/avslå). Det er også mulig å gjøre dette manuelt, via verdien 'Ingen' ( mer info ), men dette betyr også at du må behandle kanselleringer manuelt.
• DeleteSubject: Ved å beholde det originale emnet, kan vi vise emnet i portalen, appen og skjermene. Dette er mulig via verdien $False. Hvis du bruker verdien $True, vil emnet bli slettet av rommets postkasse.
• Slett kommentarer: Ved å beholde kommentarene kan vi vise emnet i portalen og appen. Dette er mulig via verdien $False. Hvis du bruker verdien $True, vil kommentarene bli slettet av rommets postkasse.
• AddOrganizerToSubject: Rompostkassen kan legge til navnet på arrangøren til emnet, men dette kan bli forvirrende. Ved å bruke verdien $False er dette deaktivert.
• RemovePrivateProperty: Rompostkassen fjerner den private eiendommen fra det innkommende møtet. Ved å bruke verdien $False, vil møtet beholde sitt private flagg.
• AllowConflicts: Ved å bruke verdien $False vil ikke rompostkassen tillate nye møter hvis et annet møte er planlagt i samme tidsramme.

9. Finn EWS-adressen

Det siste trinnet er å finne EWS-internettadressen, GoBright vil koble til denne adressen:

• Finn nettpostadressen til Exchange-omgivelsene, for eksempel: https://mail.company.com/owa
• EWS-nettadressen er litt annerledes sammenlignet med nettadressen til nettposten: https://mail.company.com/EWS/Exchange.asmx
• Endre url på samme måte, og bla til denne url via nettleseren din
• Hvis dette er riktig url, må du kanskje angi påloggingsinformasjon. Bruk din nyopprettede legitimasjon for tjenestekontoen.
• Hvis dette er riktig, vil det vise en teknisk nettside, som ser ut som bildet nedenfor:
  
• Skriv ned url, du trenger den i GoBright portal.

10. Administrer integrasjoner

Etter å ha konfigurert det eksterne systemet til Microsoft Exchange, bør du konfigurere integrasjonen i GoBright slik at integrasjonen er kjent i GoBright og kan brukes til å integrere romplaner.

Logg inn på GoBright portal med managerkontoen din, gå til administrasjonssenteret (klikk på de 4 små rutene øverst til høyre) og velg Administrasjonssenter > Integrasjoner .

Legg nå til en ny integrasjon med 'Legg til'-knappen eller velg en eksisterende for å redigere.

Sørg for at du ikke har noen falske eller gamle integrasjoner. I de fleste installasjoner er det bare én integrasjon, så dette er helt normalt.

Konfigurer en integrasjon

Når du legger til eller redigerer en integrasjon, kan du endre innstillingen for den spesifikke integrasjonen.

En integrasjon har et navn, som brukes innenfor GoBright (for å koble rom, brukere osv.) og av tilkoblingsdetaljene til det eksterne systemet.

Etter å ha gitt navnet, bør du velge hvilken type eksternt system du vil koble til.

Eksternt system: Utveksling

Skriv inn «Exchange-URL-en» for å koble den til (dette er EWS-endepunktet fra trinn 9 i denne artikkelen).

Skriv inn e-postadressen og passordet til tjenestekontoen, og kontroller at disse legitimasjonene er riktige ved å klikke "Bekreft med Exchange". Hvis riktig, blir boksene grønne.

Hvis du trenger å autentisere tjenestekontoen med noe annet enn e-postadressen, må du aktivere 'Brukerautentisering på Exchange med et annet brukernavn'. Nå kan du angi et annet brukernavn for tjenestekontoen (f.eks. DOMAINbrukernavn eller en annen UPN).

Merk: Hvis synkroniseringen ikke fungerer som den skal, sjekk artikkelen for brannmurkonfigurasjon og sjekk også Logger i Innstillinger > Logger for å finne nyttig informasjon der om feilen.