Crie manualmente um aplicativo do Azure para o Entra ID, o OneDrive for Business e o SharePoint Online

Para permitir que o MyQ X acesse recursos em seu locatário do Azure — como para sincronização de usuários ou digitalização e impressão de/para o OneDrive for Business e o SharePoint Online —, é necessário registrar um aplicativo em seu locatário do Azure com permissões suficientes.

Você pode criar vários aplicativos diferentes para cada um dos serviços e não torná-los visíveis aos usuários.

No entanto, a opção mais segura e eficiente é criar um único aplicativo que possa ser usado para todos os conectores (Entra ID, OneDrive for Business, SharePoint) e publicar esse aplicativo para todos os seus usuários. Eles verão o MyQ X como um dos aplicativos disponíveis e poderão acessar a interface web do MyQ a partir de “Meus aplicativos” em sua conta da Microsoft.

Configure o registro do aplicativo para o MyQ X

Criar ou atualizar o registro do aplicativo

1. Faça login no Portal do Microsoft Azure e acesse “Registros de aplicativos”.

   

2. Selecione “Novo registro” para criar um novo aplicativo ou escolha um aplicativo existente caso já tenha criado um aplicativo para o MyQ X e deseje apenas atualizá-lo.

3. Defina os seguintes detalhes:

   1. Nome: MyQ X.

   2. Tipos de conta compatíveis: selecione de acordo com o público-alvo

      1. Selecione a opção “Apenas contas neste diretório organizacional (somente {Nome do locatário} – Locatário único)” se todos os seus usuários que acessarão este aplicativo forem membros do seu locatário do Azure.

      2. A opção “Contas em qualquer diretório organizacional (Qualquer locatário do Microsoft Entra ID – Multilocatário)” também pode ser usada caso você vá compartilhar este aplicativo entre vários locatários.

4. Você pode ignorar as configurações de URI de redirecionamento por enquanto (descritas na Etapa 6).

5. Clique em “Registrar” para criar o aplicativo. Uma página com os detalhes do seu aplicativo recém-criado será exibida.

6. Vá para as configurações de autenticação e, em “Configurações da plataforma”, clique em “Adicionar uma plataforma”.

   1. Selecione Web e liste todas as URLs de redirecionamento para seu aplicativo do Microsoft Entra ID.

   2. Para as URLs, preencha a(s) URL(s) nas quais a interface de usuário da Web do servidor do MyQ está acessível no seguinte formato:https://{hostname:port}/auth (por exemplo, https://print.acme.com/auth).

   3. Clique em “Configurar”.

      

7. Na página Visão geral do aplicativo, salve o ID do aplicativo (cliente) e o ID do diretório (locatário), pois eles são necessários para a configuração do MyQ.

8. Clique em “Adicionar um certificado ou segredo” ao lado de “Credenciais do cliente” e siga as etapas a seguir:

   

   1. Clique em Novo segredo de cliente.

   2. Adicione uma Descrição.

   3. Defina a validade da chave.

   4. Clique em “Adicionar”.

   5. Salve o valor da chave secreta do cliente, pois você precisará dele para a configuração no MyQ e não poderá recuperá-lo posteriormente.

Configure a identidade visual do MyQ X para o aplicativo

Antes de continuar, baixe o logotipo do MyQ X que você usará mais tarde ao configurar o visual e a identidade visual do aplicativo.

1. Na página “Propriedades e marca” do aplicativo, ajuste o seguinte:

   1. Nome: deve ser configurado como MyQ X, conforme feito nas etapas anteriores.

   2. Carregar novo logotipo: selecione o logotipo do MyQ X baixado anteriormente.

   3. URL da página inicial: forneça o link para o qual o aplicativo direcionará os usuários quando eles clicarem nele no portal “Meus aplicativos”; as opções são:

      1. use a URL da interface web do MyQ do seu servidor autônomo ou do servidor do local (se este aplicativo for usado apenas por um local) ou do servidor central.

      2. use o site do MyQ: https://myq-solution.com.

      3. insira a URL do seu site de intranet a partir do qual os usuários podem acessar o MyQ X (opcional).

   4. URL dos Termos de Serviço: Políticas e Documentos Legais | MyQ Solution | MyQ (myq-solution.com).

   5. URL da declaração de privacidade: Políticas e Documentos Legais | MyQ Solution | MyQ (myq-solution.com).

2. Clique em Salvar.

Visibilidade do aplicativo MyQ X no portal “Meus aplicativos”

Torne o aplicativo MyQ X visível para os usuários em “Meus aplicativos”

1. No Portal do Azure, digite “Aplicativos corporativos” na caixa de pesquisa e abra essa seção.

2. Encontre o aplicativo (ou seja, MyQ X) que você criou anteriormente em “Registros de aplicativos”.

3. Na página “Propriedades”, configure o seguinte:

   1. Permitir que os usuários façam login?: Não

   2. Visível para os usuários?: Sim

4. Mesmo aqui, você pode configurar o logotipo do aplicativo (veja a seção “Configurar a identidade visual do MyQ X para o aplicativo” mais acima neste artigo).

5. Clique em “Salvar”.

O aplicativo ficará visível para seus usuários no portal “Meus aplicativos”. Ao clicarem nele, eles serão direcionados para a URL definida em “URL da página inicial”.

Ocultar o aplicativo MyQ X dos usuários

1. No Portal do Azure, digite “Aplicativos corporativos” na caixa de pesquisa e abra essa seção.

2. Encontre o aplicativo que você criou anteriormente em “Registros de aplicativos”.

3. Na página “Propriedades”, configure o seguinte:

   1. Permitir que os usuários façam login?: Não

   2. Visível para os usuários?: Não

4. Clique em “Salvar”.

O aplicativo não ficará visível para seus usuários no portal "Meus aplicativos".

Atualize as permissões do aplicativo para serviços específicos

Agora você pode conceder a este aplicativo permissão para ler usuários em seu locatário para sincronização do Entra ID e para acessar o OneDrive for Business e o SharePoint Online em seu ambiente MyQ X.

Para sincronização e autenticação de usuários do Entra ID

1. Na tela “Visão geral” do aplicativo, acesse “Permissões de API” e clique em “Adicionar uma nova permissão”:

   1. Selecione “API do Microsoft Graph” e o tipo de permissão (Delegada ou de Aplicativo).
      Adicione as seguintes permissões:

      1. Microsoft Graph – Aplicativo: Group.Read.All.

      2. Microsoft Graph – Aplicativo: User.Read.All.

      3. (Microsoft Graph – Delegada: User.Read é adicionada por padrão).

2. Use “Conceder consentimento de administrador para {Nome do diretório}” para definir o status das permissões como “Concedido”. Isso precisa ser definido em todas as permissões que exigem consentimento de administrador.

Para o OneDrive para Empresas

1. Acesse as configurações de autenticação e, em “Configurações da plataforma”, clique em “Adicionar uma plataforma”.

   1. Na caixa “URI de redirecionamento”, escolha “Web” e adicione https://helper.myq.cz/.

2. Na página “Permissões de API”, clique em “Adicionar uma permissão”. O painel “Solicitar permissões de API” é exibido. Adicione as seguintes permissões:

   1. Microsoft Graph – Delegado/Aplicativo: Files.ReadWrite (leia mais informações abaixo).

   2. Microsoft Graph – Delegada: User.Read (essa permissão é adicionada por padrão e não pode ser editada).

3. Use “Conceder consentimento de administrador para {Nome do diretório}” para definir o status das permissões como “Concedido”. Isso precisa ser definido em todas as permissões que exigem consentimento de administrador.

Para o SharePoint Online

1. Acesse as configurações de autenticação e, em “Configurações da plataforma”, clique em “Adicionar uma plataforma”.

   1. Na caixa URI de redirecionamento, escolha Web e adicione https://helper.myq.cz/.

2. Na página “Permissões da API”, clique em “Adicionar uma permissão”. O painel “Solicitar permissões da API” é exibido. Adicione as seguintes permissões:

   1. Microsoft Graph – Delegada - ou - Aplicativo: Sites.Read.All (leia mais informações abaixo).

   2. Microsoft Graph – Delegada - ou - Aplicativo: Sites.ReadWrite.All (leia mais informações abaixo).

   3. Microsoft Graph – Delegado: User.Read (essa permissão é adicionada por padrão e não pode ser editada).

3. Use “Conceder consentimento de administrador para {nome do diretório}” para definir o status das permissões como “Concedido”. Isso precisa ser definido em todas as permissões que exigem consentimento de administrador.

Configuração no MyQ

Com o aplicativo criado, personalizado com a marca (opcional), publicado para visibilidade (opcional) e atualizado com as permissões necessárias relacionadas aos serviços que você utilizará, você pode prosseguir com a conexão do aplicativo ao MyQ X.

Conecte o MyQ X aos serviços da Microsoft

Leia mais para saber como criar:

• Conector Entra ID

• Conector do OneDrive for Business

• Conector do SharePoint Online

Sincronização do Entra ID e “Entrar com a Microsoft”

Este conector do Microsoft Entra ID agora pode ser usado para configurar a sincronização e a autenticação de usuários. Consulte os manuais a seguir:

1. Adicionar um servidor de autenticação do Microsoft Entra ID no MyQ, em Configurações, Servidores de Autenticação.

2. Adicionar uma fonte de sincronização do Microsoft Entra ID no MyQ, em Configurações, Sincronização de Usuários.

Easy Scan e Easy Print com o OneDrive para Empresas

Você pode adicionar uma conexão para o OneDrive for Business a fim de disponibilizar esse armazenamento nas suas Ações do Terminal (Easy Print e Easy Scan) como fonte/destino para impressão e digitalização, respectivamente.

Continue para:

1. Adicionar conexão do OneDrive for Business no MyQ, em Configurações, Conexões

2. Crie uma ação “Easy Scan” para o OneDrive for Business em Configurações, Ações do Terminal

3. Criar ação “Impressão Fácil” a partir do OneDrive for Business em Configurações, Ações do Terminal

Easy Scan e Easy Print com o SharePoint Online

Você pode adicionar uma conexão com o SharePoint Online para disponibilizar esse armazenamento em suas Ações do Terminal (Easy Print e Easy Scan) como origem/destino para impressão e digitalização, respectivamente.

Continue para:

1. Adicionar conexão do SharePoint Online no MyQ, em Configurações, Conexões

2. Crie a ação “Digitalização Fácil” para o SharePoint Online em Configurações, Ações do Terminal

3. Criar ação “Impressão Fácil” a partir do SharePoint Online em Configurações, Ações do Terminal