Contratos de coleta — Microsoft SharePoint (no local)
01Como ler esta página #sec_10d0227f
Cada recurso que o REVIEWIT pode coletar para o Microsoft SharePoint (no local) tem um contrato publicado. Ele é lido como uma referência de API: o que o REVIEWIT chama no serviço coletado e por qual meio, o que o contrato exige para que a coleta seja executada e os dados que o REVIEWIT mantém. O REVIEWIT apenas realiza leituras.
- Chamadas: as requisições que o REVIEWIT faz ao serviço coletado, todas em leitura.
- Exigências: cada uma deve ser satisfeita. Sua natureza indica o que ela solicita: um direito a conceder ao identificador, uma condição de administração (uma configuração ou atribuição no fornecedor que o token não carrega, verificada por uma chamada real em leitura) ou a pertença do identificador à fazenda SharePoint da conexão. A regra indica quantas opções são necessárias: « obrigatória » para a única opção, « uma à escolha » quando uma única basta (elas são ordenadas da mais estreita à mais ampla: prefira a primeira), « todas » ou « N à escolha entre M ».
- Condições de funcionamento: o que o REVIEWIT verifica antes de cada coleta, além das exigências.
- Frescura: a idade máxima das verificações nas quais o veredicto se baseia, definida por cada contrato (aqui: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real). O REVIEWIT ainda não verifica esta solução: esta duração será aplicada às suas verificações assim que ele as fizer.
- Dados mantidos: os campos que o REVIEWIT mantém de cada objeto; o papel indica o que a revisão faz com eles.
O veredicto de cada recurso, para sua conexão, é lido em sua ficha. Um recurso que a conexão não coleta ainda pode ser alimentado pela importação de um relatório (« Importar um relatório »).
02Como o REVIEWIT verifica as exigências #sec_62891b78
Para o Microsoft SharePoint (no local), os direitos da conta de serviço não são lidos em nenhum token: o contrato exige que sejam verificados por uma chamada real, em leitura. O REVIEWIT ainda não faz essa chamada para o Microsoft SharePoint (no local): nem a autenticação da conta de serviço nem seus direitos são verificados. Os recursos são exibidos como « Não verificado »; eles ainda podem ser alimentados pela importação de um relatório (« Importar um relatório »).
03As vias de chamada #sec_bd6da6ea
Uma via indica qual token o REVIEWIT obtém para o identificador: quem o emite e para qual audiência. Os endereços chamados estão nos chamadas de cada recurso; um caminho que começa com « / » é chamado na audiência do token de sua via.
| Via | Token emitido por | Audiência do token | Autenticação do identificador |
|---|---|---|---|
| sp-onprem.server.reviewit.agent | nenhum token: autenticação Windows (Active Directory) da conta de serviço | https://{farm} | senha da conta de serviço (Active Directory) |
Uma via no local não emite nenhum token: a conta de serviço se autentica por Windows (Active Directory) no servidor, e é essa autenticação que o REVIEWIT verifica.
Nesses endereços, {farm} é o endereço da fazenda SharePoint.
04SharePoint OnPremise · Sites #sec_35b75973
sp-onprem.sharepoint.sites:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via sp-onprem.server.reviewit.agent
Coletas de sites da fazenda SharePoint e suas atribuições de função
{site} designa o endereço de uma coleção de sites, tal como a enumeração o retorna (Path).
Chamadas
- GET https://{farm}/_api/search/query?querytext='contentclass:STS_Site'&selectproperties='Title,Path,SiteId'&rowlimit=500 (enumeração das coleções de sites da fazenda)
- GET {site}/_api/site
- GET {site}/_api/web?$select=Id,Title,Url,Created,LastItemModifiedDate
- GET {site}/_api/web/roleassignments?$expand=Member,RoleDefinitionBindings
Exigências
| Natureza | Regra | Opções |
|---|---|---|
| Direito | obrigatória | política de aplicação web « Leitura total » (Full Read) concedida à conta de serviço na Administração central |
| Pertença | obrigatória | o identificador pertence à fazenda SharePoint da conexão |
Condições de funcionamento
- a conta de serviço se autentica (autenticação Windows, Active Directory)
- o serviço https://{farm} responde
Frescura: verificações de menos de 24 h; os direitos devem ser verificados por uma chamada real.
Dados mantidos
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| Id | chave do objeto | inteiro | sim |
| Title | exibido para reconhecer o objeto | texto | sim |
| Url | exibido para reconhecer o objeto | texto | não |
| Owners | acesso sujeito à revisão | lista de identidades | não |
| Members | acesso sujeito à revisão | lista de identidades | não |
| Admin | acesso sujeito à revisão | lista de identidades | não |
| Guests | acesso sujeito à revisão | lista de identidades | não |
| Type | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastModified | contexto, sem efeito sobre a revisão | data e hora | não |
| LastActivityDate | avaliado pelas políticas REVIEWIT (data da última atividade) | data e hora | não |
| Size | contexto, sem efeito sobre a revisão | inteiro | não |
05SharePoint OnPremise · Subsites #sec_8322202c
sp-onprem.sharepoint.subsites:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via sp-onprem.server.reviewit.agent
Subsites da fazenda SharePoint e a herança das suas permissões
{site} designa o endereço de uma coleção de sites (enumeração do recurso Sites); {web} o de um subsite, tal como /_api/web/webs o apresenta (Url).
Chamadas
- GET {site}/_api/web/webs?$select=Id,Title,Url,HasUniqueRoleAssignments (recursivo, para cada coleção de sites, exceto site raiz)
- GET {web}/_api/web/roleassignments?$expand=Member,RoleDefinitionBindings
Requisitos
| Nature | Regra | Opções |
|---|---|---|
| Direito | requerido | política de aplicação web « Leitura total » (Full Read) concedida à conta de serviço na Administração central |
| Assinatura | requerido | o identificador pertence à fazenda SharePoint da conexão |
Condições de funcionamento
- a conta de serviço autentica-se (autenticação Windows, Active Directory)
- o serviço https://{farm} responde
Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.
Dados conservados
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| Id | chave do objeto | inteiro | sim |
| Title | exibido para reconhecer o objeto | texto | sim |
| Url | exibido para reconhecer o objeto | texto | não |
| Owners | acesso sujeito à revisão | lista de identidades | não |
| Members | acesso sujeito à revisão | lista de identidades | não |
| Visitors | acesso sujeito à revisão | lista de identidades | não |
| Guests | acesso sujeito à revisão | lista de identidades | não |
| Type | contexto, sem efeito sobre a revisão | texto | não |
| Created | contexto, sem efeito sobre a revisão | data e hora | não |
| LastModified | avaliado pelas políticas REVIEWIT (data da última atividade) | data e hora | não |
| ParentId | contexto, sem efeito sobre a revisão | texto | não |
| InheritsPermissions | contexto, sem efeito sobre a revisão | booleano | não |
| Size | contexto, sem efeito sobre a revisão | inteiro | não |
06Para ir mais longe #sec_330f1291
- Compreender uma conexão de coleta
- Referência dos direitos por recurso
- Ler um veredicto