Módulos do Microsoft SharePoint Online

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront	Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration Workfront Ultimate Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion.
Licenças do Adobe Workfront	Padrão Trabalho ou maior
Licença do Adobe Workfront Fusion	Baseado em operação: disponível para organizações com licenças baseadas em operação Baseado em conector (legado): Workfront Fusion for Work Automation and Integration
Produto	Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação.

Para obter informações sobre licenças do Adobe Workfront Fusion, consulte Licenças do Adobe Workfront Fusion.

Expanda para exibir instruções para conectar o Microsoft SharePoint Online ao Workfront Fusion usando uma conta do Microsoft.

Você pode usar sua conta do Microsoft para criar uma conexão com o Microsoft SharePoint Online. Para obter instruções sobre como conectar sua conta do Sharepoint ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.

Expanda para exibir instruções para conectar o Microsoft SharePoint Online ao Workfront Fusion usando configurações avançadas.

Para incluir credenciais na conexão, habilite a opção Mostrar configurações avançadas. Para esse tipo de conexão, você precisa de uma ID do cliente, um Segredo do cliente e uma ID do locatário.

1. Em qualquer módulo do SharePoint, clique em Adicionar próximo ao campo Conexão para abrir a caixa Criar uma conexão.

2. Clique em Mostrar configurações avançadas.

3. Preencha os seguintes campos:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Connection type	Para usar as credenciais do cliente, selecione Email do Microsoft 365.
   Connection name	Insira um nome para a conexão.
   Client ID	Insira a ID do cliente do aplicativo SharePoint ao qual você está se conectando.
   Segredo do cliente	Insira o segredo do cliente para o aplicativo SharePoint ao qual você está se conectando.
   ID de Locatário	Insira a ID do locatário do aplicativo SharePoint ao qual você está se conectando.

4. Clique em Continuar para salvar a conexão e retornar ao módulo.

Expanda para exibir instruções para conectar o Microsoft SharePoint Online ao Workfront Fusion usando a autorização de certificado.

Você pode usar a autorização de certificado para se conectar ao SharePoint.

note important
IMPORTANT
Para usar a autorização do certificado, primeiro você deve criar um aplicativo no Microsoft Entra e carregar o certificado lá.
Para obter instruções, consulte Como configurar autoridades de certificação para autenticação baseada em certificado do Microsoft Entra na documentação do Microsoft.

1. Em qualquer módulo do SharePoint, clique em Adicionar próximo ao campo Conexão para abrir a caixa Criar uma conexão.

2. Clique em Mostrar configurações avançadas.

3. Preencha os seguintes campos:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Connection type	Para usar autorização de certificado, selecione Microsoft SharePoint Online (Autenticação do Certificado).
   Connection name	Insira um nome para a conexão.
   Client ID	Insira a ID do cliente do aplicativo SharePoint ao qual você está se conectando.
   Impressão Digital	Insira a impressão digital do aplicativo SharePoint ao qual você está se conectando.
   Private key	Insira o certificado ou a chave privada que foi gerada quando suas credenciais foram criadas no Microsoft. Para extrair a chave privada ou o certificado: Clique em Extract. Selecione se você está extraindo um certificado ou uma chave privada. Selecione o tipo de arquivo que você está extraindo. Selecione o arquivo que contém a chave privada ou o certificado. Insira a senha do arquivo. Clique em Save para extrair o arquivo e retornar à configuração de conexão.

4. Clique em Continuar para salvar a conexão e retornar ao módulo.

Expanda para exibir instruções para conectar o Microsoft SharePoint Online ao Workfront Fusion usando uma entidade de serviço.

Você pode criar uma conexão que use uma entidade de serviço (uma conexão da API do aplicativo) em vez de uma conta pessoal. Isso é útil quando você deseja que a conexão seja executada como uma identidade de aplicativo ou serviço, em vez de uma pessoa específica — por exemplo, para que a integração não seja interrompida se essa pessoa sair da empresa ou alterar sua senha.

note important
IMPORTANT
Este tipo de conexão está disponível somente para o módulo Fazer uma Chamada de API. Outros módulos do SharePoint exigem um dos outros tipos de conexão descritos neste artigo.

• Pré-requisitos para conectar o Microsoft SharePoint Online ao Workfront Fusion usando uma entidade de serviço
• Criar o registro do aplicativo na Microsoft Entra ID
• Criar um segredo do cliente
• Conceder permissões de API
• Coletar detalhes da conexão
• Criar a conexão

Pré-requisitos para conectar o Microsoft SharePoint Online ao Workfront Fusion usando uma entidade de serviço

Você precisa de acesso de Administrador Global, Administrador de Aplicativos ou Administrador de Função Privilegiada à Microsoft Entra ID para registrar o aplicativo e conceder permissões. Se você não tiver esse acesso, peça a alguém da sua equipe de TI ou de identidade que conclua essas etapas para você.

Prossiga para Criar o registro do aplicativo na Microsoft Entra ID.

Criar o registro do aplicativo na Microsoft Entra ID (Entidade de serviço)

1. Entre no centro de administração Microsoft Entra.
2. Ir para Registros de aplicativo > Novo registro.
3. Dê ao aplicativo um nome claro e reconhecível. Por exemplo, Make - SharePoint Integration.
4. Deixe URI de redirecionamento em branco. Essa conexão não envolve ninguém que faça logon por meio de um navegador.
5. Selecione Registrar.
6. Continue em Criar um segredo de cliente.

Criar um segredo do cliente (Entidade de serviço)

1. No novo registro do aplicativo, acesse Certificados e segredos.
2. Selecione Novo segredo do cliente, adicione uma descrição e escolha um período de expiração.
3. Selecione Adicionar.
4. Copie o Valor do segredo imediatamente. É exibido apenas uma vez. Se você navegar para fora antes de copiá-lo, deverá criar um novo.
5. Continue em Conceder permissões de API.

Conceder permissões de API (Entidade de serviço)

1. No registro do seu aplicativo, acesse Permissões de API.
2. Selecione Adicionar uma permissão e Gráfico do Microsoft.
3. Selecione Permissões do aplicativo.
4. Selecione a(s) permissão(ões) necessária(s) para suas chamadas de API e Adicionar permissões.
5. Selecione Conceder consentimento administrativo à sua organização e, em seguida, confirme.
6. Prossiga para Coletar detalhes da conexão.

Coletar seus detalhes de conexão (Entidade de serviço)

Na página Visão geral do registro do aplicativo, observe os seguintes valores. Você os insere ao criar a conexão no módulo.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
ID de Locatário	Na página Visão Geral, rotulada ID do Diretório (locatário).
Client ID	Na página Visão Geral, rotulada ID do Aplicativo (cliente).
Client Secret	O valor copiado em Criar um segredo de cliente.

Continue em Criar a conexão.

Criar a conexão (Entidade de serviço)

1. No módulo Fazer uma Chamada de API, clique em Adicionar próximo ao campo Conexão para abrir a caixa Criar uma conexão.

2. Clique em Mostrar configurações avançadas.

3. No campo Tipo de conexão, selecione Entidade de Serviço.

4. Insira o seguinte:

   • ID do inquilino
   • ID do cliente
   • Segredo do cliente

5. Clique em Continuar para salvar a conexão e retornar ao módulo.

   Se tudo estiver configurado corretamente, a conexão será validada com êxito.

Expanda para exibir instruções para conectar o Microsoft SharePoint Online ao Adobe Workfront Fusion usando uma conexão federada.

Uma conexão federada funciona como a conexão principal de serviço, exceto por não usar um segredo de cliente.
Em vez de armazenar um segredo, você informa ao Microsoft Entra ID para confiar em tokens que o Workfront Fusion emite para uma conexão específica. Quando a conexão é executada, o Fusion apresenta uma prova de identidade de curta duração e o Microsoft Entra ID retorna um token de acesso. Como não há segredo do cliente, não há nada que expire e nenhum segredo para girar ou armazenar.

note
NOTE
A configuração dessa conexão leva duas visitas ao centro de administração do Microsoft Entra. Registre o aplicativo primeiro, crie a conexão no Workfront Fusion e retorne ao Microsoft Entra ID para adicionar a credencial federada. Isso ocorre porque a credencial federada identifica uma conexão específica e esse identificador não existe até que a conexão seja criada.

• Pré-requisitos para conectar o Microsoft SharePoint Online ao Workfront Fusion usando uma conexão federada
• Criar o registro do aplicativo na Microsoft Entra ID (Federated connection)
• Conceder permissões de API (conexão Federada)
• Coletar detalhes da conexão (Conexão federada)
• Criar a conexão no Workfront Fusion (conexão Federada)
• Adicionar a credencial federada na Microsoft Entra ID (conexão Federada)
• Verificar a conexão (Conexão federada)
• Solução de problemas

Pré-requisitos para conectar o Microsoft SharePoint Online ao Workfront Fusion usando uma conexão federada

Você precisa de acesso de Administrador Global, Administrador de Aplicativos ou Administrador de Função Privilegiada no Microsoft Entra ID para registrar o aplicativo, conceder permissões e adicionar a credencial federada. Se você não tiver esse acesso, peça a alguém da sua equipe de TI ou de identidade que conclua essas etapas para você.

Criar o registro do aplicativo na Microsoft Entra ID (Federated connection)

1. Faça logon no centro de administração do Microsoft Entra.
2. Acesse Registros do aplicativo > Novo registro.
3. Dê ao aplicativo um nome claro e reconhecível. Por exemplo, Workfront Fusion SharePoint Integration.
4. Deixe o URL de redirecionamento em branco. Essa conexão não envolve ninguém que faça logon por meio de um navegador.
5. Selecione Registrar.
   Não crie um segredo de cliente. Uma conexão federada não usa uma.
6. Continue para Conceder permissões de API.

Conceder permissões de API (conexão Federada)

1. No registro do seu aplicativo, acesse Permissões de API.
2. Selecione Adicionar uma permissão e Gráfico do Microsoft.
3. Selecione Permissões do aplicativo.
4. Selecione a(s) permissão(ões) necessária(s) para suas chamadas de API e Adicionar permissões.
5. Selecione Dar consentimento administrativo para sua organização e confirme.
6. Prossiga para Coletar detalhes da conexão.

Coletar detalhes da conexão (Conexão federada)

1. Na página Visão geral do registro do aplicativo, observe os seguintes valores. Você os insere ao criar a conexão no módulo.

   table 0-row-2 1-row-2 layout-auto html-authored no-header
   ID de Locatário	Na página Visão Geral, rotulada ID do Diretório (locatário).
   Client ID	Na página Visão Geral, rotulada ID do Aplicativo (cliente).

2. Continue em Criar a conexão no Workfront Fusion.

Criar a conexão no Workfront Fusion (conexão Federada)

1. No módulo Fazer uma chamada de API, clique em b próximo ao campo Conexão para abrir a caixa Criar uma conexão.

2. Clique em (Federated connection).

3. No campo Tipo de conexão, selecione o tipo de conexão federada.

4. Insira o seguinte:

   • ID do inquilino
   • ID do cliente

5. Selecione Criar.
   O Workfront Fusion exibe três valores. Você as usa no próximo procedimento.

   table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
   Emissor	Sempre https://oidc.automations.adobe.com.
   Assunto	Identifica esta conexão. Parece com fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. É diferente para cada conexão criada.
   Público-alvo	Sempre api://AzureADTokenExchange.

6. Deixe este painel aberto e copie o valor de Assunto.

   note
   NOTE
   Não feche o painel nem selecione Cancelar. A conexão não será concluída até que você conclua os procedimentos restantes. Se fechar o painel, você deverá excluir a conexão e iniciar novamente, pois uma nova conexão recebe um novo Assunto.

7. Continue para Adicionar a credencial federada na Microsoft Entra ID.

Adicionar a credencial federada na Microsoft Entra ID (conexão Federada)

Esse procedimento substitui o segredo do cliente. Ele instrui o Microsoft Entra ID a aceitar tokens que o Workfront Fusion emite para essa conexão única.

1. Em uma nova guia do navegador, retorne ao centro de administração do Microsoft Entra e abra o registro do aplicativo.

2. Vá para Certificados e segredos > Credenciais federadas.

3. Selecione Adicionar credencial.

4. Em Cenário de credencial federada, selecione Outro emissor.

5. Insira o seguinte:

   table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
   Emissor	https://oidc.automations.adobe.com.
   Identificador de Assunto	O Assunto copiado do Workfront Fusion. Cole exatamente, sem espaços adicionados.
   Name	Um nome que identifica esta conexão, para que você possa localizá-la posteriormente. Por exemplo, workfront-fusion-connection-28964.
   Público-alvo	api://AzureADTokenExchange. Isso geralmente é preenchido para você. Deixe o valor padrão.

6. Selecione Adicionar.

7. Continue em Verificar a conexão.

Verificar a conexão (Conexão federada)

1. Retorne à guia do navegador Workfront Fusion, onde o painel de conexão ainda está aberto.

2. Selecione Salvar.

   • Se tudo estiver configurado corretamente, a conexão será validada com êxito e você poderá continuar a configuração do módulo.
   • Se a verificação falhar, o painel permanecerá aberto e exibirá o erro. Corrija o problema na Microsoft Entra ID e selecione Salvar novamente. Não é necessário recriar a conexão, e o Assunto não é alterado.

Solução de problemas

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Falha na verificação da conexão com um cliente inválido ou erro de solicitação inválido	A Microsoft Entra ID não pôde corresponder o token a uma credencial federada. Verifique se o Emissor é exatamente https://oidc.automations.adobe.com sem barra à direita e se o identificador de Assunto é idêntico caractere por caractere ao Assunto mostrado no Workfront Fusion. Um Assunto copiado de uma conexão diferente é a causa mais comum.
A conexão é verificada, mas as chamadas de API retornam 403	A identidade é confiável, mas o aplicativo não tem as permissões do Gráfico do Microsoft necessárias para sua chamada. Retorne para Conceder permissões de API, adicionar a permissão de aplicativo necessária e conceder consentimento administrativo.
Não é possível adicionar outra credencial federada	Você atingiu o limite de 20 credenciais federadas para esse registro de aplicativo. Registre um aplicativo adicional e crie outras conexões com ele.