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>]

Você pode usar esse cmdlet para configurar ou desabilitar o recurso de pré-autenticação no SharePoint Online. A desabilitação pode ser combinada com comutadores para dar suporte ao gerenciamento granular de pré-autenticação para aplicativos e recursos específicos no nível do locatário.

Você deve ser um administrador do SharePoint para executar o cmdlet.

Configurações de URL do Microsoft Graph

As APIs de arquivo do Microsoft Graph podem retornar URLs que os aplicativos usam para baixar, carregar, visualizar, transformar ou monitorar operações de arquivo. Algumas dessas URLs historicamente incluíram tokens de pré-autenticação ou clientes redirecionados para URLs pré-autenticadas.

Você pode usar esse cmdlet para começar a receber URLs do Microsoft Graph de APIs com suporte para aplicativos de terceiros.

Comportamento esperado da API

APIs que retornam URLs

Para APIs com uma alternativa do Microsoft Graph, se a configuração estiver habilitada para o aplicativo de chamada, a resposta usará uma URL do Microsoft Graph e o aplicativo poderá chamar essa URL usando um token de acesso apropriado do Microsoft Graph.

Para APIs sem uma alternativa do Microsoft Graph, a URL retornada do SharePoint Online não contém informações de autenticação temporárias. O aplicativo deve obter um token de acesso apropriado do Microsoft Entra para o SharePoint Online e incluí-lo ao chamar a URL retornada.

APIs que atualmente retornam um redirecionamento HTTP 302

As APIs afetadas retornam conteúdo diretamente, em vez de redirecionar o aplicativo para uma URL de autenticação temporária. Os aplicativos não devem depender da interceptação do redirecionamento, da extração de um valor de autenticação temporário do local de redirecionamento, da passagem da URL redirecionada para um cliente não autenticado ou da suposição de que cada solicitação de conteúdo retorna um código de status HTTP 302. Os aplicativos devem estar preparados para processar uma resposta de conteúdo bem-sucedida a partir da solicitação original do Microsoft Graph.

Solicitações diretas de API do SharePoint

A configuração de locatário se aplica quando a solicitação original é feita por meio do Microsoft Graph. Ele não altera as solicitações que os aplicativos fazem diretamente às APIs do SharePoint.

Cenários de API afetados

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

Este exemplo desabilita a pré-autenticação geral e adiciona uma configuração que permite que dois aplicativos usem a pré-autenticação para todos os recursos.

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

Este exemplo executa a mesma função que o exemplo 1, exceto que, nesse caso, as opções para -ExcludedApps, -IncludedFeaturese -ExcludedFeatures são adicionadas ao cmdlet.

Supõe-se que essas opções tenham o valor padrão de "" se não forem usadas com o cmdlet, e o exemplo 2 é usado para demonstrar apenas o conjunto completo de opções.

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

Este exemplo removerá um item existente da lista atual de itens. A opção de remoção pode remover entradas permitidas ou negadas da lista.

Set-SPOTenantPreAuthSettings -IsDisabled $true

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

Este exemplo desabilita a pré-autenticação geral e permite que todos os aplicativos, exceto um, usem a pré-autenticação para todos os recursos, exceto para "Download" e "WebRenderingEmbed".

Nesse caso, o aplicativo sempre terá o uso "029e7c27-4b9c-4f8b-ba32-b96249468d42" da pré-autenticação, pois ele é excluído da configuração da lista de permissões. Qualquer outro aplicativo terá permissão para usar a pré-autenticação para qualquer recurso além de "Download" e "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"

Este exemplo desabilita a pré-autenticação geral, mas contém uma sobreposição entre as configurações na lista de permissões e na lista de negações. Primeiro, ele permite que um aplicativo use a pré-autenticação para os "OfficeOnline"recursos , "WebRenderingEmbed", e "Download" . Mas na execução final do cmdlet, ele nega que o mesmo aplicativo use a pré-autenticação para todos os recursos.

Nesse caso, o aplicativo "029e7c27-4b9c-4f8b-ba32-b96249468d42" não teria permissão para usar a pré-autenticação para nenhum dos recursos da lista de permissões, apesar de ter a configuração. Isso ocorre porque a lista Negar tem precedência sobre a lista Permitir.

Set-SPOTenantPreAuthSettings -IsDisabled $false

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

Este exemplo permite a pré-autenticação geral e nega que solicitações que não sejam provenientes de um aplicativo (por exemplo, solicitações provenientes por meio de um navegador) usem a pré-autenticação para todos os recursos.

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

Este exemplo habilita a configuração para dois aplicativos, o que significa que as APIs do Microsoft Graph com suporte retornarão URLs do Graph para esses aplicativos. O uso de uma lista de destinos permite validar a compatibilidade do aplicativo antes de aplicar o comportamento de forma mais ampla.

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $true -UseGraphUrlAppsList ""

Este exemplo habilita a configuração para todos os aplicativos 3P fornecendo uma lista de aplicativos vazia.

Set-SPOTenantPreAuthSettings -UseGraphUrlIsEnabled $false

Este exemplo mostra como parar de retornar URLs do Microsoft Graph por meio dessa configuração.

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

O -IncludedFeatures e -ExcludedFeatures use nomes de recursos da tabela a seguir. Ele menciona explicitamente se o recurso será interrompido se for desabilitado por meio do cmdlet do PowerShell.