Contratos de coleta — Microsoft Exchange (no local)
01Como ler esta página #sec_67d1db2a
Cada recurso que o REVIEWIT pode coletar para o Microsoft Exchange (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 possui, verificada por uma chamada real em leitura) ou a pertença do identificador à organização Exchange 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 sobre as quais o veredicto se baseia, definida por cada contrato (aqui: verificações de menos de 24 h). 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 pode sempre ser alimentado pela importação de um relatório (« Importar um relatório »).
02Como o REVIEWIT verifica as exigências #sec_3ee1fef0
O REVIEWIT ainda não verifica as conexões Microsoft Exchange (no local): nem o identificador nem seus direitos são verificados. Os recursos são exibidos como « Não verificado »; eles sempre podem ser alimentados pela importação de um relatório (« Importar um relatório »).
03As vias de chamada #sec_46d5bb5c
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 chamados de cada recurso; um caminho que começa com « / » é chamado na audiência do token da sua via.
| Via | Token emitido por | Audiência do token | Autenticação do identificador |
|---|---|---|---|
| exch-onprem.server.reviewit.agent | nenhum token: autenticação Windows (Active Directory) da conta de serviço | https://{exchange}/powershell | 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, {exchange} é o endereço do servidor Exchange.
04Exchange OnPremise · Pastas públicas #sec_2872b6b9
exch-onprem.exchange.public-folders:collect · revisão 1 do contrato, publicada em 16 de outubro de 2026 · via exch-onprem.server.reviewit.agent
Pastas públicas Exchange e os direitos concedidos sobre cada uma
Chamadas
- Get-PublicFolder -Recurse -ResultSize Unlimited
- Get-PublicFolderStatistics -ResultSize Unlimited
- Get-PublicFolderClientPermission
Exigências
| Natureza | Regra | Opções |
|---|---|---|
| Direito | uma à escolha | View-Only Organization Management ou Public Folder Management |
| Pertença | obrigatória | o identificador pertence à organização Exchange da conexão |
Condições de funcionamento
- a conta de serviço se autentica (autenticação Windows, Active Directory)
- o serviço https://{exchange}/powershell responde
Frescura: verificações de menos de 24 h.
Dados mantidos
| Campo | Papel | Tipo | Obrigatório |
|---|---|---|---|
| Id | chave do objeto | inteiro | sim |
| Name | exibido para reconhecer o objeto | texto | sim |
| FolderPath | contexto, sem efeito sobre a revisão | texto | não |
| Owners | acesso sujeito à revisão | lista de identidades | não |
| Members | acesso sujeito à revisão | lista de identidades | não |
| MailEnabled | contexto, sem efeito sobre a revisão | booleano | não |
| ItemCount | contexto, sem efeito sobre a revisão | inteiro | não |
| LastActivityDate | avaliado pelas políticas REVIEWIT (data da última atividade) | data e hora | não |
05Exchange OnPremise · Caixa de correio partilhada #sec_e9bacb30
exch-onprem.exchange.shared-mailboxes:collect · revisão 1 do contrato, publicada em 16 de outubro de 2026 · via exch-onprem.server.reviewit.agent
Caixas de correio partilhadas e seus acessos delegados (acesso completo, enviar como, em nome de)
Chamadas
- Get-Mailbox -RecipientTypeDetails SharedMailbox -ResultSize Unlimited
- Get-MailboxStatistics
- Get-MailboxPermission
- Get-ADPermission (direito estendido Send-As)
Requisitos
| Nature | Regra | Opções |
|---|---|---|
| Direito | uma à escolha | View-Only Organization Management ou Recipient Management |
| Membresia | requerida | o identificador pertence à organização Exchange da conexão |
Condições de funcionamento
- a conta de serviço autentica-se (autenticação Windows, Active Directory)
- o serviço https://{exchange}/powershell responde
Frescura: verificações de menos de 24 h.
Dados mantidos
| Campo | Função | Tipo | Obrigatório |
|---|---|---|---|
| Id | chave do objeto | inteiro | sim |
| Title | exibido para reconhecer o objeto | texto | sim |
| MailboxAddress | exibido para reconhecer o objeto | texto | não |
| Owners | acesso sujeito à revisão | lista de identidades | não |
| FullAccessUsers | acesso sujeito à revisão | lista de identidades | não |
| SendAsUsers | acesso sujeito à revisão | lista de identidades | não |
| SendOnBehalfUsers | acesso sujeito à revisão | lista de identidades | não |
| Created | contexto, sem efeito na 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 na revisão | inteiro | não |
06Para ir além #sec_814e2867
- Compreender uma conexão de coleta
- Referência dos direitos por recurso
- Ler um veredicto