O AB Projects solicita permissões em dois lugares. O seu administrador vê uma tela de consentimento da Microsoft uma única vez para toda a organização, e um proprietário da equipe aceita uma lista curta de permissões de equipe quando o aplicativo é adicionado a uma equipe ou atualizado. Cada item corresponde a um recurso que você vê no produto, e a maior parte é acesso delegado: o aplicativo age como você e nunca pode fazer mais do que você já pode.
O que é o Microsoft Graph e para que servem as permissões?
O Microsoft Graph é a API integrada do Microsoft 365 — a porta de entrada oficial que os aplicativos usam para trabalhar com o Teams, o Outlook e o seu perfil. O AB Projects o utiliza para quatro coisas:
Vinculação de canais e sincronização de membros
Conectar um projeto ao canal certo do Teams e adicionar automaticamente os membros do canal ao projeto — consulte Adicionando ou removendo membros.
Cartões de tarefa e sincronização de comentários
Publicar cartões de tarefa e comentários na conversa do canal e sincronizar as respostas dessa conversa de volta para a tarefa — consulte Comentários com menções em canais.
Agendamento no calendário
Criar um evento no calendário do Outlook para uma tarefa quando você decide reservar tempo para ela, e agendar reuniões.
Login (SSO)
Login sem senha com sua conta do Microsoft 365 — consulte SSO e login da Microsoft.
Permissões para toda a organização
São as que o seu administrador consente uma única vez, no Microsoft Entra ID. Delegada = o aplicativo age como o usuário conectado, limitado ao que esse usuário já pode fazer. Aplicativo = usada pelo AB Projects sem um usuário conectado, para trabalhos em segundo plano, como manter os membros de um projeto alinhados ao seu canal.
| Permissão | Tipo | Por que o AB Projects precisa dela |
|---|---|---|
User.Read | Delegada | Login e leitura do seu perfil básico do Microsoft 365. Exigida por qualquer aplicativo que use o login da Microsoft. |
openid, profile, email | Delegada | Escopos padrão de login: autenticam você e leem seu nome, avatar e endereço de e-mail para que tarefas e comentários sejam atribuídos à pessoa certa. |
offline_access | Delegada | Permite que o aplicativo renove o acesso em segundo plano (por exemplo, na sincronização do calendário) sem pedir que você faça login novamente toda vez que um token expira. |
Team.ReadBasic.All | Delegada | Lê os nomes das equipes do Teams às quais você pertence, para que um projeto possa ser vinculado à equipe correta. |
Channel.ReadBasic.All | Delegada | Lê os nomes básicos dos canais para que o canal certo possa ser escolhido durante a configuração da guia e exibido corretamente. |
Group.Read.All | Delegada | Lê os grupos do Microsoft 365 por trás das suas equipes — usada para a vinculação projeto ↔ canal e para a sincronização automática que adiciona os membros do canal ao projeto. |
ChannelMessage.Send | Delegada | Publica no canal vinculado em seu nome quando você altera uma tarefa ou adiciona um comentário (incluindo @menções aos membros que você escolher). |
ChannelMessage.ReadWrite | Delegada | Lê e publica mensagens do canal para que os comentários e as atualizações de uma tarefa cheguem à própria conversa dessa tarefa no Teams. |
Calendars.ReadWrite | Delegada | Cria e atualiza um evento no calendário do Outlook para uma tarefa quando você opta por sincronizá-la (bloqueio de tempo). Solicitada no login para que nenhum pedido de consentimento extra apareça depois. |
Schedule.Read.All | Delegada | Lê as escalas do Turnos do Teams que você já pode ver. Ela aparece na tela de consentimento; nenhum recurso atual do AB Projects a utiliza. |
TeamMember.Read.All | Aplicativo | Lê quem faz parte de uma equipe, para que a lista de membros do projeto acompanhe o canal vinculado mesmo quando ninguém está conectado. |
ChannelMember.Read.All | Aplicativo | Lê quem faz parte de um canal privado ou compartilhado, cujos membros podem ser diferentes dos da equipe, para que esses projetos recebam os membros do canal e não a equipe inteira. |
Permissões de equipe (aceitas por um proprietário da equipe)
Algumas permissões se aplicam a uma única equipe. A Microsoft as chama de consentimento específico do recurso: em vez de um administrador conceder acesso a toda a organização, um proprietário da equipe as aceita quando o AB Projects é adicionado à equipe ou quando uma atualização inclui uma nova. Elas não dão ao aplicativo nada fora dessa equipe, e remover o AB Projects da equipe as revoga.
| Permissão | Tipo | Por que o AB Projects precisa dela |
|---|---|---|
TeamMember.Read.Group | Equipe | Lê a lista de membros desta equipe para a sincronização de membros. |
ChannelMessage.Read.Group | Equipe | Permite que o bot receba as respostas nos canais desta equipe sem ser @mencionado; é assim que uma resposta comum abaixo de um cartão de tarefa se torna um comentário na tarefa. Adicionada no AB Projects 2.4.0. O AB Projects registra apenas as respostas nas conversas abaixo dos seus próprios cartões de tarefa e de documento. |
ChannelMessage.Read.Group entre em vigor. Até lá, somente as respostas que @mencionam o AB Projects são sincronizadas. Consulte Comentários com menções em canais.Observações para administradores
- O acesso delegado não pode exceder o do usuário. A maioria das linhas acima age como a pessoa conectada — se ela não consegue ver um canal, o aplicativo também não.
- As permissões de aplicativo servem para a sincronização de membros. Elas permitem que o AB Projects mantenha os membros de um projeto alinhados ao seu canal quando ninguém está conectado. Elas leem apenas a associação, não as mensagens.
- A sincronização de respostas usa uma permissão de equipe, não uma para toda a organização.
ChannelMessage.Read.Groupé aceita equipe por equipe por um proprietário da equipe, portanto nunca abrange uma equipe que não a tenha aceitado. - A gravação no calendário é opcional, tarefa por tarefa. O aplicativo só acessa seu calendário quando você sincroniza explicitamente uma tarefa ou agenda uma reunião a partir dela.
- Você continua no controle. As permissões para toda a organização podem ser revisadas ou revogadas a qualquer momento no Microsoft Entra ID; o consentimento pode ser necessário uma vez por organização no primeiro login (consulte SSO e login da Microsoft). As permissões de equipe terminam quando o AB Projects é removido da equipe.
Em resumo: as permissões existem para que tarefas, canais do Teams e seu calendário permaneçam sincronizados — nada aqui lê seus e-mails ou arquivos, e as telas de consentimento são sempre a lista definitiva.