Ir para o conteúdo

Guia de Conexão OAuth do Microsoft SharePoint

Pré-requisitos

  • Você deve estar no Vinyl versão 3.3 ou posterior
  • Você deve ter uma conta Microsoft Azure

Crie um Provedor de Segurança OAuth

Aqui você criará um provedor de segurança OAuth no Vinyl.

  1. Navegue até a seção Provedores de segurança do IDE e crie um novo provedor de segurança usando o botão + Autenticação de fonte de dados

  2. Forneça os seguintes detalhes:

    • Nome - Identifica o Provedor de Segurança e aparece na URL. Exemplo: OAuth
    • Tipo - OAuth
    • Ativado - marque para ativar este provedor de segurança
    • OAuth Grant - Código de autorização
    • Autenticação de cliente OAuth - Básico
    • Autenticação de recurso OAuth - Portador
    • Redirecionar no Desafio - Verdadeiro

  3. Clique em Salvar

Criar Registro de Aplicativo do Microsoft Azure

Em seguida, você registrará um aplicativo no Microsoft Azure e configurará ainda mais o provedor de segurança OAuth no Vinyl.

  1. Navegue até portal.azure.com e faça login

  2. Clique em ID de entrada da Microsoft

    entraid.png

  3. Navegue até Registros de aplicativos

  4. Clique em Novo cadastro
  5. Atribua um Nome do aplicativo. Exemplo: OAuth

  6. Na seção URI de redirecionamento (opcional):

    • Selecione Web na lista Selecionar uma plataforma
    • Insira o URI do provedor de segurança na instância do Vinyl. O formato do URL de redirecionamento deve ser https://<Vinyl-Instance>/signin-<Security-Provider-Name>.

    redirecturi.png

  7. Clique em Registrar

  8. Clique em Permissões de API
  9. Clique em Adicionar uma permissão
  10. Clique no ficha SharePoint
  11. Selecione a opção Permissões delegadas
  12. Expanda Todos os Sites

  13. Marque para ativar as seguintes permissões:

    • Gerenciamento de todos os sites
    • Todos os sites lidos
    • Escrita em todos os sites

  14. Exe Projeto sob permissões

  15. Marque para ativar ProjectRead e ProjectWrite
  16. Clique no botão Adicionar permissões
  17. Clique em Visão geral

  18. Clique na aba Endpoints

    • A tela Endpoints contém valores necessários durante a configuração dos Endpoints do provedor de segurança no Vinyl

    endpointconfig_copy.png

  19. Clique em Adicionar um certificado ou segredo em Credenciais do cliente

  20. Clique em + Novo segredo do cliente
  21. Insira uma Descrição
  22. Selecione uma data de validade

  23. Clique no botão Adicionar

    • O segredo do cliente Valor será necessário para configuração da credencial no Vinyl

  24. Navegue de volta para os detalhes do fornecedor no Vinyl

  25. Clique em + Endpoints no painel Enpoints e configure os seguintes endpoints:

    • Endpoint de autorização: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/authorize/
    • Endpoint do token: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/token/

  26. Clique em + Credencial:

    • Tipo - Cliente
    • Nome de usuário - ID do aplicativo (cliente) do Microsoft Azure
    • Senha - Valor secreto do cliente do Microsoft Azure

  27. Clique em Salvar e saia do pop-up

  28. Clique em + Propriedade no painel Propriedades
  29. Insira o URL no campo Valor. O valor do URL deve ser https://<companyname>.sharepoint.com/.default offline_access
  30. Clique em Salvar
  31. Feche o pop-up

Vinylconfig.png

Crie uma Fonte de Dados do Microsoft SharePoint

Por último, você criará uma fonte de dados do Microsoft SharePoint no Vinyl e importará os dados do SharePoint.

  1. Navegue até o IDE
  2. Clique em Servidores de dados
  3. Clique no botão + Servidor
  4. Insira um nome no campo Nome do servidor. Exemplo: SharePoint
  5. Selecione Microsoft SharePoint na lista Tipo

  6. No campo Url, insira o caminho completo para o diretório SharePoint da empresa que você está acessando. O formato do URL deve ser https://<companyname>.sharepoint.com/sites/<directory>

    dataserver.png

  7. Expanda Configurações de segurança

  8. Selecione o provedor de segurança OAuth configurado na lista Provedor de segurança
  9. Clique em Salvar
  10. Feche o pop-up
  11. Clique em Detalhes no painel direito
  12. Clique no botão Importar
  13. Siga o fluxo OAuth
  14. Clique na aba Visualizações
  15. Clique no botão Importar esquema no esquema que você deseja importar. Exemplo: listas
  16. Navegue até o IDE
  17. Clique em Servidores de dados
  18. Clique em Detalhes no painel direito
  19. Clique no botão Lógica
  20. Clique no ícone Resultados do conteúdo importado para confirmar os dados