Conector para o Microsoft OneDrive

Com o conector Microsoft® OneDrive®, você pode usar os comandos em uma cadeia para gerenciar arquivos e pastas no Microsoft OneDrive ou no SharePoint®. Por exemplo, com esse conector, você pode:

Copiar, excluir e pesquisar arquivos e pastas
Download e upload de arquivos
Listar unidades disponíveis

Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Pré-requisitos

Para habilitar a conexão, o conector usa a API do Microsoft Graph. Para proteger a conexão, o conector usa a autenticação OAuth por meio de um aplicativo designado registrado no portal de registro de aplicativos da Microsoft ou no Azure® Active Directory®.

Para configurar o conector, você precisará de:

Um aplicativo registrado no portal de registro de aplicativos da Microsoft ou no Azure Active Directory. Registre o ID do seu aplicativo
A ID e o segredo do cliente OAuth do aplicativo do Azure
Os escopos do aplicativo do Azure, apropriados para os comandos que o conector executará
O tipo e o ID da unidade à qual você se conectará.

Nota : Você pode usar o Graph Explorer da Microsoft para recuperar esses dados do SharePoint.
O URI de redirecionamento do projeto:

Exemplo de configuração do Microsoft Azure para OneDrive

Registro de um aplicativo

Faça login no Portal do Microsoft Azure: https://azure.microsoft.com/en-us/account/
Acesse os serviços do Azure Active Directory no .
Acesse , na seção “Registros de aplicativos” ( ), em “Gerenciar”, e clique em “ ” (Novo registro) .
Insira o nome desejado para o aplicativo , e, em seguida, clique em . Cadastre-se em .

Configure a autenticação do aplicativo

Faça login no Portal do Microsoft Azure: https://azure.microsoft.com/en-us/account/
Acesse os serviços do Azure Active Directory no .
Acesse , na seção “Registros de aplicativos” , em “Gerenciar”.
Acesse “ ” > “Autenticação” > “ ” no painel “Gerenciar” atualizado.
Em “Tipos de conta compatíveis”, selecione Contas do em qualquer diretório organizacional (Qualquer locatário do Microsoft Entra ID – Multilocatário) .
Na seção “Adicionar uma plataforma”, selecione “ ” (Web ).
Em “ ” (Redirecionamento do URL de retorno), em “ ”, insira o URL de retorno válido indicado acima.
Certifique-se de marcar a caixa de seleção “ ” (MultiTenant) na seção “ ” (Tipos de contas compatíveis) .

Observação: Como o Conector do OneDrive exige que a opção MultiTenant seja ativada, cabe aos administradores do Azure garantir que os aplicativos sejam configurados corretamente para conformidade com a segurança. Essa opção, quando usada corretamente com a segurança do Azure, não abre o aplicativo para todos. A seguir, você encontrará sugestões de etapas adicionais que podem ser executadas.

Consulte a documentação do da Microsoft relacionada à configuração do MultiTenant.
Ative a segurança no aplicativo específico, seguindo as instruções da Microsoft em sobre como restringir o acesso ao seu aplicativo a um grupo de usuários .
Atribua/permita o acesso dos usuários ao aplicativo seguindo as instruções da Microsoft em e atribuindo o aplicativo a usuários e grupos .

Configuração de certificados e segredos

Faça login no Portal do Microsoft Azure: https://azure.microsoft.com/en-us/account/
Acesse os serviços do Azure Active Directory no .
Acesse , na seção “Registros de aplicativos” ( ), em “ ” (Gerenciar) .
Acesse “ ” > “Certificates” > “ ” no painel atualizado “ ” > “Manage” > “ ”.
Clique em “ ” (Gerar novo segredo de cliente) no painel central.
Após fornecer uma breve descrição do e , bem como a data de validade , será exibido um segredo do cliente. Isso precisa ser guardado para fins de segurança e para ser inserido no conector do Microsoft OneDrive.

Configurando as permissões de API

Faça login no Portal do Microsoft Azure: https://azure.microsoft.com/en-us/account/
Acesse os serviços do Azure Active Directory no .
Acesse , na seção “Registros de aplicativos” ( ), em “ ” (Gerenciar) .
Acesse “Permissões da API do ” no painel atualizado “ ” Gerenciar .
Clique em “ ” (Adicionar uma permissão) no painel central.
Escolha Microsoft Graph na seção Microsoft APIs .
Escolha “ ” (Permissões de delegado) como o “ ” (Tipo de solicitação) .
Da lista de permissões, você precisará de:
User.Read , tudo o que estiver em FILES e OpenId.offline_access .
Clique em e conceda permissão de administrador .
Defina o nível de acesso exigido pelo conector. Os
seguintes escopos do são compatíveis com o conector do Microsoft OneDrive:
- Arquivos.LeituraEGravação.Selecionado
- Arquivos.Leitura e Gravação.Pasta do Aplicativo
- Files.ReadWrite.All
- Arquivos.Leitura e Gravação
- Files.Read.Selected
- Files.Read.All
- Files.Read
- acesso_offline

É necessário, no mínimo, um escopo offline_access .

Por que os métodos Files.Read.All e Files.ReadWrite.All são necessários

O Conector do Workiva para o OneDrive se comunica com seu ambiente da Microsoft por meio da API do Microsoft Graph, utilizando permissões delegadas do OAuth — o que significa que o conector se autentica e age em nome de um usuário autenticado.

Por que o Sites.Selected não pode ser usado

Sites.Selected é uma permissão específica do SharePoint projetada para fluxos de acesso no nível do aplicativo (somente aplicativo); ela não é compatível com o modelo de permissão delegada utilizado pelo conector Workiva. Além disso, restringe o acesso apenas a sites do SharePoint pré-aprovados, o que impede que o conector execute operações dinâmicas baseadas em caminho, como Pesquisar, Copiar item e Excluir item.

Como habilitar a segurança

Faça login no Portal do Microsoft Azure: https://azure.microsoft.com/en-us/account/
Acesse os serviços do Azure Active Directory no .
Clique em Aplicativos corporativos em Gerenciar .
Selecione o aplicativo na lista para iniciar o processo de edição. Se o seu aplicativo não estiver listado por padrão, clique em Todas as aplicações na seção Gerenciar .
Clique em “ ” (Propriedades) na seção “ ” (Gerenciar) .
Na tela “ ” (Propriedades) , defina as seguintes propriedades para permitir o uso do acesso à API criado acima:

Está habilitado para que os usuários façam login? = Sim

É necessária a atribuição de usuário? = Sim

(Opcional) Visível para os usuários? = Não
Clique em “ ”, “Usuários e Grupos” ( ) na seção “ ”, em “Gerenciar” ( ).
Agora você pode usar os processos padrão do Azure AD para adicionar seus usuários conforme necessário. Esta
é a lista de usuários autorizados a usar o OneDrive e que possuem uma licença válida do Microsoft OneDrive.

Configure o conector do Microsoft OneDrive

Observação: Para disponibilizar o conector para uso nas cadeias da sua organização, um administrador de segurança da organização deve primeiro ativá-lo em Configuração.

No site , na seção “Chain Builder” ( ), clique em “ ” (Connections) ( ) compare_arrows e, em seguida, em “ ” (Create) ( ) no canto superior direito.
Em “ ” (Conectores) > “Connection” (Conexão) , selecione “ ” (Microsoft OneDrive) e o CloudRunner padrão.
Em Informações básicas, insira um nome e uma descrição únicos para ajudar a identificar o conector.
Em OAuth, insira o ID e o segredo do cliente OAuth para o aplicativo Azure do conector.
Para determinar o nível de acesso do conector, insira o escopo de autenticação do aplicativo do Azure.
É necessário, no mínimo, o escopo offline_access .
Para autorizar a conexão e as credenciais do OAuth, clique em Connect.

Em Propriedades, digite os detalhes da conexão:

Propriedade	Detalhes
Tipo de unidade	Selecione o tipo de unidade à qual você deseja se conectar, como Drive, Grupo, Usuário ou Site. Para acessar sua unidade de usuário, selecione “ ” > “Current User (Me)” > “ ”.
ID do tipo de unidade	Digite o ID da unidade à qual você deseja se conectar, com base em Tipo de unidade. Por exemplo, se o tipo de unidade d , , for “Usuário”, insira o ID do usuário; se for “Site”, insira o ID do site.

Observação: Você pode usar o Graph Explorer da Microsoft para recuperar esses dados do SharePoint.

Selecione os ambientes a serem usados com a conexão e clique em Salvar.
Para testar a conexão, crie e execute uma cadeia com o comando Baixar arquivo do conector e verifique se ele retorna uma saída válida.

Solução de problemas

Se a conexão com o Microsoft OneDrive ou o SharePoint falhar:

Verifique se as credenciais OAuth do aplicativo Azure do conector estão presentes, corretas e válidas. As credenciais OAuth têm datas de validade definidas, e o certificado pode ter expirado. Se esse for o caso, você precisará criar um novo certificado e inserir o novo segredo do cliente no Conector. Consulte
Configurando certificados e segredos para obter detalhes sobre como criar um novo segredo.
Verifique o tipo de unidade e a ID inseridos para o conector. Você pode usar o Graph Explorer da Microsoft ( ) para recuperar esses dados do SharePoint.
Verifique o URI de redirecionamento do projeto:

Centro de suporte da Workiva