Migreringsveiledning for SharePoint News-widgeter

HASTER – Tiltak kreves innen 2. april 2026
Azure ACS-autentisering blir pensjonert. Alle SharePoint News-widgeter må migreres til Microsoft Graph v2.0 før denne datoen for å unngå avbrudd i tjenesten.

1. Oversikt over migrering

Hvorfor migrere?

  • Azure ACS-avvikling: Eldre autentisering (accounts.accesscontrol.windows.net) avsluttes 2. april 2026
  • ROPC-avskrivning: Passordtildelingstyper deaktivert 1. mai 2026
  • Sikkerhet: Moderne OAuth 2.0 med forbedret sikkerhet
  • Ytelse: Native JSON API i stedet for XML-parsing
❌ Eldre versjon ✅ Moderne versjon
Azure ACS-autentisering Microsoft Graph v2.0
SharePoint REST API (API/web) Graph API (/sites/…/lists)
XML-dataparsing Innebygd JSON-håndtering
PowerShell-leietakerkonfigurasjon Registrering av Azure AD-app

2. Forutsetninger

Nødvendig tilgang og informasjon

  • Rollen Global administrator eller Programadministrator i Azure AD
  • SharePoint-administratortilgang (for bekreftelse)
  • Gjeldende widgetkonfigurasjon (klient-ID, leietaker-ID osv.)
  • Liste over SharePoint-nettsteder som bruker widgeten
  • Test SharePoint-nettsted med nyhetsinnlegg for validering

Note: Den gamle PowerShell-kommandoen (set-spotenant -DisableCustomAppAuthentication $false) er ikke lenger nødvendig og kan fjernes etter migrering.

3. Registrering av Azure AD-app

Følg trinnene nedenfor:

Trinn 3.1: Opprett ny appregistrering

  1. Naviger til Azure-portalenAzure Active DirectoryApp registreringer
  2. Klikk på «Ny registrering»
  3. Fyll ut detaljene:

    Name: SharePoint News Widget - Graph v2.0 Supported account types: Accounts in this organizational directory only Redirect URI: Leave blank (not needed for client credentials)
  4. Klikk "Register"

Trinn 3.2: Konfigurer API-tillatelser

  1. I den nye appregistreringen din går du til «API-tillatelser».
  2. Klikk på «Legg til en tillatelse»«Microsoft Graph»«Programtillatelser»
  3. Legg til følgende tillatelser:

    Tillatelse Hensikt Når du skal bruke
    Sites.Read.All Les alle SharePoint-nettsteder og -lister Enkel distribusjon, testmiljøer
    Sites.Selected Tilgang kun spesifikt tildelte nettsteder Produksjonsmiljøer, forbedret sikkerhet
    ⚠️ Velg én: Bruk enten Sites.Read.All ELLER Sites.Selected, ikke begge deler. Sites.Selected krever ytterligere konfigurasjon (se trinn 4).
  4. Klikk på «Legg til tillatelser»
  5. VIKTIG: Klikk «Gi administratorsamtykke» og bekreft
🔐 Sikkerhetstips: Bruk Sites.Selected for produksjonsmiljøer og gi kun tilgang til bestemte SharePoint-nettsteder som trenger widgeten.

Trinn 3.3: Generer klienthemmelighet

  1. Gå til «Sertifikater og hemmeligheter»«Klienthemmeligheter»
  2. Klikk på «Ny klienthemmelighet».
  3. Settbeskrivelse: SharePoint News Widget Secret
  4. Angitt utløpsdato: 24 måneder (anbefalt)
  5. Klikk på «Legg til»
  6. VIKTIG: Kopier den hemmelige verdien umiddelbart (den vises ikke igjen)
⚠️ Sikkerhetsadvarsel: Lagre klienthemmeligheten sikkert. Angi en kalenderpåminnelse for å fornye den før utløp.

Trinn 3.4: Noter nødvendig informasjon

Kopier følgende verdier fra «Oversikt» -siden for appregistreringen din:

Felt Azure Portal-plassering Brukt i widgeten
Søknad (klient) ID Oversikt → Applikasjons-ID (klient-ID) Klient-ID-parameter
Katalog (leietaker) ID Oversikt → Katalog-ID (leietaker) Leietaker-ID-parameter
Klienthemmelighet Sertifikater og hemmeligheter → Verdi (kopiert ovenfor) Klienthemmelighetsparameter

4. Sites.Selected-konfigurasjon (valgfritt – forbedret sikkerhet)

🛡️ Forbedret sikkerhet: Denne delen er valgfri, men anbefalt for produksjonsmiljøer. Sites.Selected gir detaljert tilgangskontroll, slik at appen bare får tilgang til bestemte SharePoint-nettsteder i stedet for alle nettsteder i leietakeren.

Når du skal bruke nettsteder. Valgt

  • Produksjonsmiljøer der sikkerhet er avgjørende
  • Flerstedsleietakere der widgeten bare skal ha tilgang til bestemte nettsteder
  • Samsvarskrav som krever tilgang med minst mulig rettigheter
  • Store organisasjoner med mange SharePoint-nettsteder
📝 Merk: Hvis du bruker Sites.Selected, konfigurerer du det i Azure AD-appregistreringen din i stedet for Sites.Read.All. Du kan ikke bruke begge samtidig.

Trinn 4.1: Konfigurer Sites.Selected-tillatelse

  1. I Azure AD-appregistreringen din går du til «API-tillatelser».
  2. Fjerne Sites.Read.All hvis allerede konfigurert
  3. Legge til Sites.Selected applikasjonstillatelse
  4. Gi administratortillatelse til den nye tillatelsen

Trinn 4.2: Gi nettstedsspesifikk tilgang via Graph Explorer

Følg disse trinnene for hvert SharePoint-nettsted som skal bruke widgeten:

4.2.1: Hent nettsteds-ID-en

  1. Åpne Microsoft Graph Explorer
  2. Logg inn med administratorkontoen din
  3. Send en GET-forespørsel for å finne nettstedet ditt:

    GET https://graph.microsoft.com/v1.0/sites/.sharepoint.com:/sites/ Example: GET https://graph.microsoft.com/v1.0/sites/.sharepoint.com:/sites/
  4. Kopier hele id fra svaret (format: hostname,guid,guid)

4.2.2: Sjekk gjeldende tillatelser (valgfritt)

Bekreft at ingen tillatelser er gitt for øyeblikket:

GET https://graph.microsoft.com/v1.0/sites//permissions Example: GET https://graph.microsoft.com/v1.0/sites//permissions

Svaret skal være tomt ({"value": []}) for en ny Sites.Selected-app.

4.2.3: Gi tilgang til nettstedet

  1. Send en POST-forespørsel for å gi appen din tilgang til det spesifikke nettstedet:

    POST https://graph.microsoft.com/v1.0/sites//permissions Headers: Content-Type: application/json Body: { "roles": ["read"], "grantedToIdentities": [{ "application": { "id": "", "displayName": "" } }] }
  2. Erstatt plassholderne:
    • Den fullstendige nettsteds-ID-en fra trinn 4.2.1
    • Program-ID (klient-ID) fra Azure AD
    • Visningsnavn fra Azure AD
Example POST Request: POST https://graph.microsoft.com/v1.0/sites//permissions { "roles": ["read"], "grantedToIdentities": [{ "application": { "id": "", "displayName": "" } }] }

Trinn 4.3: Bekreft at tilgang er gitt

  1. Gjenta GET-tillatelseskallet fra trinn 4.2.2
  2. Du skal nå se applikasjonen din oppført med lesetillatelser
  3. Svaret bør inneholde appens detaljer og tildelte roller
✅ Suksess: Applikasjonen din har nå lesetilgang til dette spesifikke SharePoint-nettstedet og kan hente nyhetsinnlegg fra det ved hjelp av Graph API-et.

Trinn 4.4: Gjenta for flere nettsteder

Hvis du har flere SharePoint-nettsteder som bruker widgeten, gjentar du trinn 4.2.1 til 4.3 for hvert nettsted. Hvert nettsted krever individuelle tillatelser når du bruker Sites.Selected.

5. SharePoint-forberedelse

Følg trinnene nedenfor:

Trinn 5.1: Bekreft SharePoint-nettsteder

  1. Sørg for at SharePoint-nettstedene dine har publiserte nyhetsinnlegg
  2. Bekreft at tilpassede egenskaper (hvis brukt) fortsatt er konfigurert:
    • Tilpassede Ja/Nei-kolonner for filtrering (f.eks. «VisPåSkilting»)
    • Tilpassede tekstkolonner for utdrag (f.eks. «Tilpasset beskrivelse»)
  3. Test at bilder lastes opp til SharePoint (ikke eksterne lenker)

Trinn 5.2: Fjern gammel PowerShell-konfigurasjon (valgfritt)

Følgende PowerShell-kommando er ikke lenger nødvendig og kan fjernes:

# This is NO LONGER REQUIRED for Graph v2.0 set-spotenant -DisableCustomAppAuthentication $false
💡 Tips: Du kan la denne innstillingen være som den er hvis du har andre eldre SharePoint-apper som fortsatt trenger den.

6. Widget-migrering

Følg trinnene nedenfor:

Trinn 6.1: Oppdater widgetkoden

  1. Erstatt den gamle SharePoint News-widgeten DataSource med den nye Graph v2.0-versjonen
  2. Legg til den nye liste-ID- parameteren (se trinn 6.3)
  3. Distribuer den oppdaterte widgeten til din GoBright plattform
📝 Nytt krav: Graph v2.0-versjonen krever en liste-ID-parameter for forbedret pålitelighet på tvers av alle SharePoint-nettsteder.

Trinn 6.2: Hent liste-ID fra SharePoint

I din GoBright widgetkonfigurasjon, oppdater bare autentiseringsfeltene:

Parameter Gammel verdi (eldre) Ny verdi (graf v2.0)
Klient-ID Gammel ACS-klient-ID Ny Azure AD-program-ID
Klienthemmelighet Gammel ACS-klienthemmelighet Ny Azure AD-klienthemmelighet
Leietaker ID Samme Samme (uendret)
SharePoint-URL Samme Samme (uendret)
Nettstedsnavn Samme Samme (uendret)
Liste-ID Ikke påkrevd Obligatorisk: Hent fra nettstedsinnhold
📝 Viktig: Alle andre parametere (dager, maks. antall elementer, bildekvalitet, filternøkkelord, tilpassede egenskaper) forblir nøyaktig de samme.

Trinn 6.3: Oppdater autentiseringsinformasjon

Den nye Graph v2.0-widgeten krever en liste-ID-parameter. Følg disse trinnene for å hente den.

Naviger til SharePoint-nettstedet ditt (f.eks. https://yourtenant.sharepoint.com/sites/yoursite)
  1. Gå til nettstedsinnhold
  2. Finn listen du vil bruke (vanligvis «Nettsider» for nyhetsinnhold)
  3. Klikk på de tre prikkene (⋯) ved siden av listenavnet
  4. Velg «Innstillinger»
  5. Kopier liste-ID-en fra URL-en:
Eksempel-URL: https://.sharepoint.com/sites//_layouts/15/listedit.aspx?List= Liste-ID:

📝 Fordel: Denne tilnærmingen fungerer med alle SharePoint-lister (nettstedssider, tilpassede lister, dokumentbiblioteker) og eliminerer problemer med nettstedskompatibilitet.

7. Importer SharePoint-nyhetswidgeten

Følg trinnene nedenfor for å laste ned og importere den nye SharePoint News-widgeten til miljøet ditt.

Trinn 7.1: Last ned widgeten

Du kan laste ned widgeten fra følgende sted: gobright

Trinn 7.2: Laste opp widgeten

Når widgeten er lastet ned, kan du laste den opp til din GoBright miljø.

  1. Velg fanen Administrasjon
  2. Gå til Widgeter og datakilder.
  3. Velg mappen der du vil lagre widgeten (f.eks. Hovedmappen).
  4. Velge Import.
  5. I dialogboksen som vises, velg Velge.
  6. Bla til mappen der du lagret den nedlastede widgetfilen
  7. Velg Åpne .
  8. Bekreft ved å klikke på OK i ledeteksten Importen var vellykket

Widgeten vil nå bli importert og er klar til bruk.

Trinn 7.3: Oppdatere SharePoint-widgeten i malene

Hvis SharePoint-widgeten allerede er i bruk, og du importerer den i de forrige trinnene, vil den gamle widgeten bli overskrevet.

Etter at du har gjort dette, går du til malen(e) der den « gamle SharePoint-widgeten » ble brukt. Øverst i malen velger du Oppdater- knappen.


Når dette er gjort, vil widgeten bli oppdatert med den nye 'Liste-ID feltet vil bli lagt til.

Alle verdier som allerede er fylt ut, forblir på samme sted. Deretter fyller du inn de nye verdiene som har endret seg, som vist i tabellen i trinn 6.2.

Ikke glem å lagre endringene øverst til høyre på slutten.

Trinn 7.4: Oppdatere SharePoint-widgeten i spillelister/lysbilder

Etter at du har oppdatert malen(e), går du til hver spilleliste der widgeten er aktiv. I forhåndsvisningen av spillelisten vil du se den samme Oppdater- knappen øverst. Når du velger denne knappen, kopieres malen til lysbildet, slik at alle verdier oppdateres automatisk. Det betyr at du ikke trenger å fylle dem ut manuelt, per widget.

Gjenta dette trinnet for hver spilleliste der malen(e) brukes.

Når alt er oppdatert, oppdaterer du innholdet ved å velge Oppdater innhold og spillerne som laster ned det nyeste innholdet.

8. Feilsøking

Vanlige problemer og løsninger

Autentiseringsfeil

Feil Forårsake Løsning
"Ugyldig klientlegitimasjon" Feil klient-ID eller hemmelighet Bekreft legitimasjon i Azure AD-appregistrering
«Utilstrekkelige privilegier» Manglende API-tillatelser Legg til Sites.Read.All-tillatelse og gi administratortillatelse
«Leietaker ikke funnet» Feil leietaker-ID Kopier riktig leietaker-ID fra Azure AD

Problemer med datainnhenting

Utgave Forårsake Løsning
Nettstedet ble ikke funnet Feil nettstednavn Bekreft nøyaktig navn på SharePoint-nettstedet (skiller mellom store og små bokstaver)
Ingen nyhetsinnlegg vist Ingen nylige innlegg eller filter for feil dato Sjekk datointervallparameteren og bekreft at publiserte innlegg finnes
Bildene lastes ikke inn Mangler BannerImageUrl-felt Sørg for at nyhetsinnlegg har bannerbilder angitt i SharePoint
Tilpassede egenskaper fungerer ikke Feltnavnene stemmer ikke overens Bekreft nøyaktige egendefinerte feltnavn i SharePoint

Nettsteder. Utvalgte spesifikke problemer

Feil Forårsake Løsning
«Ingen tilgang» ved henting av data Nettstedet er ikke innvilget til søknaden Følg trinn 4.2 for å gi nettstedsspesifikke tillatelser
«Nettstedet ble ikke funnet» med Sites.Selected Manglende tillatelser for nettstedsoppdagelse Sørg for at nettstedstillatelser er gitt via Graph Explorer POST-forespørsel
«Forbudt» på et bestemt nettsted Tillatelse gitt til feil nettsted-ID Bekreft at den fullstendige nettsteds-ID-en som ble brukt i trinn 4.2.1 samsvarer med nettstedet som åpnes
Fungerer i Graph Explorer, men feiler i widgeten Bruk av brukertoken kontra applikasjonstoken Sørg for at widgeten bruker kun applikasjonsautentisering (client_credentials)

Ytelsesproblemer

  • Treg lasting: Reduser filteret for maks antall elementer eller dager for å begrense datastørrelsen
  • Tidsavbruddsfeil: Kontroller nettverkstilkoblingen til graph.microsoft.com
  • Hastighetsbegrensning: Implementer riktig mellomlagring (allerede inkludert i ny versjon)

Få hjelp

  • Problemer med Azure AD: Sjekk Azure Portal → Azure AD → Appregistreringer → [Din app] → Oversikt for konfigurasjon
  • SharePoint-problemer: Kontroller i SharePoint-administrasjonssenteret at nettsteder er tilgjengelige
  • Sites.Selected Permissions: Bruk Graph Explorer til å teste nettstedstilgang og bekrefte tillatelser
  • GoBright støtte: Kontakt med feilmeldinger og konfigurasjonsdetaljer
  • Microsoft Graph Explorer: Test API-kall på developer.microsoft.com/graph/graph-explorer

🔍 Feilsøking av valgte nettsteder: Hvis du opplever problemer med tillatelser, bruk Graph Explorer til å teste de nøyaktige API-kallene:

  • HENT nettstedsinformasjon: /sites/.sharepoint.com:/sites/
  • FÅ nettstedstillatelser: /sites//permissions
  • GET-liste over nettstedssider: /sites//lists/Site Pages/items

Migrering fullført!

Gratulerer! SharePoint News-widgeten din bruker nå moderne Microsoft Graph v2.0-godkjenning og vil fortsette å fungere pålitelig utover fristen i april 2026.

Viktige oppnådde fordeler:

  • ✅ Fremtidssikker autentisering
  • ✅ Forbedret sikkerhet
  • ✅ Bedre ytelse
  • ✅ Forenklet oppsett (ikke mer PowerShell)
  • ✅ Full bakoverkompatibilitet

Denne artikkelen kommer fra hjelpesenteret til GoBright .

Se originalartikkelen
GoBright vil være til stede på The Workplace Event i Birmingham; fra 28. til 30. april 2026 - stand 3A/w12

Bli med Chris Wiegeraad på Workplace Leaders' Summit 29. april kl. 11:20.

Registrer deg nå! TWE 2026
Chris The Workplace-arrangementet Workplace Leaders Summit