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

O conector do Serviço Web integra identidades por operações do Serviço Web com o Microsoft Identity Manager (MIM) 2016 SP1. O conector requer que o arquivo do Projeto do Serviço Web se conecte com a 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 especifica 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 utiliza o mecanismo de tempo de execução do .NET 4 Workflow Foundation.

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 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 ma (agente de gerenciamento de serviço Web):

• Ferramenta de Configuração do Serviço Web
• Conector de tempo de execução implementado com o Workflow do .NET 4.0

Fontes de dados com suporte para descoberta do Serviço Web

A Ferramenta de Configuração do 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 ponto(s) 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 de serviço Restful, ou seja, pontos de extremidade de serviço, caminho do recurso, método e detalhes do parâmetro. Um usuário pode adicionar um número ilimitado de serviços Restful. As informações dos serviços REST serão armazenadas no arquivo discovery.xml do projeto wsconfig. Elas serão usadas posteriormente pelo usuário para configurar a atividade Rest do Serviço Web 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 do Agente de Gerenciamento (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 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 às 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 interface Get Schema quando o MA estiver configurado usando a interface 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. Ele é usado pelo MA do Serviço Web em runtime 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.

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

• Assembly SOAP: ao analisar a entrada do 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.

• Montagem REST: Durante a análise do exemplo de solicitação-resposta para o Serviço Web REST, a ferramenta de configuração gerará tipos (classes) que serão utilizados 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 namespace separado ajudará a reduzir problemas devido ao nome de tipo(classe) duplicado.

Tipo de arquivo do projeto

O Web Service MA é salvo em um arquivo compactado (formato ZIP) com o nome especificado pelo usuário e a extensão de arquivo "WsConfig". A extensão de arquivo "WsConfig" é 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 de 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 Basic, Digest, Certificate, Windows ou None.

Tipos de dados com suporte

Há suporte para os seguintes tipos de dados:

• SOAP (herdado): há suporte para o tipo de dados SOAP, conforme descrito neste artigo do MSDN. O suporte é fornecido apenas para a pilha BAPI (interface de programação de aplicativo de negócios). 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

• Instalar a Ferramenta de Configuração do Serviço Web
• Guia de implantação SOAP
• guia de implantação REST
• Configuração do serviço Web de MA