M365Con 2027 – conferência online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Como encontrar todos os usuários externos com acesso aos seus sites do SharePoint

Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.

By · · Updated

Encontre usuários externos no SharePoint com três visões: contas de convidado no Microsoft Entra, Get-SPOExternalUser por site e relatórios de compartilhamento. Etapas, limites e armadilhas.

Automatically translated with AI from the original post. Read the English original

Para encontrar usuários externos no SharePoint, combine três visões. O Microsoft Entra lista as contas de convidado de todo o locatário. O cmdlet Get-SPOExternalUser lista os usuários externos de cada site. Os relatórios de compartilhamento no centro de administração do SharePoint mostram links que podem alcançar pessoas sem conta de convidado. Este artigo é para administradores de segurança que precisam responder: "Quem fora da nossa empresa pode abrir nosso conteúdo?" Você vai encontrar as etapas de cada visão, os limites documentados pela Microsoft, um exemplo prático e as armadilhas que levam a uma lista incompleta.

Pontos-chave

  • Nenhuma lista única mostra todas as pessoas externas com acesso, porque contas de convidado, acesso apenas por link e convites por site ficam em lugares diferentes.
  • O Microsoft Entra mantém as contas de convidado do locatário, e Get-EntraUser com o filtro userType eq 'Guest' as lista todas.
  • Get-SPOExternalUser lista os usuários externos por site, retorna no máximo 50 usuários por chamada e pagina com um valor de Position, então sites grandes exigem várias chamadas.
  • Um relatório de convidados pode deixar de fora pessoas que usam links de Qualquer pessoa, porque esses links concedem acesso sem uma conta de convidado.
  • Combine as três visões e depois decida, para cada convidado, se o acesso ainda é necessário, quem é o responsável por ele e quando ele termina.

Quem conta como usuário externo?

Comece pela definição, porque ela orienta o método. Um usuário externo é uma pessoa fora da sua organização que pode acessar seu conteúdo, e o acesso de convidado é a forma mais comum de fazer isso. Existem duas rotas principais.

A primeira é uma conta de convidado. Um convidado é convidado, aceita e então passa a existir como um objeto de usuário no seu diretório. O Microsoft Entra mantém essas contas, e o Microsoft Entra External ID é a área que cobre a colaboração externa. Os convidados aparecem nas listas e podem ser revisados, desabilitados ou removidos.

A segunda é um link. Um link de Qualquer pessoa funciona sem login, então a pessoa não tem conta no seu diretório e não aparece em nenhuma lista de convidados. A referência da Microsoft sobre configurações de compartilhamento descreve quatro níveis de compartilhamento: Qualquer pessoa, novos e existentes convidados, somente convidados existentes e somente pessoas da sua organização. Quais níveis o seu locatário permite define quanto do problema está em cada rota.

Portanto, uma resposta completa cobre contas de convidado e links. Trate qualquer ferramenta que mostre apenas um deles como uma resposta parcial.

Como listo todas as contas de convidado no Microsoft Entra?

A página da Microsoft sobre gerenciamento de contas de convidado com o PowerShell do Entra mostra o comando básico. Conecte-se com o escopo User.Read.All, depois execute Get-EntraUser com o filtro userType eq 'Guest' e a opção -All. Selecione as propriedades de que precisa, por exemplo nome de exibição, email, data de criação e conta habilitada, e exporte-as para um arquivo CSV.

A Microsoft lista como papéis mínimos para visualizar convidados o Guest Inviter ou o User Administrator. Desabilitar ou remover convidados exige o escopo User.ReadWrite.All e o papel User Administrator.

Essa lista responde à pergunta no nível do locatário: quantos convidados existem e quando foram criados? Ela não informa a quais sites do SharePoint eles têm acesso. Para isso, você precisa das duas próximas visões.

Como encontrar usuários externos no SharePoint, site por site?

O cmdlet Get-SPOExternalUser, documentado na referência do PowerShell do SharePoint Online, retorna usuários externos com base em critérios. Quatro parâmetros são importantes:

  • -SiteUrl limita o resultado a um site. Sem ele, você obtém os usuários externos de todos os sites.
  • -PageSize define o número máximo de usuários a retornar, e ele deve ser 50 ou menos.
  • -Position é o índice baseado em zero do primeiro resultado, por isso você o usa para paginar.
  • -Filter limita os resultados a usuários cujo primeiro nome, sobrenome ou e-mail começa com o texto informado. Curingas não funcionam.

O limite de 50 usuários tem um efeito prático. Um site com 130 usuários externos precisa de três chamadas, com as posições 0, 50 e 100. Escreva um pequeno loop que aumente a posição até que uma chamada retorne menos de 50 usuários, e exporte cada página.

As observações da Microsoft também dizem que a página não documenta as propriedades de saída, então verifique-as com Get-Member antes de montar um relatório. Há também um switch que mostra usuários que aceitaram um convite com uma conta diferente da convidada. Isso é uma pista útil para a limpeza, porque esses usuários podem ser difíceis de associar a uma pessoa.

Como encontrar acesso externo por meio de links e relatórios?

Use os relatórios no centro de administração do SharePoint para a via de links. A página da Microsoft sobre relatórios de governança de acesso a dados descreve os relatórios de links de compartilhamento que cobrem os últimos 28 dias: links Anyone, links People in the organization e links Specific people. No PowerShell, as entidades de relatório incluem SharingLinks_Guests para links Specific people criados nesse período.

Você também pode usar o relatório por usuário para obter uma lista de convidados. Ele mostra cada site que um determinado usuário pode acessar e se o acesso é ao site inteiro ou apenas a itens. Como o relatório exige nomes de usuário principal (UPN), use o UPN completo do convidado, que contém #EXT#. Os relatórios exigem o SharePoint Advanced Management, então verifique antes a página de licenciamento.

Para um único arquivo ou pasta, abra Compartilhar e depois Gerenciar acesso. Segundo a Microsoft, os usuários externos aparecem pelo endereço de e-mail e com o rótulo External User. Essa é a verificação certa quando alguém pergunta: "Quem de fora pode abrir este contrato?"

Qual é um fluxo de trabalho prático?

Execute as visões nesta ordem.

  1. Conte os convidados. Use a lista do Entra para obter o total e as datas de criação.
  2. Relacione os convidados aos sites. Para cada site importante, execute Get-SPOExternalUser -SiteUrl com paginação. Combine os resultados em uma única tabela com site, usuário e data.
  3. Adicione a visão de links. Execute os relatórios de links de compartilhamento para links Anyone e Specific people.
  4. Atribua um responsável a cada descoberta. Para cada convidado e cada site, indique um responsável de negócio que possa dizer se o acesso ainda é necessário.
  5. Decida e aja. Remova, desabilite ou mantenha com uma data de término. Registre a decisão por escrito.

O passo 4 é o que a maioria das equipes pula. Uma lista sem responsáveis é uma lista que ninguém usa para agir.

Exemplo: contagem de chamadas e descobertas para seis sites

Os números são fictícios, para mostrar o método. O Entra mostra 1.400 contas de convidados no locatário. Você escolhe seis sites com conteúdo sensível. As quantidades de usuários externos são 130, 48, 75, 12, 210 e 5.

Com um tamanho de página de 50, o número de chamadas por site é a quantidade dividida por 50, arredondada para cima: 3, 1, 2, 1, 5 e 1. Isso dá 13 chamadas no total para 480 entradas de usuários externos. Um script simples resolve isso em poucos minutos.

Você descobre então que 62 dos 480 registros pertencem a convidados cujo projeto terminou no ano passado. Outros 9 registros são de convidados que aceitaram com uma conta diferente da convidada. Suas ações: pedir aos seis proprietários dos sites que confirmem os 62, desativar essas contas após a aprovação e entrar em contato com os 9 usuários para confirmar quem são. O relatório de links de compartilhamento acrescenta 14 links "Qualquer pessoa" em dois dos seis sites, que você encaminha aos proprietários para revisão.

O resultado é uma lista curta de ações, com nomes, e não uma preocupação vaga. Ela também fornece números para a próxima auditoria: 480 registros externos, 62 inativos, 9 divergentes, 14 links.

O que você deve fazer com a lista depois?

Uma lista de usuários externos é apenas o começo. Ordene-a por risco e por antiguidade e, então, decida em rodadas.

  • Rodada um: convidados inativos. Convidados cujo projeto terminou ou cujas contas você não consegue associar a uma pessoa. Desative-os primeiro. Desativar é reversível, enquanto remover uma conta não é.
  • Rodada dois: acesso amplo. Convidados que podem acessar sites inteiros, e não apenas arquivos isolados. Pergunte ao proprietário se esse escopo é necessário.
  • Rodada três: responsabilidade. Cada convidado restante precisa de um patrocinador interno nomeado ou de um proprietário do site que garanta o acesso e a sua data de término.

Registre cada decisão. No próximo trimestre, execute novamente as mesmas três visões e compare os números. A queda na quantidade de convidados inativos é o melhor sinal de que a rotina funciona. Se a quantidade aumentar, analise como os convidados são convidados e quem tem permissão para convidá-los.

Erros comuns

  • Confiar apenas na lista de convidados. Links "Qualquer pessoa" concedem acesso sem uma conta de convidado.
  • Ignorar a paginação. Com um limite de 50 por chamada, uma primeira chamada isolada mostra apenas uma fração dos usuários em sites grandes.
  • Excluir antes de perguntar. A remoção de uma conta de convidado não pode ser desfeita; por isso, desative primeiro e confirme com o proprietário.
  • Olhar apenas para o locatário. A lista de convidados mostra quem existe, não onde essas pessoas têm acesso.
  • Nenhum proprietário por achado. Sem um proprietário, a lista envelhece e o acesso permanece.

Como o software pode ajudar

A rota nativa é o Microsoft Entra, o módulo do SharePoint Online PowerShell e os relatórios de governança de acesso a dados. Eles cobrem as três visões, mas você precisa unir os resultados manualmente. Uma ferramenta de relatórios pode reunir em um só lugar os relatórios de permissões e os links de compartilhamento. O SharePoint Essentials Toolkit, da Cognillo, é um exemplo. Segundo a página do produto, ele oferece relatórios de permissões para sites, pastas e itens, pode mostrar tudo a que uma pessoa tem acesso e gera relatórios sobre links de compartilhamento. Essas são afirmações do fornecedor, e o M365.FM não as testou. Compare qualquer ferramenta com as visões nativas antes de decidir.

Divulgação: a Cognillo patrocina o M365.FM.

Próximo passo

Execute hoje a lista de convidados do Entra, escolha os três sites com o conteúdo mais sensível e encontre os usuários externos nesses sites com Get-SPOExternalUser. Envie a cada proprietário de site a sua lista e peça uma decisão em até duas semanas.

Seguir o podcastSpotify

Entities in this article

Guest access SharePoint permissions Microsoft Entra External ID SharePoint Essentials Toolkit

Related articles

RSS