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 Mirko Peters · · 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:
-SiteUrllimita o resultado a um site. Sem ele, você obtém os usuários externos de todos os sites.-PageSizedefine 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.-Filterlimita 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.
- Conte os convidados. Use a lista do Entra para obter o total e as datas de criação.
- Relacione os convidados aos sites. Para cada site importante, execute
Get-SPOExternalUser -SiteUrlcom paginação. Combine os resultados em uma única tabela com site, usuário e data. - Adicione a visão de links. Execute os relatórios de links de compartilhamento para links Anyone e Specific people.
- 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.
- 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.