Weboldal keresés

Csatlakozzon a SharePoint Online-hoz a PowerShell Azure AD App ID használatával

Követelmény: Csatlakozzon a SharePoint Online-hoz a PowerShell Azure Active Directory alkalmazással.

Hogyan csatlakozhat a SharePoint Online-hoz a PowerShell Azure Application ID használatával?

Az Azure Application ID használata a SharePoint Online-hoz való csatlakozáshoz nagyszerű módja annak, hogy kezelje a SharePoint Online-környezetet a felügyelet nélküli PowerShell-szkriptekből. Ebben a bejegyzésben áttekintjük a SharePoint Online-hoz való csatlakozáshoz szükséges lépéseket a PowerShell Azure-alkalmazásazonosítójával.

1. lépés: Az Azure AD alkalmazásazonosító beállítása

Ha az Azure Application ID használatával szeretne csatlakozni a SharePoint Online-hoz, a következő lépések szükségesek:

  1. Regisztráljon egy Azure AD-alkalmazást
  2. Adjon engedélyt az alkalmazásnak
  3. Hozzon létre egy tanúsítványt, és töltse fel az Azure App Secretbe

Regisztráljon egy Azure-alkalmazást

Az első lépés egy új alkalmazás létrehozása az Azure App regisztrációkban.

  1. Jelentkezzen be az Azure Portalra globális rendszergazdaként a https://aad.portal.azure.com címen
  2. Kattintson az „Azure Active Directory”, majd az „Alkalmazásregisztrációk” elemre.

  3. Kattintson a „Jelentkezés regisztrálása” vagy az „Új regisztráció” gombra.

  4. Írja be az alkalmazás nevét, hagyja meg az alapértelmezett beállításokat, majd kattintson a „Regisztráció” gombra.

  5. Ekkor megjelenik az alkalmazás összefoglalója. Jegyezze fel az alkalmazásazonosítót.

Adjon engedélyeket az Azure-alkalmazásnak

Az alkalmazás létrehozása után meg kell adnunk a szükséges hozzáférést az alkalmazáshoz. Esetünkben ezt az alkalmazásazonosítót tervezzük használni a SharePoint Online PowerShell-szkriptjeinkben. Tehát meg kell adnunk a SharePoint alkalmazás engedélyét: Teljes felügyelet.

  1. A létrehozott alkalmazás-összefoglaló oldalon kattintson az „API engedélyek” elemre a bal oldali navigációs linkben, majd kattintson az „Engedély hozzáadása” elemre.

  2. Az „API engedélyek kérése” oldalon válassza a „SharePoint” lehetőséget.

  3. Válassza az Alkalmazásengedélyek lehetőséget >> Válassza a „Sites.FullControl.All” lehetőséget, majd kattintson az „Engedélyek hozzáadása” elemre.

  4. Kattintson a „Rendszergazdai hozzájárulás megadása” elemre az engedélyek jóváhagyásához.

Hozzon létre egy tanúsítványt, és töltse fel az App Secretbe

A következő lépés egy titok létrehozása az alkalmazás számára. Bár a jelszavak működnek, kevésbé előnyös a tanúsítványokhoz képest. Tehát szükségünk van egy önaláírt tanúsítványra az alkalmazásba való feltöltéshez.


$CertificateName = "SharePoint Online Certificate"
$CertificatePassword = "Password1"

#Get the "Documents" folder
$DocumentsFolder = [Environment]::GetFolderPath("MyDocuments")

#Generate a Self-signed Certificate
$Certificate = New-SelfSignedCertificate -Subject $CertificateName -CertStoreLocation "Cert:\CurrentUser\My" -KeyExportPolicy Exportable -KeySpec Signature -KeyLength 2048 -KeyAlgorithm RSA -HashAlgorithm SHA256

#Export the Certificate to "Documents" Folder in your computer
Export-Certificate -Cert $Certificate -FilePath $DocumentsFolder\$CertificateName.cer

#Export the PFX File
Export-PfxCertificate -Cert $Certificate -FilePath "$DocumentsFolder\$CertificateName.pfx" -Password (ConvertTo-SecureString -String $CertificatePassword -Force -AsPlainText)

Az önaláírt tanúsítvány létrehozásáról itt olvashat bővebben: https://learn.microsoft.com/en-us/azure/active-directory/develop/howto-create-self-signed-certificate

A tanúsítvány létrehozása után a következő lépés a tanúsítvány feltöltése az alkalmazástitok közé.

  1. Lépjen az Azure-alkalmazásba >> Kattintson a „Tanúsítványok és titkok” elemre.

  2. Kattintson a „Tanúsítvány feltöltése” gombra.

  3. Keresse meg a létrehozott CER fájlt, és kattintson a „Hozzáadás” gombra.

  4. Jegyezze fel a hüvelykujjlenyomatot. Ez a tanúsítványhoz társított biztonsági kulcsa az alkalmazás hitelesítéséhez.

Ez minden! Miután elvégezte az összes lépést, csatlakozhat a SharePoint Online-hoz a PowerShell Azure-alkalmazásazonosítójával!

Alternatív megközelítés: a PowerShell az alkalmazás regisztrálásához, az engedélyek megadásához és a titkos ügyfél titkosításához

A fenti lépések automatizálhatók egy PowerShell-szkript segítségével anélkül, hogy a webes felhasználói felületen át kellene menniük. Nyissa meg a PowerShell-konzolt rendszergazdaként, és futtassa ezt a szkriptet:


Register-PnPAzureADApp -ApplicationName "SharePointApp" -Tenant "Crescent.com" -Store CurrentUser -SharePointApplicationPermissions "Sites.FullControl.All" -Interactive

Ez a szkript regisztrál egy új Azure AD-alkalmazást, létrehoz egy új önaláírt tanúsítványt, és hozzáadja a helyi tanúsítványtárolóhoz. A tanúsítványt az Azure-alkalmazás regisztrációjához is feltölti.

A következő engedélyek jóváhagyására kéri a rendszer: „Sites.FullControl.All”. Jelentkezzen be, és fogadja el az engedélykérést.

Jegyezze fel az alkalmazásazonosítót/kliensazonosítót és az ujjlenyomatot.

Most már folytathatjuk a SharePoint Online-hoz való csatlakozást a PnP PowerShell segítségével.

2. lépés: Csatlakozzon a SharePoint Online-hoz alkalmazásazonosító és tanúsítvány használatával

Ha az Azure AD-alkalmazás készen áll, csatlakozhat a SharePoint Online-hoz a PnP PowerShellből a következőképpen:


#Parameters
$SiteURL = "https://Crescent.sharepoint.com/sites/retail"
$ClientID = "3735f461-fdb5-4360-8184-b30345e57796"
$ThumbPrint = "EE4C7845D6794F7525C2482551C2AC89F6B9CEE1"
$Tenant = "Crescent.com"

#Connect to SharePoint Online using Certificate
Connect-PnPOnline -Url $SiteURL -ClientId $ClientID -Thumbprint $ThumbPrint -Tenant $Tenant

#Get the Site
Get-PnPSite

Mindenkinek, akinek az alkalmazással csatlakoznia kell a SharePoint Online-hoz, először telepítenie kell a tanúsítványt a helyi gépére, majd az ügyfélazonosítót és a tanúsítvány ujjlenyomatát kell használnia a hitelesítéshez.

Íme a másik bejegyzésem a Kapcsolódás a SharePoint Online-hoz a ClientID és Client Secret segítségével a PnP PowerShell segítségével

Kapcsolódó cikkek