Integração Outlook¶
Uma integração Outlook pode ser adicionada à sua instalação do Drovio Server. Permite aos utilizadores planear reuniões Drovio diretamente a partir do seu calendário Outlook: um botão Add a Drovio meeting insere no compromisso o link para entrar, e o envio do compromisso mantém a reunião alinhada com a sua data, os seus participantes e a sua recorrência. Terá de criar um registo de aplicação no Microsoft Entra ID.
O suplemento funciona no Outlook na Web, no novo Outlook para Windows, no Outlook clássico para Windows e no Outlook para Mac. Autentica os utilizadores com a sua conta Microsoft: na primeira vez, estes autenticam-se também uma única vez na sua instância do Drovio Server, para associar as duas contas. A sua conta Drovio tem de existir previamente.
Apenas HTTPS
O Outlook só carrega os suplementos por HTTPS. O seu Drovio Server tem de estar acessível por HTTPS a partir das máquinas onde o Outlook é executado.
Declarar o suplemento no Microsoft Entra ID¶
No que se segue, <your server> designa o nome de anfitrião do URL público do seu
Drovio Server, por exemplo drovio.example.com.
Não tem de construir à mão o URI de redirecionamento nem o Application ID URI: a página Outlook do painel de administração apresenta ambos, prontos a copiar. Abra Integrations e depois Configure no cartão Outlook.
Criar o registo de aplicação¶
No portal Azure, abra Microsoft Entra ID, depois App registrations e New registration.
| Campo | Valor |
|---|---|
| Name | O nome que quiser, por exemplo Drovio Outlook |
| Supported account types | Accounts in this organizational directory only (inquilino único) |
| Redirect URI | Single-page application (SPA), depois brk-multihub://<your server> |
No painel Overview, anote:
| Valor no Entra ID | Utilizado como |
|---|---|
| Application (client) ID | client_id |
| Directory (tenant) ID | tenant_id |
Não é necessário nenhum segredo de cliente: o suplemento nunca se autentica como a aplicação.
Expor a API¶
Em Expose an API, clique em Add ao lado de Application ID URI, e introduza o URI que o painel de administração apresenta assim que o Application ID estiver guardado:
api://<your server>/<client id>
Depois Add a scope:
| Campo | Valor |
|---|---|
| Scope name | access_as_user |
| Who can consent | Admins and users |
| Admin consent display name | Use Drovio as the user |
| Admin consent description | Lets Outlook sign the user in to Drovio. |
| State | Enabled |
Ainda em Expose an API, clique em Add a client application, introduza
ea5a67f6-b6f3-4338-b240-c655ddc3cc8e e assinale o âmbito access_as_user. Este
identificador representa o conjunto das aplicações Office, que pedem um token em
nome do suplemento quando o Outlook não dispõe da autenticação de aplicações
aninhadas (nested app authentication).
Pedir tokens da versão 2¶
Em Manifest, passe requestedAccessTokenVersion para 2, na secção api,
depois Save. O Drovio Server verifica os tokens tal como o Entra ID os emite
nessa versão.
Conceder o consentimento¶
Em API permissions, Add a permission, abra APIs my organization
uses, encontre o registo de aplicação pelo seu nome e adicione a sua permissão
delegada access_as_user. Clique em seguida em Grant admin consent for <your
tenant>, o que poupa a cada utilizador o pedido de consentimento.
Configurar a integração¶
No painel de administração, abra Integrations e depois Configure no cartão Outlook.
| Campo | De onde vem |
|---|---|
| Status | Enabled ou Disabled |
| Application ID | O client_id anotado no Entra ID |
| Tenant ID | O tenant_id anotado no Entra ID |
Guardar produz efeito logo no pedido seguinte, sem reinício a efetuar. Assim que o Application ID estiver guardado, a página apresenta o Application ID URI e o URI de redirecionamento que o registo de aplicação tem de declarar.
Passar o estado a Disabled recusa os pedidos vindos do Outlook, deixando a página acessível para configurar a integração.
Referência de configuração¶
Eis as chaves do elemento outlook de settings.conf, caso prefira editá-lo
diretamente. Num cluster, o painel de administração não as pode guardar: cada
servidor lê o seu próprio ficheiro de configuração, que tem de ser editado em cada
um deles.
| Chave | Predefinição | Significado |
|---|---|---|
enabled |
false |
Ativa a integração |
client_id |
Application (client) ID do registo de aplicação | |
tenant_id |
Directory (tenant) ID do registo de aplicação, obrigatório para ativar a integração | |
manifest_id |
Identifica o suplemento no Microsoft 365. Definido no primeiro guardar, não o edite |
Implantar o suplemento¶
O suplemento é descrito por um manifest que aponta para o seu servidor. Na página Outlook do painel de administração, a secção Manifest permite transferi-lo, preenchido com a configuração guardada.
No Microsoft 365 admin center, vá a Settings, depois Integrated apps e Upload custom apps. Escolha Office Add-in, carregue o manifest e selecione em seguida os utilizadores ou os grupos aos quais o implantar. A implantação demora até 24 horas a chegar ao Outlook, por vezes mais no Outlook clássico para Windows.
Utilizar o suplemento¶
Num compromisso que o utilizador organiza, o friso apresenta um grupo Drovio:
| Botão | O que faz |
|---|---|
| Add a Drovio meeting | Cria a reunião Drovio a partir do compromisso, define o link para entrar como local e adiciona-o ao convite |
| Settings | Apresenta a conta Drovio à qual o suplemento está ligado, e permite terminar sessão |
Quando o compromisso é enviado, o suplemento atualiza a reunião Drovio com as alterações feitas desde então: assunto, descrição, datas, participantes e recorrência. O Drovio não envia nenhum convite próprio: o convite do Outlook é o que os participantes recebem.
Outlook na Web e o novo Outlook
No Outlook na Web e no novo Outlook para Windows, o suplemento só é executado no envio quando o compromisso está aberto numa janela própria, com Open in new window. A partir do formulário que se abre dentro da janela principal, ou quando o compromisso é reencaminhado, as alterações feitas depois de adicionar a reunião Drovio não lhe chegam.