Criar uma SharePoint conexão

O serviço de Faturamento Eletrônico pode ler arquivos de pastas do Microsoft SharePoint e carregar arquivos no SharePoint. Para garantir que o faturamento eletrônico possa acessar um site específico do SharePoint, você deve fornecer as credenciais do site ao serviço de Faturamento Eletrônico. Além disso, para garantir que as credenciais sejam armazenadas de forma segura, não as forneça diretamente. Em vez disso, armazene-as em um Azure Key Vault e forneça um segredo do Key Vault.

Conceder acesso a uma do pasta SharePoint

1. Crie um registro de aplicativo no locatário em que o RCS (Regulatory Configuration Service) está instalado.

   1. Entre no portal do Azure.
   2. Vá para Registros de aplicativos.
   3. Selecione Novo registro.
   4. Insira um nome, como Aplicativo SharePoint para faturamento eletrônico, e conclua o registro.
   5. Selecione o registro do novo aplicativo.
   6. Na guia Autenticação, habilite a opção Permitir fluxos de cliente público.
   7. Na guia Certificados e segredos, selecione Novo segredo de cliente para criar um segredo de cliente.
   8. Copie o valor do segredo que foi criado.

   Siga estas diretrizes:

   • Não use o mesmo registro de aplicativo para serviços diferentes.
   • Siga as recomendações de diretiva de senha.
   • Configure a rotação de senhas. Durante a rotação, crie um novo segredo de cliente para o registro do aplicativo, atualize o cofre de chaves e exclua o segredo antigo.

2. Salve os valores de Segredo do Registro de aplicativo e ID (cliente) do aplicativo como dois segredos novos no cofre de chaves na configuração do seu ambiente de faturamento eletrônico.

3. Adicione os segredos que você criou aos parâmetros do cofre de chaves na configuração do seu ambiente de faturamento eletrônico no RCS.

4. No portal do Azure, conceda acesso ao SharePoint. Essa etapa deve ser concluída pelo administrador do locatário.

   1. Selecione o registro de aplicativo que você criou.

   2. Na guia Permissões de API, selecione Adicionar uma permissão.

   3. Selecione Microsoft Graph (permissões de aplicativo)>Sites.Selected.

   4. Selecione Conceder consentimento de administrador para <nome de usuário>.

   5. Revise o campo Status para verificar se as permissões foram concedidas.

      

   6. Abra o Explorador de gráficos e entre.

   7. No painel esquerdo, na guia Consultas de exemplo, em Sites do SharePoint, selecione obter site com base no caminho relativo do site do SharePoint.

   8. Preencha os parâmetros {host-name} e {server-relative-path}. Por exemplo, preencha <domain>.sharepoint.com para {host-name} e sites/<siteName> para {server-relative-path}.

      Observação

      Para o site padrão, deixe o parâmetro {server-relative-path} em branco.

   9. Selecione Executar consulta e salve o resultado.

   10. Configure a consulta a seguir.

       POST https://graph.microsoft.com/v1.0/sites/{site-id}/permissions

       Nessa consulta, {site-id} é o valor do nó id da resposta de consulta anterior.

       Veja o corpo da solicitação.

       {
           "roles": [
               "read",
               "write"
           ],
           "grantedToIdentities": [
               {
                   "application": {
                       "id": "{app-id}",
                       "displayName": "{app-name}"
                   }
               }
           ]
       }
       

       Neste corpo da solicitação, {app-id} é o valor ID (cliente) do aplicativo e {app-name} é o valor do Nome do aplicativo.

       

   11. Na guia Permissões de modificação, selecione Abrir o painel permissões e, em seguida, selecione Sites>Sites.FullControl.All>Consentimento.

   12. Selecione Executar consulta.

Agora, o serviço de Faturamento Eletrônico tem acesso ao seu site do SharePoint.