Set-SPOTenantPreAuthSettings

Set-SPOTenantPreAuthSettings
    -IsDisabled <Boolean>
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    -Type <TenantPreAuthSettingsListType>
    [-Add]
    [-IncludedApps <String>]
    [-ExcludedApps <String>]
    [-IncludedFeatures <String>]
    [-ExcludedFeatures <String>]
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    -Id <String>
    [-Remove]
    [<CommonParameters>]

Set-SPOTenantPreAuthSettings
    [-UseGraphUrlIsEnabled <Boolean>]
    [-UseGraphUrlAppsList <String>]
    [<CommonParameters>]

Vous pouvez utiliser cette applet de commande pour configurer ou désactiver la fonctionnalité de pré-authentification dans SharePoint Online. La désactivation peut être combinée avec des commutateurs pour prendre en charge une gestion granulaire de la pré-authentification pour des applications et des fonctionnalités spécifiques au niveau du locataire.

Vous devez être un administrateur SharePoint pour exécuter l’applet de commande.

Paramètres d’URL de Microsoft Graph

Les API de fichier Microsoft Graph peuvent renvoyer les URL que les applications utilisent pour télécharger, charger, prévisualiser, transformer ou surveiller les opérations de fichier. Certaines de ces URL incluent toujours des jetons de préauthentification ou redirigent les clients vers des URL pré-authentifiées.

Vous pouvez utiliser cette applet de commande pour commencer à recevoir des URL Microsoft Graph à partir des API prises en charge pour les applications tierces.

Comportement attendu de l’API

API qui retournent des URL

Pour les API avec une alternative Microsoft Graph, si le paramètre est activé pour l’application appelante, la réponse utilise une URL Microsoft Graph, et l’application peut appeler cette URL à l’aide d’un jeton d’accès Microsoft Graph approprié.

Pour les API sans alternative Microsoft Graph, l’URL SharePoint Online renvoyée ne contient pas d’informations d’authentification temporaires. L’application doit obtenir un jeton d’accès Microsoft Entra approprié pour SharePoint Online et l’inclure lors de l’appel de l’URL renvoyée.

API qui retournent actuellement une redirection HTTP 302

Les API affectées retournent directement le contenu au lieu de rediriger l’application vers une URL d’authentification temporaire. Les applications ne doivent pas dépendre de l’interception de la redirection, de l’extraction d’une valeur d’authentification temporaire de l’emplacement de redirection, de la transmission de l’URL redirigée à un client non authentifié ou de la supposation que chaque demande de contenu retourne un code d’status HTTP 302. Les applications doivent être prêtes à traiter une réponse de contenu réussie à partir de la demande Microsoft Graph d’origine.

Demandes directes d’API SharePoint

Le paramètre de locataire s’applique lorsque la demande d’origine est effectuée via Microsoft Graph. Elle ne modifie pas les demandes que les applications effectuent directement aux API SharePoint.

Scénarios d’API affectés

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

Cet exemple désactive globalement la pré-authentification et ajoute un paramètre qui permet à deux applications d’utiliser la pré-authentification pour toutes les fonctionnalités.

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e" -ExcludedApps "" -IncludedFeatures "" -ExcludedFeatures ""

Cet exemple remplit la même fonction que l’exemple 1, sauf que dans ce cas, les commutateurs pour -ExcludedApps, -IncludedFeatureset -ExcludedFeatures sont ajoutés à l’applet de commande.

Ces commutateurs sont supposés prendre la valeur par défaut de "" s’ils ne sont pas utilisés avec l’applet de commande et l’exemple 2 est utilisé pour illustrer l’ensemble complet de commutateurs uniquement.

Set-SPOTenantPreAuthSettings -Remove -Id "368dde6f-c857-4383-a8a7-02a04a294e6d"

Cet exemple supprimera un élément existant de la liste actuelle d’éléments. Le commutateur de suppression permet de supprimer, autoriser ou refuser des entrées de la liste.

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -ExcludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42" -ExcludedFeatures "Download,WebRenderingEmbed"

Cet exemple désactive globalement la pré-authentification et permet à toutes les applications, à l’exception d’une seule, d’utiliser la pré-authentification pour toutes les fonctionnalités, à l’exception de "Download" et "WebRenderingEmbed".

Dans ce cas, l’application "029e7c27-4b9c-4f8b-ba32-b96249468d42" se verra toujours refuser l’utilisation de la pré-authentification, car elle est exclue du paramètre de liste verte. Toute autre application sera autorisée à utiliser la pré-authentification pour toute fonctionnalité à l’exception de "Download" et "WebRenderingEmbed".

Set-SPOTenantPreAuthSettings -IsDisabled $true

Set-SPOTenantPreAuthSettings -Add -Type Allow -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42" -IncludedFeatures "OfficeOnline,WebRenderingEmbed,Download"

Set-SPOTenantPreAuthSettings -Add -Type Deny -IncludedApps "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

Cet exemple désactive globalement la pré-authentification, mais contient un chevauchement entre les paramètres de la liste verte et de la liste interdite. Il permet tout d’abord à une application d’utiliser la pré-authentification pour les "OfficeOnline"fonctionnalités , "WebRenderingEmbed", et "Download" . Toutefois, dans l’exécution finale de l’applet de commande, il empêche la même application d’utiliser la pré-authentification pour toutes les fonctionnalités.

Dans ce cas, l’application "029e7c27-4b9c-4f8b-ba32-b96249468d42" n’est pas autorisée à utiliser la pré-authentification pour les fonctionnalités répertoriées par l’autorisation malgré ce paramètre. En effet, la liste d’exclusion prévaut sur la liste d’autorisation.

Set-SPOTenantPreAuthSettings -IsDisabled $false

Set-SPOTenantPreAuthSettings -Add -Type Deny -IncludedApps "Empty"

Cet exemple active la préauthentification globale et empêche les demandes qui ne proviennent pas d’une application (par exemple, les demandes provenant d’un navigateur) d’utiliser la préauthentification pour toutes les fonctionnalités.

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $true -UseGraphUrlAppsList "029e7c27-4b9c-4f8b-ba32-b96249468d42,0ab82eba-96c7-4681-9f75-c18437e20d0e"

Cet exemple active le paramètre pour deux applications, ce qui signifie que les API Microsoft Graph prises en charge retournent des URL Graph à ces applications. L’utilisation d’une liste ciblée vous permet de valider la compatibilité des applications avant d’appliquer le comportement plus largement.

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $true -UseGraphUrlAppsList ""

Cet exemple active le paramètre pour toutes les applications 3P en fournissant une liste d’applications vide.

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $false

Cet exemple montre comment arrêter le retour d’URL Microsoft Graph via ce paramètre.

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

-ExcludedFeatures Les -IncludedFeatures et utilisent les noms de fonctionnalité du tableau suivant. Il mentionne explicitement si la fonctionnalité sera rompue si elle est désactivée via l’applet de commande PowerShell.