Pacote de integração para SharePoint

  • Artigo

Importante

Esta versão do Orchestrator chegou ao fim do suporte. Recomendamos que você atualize para o Orchestrator 2022.

Os pacotes de integração são complementos para o System Center – Orchestrator. Eles ajudam você a otimizar as operações de TI em ambientes heterogêneos. Usando pacotes de integração, você pode criar runbooks no Orchestrator que usam atividades executadas por outros componentes do System Center, outros produtos da Microsoft e produtos que não são da Microsoft.

Saiba mais sobre a privacidade do Orchestrator.

Este artigo fornece informações sobre o pacote de integração do System Center para o Microsoft SharePoint.

O Pacote de Integração do System Center para Microsoft SharePoint permite a automação de tarefas comuns no SharePoint. Por exemplo, para criar itens de lista, carregar e baixar documentos e monitorar uma lista de alterações.

Requisitos de sistema

O pacote de integração do SharePoint exige que o software a seguir seja instalado e configurado antes da implementação da integração.

  • System Center – Orchestrator
  • Microsoft .NET Framework 4
  • Microsoft SharePoint
  • System Center – Orchestrator 2019
  • Microsoft .NET Framework 4.6.1 ou superior (mais recente .NET Framework recomendado)

Importante

  1. Os destinos do Pacote de Integração do SharePoint (v10.19.38.0 ou superior) .NET Framework 4.6.1. Verifique se .NET Framework Runtime v4.6.1 ou posterior está instalado nos computadores Runbook Designer e Runbook Server. É recomendável instalar a versão mais recente do .NET Framework disponível.

  2. Crie os seguintes arquivos com conteúdo (idêntico) conforme mostrado abaixo para atualizar supportedRuntimeVersion para v4:

    • %systemdrive%/Program Files (x86)/Microsoft System Center/Orchestrator/Runbook Designer/RunbookDesigner.exe.config
    • %systemdrive%/Program Files (x86)/Microsoft System Center/Orchestrator/Runbook Designer/RunbookTester.exe.config
    • %systemdrive%/Program Files (x86)/Microsoft System Center/Orchestrator/Runbook Server/PolicyModule.exe.config

    Conteúdo:

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <startup useLegacyV2RuntimeActivationPolicy="true">
    <supportedRuntime version="v4.0.30319"/>
  </startup>
  <system.xml.serialization>
    <xmlSerializer tempFilesLocation="C:\ProgramData\Microsoft System Center 2012\Orchestrator\Activities\XmlSerializers\"/>
  </system.xml.serialization>
</configuration>
  • System Center – Orchestrator 2022
  • Microsoft .NET Framework 4.7 ou superior (mais recente .NET Framework recomendado)

Baixar o pacote

Registrar e implantar o pacote de integração

Depois de baixar o arquivo do pacote de integração, você deve registrá-lo no servidor de gerenciamento do Orchestrator e implantá-lo em servidores de runbook e Runbook Designers. Saiba mais sobre como instalar o pacote.

O Pacote de Integração do SharePoint executa ações em nome de um usuário que pode acessar seu domínio do SharePoint. O IP é autenticado com o SharePoint como este usuário em dois modos:

  • A autenticação básica (padrão, dá suporte ao SharePoint Online e ao SharePoint local).
  • Autenticação moderna (também conhecida como OAuth) usando o Azure AD (aplicável somente ao SharePoint Online).

Configurar as conexões do pacote para Autenticação Básica

Uma conexão estabelece um vínculo reutilizável entre o Orchestrator e um site do SharePoint. Você pode criar tantas conexões quantas forem necessárias para especificar links para vários sites. Você também pode criar várias conexões com o mesmo servidor, para permitir diferenças nas permissões de segurança para diferentes contas de usuário.

  1. No runbook do Orchestrator Designer, selecione Opções e selecione Microsoft SharePoint.
  2. A caixa de diálogo Microsoft SharePoint é exibida.
  3. Na guia Configurações , selecione Adicionar para iniciar a configuração da conexão. A caixa de diálogo Adicionar Configuração é exibida.
  4. Na caixa Nome, digite um nome para essa conexão. Esse pode ser o nome do site do SharePoint ou um nome descritivo para distinguir o tipo de conexão.
  5. Na caixa Tipo , selecione Configuração do SharePoint.
  6. Na caixa Site do SharePoint, digite a URL do site do SharePoint que contém a lista com a qual você deseja se integrar.
  7. Nas caixas Nome de usuário e Senha, digite as credenciais que o Orchestrator usará para se conectar com o site do SharePoint.
  8. Na caixa Domínio, insira o nome do domínio que autorizará o acesso.
  9. Na caixa SharePoint Online , insira False se a instância do SharePoint for local.
  10. Defina a caixa Utilizar OAuth como False.
  11. Na caixa Intervalo de Monitor Padrão (segundos), insira um valor de tempo limite em segundos ou mantenha o valor padrão.
  12. Na caixa Itens Máximos Padrão, insira um valor máximo ou mantenha o valor padrão.
  13. Selecione OK.
  14. Adicione conexões adicionais, se aplicável, e selecione Concluir.

Configurar as conexões do pacote para Autenticação Moderna (SharePoint Online)

Registre um aplicativo cliente do AD em sua Instância do Azure Active Directory (AD) e configure o IP para usar esse cliente. O IP é autenticado em seu nome; portanto, suas credenciais são necessárias no painel de configuração de IP.

Observação

Esse modo de autenticação tem suporte apenas para o SharePoint Online.

Registrar um aplicativo cliente no Azure AD

Para registrar um aplicativo cliente no Azure AD, siga estas etapas:

  1. Acesse o portal do Azure.

  2. Navegue até Azure Active Directory>Registros de aplicativo e selecione Novo registro para registrar.

  3. Defina um nome aplicável para o aplicativo e escolha o URI de Redirecionamento indicado (cliente público/aplicativo nativo) no menu suspenso.

    Captura de tela da página Registro.

  4. Escolha o tipo de conta dependendo da configuração do AD e se você usa produtos locais e online.

  5. Selecione Registrar.

Visão geral do aplicativo

O ApplicationID e o TenantID são exibidos em Visão geral; anote-os para baixo.

Captura de tela da Visão geral.

URI de redirecionamento

Defina o URI de redirecionamento OAuth. Escolha a plataforma Cliente público (aplicativo Móvel/Área de Trabalho):

  1. Em Configurações de plataforma, selecione Adicionar uma plataforma.

    Captura de tela de Adicionar plataforma.

  2. Selecione https://login.microsoftonline.com/common/oauth2/nativeclient como o URI de Redirecionamento e selecione Configurar.

    Captura de tela do URI de redirecionamento.

  3. Em Configuração Avançada, defina Permitir fluxos de cliente público comoSim e selecione Salvar.

    Captura de tela dos fluxos do cliente.

Permissões de API

O SharePoint oferece escopos/permissões de API diferentes.

Siga estas etapas para definir permissões de API:

  1. Em Permissões configuradas, selecione Adicionar uma permissão e selecione SharePoint.

    Captura de tela da API do SharePoint.

  2. Conceda a permissão AllSites.Write ou superior ao aplicativo e selecione Adicionar permissões. AllSites.Write é necessário para que todas as atividades de IP do SharePoint funcionem e você pode escolher um escopo mais estreito dependendo das atividades que os runbooks usam.

    Captura de tela dos Escopos da API do SharePoint.

Configurar o IP do SharePoint para Autenticação Moderna

Use as seguintes etapas para configurar o IP do SharePoint para autenticação OAuth:

  1. No runbook do Orchestrator Designer, selecione Opções e Selecione Microsoft SharePoint.

  2. A caixa de diálogo Microsoft SharePoint é exibida.

  3. Na guia Configurações , selecione Adicionar para iniciar a configuração da conexão. A caixa de diálogo Adicionar Configuração é exibida.

  4. Na caixa Nome, digite um nome para essa conexão. Esse pode ser o nome do site do SharePoint ou um nome descritivo para distinguir o tipo de conexão.

  5. Na caixa Tipo, selecione Configuração do SharePoint.

  6. Na caixa Site do SharePoint, digite a URL do site do SharePoint que contém a lista com a qual você deseja se integrar.

  7. Nas caixas Nome de usuário e Senha, digite as credenciais (do usuário) que o Orchestrator usará para se conectar com o site do SharePoint quando os runbooks forem executados.

  8. Na caixa Domínio, insira o nome do domínio para autorizar o acesso.

  9. Na caixa SharePoint Online, insira Verdadeiro.

  10. Defina a caixa Utilizar OAuth como True.

  11. Defina ID do aplicativo para a ID do aplicativo vista no portal.

  12. Defina ID do Diretório para a ID do diretório (locatário) vista no portal. Isso também é conhecido como ID do locatário do Microsoft 365.

  13. Defina o URI da Instância do AAD para a URL do AD (ou deixe-o como valor padrão).

  14. Selecione OK.

  15. Adicione conexões adicionais, se aplicável, e selecione Concluir.

Obter dados do SharePoint

Depois de executar as etapas acima, crie um runbook e use a atividade Obter Itens de Lista do SharePoint. Quando você definir a configuração desejada nas configurações da atividade, o Runbook Designer exercerá suas opções de conexão para buscar alguns dados do SharePoint.

Um pop-up é exibido caso haja algum problema com as credenciais ou outras configurações.