Rutiner: E-postdomener

Oppdatert:25. februar 2025

Dette dokumentet er en del av de generelle rutinene som ikke er knyttet til et spesifikt system/tjeneste, og beskriver ulike oppgaver knyttet til konfigurasjon av e-postdomener.

E-postdomene

Opprette nytt e-postdomene

For at vi skal opprette et nytt e-postdomene, må det først godkjennes av domenenavn@usit.uio.no og oss. Vi må også ha en stedkode som kan kobles til domenet, om domenet skal inneholde personlige e-postadresser.

E-postdomener som kun skal brukes til upersonlige e-postadresser, f.eks. Sympa og RT, trenger ingen stedkode og man trenger ikke legge inn SRV-oppføring i DNS eller konfiguerere formatet til personadresser (fulltnavn eller brukernavn).

Hvor administreres domenet fra?

Dersom det er et domene under .uio.no er det rimelig å anta at alt kan gjøres i mreg.

Hvis ikke - sjekk norid.no. Dersom det eies av UiO, og er forhandlet av domeneshop er det antagelig en sak for hostmaster.

For domener administrert gjennom UiO

Når så det formelle er i orden, må man først sørge for at domenet har en MX-oppføring i DNS som peker på smtp.uio.no og riktig SPF-oppføring:

# Opprett domenenavnet om det ikke finnes.
mreg> host add -contact <e-postadreses> -comment "<kort beskrivelse>" <domene>.uio.no

# Fjern standard SPF og legg til ny.
mreg> host txt_remove <domene>.uio.no "v=spf1 -all"
mreg> host txt_add <domene>.uio.no "v=spf1 mx ip4:129.240.10.0/25 ip6:2001:700:100:10::/64 ip6:2001:700:100:8210::/64 include:spf.uio.no ?all"

# Legg inn MX.
mreg> host mx_add <domene>.uio.no 10 smtp.uio.no

# dig -t MX +short <domain>.uio.no
smtp.uio.no

For å opprette domenet i Bofh (beskrivelsen kan endres senere):

bofh> email domain_create <domain>.uio.no "Kort beskrivelse av domenet"
OK

Neste steget er vanligvis å konfigurere domenet til å få innstillingen UIO_GLOBALS. Det gjør at alle adresser i Cerebrum som har UIO_GLOBALS som domene vil opprettes i det nye domenet også. Se f.eks. email info postmaster@UIO_GLOBALS i Bofh. For å sette innstillingen i Bofh:

bofh> email domain_configuration on <domain>.uio.no UIO_GLOBALS
UIO_GLOBALS is now on

NB! Om domenet ikke har UIO_GLOBALS satt og skal brukes til Sympa-lister, må sympa@DOMENE manuelt legges til sympa-brukeren: email add_address sympa sympa@<domain>.uio.no

Personadresser i domenet?

Dersom domenet skal brukes til personadresser må man angi formen primæradressen skal være på. Alternativene er fullt navn (cnaddr) eller brukernavn (uidaddr). Fullt navn er normen:

bofh> email domain_configuration on <domain>.uio.no cnaddr

For at Autodiscover skal virke og Exchange-oppsett bli riktig må man også legge til en SRV-oppføring:

mreg> host srv_add -name _autodiscover._tcp.<domene>.uio.no -priority 0 -weight 100 -port 443 -host mail.uio.no

Adressetilknyttning på stedkode

Nye stedkoder har ingen e-posttilknyttning og dette må konfigureres av Postmaster.

I de fleste tilfeller skal stedkoden ha de samme innstillinger som stedkoden over i strukturen. I noen tilfeller skal stedkoden settes opp med et eget domene. Dette gjelder typisk ting som opprettelse av nye senter og prosjekter. Spør på postmaster-core hvis du er usikker på hvilke innstillinger en stedkode skal ha.

Nye stedkoder har ikke satt «Email domain» felter:

bofh> ou info 531570
Stedkode:     531570

Det vanlige er å bruke innstilingen fra stedkoden over. Strukturen listes ut med kommandoen tre-kommandoen:

bofh> ou tree 531570
900000 Universitetet i Oslo
  500000 Det medisinske fakultet
    530000 Institutt for klinisk medisin
      531500 Hjerte-, lunge- og karklinikken
*       531570 K.G. Jebsen-senter for hjerteforskning

Se på informasjonen

bofh> ou info 531500
Stedkode:     531500
...
Email domain:  affiliation STUDENT @studmed.uio.no
Email domain:  affiliation <any>   @medisin.uio.no

Stedkoden konfigureres med «email add_domain_affiliation».:

bofh> email domain_add_affiliation studmed.uio.no 531570 STUDENT
OK, 0 accounts updated
bofh> email domain_add_affiliation medisin.uio.no 531570
OK, 0 accounts updated

Dobbeltsjekk at det ser riktig ut:

bofh> ou info 531570
Stedkode:     531570
...
Email domain:  affiliation STUDENT @studmed.uio.no
Email domain:  affiliation <any>   @medisin.uio.no

Forandre navn på e-postdomene

Følg først oppskriften over. Sjekk hvordan det gamle e-postdomenet er konfigurert:

bofh> email domain_info ukm.uio.no
E-mail domain:    ukm.uio.no
Description:      Universitetets kulturhistoriske museer
Configuration:    cnaddr
Configuration:    UIO_GLOBALS
Affiliation:      any@270000 (KHM)
Affiliation:      any@270010 (KHM, Administrasjon)
[...]

Overfør eksisterende affiliations til det nye domenet:

bofh> email domain_add_affiliation khm.uio.no (270000 270010)
OK (was ukm.uio.no), 9 accounts updated
OK (was ukm.uio.no), 26 accounts updated

Siden bofhd oppdaterer e-postadressene til alle kontoer som har slik primærkobling, er dette er en ganske tung kommando. Omtrent 7-8 konti per sekund er farten det går i. Siden bofhd ikke er trådet, vil ingen andre kunne gi bofh-kommandoer mens denne kommandoen kjører. Hvis mulig, unngå å gjøre dette rett etter lunsj, og ta helst hver stedkode for seg.

Ofte skal Sympa-lister også overføres fra det gamle til det nye domenet. Hvordan dette best kan gjøres vil variere utifra hva man har avtalt - skal f.eks. det gamle domenet videreføres som alias for alle listene.

Slette e-postdomene

Utkast til hvilke steg som må tas for å slette et e-postdomene:

  • Få bekreftet at domenet virkelig skal slettes.

  • Sørg for at alle e-postlister er avviklet (slettet og så fjernet helt).

  • Fjern domenet fra konfigurasjonen til e-postlistesystemet, se rutinene til Sympa.

  • Ingen brukerkontoer, verken slettede eller aktive, må ha adresser i domenet (informere?) - bruk f.eks.: jbofh> email address_remove ...

  • Få hostmaster til å fjerne MX-oppføringene i DNS (om det ikke finnes en host med samme navn).

  • Fjern konfigurasjonen til domenet (UIO_GLOBALS, cnaddr/uidaddr): jbofh> email domain_configuration ...

  • Verifiser at det ikke er adresser i domenet i LDAP, se f.eks. mail-pipe03:/var/ldap/mail.ldif

  • Slett domenet (eller sett konfigurasjonen til noexport):

    jbofh> email domain_delete domene.uio.no
OK, domain 'domene.uio.no' deleted

  • Fjern domenet som «AcceptedDomain» i Exchange (og MS365):

    Remove-AcceptedDomain csmn.uio.no
Removing Accepted Domain "csmn.uio.no".

# TODO: Kommando for å fjerne i MS365 (krever nok Global Admin).