Inventário de sites e permissões
Lista os sites com getAllSites, as bibliotecas de cada um e percorre cada drive com delta e Prefer: hierarchicalsharing, lendo permissões só nas raízes de herança.
Octo para SharePoint, OneDrive, Teams e Power Automate
No Microsoft 365, sites, bibliotecas, arquivos e permissões passam pelo Microsoft Graph. O Octo inventaria o tenant só com leitura, aponta link anônimo e herança quebrada, propõe a permissão mínima para cada aplicativo, mede a pasta de rede antes de migrar e trata fluxos do Power Automate como código revisável. Consentimento, acesso, dado pessoal e publicação ficam com o administrador e com o dono de cada site.
Seis entregas possíveis, tiradas do levantamento. Todas começam por leitura, todas pedem a menor permissão que resolve, e todas vão para revisão de quem administra o tenant e de quem é dono do conteúdo.
Lista os sites com getAllSites, as bibliotecas de cada um e percorre cada drive com delta e Prefer: hierarchicalsharing, lendo permissões só nas raízes de herança.
Troca o Sites.ReadWrite.All pedido "para testar" por Sites.Selected com papel read ou write no site que importa, e registra como revogar.
Mede a pasta de rede antes da janela: caminho acima de 400 caracteres com o prefixo do destino, arquivo acima de 250 GB, nome suspeito, duplicata por SHA-256, pasta com dado pessoal.
Entrega: manifesto CSV para o dono dos dados aprovarSó o que foi aprovado vai, com createUploadSession, conflictBehavior igual a fail, fragmentos de 10 MiB e respeito ao Retry-After.
Exporta a solução com pac solution export, desempacota e revisa o JSON de cada fluxo por diff; importa com arquivo de configuração por ambiente.
Acha script que ainda depende de SharePoint Add-ins e ACS, encerrados em 02/04/2026, e integração do OneNote que contava com permissão de aplicativo.
Entrega: lista do que parou ou vai parar, com o caminho novoO mesmo ciclo do Octo, aplicado ao Microsoft 365. Cada braço tem um papel estreito; quem consente, quem dá acesso e quem responde pelo dado são pessoas.
Sites, bibliotecas, equipes, fluxos, aplicativos registrados e o que ainda depende de Add-ins e ACS.
Bibliotecas, colunas, versões, volume e o que vira metadado na migração.
Permissão mínima por aplicativo, link anônimo, convidado externo e pastas com dado pessoal (LGPD) sinalizadas.
Graph direto, PnP PowerShell, Migration Manager ou solução do Power Platform, conforme a tarefa e o volume.
Inventário, pre-scan e envio com throttling respeitado e a fonte de cada sintaxe anotada.
Permissão listada no site, tamanho no destino, diff do JSON do fluxo antes de importar.
Pacote e roteiro prontos; a aplicação no tenant é feita com aprovação de uma pessoa.
Inventário, permissões concedidas, quem aprovou, manifesto da migração e como reverter.
O Octo não consente permissões, não guarda certificado nem segredo de aplicativo, não abre nem fecha acesso por conta própria e não responde pelo dado armazenado no tenant.
O critério que o Octo usa para escolher, com a chamada e a permissão de menor privilégio documentada.
| Tarefa | Caminho | Observação |
|---|---|---|
| Listar todos os sites | GET /sites/getAllSites | Só aplicativo, Sites.Read.All |
| Varrer arquivos e mudanças | GET /drives/{id}/root/delta | Files.Read.All; guardar o deltaLink |
| Achar só raízes de permissão | Prefer: hierarchicalsharing | Operação de permissão custa 5 RU |
| Ler permissões de um item | GET .../items/{id}/permissions | Direta em grantedToV2, de link em grantedToIdentitiesV2; a raiz de permissão vem do delta |
| Dar acesso a um site só | Sites.Selected + POST /sites/{id}/permissions | Gravar exige Sites.FullControl.All; em sessão delegada, admin do SharePoint e membro do site |
| Revogar esse acesso | DELETE /sites/{id}/permissions/{id} | Ou revogar o consentimento |
| Enviar arquivo grande | createUploadSession + PUT | Múltiplos de 320 KiB, abaixo de 60 MiB |
| Juntar chamadas | POST /$batch | Até 20; throttling conta cada uma |
| Migrar compartilhamento de rede | Migration Manager | Agentes, CSV, arquivos até 250 GB |
| Exportar e promover fluxos | pac solution export / import | Importa o zip gerenciado, com --settings-file por ambiente |
| Mensagem em canal do Teams | POST /teams/{id}/channels/{id}/messages | Delegada; aplicativo só em migração |
| Cadernos do OneNote | /me/onenote/... | Só delegada desde 31/03/2025 |
Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado na sua equipe.
Proposta, não promessa
O Octo mostra o que há no tenant e onde o acesso está aberto demais, sem gravar nada.
Aplicativos passam a enxergar só o site de que precisam; migrações começam por pre-scan e manifesto.
Sites.Selected no lugar de .AllFluxos em controle de versão, promoção por solução e um registro de cada acesso concedido.
Cada ponto abaixo tem fonte publicada pela Microsoft (Learn e Suporte), pelo repositório oficial do pacote (PyPI, NuGet, PowerShell Gallery) ou em lei federal. Os exemplos são roteiros, não execuções. As fontes estão na seção seguinte.
4
pontos com fonte publicada, cada um com a referência indicada ao lado.
Sites.Selected começa sem acesso; a permissão é gravada no site com POST /sites/{id}/permissions e papéis read, write, owner ou fullcontrol. Em lista, item ou arquivo, quebra a herança. Em sessão delegada, quem grava precisa ser SharePoint Administrator ou superior e membro do site de destino; o método só cria permissão de aplicativo.Fonte: Microsoft Learn, permissões selected e criação de permissão em siteO Octo prepara tudo, mas não assina. O documento que vale continua com quem responde por ele.
Levanta, organiza e gera os arquivos: documentos, planilhas, apresentações, cronogramas, inventários e relatórios de conferência, no arquivo e pelas APIs, sem enviar nem publicar nada.
Entrega: material pronto para conferirQuem responde pelo documento, pela planilha ou pelo cronograma confere o que o Octo entregou antes de aprovar. Se algo não fecha, volta para o Octo com a correção.
Etapa: conferência por quem respondeO Octo não assina, não aprova e não envia. O dono do documento revisa e assina; o gerente do projeto aprova a linha de base; o administrador do Microsoft 365 consente as permissões; o encarregado de dados aprova o que sai com dado pessoal.
Aprovação: dono do documento e administrador do 365Documentação oficial do Microsoft Graph, do SharePoint Online, do Entra ID e do Power Platform, e a documentação do PnP PowerShell, consultadas em 31/10/2026.
O diagnóstico começa por um inventário de sites e permissões, só com leitura. Você recebe a lista do que está aberto demais, do que vai parar de funcionar e das perguntas que só a sua equipe responde, e decide com ela na mão.