Compartilhar via

Visão geral do conector genérico do Serviço Web

  • Artigo

O conector de Serviço Web integra identidades por meio de operações de Serviço Web com o MIM (Microsoft Identity Manager) 2016 SP1. O conector requer que o arquivo do Projeto de Serviço Web se conecte à fonte de dados correta. Este projeto pode ser baixado do Centro de Download da Microsoft juntamente com a documentação para usar o conector com Oracle eBusiness, Oracle PeopleSoft e SAP. Você também pode criá-lo usando a Ferramenta de Configuração do Serviço Web.

Quando o Serviço de Sincronização do MIM invoca o conector do Serviço Web, ele carrega seu arquivo de projeto configurado (arquivo WsConfig ). Esse arquivo ajuda a reconhecer o ponto de extremidade da fonte de dados que deve ser usado para estabelecer uma conexão. O arquivo também informa o fluxo de trabalho a ser executado para implementar uma operação mim. Para executar os fluxos de trabalho configurados, o conector de serviço Web aproveita o mecanismo de tempo de execução do .NET 4 Workflow Foundation.

Configuração do fluxo de trabalho com a ferramenta de configuração de serviços Web

Pré-requisitos

A implantação desse conector pode exigir alterações na configuração do sistema de destino, bem como alterações de configuração no MIM. Para implantações que envolvem a integração do MIM a um sistema de terceiros em um ambiente de produção, recomendamos que os clientes trabalhem com o fornecedor do servidor de diretório ou com um parceiro de implantação para obter ajuda, diretrizes e suporte para essa integração.

Camadas do Serviço Web

Duas camadas principais são usadas para implementar a solução de MA (agente de gerenciamento de serviço Web):

  • Ferramenta de Configuração de Serviço Web
  • Conector em tempo de execução implementado com o Fluxo de Trabalho .NET 4.0

Fontes de dados com suporte para descoberta de serviço Web

A Ferramenta de Configuração de Serviço Web implementa as seguintes funcionalidades:

  • Descoberta soap: permite que o administrador insira o caminho WSDL exposto pelo serviço Web de destino. A descoberta produzirá uma estrutura de árvore de seus serviços Web hospedados com seus pontos de extremidade/operações internas, juntamente com a descrição de metadados da operação. Não há limite para o número de operações de descoberta que podem ser feitas (passo a passo). As operações descobertas são usadas posteriormente para configurar o fluxo de operações que implementam as operações do conector na fonte de dados (como Importação/Exportação/Senha).

  • Descoberta REST: permite que o administrador insira detalhes do serviço restful, ou seja, detalhes de ponto de extremidade de serviço, caminho do recurso, método e parâmetro. Um usuário pode adicionar um número ilimitado de serviços restful. As informações de serviços restantes serão armazenadas no discovery.xml arquivo do wsconfig projeto. Eles serão usados posteriormente pelo usuário para configurar a atividade rest web service no fluxo de trabalho.

  • Configuração do esquema de espaço do conector: permite que o administrador configure o esquema de espaço do conector. A configuração do esquema incluirá uma listagem de Tipos de Objeto e atributos para uma implementação específica. O administrador pode especificar os tipos de objeto que terão suporte pelo MA do Serviço Web. O administrador também pode escolher aqui os atributos que farão parte do Esquema de espaço do Conector.

  • Configuração do Fluxo de Operação: interface do usuário do designer de fluxo de trabalho para configurar a implementação de operações do FIM (Importação/Exportação/Senha) por tipo de objeto por meio de funções de operações de serviço Web expostas, como:

    • Atribuição de parâmetros do espaço do conector para funções de serviço Web.
    • Atribuição de parâmetros de funções de serviço Web para o espaço do conector.

Recursos gerados pela Ferramenta de Configuração do Serviço Web

A Ferramenta de Configuração do Serviço Web gera os recursos necessários para configurar um MA de Serviço Web totalmente funcional, que inclui:

  • Esquema de espaço do conector: um arquivo binário que inclui a configuração do esquema. O arquivo será importado pelo MIM por meio da Get Schema interface quando o MA for configurado usando a interface do usuário de sincronização do FIM. Em seguida, ele é convertido em objeto de formato de esquema ECMA2.

  • Fluxos de trabalho: uma série de definições de fluxo de trabalho. Eles são usados pelo MA do Serviço Web em tempo de execução para executar uma operação apropriada.

  • Arquivo de configuração do WCF: um arquivo de configuração produzido pela operação de descoberta. O arquivo inclui as informações de associação e pontos de extremidade necessárias para invocar uma operação de serviço Web na fonte de dados.

  • Assembly de contrato de dados: como o conector de Serviço Web agora dá suporte ao serviço SOAP e REST, os contratos de dados gerados para serão diferentes no arquivo generated.dll.

  • Assembly SOAP: ao analisar a entrada WSDL, a ferramenta de configuração do Serviço Web gera tipos de contrato de dados, que são estruturas de dados usadas pelas operações do serviço Web para se comunicar com o serviço remoto. Esses tipos de contrato também são usados para expor entidades de fonte de dados remotas para mapeamento de atributo de tipo de objeto.

  • Assembly REST: ao analisar exemplos de solicitação-resposta para o Serviço Web REST, a ferramenta de configuração gerará tipos (classes), que serão usados no fluxo de trabalho para se comunicar com o serviço Web por meio da atividade de Chamada de Serviço Web. Cada Solicitação/Resposta será definida em seu próprio namespace. O namespace tem uma sintaxe como <ServiceName>.< ResourceName>.< MethodName>.[ Solicitação/resposta]. Encapsular cada solicitação/resposta em um namespace separado ajudará a reduzir os problemas devido ao nome de tipo(classe) duplicado.

Criação de fluxo de trabalho de um arquivo .wsconfig pela ferramenta de configuração de serviços Web para uso pelo agente de gerenciamento de serviços Web

Tipo de arquivo de projeto

O MA do Serviço Web é salvo no arquivo compactado (formato ZIP) com o nome especificado pelo usuário e a extensão de arquivo "WsConfig". A extensão de arquivo "WsConfig" está registrada e associada à ferramenta de configuração do Serviço Web pelo instalador. Os projetos de MA existentes podem ser abertos, modificados e salvos. Eles podem ser salvos na pasta extensões do Serviço de Sincronização do FIM ou em qualquer outro local. As alterações relacionadas ao tipo de objeto e aos atributos exigem sincronização no lado do FIM. A ferramenta de configuração é um aplicativo de várias instâncias projetado para criar e modificar MA(s).

Modos de segurança com suporte

O aplicativo de serviço Web REST/SOAP pode ser protegido por meio de um servidor Web como o IIS. O aplicativo permite que o usuário selecione o modo de segurança, conforme mostrado na figura a seguir. Os modos de segurança incluem Básico, Digest, Certificado, Windows ou Nenhum.

Modos de segurança

Tipos de dados com suporte

Há suporte para os seguintes tipos de dados:

  • SOAP (herdado): o tipo de dados SOAP tem suporte, conforme descrito neste artigo do MSDN. O suporte é fornecido apenas para a pilha BAPI (Business Application Programming Interface). Modelos SOAP de exemplo estão disponíveis no Centro de Download da Microsoft.
  • REST (não ODATA): um conector/web baseado em protocolo HTTP.

Próximas etapas