Tivoli Identity Manager

Transcrição

1 Tivoli Identity Manager Versão 4.6 DB2 Universal Database Adapter: Guia de Instalação e Configuração S

2

3 Tivoli Identity Manager Versão 4.6 DB2 Universal Database Adapter: Guia de Instalação e Configuração S

4 Nota Antes de utilizar estas informações e o produto suportado por elas, leia as informações no Apêndice D, Avisos, na página 65. Sétima Edição (Junho de 2005) Esta edição se aplica à versão 4.6 deste adaptador e a todos os releases e modificações subseqüentes, até que seja indicado de outra maneira em novas edições. Direitos Autorais International Business Machines Corporation 2002, Todos os direitos reservados.

5 Índice Prefácio v Quem Deve Ler este Manual v Publicações e Informações Relacionadas.....v Biblioteca do Tivoli Identity Manager.....v Publicações de Pré-requisito do Produto.... vii Publicações Relacionadas viii Acessando Publicações On-line viii Acessibilidade ix Informações sobre Suporte ix Convenções Utilizadas neste Manual......ix Convenções Tipográficas ix Diferenças de Sistemas Operacionais.....x Definições para HOME e outras Variáveis de Diretório x Capítulo 1. Visão Geral do Adaptador UDB Recursos do Adaptador Capítulo 2. Instalando e Configurando o Adaptador UDB Pré-requisitos Testando a Conectividade de Rede Instalando o Adaptador Importando o Perfil do Adaptador no Servidor Tivoli Identity Manager Importando o Perfil do Adaptador Criando um Serviço UDB Configurando o Adaptador Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager... 9 Iniciando a Ferramenta de Configuração do Adaptador Visualizando Definições de Configuração Alterando Definições de Configuração de Protocolo 10 Configurando a Notificação de Eventos Definindo Acionadores de Notificação de Eventos 16 Modificando um Contexto de Notificação de Evento Alterando a Chave de Configuração Alterando as Configurações do Log de Atividades 19 Alterando Configurações de Registro Modificando Configurações de Registro Não-criptografadas Modificando Configurações de Registro Criptografadas Alterando Configurações Avançadas Visualizando Estatísticas Acessando a Ajuda e Opções Adicionais Capítulo 4. Configurando a Autenticação SSL para o Adaptador UDB Visão Geral dos Certificados Digitais e SSL Chaves Privadas, Chaves Públicas e Certificados Digitais Certificados Auto-assinados Formatos de Certificado e de Chave O Uso da Autenticação SSL Configurando Certificados para Autenticação SSL 32 Configurando Certificados para Autenticação SSL de Uma Via Configurando Certificados para Autenticação SSL de Duas Vias Configurando Certificados quando o Adaptador Funciona como um Cliente SSL Gerenciando Certificados SSL Utilizando o CertTool 35 Iniciando o CertTool Gerando uma Chave Privada e um Pedido de Certificado Instalando o Certificado Instalando o Certificado e a Chave de um Arquivo PKCS Visualizando o Certificado Instalado Instalando um Certificado CA Visualizando Certificados CA Excluindo um Certificado CA Visualizando Certificados Registrados Registrando um Certificado Cancelando o Registro de um Certificado...41 Exportando um Certificado e uma Chave para o Arquivo PKCS Capítulo 5. Customizando o Adaptador UDB Copiar o Arquivo UDBProfile.jar e Extrair os Arquivos Criar um Novo Arquivo JAR e Instalar os Novos Atributos no Servidor Tivoli Identity Manager...44 Gerenciando Senhas ao Restaurar Contas Capítulo 6. Fazendo Upgrade do Adaptador UDB ou do ADK Fazendo Upgrade do Adaptador UDB Fazendo Upgrade do ADK Arquivos de Log Capítulo 7. Desinstalando o Adaptador UDB Apêndice A. Atributos do Adaptador.. 51 Descrições dos Atributos Atributos por Ações do Adaptador UDB Adição de Logins do Banco de Dados Alteração de Logins do Banco de Dados Exclusão de Logins do Banco de Dados Suspensão de Logins do Banco de Dados...58 Direitos Autorais IBM Corp. 2002, 2005 iii

6 Restauração de Logins do Banco de Dados...58 Reconciliação Apêndice B. Configurando o Adaptador UDB para Suporte a Várias Instâncias. 59 Apêndice C. Informações sobre Suporte Procurando Bases de Conhecimento Procurar no Centro de Informações no Sistema ou Rede Local Procurar na Internet Obtendo as Correções Entrando em Contato com o IBM Software Support 62 Determinar o Impacto Comercial do Problema..63 Descrever seu Problema e Reunir Informações de Segundo Plano Submeter Problemas ao IBM Software Support 64 Apêndice D. Avisos Marcas Registradas Índice Remissivo iv IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

7 Prefácio Quem Deve Ler este Manual O IBM Tivoli Identity Manager DB2 Universal Database Adapter (Adaptador UDB) ativa a conectividade entre o Servidor Tivoli Identity Manager e uma rede de sistemas que executam o UDB RDBMS (Relational Database Management System). Depois que o adaptador é instalado e configurado, o Tivoli Identity Manager gerencia o acesso a recursos do UDB RDBMS com o sistema de segurança de seu site. Este manual descreve como instalar e configurar o Adaptador UDB. Nota: O programa utilizado para conectar o recurso gerenciado ao Servidor Tivoli Identity Manager agora é chamado de adaptador. O termo adaptador substitui o termo agente utilizado anteriormente. A interface com o usuário utilizada para configurar o adaptador ainda utiliza o termo agente. Este manual destina-se a administradores de segurança do UDB RDBMS responsáveis por instalar software nos sistemas de computadores em seus sites. Os leitores devem estar familiarizados com os conceitos do AIX e do UDB RDBMS. A pessoa que concluirá o procedimento de instalação do Adaptador UDB também deve estar familiarizada com os padrões do sistema de seu site e precisa ter experiência e conhecimento apropriados do AIX. Os leitores devem ser capazes de executar tarefas de rotina do sistema AIX e da administração de segurança. Publicações e Informações Relacionadas Leia as descrições da biblioteca do Tivoli Identity Manager. Para determinar quais publicações adicionais possam ser úteis a você, leia Publicações de Pré-requisito do Produto na página vii e Publicações Relacionadas na página viii. Depois de determinar as publicações necessárias, consulte as instruções em Acessando Publicações On-line na página viii. Biblioteca do Tivoli Identity Manager As publicações na biblioteca de documentação técnica do Tivoli Identity Manager são organizadas nas seguintes categorias: v Informações sobre o release v Assistência on-line ao usuário v Instalação e configuração do servidor v Determinação de problemas v Complementos técnicos v Instalação e configuração do adaptador Informações sobre o Release: v IBM Tivoli Identity Manager: Notas sobre o Release Fornece requisitos de software e hardware para o Tivoli Identity Manager, informações adicionais sobre correção e outras informações de suporte. v IBM Tivoli Identity Manager Documentation Read This First Card Lista as publicações do Tivoli Identity Manager. Assistência On-line ao Usuário: Direitos Autorais IBM Corp. 2002, 2005 v

8 Fornece tópicos de ajuda on-line e um centro de informações para todas as tarefas administrativas do Tivoli Identity Manager. O centro de informações inclui informações que anteriormente eram fornecidas no IBM Tivoli Identity Manager: Guia de Configuração e no IBM Tivoli Identity Manager Policy and Organization Administration Guide. Instalação e Configuração do Servidor: O IBM Tivoli Identity Manager: Guia de Instalação e Configuração do Servidor para Ambientes do WebSphere fornece informações de instalação e configuração do Tivoli Identity Manager. Informações de configuração que anteriormente eram fornecidas no IBM Tivoli Identity Manager: Guia de Configuração agora estão incluídas no guia de instalação ou no IBM Tivoli Identity Manager Information Center. Determinação de Problemas: O IBM Tivoli Identity Manager: Guia de Determinação de Problemas fornece determinação de problemas, log e informações de mensagens do produto Tivoli Identity Manager. Complementos Técnicos: Os complementos técnicos a seguir são fornecidos por desenvolvedores ou por outros grupos interessados neste produto: v IBM Tivoli Identity Manager: Guia de Ajuste de Desempenho Fornece as informações necessárias para ajustar o Servidor Tivoli Identity Manager a um ambiente de produção, disponível na Web em: Clique no caractere I na lista de produtos de A a Z e, em seguida, clique no link Tivoli Identity Manager. Procure no centro de informações a seção Technical Supplements. v Redbooks e white papers estão disponíveis na Web em: IBMTivoliIdentityManager.html Procure a seção Self Help, na categoria Learn e clique no link Redbooks. v As technotes estão disponíveis na Web em: v Guia de campo estão disponíveis na Web em: v Para obter uma lista maior de outros recursos do Tivoli Identity Manager, procure no seguinte endereço da Web do IBM developerworks: Instalação e Configuração do Adaptador: A biblioteca de documentação técnica do Servidor Tivoli Identity Manager inclui também um conjunto em desenvolvimento de documentos de instalação específicos de plataforma para os componentes de adaptador de uma implementação do Servidor Tivoli Identity Manager. Localize os adaptadores na Web em: vi IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

9 Passport_Advantage_Home Clique em Support & downloads. Navegue para Downloads and drivers. Clique no link para o inventário atual de adaptadores. Qualificações e Treinamento: As seguinte informações adicionais sobre treinamento técnico e qualificações estavam disponíveis no momento em que este manual foi publicado: v Virtual Skills Center para Tivoli Software na Web em: v Tivoli Education Software Training Roadmaps na Web em: v Tivoli Technical Exchange na Web em: supp_tech_exch.html Publicações de Pré-requisito do Produto Para utilizar as informações neste manual com eficiência, você deve ter algum conhecimento dos produtos que são pré-requisitos para o Servidor Tivoli Identity Manager. As publicações estão disponíveis nas seguintes localizações: v UDB RDBMS v Sistemas operacionais IBM AIX Sun Solaris Red Hat Linux Microsoft Windows Server v Servidores de bancos de dados IBM DB2 - Suporte: - Centro de informações: - Documentação: winos2unix/support/v8pubs.d2w/en_main - Família de produtos DB2: - Fix packs: - Requisitos do sistema: Oracle Prefácio vii

10 Publicações Microsoft SQL Server v Aplicativos do servidor de diretórios IBM Directory Server en_us/html/ldapinst.htm Sun ONE Directory Server v WebSphere Application Server Informações adicionais estão disponíveis no diretório de produtos ou em Web sites. v Sistema de mensagens incorporado do WebSphere v IBM HTTP Server Relacionadas Informações relacionadas ao Servidor Tivoli Identity Manager estão disponíveis nas seguintes publicações: v O Tivoli Software Library fornece uma variedade de publicações Tivoli, como white papers, planilhas, demonstrações, redbooks e cartas de anúncio. O Tivoli Software Library está disponível na Web em: v O Tivoli Software Glossary inclui definições para muitos dos termos técnicos relacionados a software Tivoli. O Tivoli Software Glossary está disponível no link Glossary da página da Web do Tivoli Software Library em: Acessando Publicações On-line A IBM lança publicações para este e todos os outros produtos Tivoli, assim que são disponibilizados e sempre que são atualizados, no Web site Tivoli software information center. Acesse o centro de informações de software Tivoli no seguinte endereço da Web: Clique no caractere I na lista de produtos de A a Z e, em seguida, clique no link Tivoli Identity Manager para acessar a biblioteca do produto. Nota: Se você imprimir documentos PDF em outro papel com tamanho diferente de carta, defina a opção na janela File Print para permitir que o Adobe Reader imprima páginas tamanho carta em seu papel. viii IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

11 Acessibilidade Informações sobre Suporte A documentação do produto inclui os seguintes recursos para auxiliar a acessibilidade: v A documentação está disponível em formato PDF conversível para oferecer oportunidade máxima para que os usuários apliquem o software de leitor de tela. v Todas as imagens contidas na documentação são fornecidas com texto alternativo; dessa forma, os usuários com capacidade de visão diminuída podem entender o conteúdo das imagens. Se você tiver um problema com software IBM, desejará resolvê-lo rapidamente. A IBM oferece os seguintes modos para se obter o suporte necessário: v Procurando bases de conhecimento: você pode procurar em toda a ampla coleção de problemas conhecidos e soluções alternativas, Technotes e outras informações. v Obtendo correções: você pode localizar as correções mais recentes que já estão disponíveis ao seu produto. v Entrando em Contato com o IBM Software Support: se você ainda não puder resolver o problema e precisar trabalhar com alguém da IBM, poderá utilizar várias maneiras para entrar em contato com o IBM Software Support. Para obter mais informações sobre essas formas de resolver problemas, consulte o Apêndice C, Informações sobre Suporte, na página 61. Convenções Utilizadas neste Manual Convenções Esta referência utiliza várias convenções para termos e ações especiais e para a operação de comandos e caminhos dependentes do sistema. Tipográficas Este guia utiliza as seguintes convenções sobre tipos de letra: Negrito Itálico v Comandos em minúsculas e comandos que misturem letras minúsculas e maiúsculas que possam ser difíceis de serem distinguidos do texto ao redor v Controles da interface (caixas de opções, botões de comandos, botões de opções, botões de rotação, campos, pastas, ícones, quadros de listagem, itens dentro de quadros de listagem, listas de colunas múltiplas, contêineres, opções de menu, nomes de menus, guias, folhas de propriedades), etiquetas (como as Dicas: e Considerações sobre o sistema operacional): v Palavras-chave e parâmetros no texto v Palavras definidas no texto v Ênfases em palavras (palavras como palavras) v Novos termos no texto (exceto na lista de definições) v Variáveis e valores que devem ser fornecidos pelo usuário Monoespaçamento Prefácio ix

12 v Exemplos e exemplos e código v Nomes de arquivos, palavras-chave de programação e outros elementos que são difíceis de serem distinguidos do texto adjacente v Texto de mensagem e avisos dirigidos ao usuário v Texto que o usuário deve digitar v Valores para opções de argumentos ou comandos Diferenças de Sistemas Operacionais Este guia utiliza a convenção do UNIX para especificar variáveis de ambiente e notação de diretório. Ao utilizar a linha de comandos do Windows, substitua $variable por %variable% para variáveis de ambiente e substitua cada barra (/) por uma barra invertida (\) nos caminhos de diretórios. Os nomes de variáveis de ambiente nem sempre são os mesmos no Windows e no UNIX. Por exemplo, %TEMP% no sistema operacional Windows é equivalente a $tmp em um sistema operacional UNIX. Nota: Se você for utilizar o shell bash em um sistema Windows, poderá utilizar as convenções UNIX. Definições para HOME e outras Variáveis de Diretório A tabela a seguir contém as definições padrão utilizadas neste guia para representar o nível de diretório HOME para vários caminhos de instalação do produto. É possível personalizar o diretório de instalação e o diretório HOME para sua implementação específica. Se este for o caso, será necessário fazer a substituição apropriada para a definição de cada variável representada nessa tabela. O valor de path varia de acordo com estes sistemas operacionais: v Windows: unidade:\arquivos de Programas v AIX: /usr v Outro UNIX: /opt Variável do Caminho Definição Padrão Descrição DB_INSTANCE_HOME Windows: caminho\ibm\sqllib UNIX: v AIX, Linux: /home/dbinstancename v Solaris: /export/home/dbinstancename O diretório que contém o banco de dados do Tivoli Identity Manager. x IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

13 Variável do Caminho Definição Padrão Descrição LDAP_HOME v Para IBM Directory Server Versão 5.2 O diretório que contém o código do Windows: servidor de caminho\ibm\ldap diretórios. UNIX: AIX, Linux: caminho/ldap Solaris: caminho/ibmldaps caminho/ibm/ldap v Para IBM Directory Server Versão 6.0 Windows: caminho\ibm\ldap\v6.0 UNIX: caminho/ibm/ldap/v6.0 AIX, Solaris Linux: opt/ibm/ldap/v6.0 v Para o Sun ONE Directory Server Windows: caminho\sun\mps UNIX: /var/sun/mps IDS_instance_HOME Para IBM Directory Server Versão 6.0 Windows: unidade\ ibmslapd-instance_owner_name O diretório que contém a instância do IBM Directory Server Versão 6.0. HTTP_HOME O valor de unidade poderá ser C:\ em sistemas Windows. Um exemplo de instance_owner_name poderá ser ldapdb2. Por exemplo, o arquivo de log poderá ser C:\idsslapd-ldapdb2\logs\ibmslapd.log. UNIX: INSTANCE_HOME/idsslapd-instance_name Em sistemas Linux e AIX, o diretório home padrão é o diretório /home/instance_owner_name. Em sistemas Solaris, por exemplo, o diretório é /export/home/ldapdb2/idsslapdldapdb2. Windows: caminho\ibmhttpserver UNIX: caminho/ibmhttpserver O diretório que contém o código do IBM HTTP Server. Prefácio xi

14 Variável do Caminho Definição Padrão Descrição ITIM_HOME WAS_HOME WAS_MQ_HOME WAS_NDM_HOME Tivoli_Common_Directory Windows: caminho\ibm\itim UNIX: caminho/ibm/itim Windows: caminho\websphere\appserver UNIX: caminho/websphere/appserver Windows: caminho\ibm\websphere MQ UNIX: caminho/mqm Windows: caminho\websphere\deploymentmanager UNIX: caminho/websphere/deploymentmanager Windows: caminho\ibm\tivoli\common\ctgim UNIX: caminho/ibm/tivoli/common/ctgim O diretório de base que contém o código, a configuração e a documentação do Tivoli Identity Manager. O diretório home do WebSphere Application Server. O diretório que contém o código do WebSphere MQ. O diretório home no gerenciador de implementação. O local central para todos os arquivos relacionados a capacidade de uso, como logs e dados de captura de primeira falha. xii IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

15 Capítulo 1. Visão Geral do Adaptador UDB Recursos do Adaptador Um adaptador é um programa que fornece uma interface entre um recurso gerenciado e o Servidor Tivoli Identity Manager. Os adaptadores podem ou não residir no recurso gerenciado, e o Servidor Tivoli Identity Manager gerencia o acesso ao recurso utilizando seu sistema de segurança. Adaptadores funcionam como administradores virtuais confiáveis na plataforma de destino, executando tarefas como criar IDs de login, suspender IDs e executar outras funções que os administradores normalmente executam manualmente. O adaptador é executado como um serviço, quer o usuário esteja ou não com login efetuado no Servidor Tivoli Identity Manager. O IBM Tivoli Identity Manager Adaptador UDB ativa a conectividade entre o Servidor Tivoli Identity Manager e um sistema que executa o UDB RDBMS. Este guia de instalação fornece as informações básicas que você precisa para instalar e configurar o Adaptador UDB. Este capítulo fornece uma visão geral do adaptador e de seus recursos. Você pode utilizar o Adaptador UDB para automatizar as seguintes tarefas administrativas: v Criar novos usuários no servidor DB2 UDB RDBMS. v Modificar atributos do usuário do DB2 UDB RDBMS. v Alterar a senha da conta do usuário do DB2 UDB RDBMS. v Suspender, restaurar e excluir contas de usuários do DB2 UDB RDBMS. v Consultar operações do usuário para contas de usuários do DB2 UDB RDBMS. v Reconciliar contas de usuários do DB2 UDB RDBMS. Direitos Autorais IBM Corp. 2002,

16 2 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

17 Capítulo 2. Instalando e Configurando o Adaptador UDB Pré-requisitos Instalar e configurar o Adaptador UDB envolve diversas etapas que você deve concluir na seqüência apropriada. Reveja os pré-requisitos antes de começar o processo de instalação. Você também pode criar uma conta no recurso gerenciado a ser utilizada pelo adaptador. A Tabela 1 identifica os pré-requisitos de hardware, software e autorização para instalar o Adaptador UDB. Verifique se todos os pré-requisitos foram atendidos antes de instalar o Adaptador UDB. Tabela 1. Pré-requisitos para Instalar o Adaptador UDB Sistema v Microprocessador de 32 bits baseado em x86. v No mínimo, 256 MB de memória. v No mínimo, 300 MB de espaço livre em disco. Sistema Operacional Uma das seguintes versões do AIX devem estar instaladas e em operação no sistema no qual o adaptador está instalado: v 5.1 v 5.2 Banco de Dados DB2 v DB2 UDB 7.1 RDBMS v DB2 UDB 7.2 RDBMS Nota: O DB2 UDB RDBMS não precisa estar no mesmo sistema que o adaptador. Software do Cliente DB2 As seguintes versões do cliente DB2 devem estar instaladas no sistema no qual o adaptador será executado: v DB2 UDB 7.1 v DB2 UDB 7.2 Essas duas versões do cliente podem conectar-se ao DB2 UDB 7.1 RDBMS ou DB2 UDB 7.2 RDBMS. Conectividade da Rede Rede TCP/IP Autoridade de Administrador do Sistema Servidor Tivoli Identity Manager O usuário que está concluindo o procedimento de instalação do Adaptador UDB deve ter a autoridade de administrador do sistema para concluir as etapas deste capítulo. Para cada banco de dados gerenciado pelo adaptador, você deve fornecer uma conta do sistema operacional com autoridade SYSADM no DB2 UDB RDBMS. Versão 4.6 Direitos Autorais IBM Corp. 2002,

18 Testando a Conectividade de Rede Instalando o Adaptador Para testar o recurso de conectividade de rede e transferência de arquivos entre a estação de trabalho na qual o Adaptador UDB será instalado e a estação de trabalho na qual o Servidor Tivoli Identity Manager está instalado, conclua estas etapas. 1. Efetue logon na estação de trabalho do AIX como raiz ou superusuário. 2. Teste a comunicação entre o sistema em que o Servidor Tivoli Identity Manager está localizado e a estação de trabalho do AIX. # ping nome_do_host_aix Os arquivos de instalação do Tivoli Identity Manager Adaptador UDB estão disponíveis para download no Web site da IBM. Entre em contato com o representante da sua conta IBM para obter o endereço da Web e conhecer as instruções de download. Para instalar o adaptador, conclua as seguintes etapas: 1. Faça download do arquivo de instalação compactado do Adaptador UDB a partir do Web site. 2. Extraia o conteúdo do arquivo compactado em um diretório temporário e navegue para esse diretório. 3. Digite./setupaix.bin e pressione Enter para executar o programa de instalação. 4. Na janela Bem-vindo, clique em Avançar. 5. Na janela Contrato de Licença, revise o contrato de licença e decida se você aceita os termos. Se aceitá-los, selecione Aceitar e clique em Avançar. 6. Digite o nome da conta utilizada para gerenciar o banco de dados DB2 UDB e clique em Avançar. 7. Na janela Selecionar Diretório de Destino, especifique onde você quer instalar o adaptador no campo Nome do Diretório. Você pode aceitar o local padrão ou clicar em Procurar para especificar um diretório diferente. Em seguida, clique em Avançar. 4 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

19 Instalador r Clique em Avançar para instalar < agentname> neste diretório ou clique em Procurar para instalar em um diretório diferente. Nome do Diretório: /home/tivoli/< agentname> Procurar... InstallShield < Voltar Avançar > Cancelar Figura 1. Janela Selecionar Diretório de Destino 8. Na janela Resumo da Instalação, clique em Avançar para começar a instalação. 9. Na janela Instalação Concluída, clique em Concluir para sair do programa. O Adaptador UDB pode gerenciar várias instâncias de banco de dados ao mesmo tempo. Para obter informações adicionais sobre como gerenciar instâncias de banco de dados, consulte o Apêndice B, Configurando o Adaptador UDB para Suporte a Várias Instâncias, na página 59. Importando o Perfil do Adaptador no Servidor Tivoli Identity Manager Antes de poder incluir um adaptador como um serviço no Servidor Tivoli Identity Manager, o servidor deverá ter um perfil do adaptador para reconhecer o adaptador como um serviço. Os arquivos que estão no pacote do Adaptador UDB incluem o arquivo JAR do adaptador, UDBProfile.jar. Utilizando o recurso Importar do Servidor Tivoli Identity Manager, você pode importar o perfil do adaptador no servidor como um perfil de serviço. O arquivo UDBProfile.jar inclui todos os arquivos que são necessários para definir o esquema do adaptador, o formulário de conta, o formulário de serviço e as propriedades do perfil. Importando o Perfil do Adaptador Um perfil do adaptador define os tipos de recursos que o Servidor Tivoli Identity Manager pode gerenciar. Você deve importar o perfil do adaptador no Servidor Tivoli Identity Manager antes de utilizar o Adaptador UDB. O perfil é utilizado para criar um serviço do Adaptador UDB no Servidor Tivoli Identity Manager e comunicar-se com o adaptador. Antes de começar a importar o perfil do adaptador, verifique se as seguintes condições foram atendidas: Capítulo 2. Instalando e Configurando o Adaptador UDB 5

20 Criando um Serviço UDB v O Servidor Tivoli Identity Manager deve estar instalado e em execução. v Você ter autoridade root ou de Administrador no Servidor Tivoli Identity Manager. Para importar o perfil do adaptador, conclua as seguintes etapas: 1. Efetue login no Servidor Tivoli Identity Manager utilizando uma conta que tenha a autoridade para executar tarefas administrativas. 2. Na Barra de Navegação do Menu Principal, selecione a guia Configuração. 3. Na janela Configuração, selecione as guias Importar/Exportar Importar. 4. Na janela Importar, no campo Arquivo para Upload, digite o local do arquivo UDBProfile.jar ou clique em Procurar para localizar o arquivo. 5. Clique no link Importar Dados no Identity Manager para importar o perfil do adaptador no Servidor Tivoli Identity Manager. v Se a importação do perfil do adaptador for concluída com êxito, a seguinte mensagem será exibida: A instalação do perfil foi concluída. v Se a importação do perfil do adaptador não for concluída com êxito, a seguinte mensagem será exibida: A instalação do perfil falhou. Ao importar o perfil do adaptador, se você receber um erro relacionado ao esquema, o arquivo trace.log conterá informações sobre esse erro. O local do arquivo trace.log é especificado pela propriedade handler.file.filedir definida no arquivo enrolelogging.properties do Tivoli Identity Manager, que está localizado no diretório \data do Tivoli Identity Manager. Depois que o perfil do adaptador é importado no Servidor Tivoli Identity Manager, você deve criar um serviço de provisão para permitir que o Tivoli Identity Manager se comunique com o adaptador. Para criar um serviço de provisão, conclua as seguintes etapas: 1. Efetue login no Servidor Tivoli Identity Manager utilizando uma conta que tenha a autoridade para desempenhar tarefas administrativas. 2. Na Barra de Navegação do Menu Principal, clique na guia Provisão. 3. Na janela Provisão, clique na guia Gerenciar Serviços. 4. Na janela Gerenciar Serviços, clique em Incluir. 5. Na lista de tipos de serviços, selecione Perfil do UDB e, em seguida, clique em Continuar. O formulário de serviço Adaptador UDB é exibido. O formulário de serviço contém os seguintes campos: Nome do Serviço Especifique um nome que defina esse serviço UDB no Servidor Tivoli Identity Manager. Nome do Serviço é um campo obrigatório. Serviço UDB O nome da instância do UDB à qual o adaptador conecta-se. Descrição Especifique uma descrição opcional para esse serviço. URL Especifique o local e o número da porta do Adaptador UDB. URL é um campo obrigatório. 6 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

21 Configurando o Adaptador Se https for especificado como parte da URL, o adaptador deverá ser configurado para utilizar autenticação SSL. Se o adaptador não estiver configurado para utilizar autenticação SSL, especifique http para a URL. Para obter informações adicionais sobre como configurar o adaptador para utilizar autenticação SSL, consulte o Capítulo 4, Configurando a Autenticação SSL para o Adaptador UDB, na página 29. ID do Usuário Especifique um nome de usuário do protocolo DAML (Directory Access Markup Language). ID do Usuário é um campo obrigatório. Senha Especifique a senha para o nome do usuário do protocolo DAML. Senha é um campo obrigatório. Proprietário Especifique o proprietário do serviço, se houver. Proprietário é um campo opcional. Pré-requisito do Serviço Especifique um serviço existente do Tivoli Identity Manager que seja um pré-requisito para o serviço do UDB. 6. Para verificar a conexão, pressione Testar. 7. Para criar o serviço, pressione Submeter. Depois de instalar o Tivoli Identity Manager Adaptador UDB e importar o perfil do adaptador, a configuração é necessária para assegurar que ele funcione corretamente. Para configurar o Adaptador UDB, conclua as etapas a seguir: 1. Inicie o serviço Adaptador UDB a partir do diretório /bin do adaptador com./startagent.sh. 2. Configure o DAML para assegurar a comunicação com o Servidor Tivoli Identity Manager. Para obter mais informações sobre como configurar o DAML, consulte Alterando Definições de Configuração de Protocolo na página Configure o Adaptador UDB para comunicar-se com o Servidor Tivoli Identity Manager configurando o adaptador para notificação de evento. Para obter mais informações sobre como configurar notificação de evento, consulte Configurando a Notificação de Eventos na página Para obter comunicação segura, instale um certificado na máquina onde o adaptador reside e no Servidor Tivoli Identity Manager. Para obter mais informações sobre como instalar certificados, consulte o Capítulo 4, Configurando a Autenticação SSL para o Adaptador UDB, na página Use o utilitário agentcfg para modificar os parâmetros do adaptador. Para obter mais informações sobre configuração de parâmetros, consulte o Capítulo 3, Configurando o Adaptador UDB do IBM Tivoli Identity Manager, na página Defina os Nomes de Serviços a serem gerenciados pelo Adaptador UDB. 7. Inclua e, em seguida, configure o formulário de serviço no Servidor Tivoli Identity Manager. Para obter informações adicionais sobre como incluir e configurar um formulário de serviço, consulte Criando um Serviço UDB na página 6. Capítulo 2. Instalando e Configurando o Adaptador UDB 7

22 8. Configure o formulário de conta do adaptador. Para obter informações adicionais sobre como configurar o formulário de conta do adaptador, consulte o IBM Tivoli Identity Manager Information Center. 8 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

23 Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager Este capítulo descreve como utilizar o agentcfg, o programa fornecido de configuração do adaptador, para visualizar ou modificar os parâmetros do Adaptador UDB. Todas as modificações feitas em definições com essa ferramenta são efetivadas imediatamente. Iniciando a Ferramenta de Configuração do Adaptador Para iniciar a ferramenta de configuração do adaptador, agentcfg, para os parâmetros do Adaptador UDB, conclua estas etapas: 1. Efetue login no sistema do Adaptador UDB. 2. Na janela de prompt de comandos, altere para o diretório bin do adaptador. Por exemplo, digite o seguinte comando, se o diretório do Adaptador UDB estiver no local padrão: (suponha que um usuário chamado usr tenha /usr/tivoli como o diretório home.) # cd usr/tivoli/agents/udbagent/bin 3. Digite o seguinte comando: agentcfg -agent UDBAgent Também é possível utilizar o agentcfg para exibir ou alterar definições de configuração a partir de um computador remoto. Consulte a tabela em Acessando a Ajuda e Opções Adicionais na página 26 para conhecer os procedimentos sobre como utilizar argumentos adicionais. 4. No prompt Enter configuration key for Agent UDBAgent :, digite a chave de configuração para o Adaptador UDB. A chave de configuração padrão é agent. Você deve alterar a chave de configuração uma vez concluída a instalação para evitar acesso não autorizado à configuração do adaptador. Consulte Alterando Definições de Configuração de Protocolo na página 10 para conhecer procedimentos sobre como alterar a chave de configuração. O Main Configuration Menu é exibido. UDBAgent 4.6 Agent Main Configuration Menu A. Configuration Settings. B. Protocol Configuration. C. Event Notification. D. Change Configuration Key. E. Activity Logging. F. Registry Settings. G. Advanced Settings. H. Statistics. I. Codepage Support. X. Done Select menu option: No Main Menu, você pode configurar o protocolo, visualizar estatísticas e modificar definições, incluindo configuração, registro e configurações avançadas. Direitos Autorais IBM Corp. 2002,

24 Tabela 2. Opções do Main Configuration Menu Opção Tarefa de Configuração Para Obter Mais Informações n Visualizando definições de configuração B Alterando definições de configuração de protocolo S Configurando notificação de eventos Consulte a página 10. Consulte a página 10. Consulte a página 13. n Alterando a chave de configuração Consulte a página 19. A Alterando configurações de log de atividades u Alterando configurações de registro Consulte a página 19. Consulte a página 22. G Alterando configurações avançadas Consulte a página 24. H Visualizando estatísticas Consulte a página 26. Visualizando Definições de Configuração O procedimento a seguir descreve como exibir as definições de configuração do Adaptador UDB. 1. No Agent Main Configuration Menu, digite A. As definições de configuração do Adaptador UDB são exibidas. A tela a seguir é um exemplo das definições de configuração do Adaptador UDB. Configuration Settings Name : UDBAgent Version : 4.6 ADK Version : 4.64 ERM Version : 4.64 License : NONE Asynchronous ADD Requests : TRUE (Max.Threads:3) Asynchronous MOD Requests : TRUE (Max.Threads:3) Asynchronous DEL Requests : TRUE (Max.Threads:3) Asynchronous SEA Requests : TRUE (Max.Threads:3) Available Protocols : DAML Configured Protocols : DAML Logging Enabled : TRUE Logging Directory : /usr/tivoli/agents/udbagent/log Log File Name : UDBAgent.log Max. log files : 3 Max.log file size (Mbytes) : 1 Debug Logging Enabled : TRUE Detail Logging Enabled : FALSE Press any key to continue 2. Pressione qualquer tecla para retornar ao Main Menu. Alterando Definições de Configuração de Protocolo O Adaptador UDB utiliza o DAML Protocol para comunicar-se com o Servidor Tivoli Identity Manager. Por padrão, quando o adaptador é instalado, o DAML Protocol é configurado para ser utilizado em modo não seguro. Para configurar um ambiente seguro, você deve configurar o DAML Protocol para utilizar SSL e instalar um certificado. Consulte o Instalando o Certificado na página 39 para obter informações adicionais sobre como instalar certificados. 10 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

25 Nas versões anteriores deste adaptador, você podia incluir e remover protocolos. Contudo, na versão mais recente deste adaptador, o DAML Protocol é o único protocolo suportado que você pode utilizar. Portanto, não será necessário incluir ou remover um protocolo. Para configurar o DAML Protocol para o Adaptador UDB, conclua as seguintes etapas: 1. No Agent Main Configuration Menu, digite B. O DAML protocol está configurado e disponível por padrão para o Adaptador UDB. Agent Protocol Configuration Menu Available Protocols: DAML Configured Protocols: DAML A. Add Protocol. B. Remove Protocol. C. Configure Protocol. X. Done Select menu option 2. No Agent Protocol Configuration Menu, digite C. O Configure Protocol Menu é exibido. 3. No Configure Protocol Menu, digite C. O Protocol Properties Menu para o protocolo configurado é exibido com propriedades do protocolo. As propriedades em seu menu poderão ser diferentes das mostradas nos exemplos. A tela a seguir é um exemplo das propriedades do DAML Protocol: DAML Protocol Properties A. USERNAME ****** ;Authorized user name. B. PASSWORD ****** ;Authorized user password. C. MAX_CONNECTIONS 100 ;Max Connections. D. PORTNUMBER ;Protocol Server port number. E. USE_SSL FALSE ;Use SSL secure connection. F. SRV_NODENAME ;Event Notif. Server name. G. SRV_PORTNUMBER 9443 ;Event Notif. Server port number. H. VALIDATE_CLIENT_CE FALSE ;Require client certificate. I. REQUIRE_CERT_REG FALSE ;Require registered certificate. X. Done Select menu option: 4. Digite a letra da opção de menu da propriedade de protocolo que você deseja configurar. Consulte a Tabela 3 a seguir para obter informações adicionais sobre as propriedades que você pode configurar para o DAML Protocol. Tabela 3. Opções do DAML Protocol Menu Opção Tarefa de Configuração n O seguinte aviso é exibido: Modify Property USERNAME : Digite um ID de usuário, por exemplo, admin. Esse valor é o ID de usuário que o Servidor Tivoli Identity Manager utiliza para conectar-se ao adaptador. Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager 11

26 Tabela 3. Opções do DAML Protocol Menu (continuação) Opção Tarefa de Configuração B O seguinte aviso é exibido: Modify Property PASSWORD : Digite uma senha, por exemplo, admin. Esse valor é a senha para o ID de usuário que o Servidor Tivoli Identity Manager utiliza para conectar-se ao adaptador. S O seguinte aviso é exibido: Modify Property MAX_CONNECTIONS : Digite o número máximo de conexões simultâneas abertas o adaptador suporta. O número padrão é 100. n O seguinte aviso é exibido: Modify Property PORTNUMBER : Digite um número de porta diferente. Esse valor é o número da porta que o Servidor Tivoli Identity Manager utiliza para conectar-se ao adaptador. O número da porta padrão é A O seguinte aviso é exibido: Modify Property USE_SSL : Digite TRUE ou FALSE para especificar se uma conexão SSL segura será utilizada para conexão ou desconexão do adaptador. O valor padrão é FALSE. Você deverá instalar um certificado, quando USE_SSL for definido como TRUE. Para obter mais informações sobre instalação de certificado, consulte Instalando o Certificado na página 39. u O seguinte aviso é exibido: Modify Property SRV_NODENAME : Digite o nome do servidor ou um endereço IP, por exemplo, Esse valor é o nome DNS ou o endereço IP do Servidor Tivoli Identity Manager que é utilizado para notificação de eventos e processamento assíncrono de pedidos. Nota: Se sua plataforma suportar conexões IPv6 (Internet Protocol version 6), você poderá especificar um servidor IPv6. G O seguinte aviso é exibido: Modify Property SRV_PORTNUMBER : Digite um número de porta diferente para acessar o Servidor Tivoli Identity Manager. Esse valor é o número de porta que o adaptador utiliza para conectar-se ao Servidor Tivoli Identity Manager. O número de porta padrão é IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

27 Tabela 3. Opções do DAML Protocol Menu (continuação) Opção Tarefa de Configuração H O seguinte aviso é exibido: Modify Property VALIDATE_CLIENT_CE : Digite TRUE para exigir que o Servidor Tivoli Identity Manager envie um certificado quando comunicar-se com o adaptador. Digite FALSE para permitir que o Servidor Tivoli Identity Manager se comunique com o adaptador sem um certificado. O valor padrão é FALSE. Notas: 1. Se você definir essa opção como TRUE, deverá configurar as opções de D a H. 2. O nome da propriedade é de fato VALIDATE_CLIENT_CERT. Ele é truncado por agentcfg para ajustar-se à tela. 3. Você deve utilizar o CertTool para instalar os certificados CD apropriados e opcionalmente registrar o certificado do Servidor Tivoli Identity Manager. Para obter mais informações sobre como utilizar o CertTool, consulte Gerenciando Certificados SSL Utilizando o CertTool na página 35. I O seguinte aviso é exibido: Modify Property REQUIRE_CERT_REG : Esse valor só se aplica quando a opção H é definida como TRUE. Digite TRUE para exigir que o certificado cliente do Servidor Tivoli Identity Manager seja registrado no adaptador antes que ele aceite uma conexão SSL. Digite FALSE para exigir que o certificado cliente seja conferido apenas com a lista de certificados CA. O valor padrão é FALSE. Para obter mais informações sobre certificados, consulte o Capítulo 4, Configurando a Autenticação SSL para o Adaptador UDB, na página No prompt, altere o valor e pressione Enter. O Protocol Properties Menu é exibido com suas novas configurações. Se você não desejar alterar o valor, simplesmente pressione Enter para retornar ao Protocol Properties Menu. 6. Repita as etapas 4 e 5 para configurar quantas propriedades de protocolo você precisar. 7. No Protocol Properties Menu, digite X para sair do menu. Configurando a Notificação de Eventos Notificação de eventos é um recurso do Adaptador UDB que atualiza o Servidor Tivoli Identity Manager a intervalos definidos. A notificação de eventos detecta alterações feitas no recurso gerenciado e atualiza o Servidor Tivoli Identity Manager com as alterações. Você poderá ativar a notificação de eventos se quiser que informações atualizadas do recurso gerenciado sejam enviadas novamente ao Servidor Tivoli Identity Manager entre reconciliações completas. A notificação de eventos não está planejada para substituir as reconciliações no Servidor Tivoli Identity Manager. Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager 13

28 Quando a notificação de eventos está ativada, um banco de dados de reconciliação é mantido na máquina onde o adaptador está instalado. O banco de dados é atualizado com as alterações solicitadas pelo Servidor Tivoli Identity Manager e permanecerá sincronizado com o servidor. Você pode especificar um intervalo para o processo de notificação de eventos a fim de comparar o banco de dados com os dados existentes atualmente no recurso gerenciado. Decorrido o intervalo, todas as diferenças entre o recurso gerenciado e o banco de dados são encaminhadas para o Servidor Tivoli Identity Manager e atualizadas no banco de dados local de captura instantânea. Há várias etapas para ativar a notificação de eventos. Essas etapas partem do princípio de que o adaptador está se comunicando com êxito com o recurso gerenciado e com o Servidor Tivoli Identity Manager. Em primeiro lugar, você deve configurar o nome do host, o número da porta e as informações de login do Servidor Tivoli Identity Manager. Para identificar o servidor para o protocolo DAML a ser utilizado, conclua as seguintes etapas: 1. No Agent Protocol Configuration Menu, selecione Configure Protocol. Para obter mais informações sobre como configurar um protocolo, consulte Alterando Definições de Configuração de Protocolo na página Digite a opção de menu para a propriedade SRV_NODENAME. 3. Especifique o endereço IP ou o nome do servidor que identifica o Servidor Tivoli Identity Manager e pressione Enter. O Protocol Properties Menu é exibido com suas novas configurações. 4. Digite a opção de menu para a propriedade SRV_PORTNUMBER. 5. Especifique o número da porta que o adaptador utiliza para conectar-se ao Servidor Tivoli Identity Manager para notificação de eventos e pressione Enter. O Protocol Properties Menu é exibido com suas novas configurações. O exemplo de menu mostra todas as opções exibidas quando a Event Notification está ativada. Se a Event Notification estiver desativada, nem todas as opções serão exibidas. Para definir a Event Notification para o Servidor Tivoli Identity Manager, conclua as etapas a seguir: 1. No Agent Main Configuration Menu, digite C. O Event Notification Menu é exibido. Event Notification Menu * Reconciliation interval : 1 day(s) * Next Reconciliation time : 23 hour(s) 56 min(s). 23 sec(s). * Configured Contexts : Jupiter, dd309 A. Enabled B. Time interval between reconciliations. C. Set Processing cache size. (currently: 50 Mbytes) D. Start event notification now. E. Set attributes to be reconciled. F. Reconciliation process priority. (current: 1) G. Add Event Notification Context. H. Modify Event Notification Context. I. Remove Event Notification Context. J. List Event Notification Contexts. X. Done Select menu option: 14 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

29 Nota: Esse menu mostra todas as opções que são exibidas quando a Event Notification está ativada. Se a Event Notification estiver desativada, nenhuma opção será exibida. 2. Digite a letra da opção de menu que você deseja alterar. A opção A deve ser ativada para que os valores das outras opções sejam efetivados. Pressione Enter para retornar ao Agent Event Notification Menu sem alterar o valor. Tabela 4. Opções do Event Notification Menu Opção Tarefa de Configuração n Se essa opção estiver ativada, o adaptador atualizará o Servidor Tivoli Identity Manager com as alterações no adaptador a intervalos regulares. Digite A para alternar entre as opções. Quando a opção está definida para: v Disabled, altera automaticamente para ativado. v Enabled, altera automaticamente para desativado. R O seguinte aviso é exibido: Enter new interval ([ww:dd:hh:mm:ss]) Digite um intervalo de reconciliação diferente.exemplo: [00:01:00:00:00] Nota: Esse valor é o intervalo a ser aguardado depois que a notificação de eventos é concluída e antes que seja executada novamente. O processo de notificação de eventos possui intensos recursos; portanto, esse valor não deve ser definido para ser executado com muita freqüência. C O seguinte aviso é exibido: Enter new cache size[5]: Digite um valor diferente para alterar o tamanho do cache de processamento. n Se essa opção for selecionada, a Event Notification será iniciada. E O menu Event Notification Entry Types é exibido. Consulte Definindo Acionadores de Notificação de Eventos na página 16 para obter informações adicionais. d O seguinte aviso é exibido: Enter new thread priority [1-10]: Digite um valor de encadeamento diferente para alterar a prioridade do processo de notificação de eventos. A definição da prioridade de encadeamento para um valor mais baixo reduz o impacto que o processo de notificação de eventos tem sobre o desempenho do adaptador. Um valor mais baixo também poderá fazer com que a notificação de eventos leve mais tempo. T O seguinte aviso é exibido: Context name : Digite o nome do novo contexto e pressione Enter. O novo contexto é adicionado. Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager 15

30 Tabela 4. Opções do Event Notification Menu (continuação) Opção Tarefa de Configuração H Um menu listando o contexto disponível é exibido. Consulte Modificando um Contexto de Notificação de Evento na página 17 para obter informações adicionais. I O menu Remove Context é exibido. Selecione o contexto a ser removido. O seguinte prompt é exibido: Delete context context1? [no]: Pressione Enter para sair sem excluir o contexto ou digite Yes e pressione Enter para excluir o contexto. J Os Event Notification Contexts são exibidos no seguinte formato: Context Name : Context1 Target DN : erservicename=context1,o=ibm, ou=ibm,dc=com --- Attributes for search request --- {search attributes listed} Se você alterou o valor para as opções B, C, E ou F, pressione Enter. As outras opções são alteradas automaticamente quando você digita a letra da opção de menu correspondente. O Event Notification Menu é exibido com suas novas configurações. Definindo Acionadores de Notificação de Eventos Por padrão, todos os atributos são consultados em busca de alterações no valor. Os atributos que são alterados com freqüência (por, exemplo, duração da senha ou último logon bem-sucedido) devem ser omitidos. 1. No Event Notification Menu, digite E. O menu Event Notification Entry Types é exibido. Event Notification Entry Types A. USER B. GROUP X. Done Select menu option: Os tipos USER e GROUP não serão exibidos no menu acima até que as seguintes condições tenham sido atendidas: a. A notificação de eventos tenha sido ativada b. Um contexto tenha sido criado e configurado c. Uma reconciliação completa tenha sido executada 2. Digite A para obter uma lista dos atributos retornados durante uma reconciliação do usuário ou digite B para obter os atributos retornados durante uma reconciliação de grupo. É exibida a Event Notification Attribute Listing para o tipo de reconciliação selecionada. A definição padrão lista todos os atributos que o adaptador suporta. O exemplo a seguir lista exemplos de atributos, e pode diferir da lista que é exibida em sua máquina. 16 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

31 Event Notification Attribute Listing (a) **erudbinstancename (b) **erudbprivindextab (c) **erudbprivselectview (d) **erudbindexname (e) **eruid (f) **erudbprivupdatetab (g) **erudbprivaltertab (h) **erudbprivinserttab (i) **erudbprivupdateview (j) **erudbprivwgrtabalter (k) **erudbprivinsertview (l) **erdepartment (m) **erudbprivdatabase (n) **erudbprivreftab (o) **erudbprivusetabspace (p) **erprivdeleteview (q) **erudbprivselecttab (r) **eraccountstatus (p)rev page 1 of 3 (n)ext X. Done Select menu option: 3. Digite a opção da letra do atributo a ser excluído de uma notificação de eventos. Os atributos marcados com asteriscos são retornados durante a Event Notification. Os atributos não marcados com asteriscos não são retornados durante a Event Notification. Modificando um Contexto de Notificação de Evento Contexto de notificação de eventos corresponde a um serviço no Servidor Tivoli Identity Manager. Alguns adaptadores suportam diversos serviços. Um Adaptador UDB pode ter vários serviços do Tivoli Identity Manager, especificando um ponto de base diferente para cada serviço. O ponto de base do Adaptador UDB é o ponto no servidor de diretório que é utilizado como raiz do adaptador. Esse ponto base pode ser uma OU (Organizational Unit) ou um DC (Domain Container). Como o ponto de base é um valor opcional, se não for especificado um valor, o adaptador utilizará o domínio padrão da máquina na qual ele está instalado. Você pode ter vários contextos de notificação de eventos, mas deverá ter pelo menos um adaptador. Na tela de exemplo a seguir, note que Context1, Context2 e Context3 são três contextos diferentes, todos tendo um ponto de base diferente. Para modificar um contexto de notificação de eventos, conclua as etapas a seguir: 1. No Event Notification Menu, digite H. O Modify Context Menu é exibido. Modify Context Menu A. Context1 B. Context2 C. Context3 X. Done Select menu option: 2. Digite a letra da opção de opção do contexto que você deseja modificar. O Modify Context Menu para o contexto selecionado é exibido. A. Set attributes for search B. Target DN: C. Delete Baseline Database X. Done Select menu option: Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager 17

32 Tabela 5. Opções do Modify Context Menu Opção Tarefa de Configuração Para Obter Mais Informações n Incluindo atributos de procura para notificação de eventos B Configurando o DN de destino para contextos de notificação de eventos S Removendo o banco de dados de linha de base para contextos de notificação de eventos Consulte a página 18. Consulte a página 18. Consulte a página 19. Incluindo Atributos de Procura para Notificação de Eventos Em alguns adaptadores, você poderá precisar especificar um par de atributo-valor para um ou mais contextos. Esses pares de atributo-valor, que são definidos ao concluir as etapas a seguir, são úteis para diversos propósitos: v Quando múltiplos valores são suportados por um único adaptador, cada serviço precisa especificar um ou mais atributos para diferenciá-lo dos outros serviços. v Os atributos de procura são transmitidos ao processo de notificação de eventos, depois de decorrido o intervalo de notificação de eventos ou de ser iniciado manualmente. Para cada contexto, um pedido de procura completa é enviado ao adaptador. Adicionalmente, os atributos especificados para esse contexto são transmitidos ao adaptador. v Quando o Servidor Tivoli Identity Manager inicia um processo de reconciliação, o adaptador substitui o banco de dados local que representa esse serviço pelo novo banco de dados. Para incluir atributos de procura, conclua as etapas a seguir: 1. No Modify Context Menu para o contexto, digite A. O menu Reconciliation Attribute Passed to Agent é exibido. Reconciliation Attributes Passed to Agent for Context: Context A. Add new attribute B. Modify attribute value C. Remove attribute X. Done Select menu option: O Adaptador UDB requer que o atributo erudbinstancename seja especificado para cada contexto. Esse é o nome da instância à qual o adaptador é conectado. O valor do atributo deve ser configurado para o Nome do Serviço definido no Formulário de Serviço do Tivoli Identity Manager. 2. Digite a letra da opção de menu da que você deseja alterar. Os nomes de atributos suportados serão exibidos com dois asteriscos (**) na frente de cada nome. Quando você digitar a letra de um atributo, ela ativará e desativará os asteriscos. Atributos sem asteriscos não serão atualizados durante uma notificação de eventos. O menu Reconciliation Attributes Passed to Agent é exibido com as alterações exibidas. Configurando o DN de Destino para Contextos de Notificação de Eventos O campo do DN de destino contém o nome exclusivo do serviço que recebe atualizações de notificação de eventos. 18 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

33 Para configurar o DN de destino, conclua as etapas a seguir: 1. No Modify Context Menu para o contexto, digite B. O seguinte prompt é exibido: Enter Target DN: 2. Digite o DN de destino para o contexto e pressione Enter. O DN de destino para o Event Notification Contexts deve estar no seguinte formato: erservicename=erservicename,o=organizationname,ou=tenantname,rootsuffix Cada elemento do DN é definido da seguinte maneira: erservicename Nome do serviço de destino. o Nome da organização. ou Nome do locatário em que a organização está localizada. rootsuffix Raiz da árvore de diretórios. O Modify Context Menu é exibido com o novo DN de destino listado. Removendo o Banco de dados de Linha de Base para Contextos de Notificação de Eventos Essa opção estará disponível somente depois que um contexto for criado e uma reconciliação for executada no contexto para criar um arquivo do Banco de Dados de Linha de Base. No Modify Context Menu para o contexto, digite C. O Modify Context Menu é exibido com a opção Delete Baseline Database removida. Alterando a Chave de Configuração Utilize a chave de configuração como senha para acessar a ferramenta de configuração do adaptador. Para alterar a chave de configuração do Adaptador UDB, conclua as etapas a seguir: 1. No prompt do Main Menu, digite D. 2. Altere o valor da chave de configuração e pressione Enter. Pressione Enter para retornar ao Main Configuration Menu sem alterar a chave de configuração. A chave de configuração padrão é agent. Certifique-se de escolher senhas que não sejam descobertas facilmente. A seguinte mensagem será exibida: Configuration key successfully changed. O programa de configuração é encerrado e o prompt do Main Menu é exibido. Alterando as Configurações do Log de Atividades Quando você ativa o log, o Tivoli Identity Manager mantém um arquivo de log datado de todas as transações, UDBAgent.log. Por padrão, o arquivo de log está localizado no diretório /log. Para alterar as configurações do log de atividades do Adaptador UDB, conclua as etapas a seguir: 1. No prompt do Main Menu, digite E. Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager 19

34 O Agent Activity Logging Menu é exibido. O exemplo a seguir mostra as configurações do log de atividades padrão. Agent Activity Logging Menu A. Activity Logging (Enabled). B. Logging Directory (current: /usr/tivoli/agents/udbagent/log). C. Activity Log File Name (current: UDBAgent.log). D. Activity Logging Max. File Size ( 1 mbytes) E. Activity Logging Max. Files ( 3 ) F. Debug Logging (Enabled). G. Detail Logging (Disabled). H. Base Logging (Disabled). I. Thread Logging (Disabled). X. Done Select menu option: 2. Digite a letra de opção de menu da opção de registro de atividades que você deseja alterar. A opção A deve ser ativada para que os valores das outras opções sejam efetivados. Pressione Enter para retornar ao Agent Activity Logging Menu sem modificar o valor. Tabela 6. Opções do Activity Logging Menu Opção Tarefa de Configuração O Configure essa opção como Enabled para que o adaptador mantenha um arquivo de log datado de todas as transações. Digite A para alternar entre as opções. Quando a opção está definida para: v Disabled, digitar um A altera automaticamente a opção para Enabled. v Enabled, digitar um A altera automaticamente a opção para Disabled. B O seguinte aviso é exibido: Enter log file directory: Digite um valor diferente para o diretório de registro, por exemplo, /home/log. Quando a opção de registro está ativada, detalhes sobre cada pedido de acesso são armazenados no arquivo de registro localizado nesse diretório. C O seguinte aviso é exibido: Enter log file name: Digite um valor diferente para o nome do arquivo de log. Quando a opção de registro está ativada, detalhes sobre cada pedido de acesso são armazenados no arquivo de registro. E O seguinte aviso é exibido: Enter maximum size of log files (mbytes): Digite um novo valor, por exemplo, 10. Os dados mais antigos são arquivados quando o arquivo de log atinge o tamanho de arquivo máximo. O tamanho do arquivo é medido em megabytes. É possível que o tamanho do arquivo de log de atividades exceda a capacidade do disco. 20 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

35 Tabela 6. Opções do Activity Logging Menu (continuação) Opção Tarefa de Configuração E O seguinte aviso é exibido: Enter maximum number of log files to retain: Digite um novo valor, até 100, por exemplo, 5. O adaptador exclui automaticamente os logs de atividades mais antigos além do limite especificado. d Se essa opção estiver definida como ativada, o adaptador incluirá as instruções de depuração no arquivo de log de todas as transações. Digite F para alternar entre as opções. Quando a opção está definida para: v Disabled, digitar um F altera automaticamente a opção para Enabled. v Enabled, digitar um F altera automaticamente a opção para Disabled. T Se essa opção estiver definida como ativada, o adaptador manterá um arquivo de log detalhado de todas as transações. A opção de log de detalhes deve ser utilizada apenas para finalidades de diagnóstico. O log detalhado permite mais mensagens do adaptador e poderá aumentar o tamanho dos logs. Digite G para alternar entre as opções. Quando a opção está definida para: v Disabled, digitar um G altera automaticamente a opção para Enabled. v Enabled, digitar um G altera automaticamente a opção para Disabled. H Se essa opção estiver configurada como ativada, o adaptador mantém um arquivo de log de todas as transações no ADK (Agent Development Kit) e em arquivos de biblioteca. O log de base aumentará substancialmente o tamanho dos logs. Digite H para alternar entre as opções. Quando a opção está definida para: v Disabled, digitar um H altera automaticamente a opção para Enabled. v Enabled, digitar um H altera automaticamente a opção para Disabled. T Se essa opção estiver ativada, o arquivo de log conterá IDs de encadeamento, além de uma data e um timestamp em cada linha do arquivo. Digite I para alternar entre as opções. Quando a opção está definida para: v Disabled, digitar um H altera automaticamente a opção para Enabled. v Enabled, digitar um H altera automaticamente a opção para Disabled. 3. Pressione Enter se você alterou o valor da opção B, C, D ou E. As outras opções são alteradas automaticamente quando você digita a letra da opção de menu correspondente. O Agent Activity Logging Menu é exibido com suas novas configurações. Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager 21

36 Alterando Configurações de Registro O procedimento a seguir descreve como alterar as definições do registro do Adaptador UDB. 1. No Main Menu, digite F. O menu de configurações de registro é exibido. UDBAgent 4.6 Agent Registry Menu A. Modify Non-encrypted registry settings. B. Modify encrypted registry settings. C. Multi-instance settings. X. Done Select menu option: 2. Consulte os procedimentos a seguir sobre como modificar definições de registro. Nota: Para cada banco de dados UDB gerenciado pelo Adaptador UDB, você deve definir os itens de registro criptografados e não criptografados. O item de registro para as configurações de registro não criptografadas é o nome do usuário administrativo do Serviço UDB. O item de registro para as configurações de registro criptografadas é a senha do usuário administrativo do Serviço UDB. O formato desses itens de registro é explicado em Modificando Configurações de Registro Não-criptografadas e Modificando Configurações de Registro Criptografadas na página 23. Modificando Configurações de Registro Não-criptografadas Para modificar as configurações de registro não-criptografadas, conclua as seguintes etapas: 1. No Agent Registry Menu, digite A. O Non-encrypted Registry Settings Menu é exibido. Agent Registry Items ENROLE_Version Data_Dir /usr/tivoli/agents/udbagent/data/ 03. UDBAdkDb_File UDBAdkDb 04. UDBServicesample db2inst Page 1 of 1 A. Add new attribute B. Modify attribute value C. Remove attribute X. Done Select menu option: 2. Digite a letra do menu relativa à ação que você deseja desempenhar em um atributo. Tabela 7. Descrições da Opção de Configuração de Atributo Opção Tarefa de Configuração n Incluir novo atributo B Modificar valor do atributo S Remover atributo 3. Digite o nome do item do registro e pressione Enter. 22 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

37 Consulte a Tabela 8 para obter uma descrição de cada chave de registro. 4. Se você selecionou a opção A ou B, digite o valor do item de registro e pressione Enter. O Non-encrypted Registry Settings Menu exibe as novas configurações. Nota: A chave para o usuário administrativo do Serviço UDB deve estar no seguinte formato: UDBService <alias-name> em que alias-name é o alias do banco de dados catalogado ao qual o adaptador se conectará. O alias-name é igual ao Serviço UDB que foi especificado no formulário de serviço do perfil, conforme explicado em Criando um Serviço UDB na página 6. O valor para essa chave ser o usuário administrativo do banco de dados catalogado. Por exemplo, para o alias do UDB sample com nome de usuário db2inst1, você deve digitar: v Nome do Item de Registro: UDBServicesample v Valor do Item de Registro: db2inst1 A Tabela 8 descreve as chaves de registro não criptografadas e suas configurações disponíveis: Tabela 8. Descrições das Chaves de Registro Não Criptografadas Chave Descrição Data_Dir Especifica o caminho do diretório de dados. UDBAdkDB_File Especifica o nome do arquivo AdkDB, que contém o ID de login do usuário e o ConnectString para o DB2 UDB RDBMS. ConnectString é utilizado para conectar ao DB2 e para localizar o usuário no DB2. UDBService<alias-name> Especifica o usuário administrativo do banco de dados catalogado, em que <alias-name> é o alias do banco de dados catalogado ao qual o adaptador está conectado. Modificando Configurações de Registro Criptografadas Para modificar as configurações de registro criptografadas, conclua as seguintes etapas: 1. No Agent Registry Menu, digite B. O menu de configurações de registro criptografadas é exibido. Encrypted Registry Items UDBPasswdsample ***** Page 1 of 1 A. Add new attribute. B. Modify attribute value. C. Remove attribute. X. Done Select menu option: 2. Digite a letra do menu relativa à ação que você deseja desempenhar em um atributo. Tabela 9. Descrições da Opção de Configuração de Atributo Opção Tarefa de Configuração Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager 23

38 Tabela 9. Descrições da Opção de Configuração de Atributo (continuação) n Incluir novo atributo B Modificar valor do atributo S Remover atributo 3. Digite o nome do item do registro e pressione Enter. 4. Se você selecionou a opção A ou B, digite o valor do item de registro e pressione Enter. O menu de configurações de registro criptografadas exibe as novas configurações. Nota: A chave para a senha do usuário administrativo do Serviço UDB deve estar no seguinte formato: UDBPasswd <alias-name> em que alias-name é o alias do banco de dados catalogado ao qual o adaptador se conectará. O alias-name é igual ao Serviço UDB que foi especificado no formulário de serviço do perfil, conforme explicado em Criando um Serviço UDB na página 6. O valor para essa chave ser a senha do usuário administrativo do banco de dados catalogado. Por exemplo, para o alias do UDB sample com a senha do usuário administrativo db2inst1, você deve digitar: v Nome do Item de Registro: UDBPasswdsample v Novo Valor do Item de Registro: v Verificação: A Tabela 10 descreve as chaves de registro criptografadas e suas configurações disponíveis: Tabela 10. Descrições das Chaves de Registro Criptografadas Chave Descrição UDBPasswd<alias-name> Especifica se senha do usuário administrativo do banco de dados catalogado, em que <alias-name> é o alias do banco de dados catalogado ao qual o adaptador está conectado. Alterando Configurações Avançadas Você pode alterar as configurações de contagem de encadeamentos do Adaptador UDB para os seguintes tipos de pedidos: v Adição de Login do Sistema v Alteração de Login do Sistema v Exclusão de Login do Sistema v Reconciliação Essas definições determinam o número máximo de pedidos processados simultaneamente pelo Adaptador UDB. Para alterar essas configurações, conclua as etapas a seguir: 1. No prompt do Main Menu, digite G. O Advanced Settings Menu é exibido. O exemplo a seguir mostra as configurações padrão de contagem de encadeamentos. 24 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

39 UDBAgent 4.6 Advanced Settings Menu A. Single Thread Agent (current:true) B. ADD max. thread count. (current:3) C. MODIFY max. thread count. (current:3) D. DELETE max. thread count. (current:3) E. SEARCH max. thread count. (current:3) F. Allow User EXEC procedures (current:false) G. Archive Request Packets (current:false) H. UTF8 Conversion support (current:true) I. Pass search filter to agent (current:false) J. Thread Priority Level (1-10) (current:4) X. Done Select menu option: 2. Digite a letra de opção de menu da definição avançada que você deseja alterar. Para obter uma descrição de cada opção, consulte a Tabela 11, que descreve as configurações avançadas. Tabela 11. Opções do Advanced Settings Menu Opção Descrição n Força o adaptador a permitir somente um pedido por vez. O valor padrão é TRUE. R Controla quantos pedidos ADD simultâneos podem ser executados por vez. O valor padrão é 3. C Controla quantos pedidos MODIFY simultâneos podem ser executados por vez. O valor padrão é 3. E Controla quantos pedidos DELETE simultâneos podem ser executados por vez. O valor padrão é 3. E Controla quantos pedidos SEARCH simultâneos podem ser executados por vez. O valor padrão é 3. d Determina se o adaptador permite funções pré e pós execução. A ativação dessa opção consiste em um risco de segurança potencial. O valor padrão é FALSE. T Essa opção não é mais suportada. H Essa opção não é mais suportada. I Atualmente, esse adaptador não suporta o processamento de filtros diretamente. Essa opção deve ser sempre FALSE. J Define o nível de prioridade de encadeamento do adaptador. O valor padrão é Altere o valor e pressione Enter. O menu de configurações avançadas é exibido com suas novas configurações. Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager 25

40 Visualizando Estatísticas Para visualizar um log de eventos do Adaptador UDB, conclua as etapas a seguir: 1. No prompt do Main Menu, digite H. O histórico de atividades do adaptador é exibido. UDBAgent 4.6 Agent Request Statistics Date Add Mod Del Ssp Res Rec /15/ X. Done 2. Digite X para retornar ao Main Configuration Menu. Acessando a Ajuda e Opções Adicionais Para acessar o menu de ajuda do agentcfg e utilizar os argumentos da ajuda, conclua as etapas a seguir: 1. No prompt do Main Menu, digite X. O prompt de comandos é exibido e você está no diretório \bin. 2. Digite agentcfg -help no prompt para exibir o menu de ajuda. A seguinte lista de possíveis comandos é exibida: -version ; Show version -hostname < value> ; Target nodename to connect to (Default:Local host IP address) -findall ; Find all agents on target node -list ; List available agents on target node -agent <value> ; Name of agent -tail ; Display agent s activity log -schema ; Display agent s attribute schema -portnumber <value>; Specified agent s TCP/IP port number -netsearch <value> ; Lookup agents hosted on specified subnet -confidencetest ; Confidence test -setup ; Confidence test setup -help ; Display this help screen Tabela 12 descreve cada argumento. Tabela 12. Argumentos e Descrições para o Menu de Ajuda do agentcfg. Argumento Descrição -version Utilize esse argumento para exibir a versão da ferramenta agentcfg. -hostname <value> Utilize o argumento -hostname com qualquer um dos seguintes argumentos para especificar um host diferente: v v v v -findall -list -tail -agent Digite um nome de host ou endereço IP como o valor. 26 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

41 Tabela 12. Argumentos e Descrições para o Menu de Ajuda do agentcfg. (continuação) Argumento Descrição -findall Utilize esse argumento para procurar e exibir todos os endereços de porta entre e e seus nomes de adaptador designados. Essa opção será interrompida em números de porta não utilizados; por isso, poderá levar vários minutos para ser concluída. Adicione o argumento -hostname para pesquisar um host remoto. -list Utilize esse argumento para exibir os adaptadores que estão instalados no host local do Adaptador UDB. Por padrão, a primeira vez que você instala um adaptador, ele é designado ao endereço de porta ou ao próximo número de porta disponível. Todos os adaptadores instalados subseqüentemente são designados ao próximo endereço de porta disponível. Uma vez localizada uma porta não utilizada, a listagem é interrompida. Utilize o argumento -hostname para procurar um host remoto. -agent <value> Utilize esse argumento para especificar o adaptador que você deseja configurar. Digite um nome de adaptador como o valor. Utilize esse argumento com o argumento -hostname para modificar a definição de configuração a partir de um host remoto. Também é possível utilizar esse argumento com o argumento -tail. -tail Utilize esse argumento com o argumento -agent para exibir o log de atividades para um adaptador. Inclua o argumento -hostname para exibir o arquivo de log para um adaptador em um host diferente. -schema Essa opção não é mais suportada. -portnumber <value> Utilize esse argumento com o argumento -agent para especificar o número de porta que é utilizado para conexões da ferramenta agentcfg. -netsearch <value> Utilize esse argumento com o argumento -findall para exibir todos os adaptadores ativos no sistema. Você deve especificar um endereço de sub-rede como o valor. -confidencetest Utilize esse argumento para executar um teste para incluir, modificar, procurar e excluir um pedido ao adaptador. O teste de confiança permite testar a conexão entre o adaptador e o UDB RDBMS. Isso permite a você verificar se o adaptador pode conectar-se ao UDB RDBMS sem o Servidor Tivoli Identity Manager. -setup Utilize esse argumento, junto com o argumento confidence para configurar o teste de confiança. -help Utilize esse argumento para exibir as informações de Ajuda para o comando agentcfg. 3. Digite agentcfg e um ou mais dos argumentos suportados no prompt. Você deve digitar agentcfg antes de cada argumento para executar a ferramenta de configuração do adaptador. Digite agentcfg -list para listar todos os adaptadores no endereço IP do host local. Observe que o nó padrão para o Servidor Tivoli Identity Manager é A saída é semelhante à seguinte: Capítulo 3. Configurando o Adaptador UDB do IBM Tivoli Identity Manager 27

42 Agent(s) installed on node UDBAgent (44970) Digite agentcfg -agent UDBAgent para exibir o Main Menu da ferramenta agentcfg, que é utilizada para visualizar ou modificar os parâmetros do Adaptador UDB. Digite agentcfg -list -hostname para listar os adaptadores em um host cujo endereço IP seja Observe que o nó padrão para o Adaptador UDB é A saída é semelhante à seguinte: Agent(s) installed on node UDBAgent (44970) Digite agentcfg -agent UDBAgent -hostname para exibir o Main Menu da ferramenta agentcfg para um host cujo endereço IP seja Utilize as opções do menu para exibir ou modificar os parâmetros do Adaptador UDB. 28 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

43 Capítulo 4. Configurando a Autenticação SSL para o Adaptador UDB Para estabelecer uma conexão segura entre um adaptador Tivoli Identity Manager e o Servidor Tivoli Identity Manager, é necessário configurar o adaptador e o servidor para que utilizem a autenticação SSL (Secure Sockets Layer) com o protocolo de comunicação padrão, DAML. A configuração do adaptador para SSL assegura que o Servidor Tivoli Identity Manager verifique a identidade do adaptador antes que uma conexão segura seja estabelecida. Você pode configurar a autenticação SSL para conexões originárias do Servidor Tivoli Identity Manager ou do adaptador. Normalmente, o Servidor Tivoli Identity Manager inicia uma conexão com o adaptador para definir e recuperar o valor de um atributo gerenciado no adaptador. Entretanto, dependendo dos requisitos de segurança de seu ambiente, talvez seja necessário configurar a autenticação SSL para conexões originárias do adaptador. Por exemplo, se o adaptador utilizar eventos para notificar o Servidor Tivoli Identity Manager de alterações nos atributos do adaptador, você poderá configurar a autenticação SSL para conexões da Web que se originem do adaptador para o servidor Web utilizado pelo Servidor Tivoli Identity Manager. Em um ambiente de produção, é necessário ativar a segurança SSL; entretanto, para finalidades de teste, talvez você queira desativar o SSL. Se um aplicativo externo que se comunica com o adaptador (como o Servidor Tivoli Identity Manager) estiver definido para utilizar autenticação de servidor, você deverá ativar o SSL no adaptador para verificar o certificado que o aplicativo apresenta. Este capítulo apresenta uma visão geral da autenticação SSL, dos certificados e de como ativar a autenticação SSL com o uso do utilitário CertTool. Visão Geral dos Certificados Digitais e SSL Ao implementar o Tivoli Identity Manager em uma rede corporativa, você deve proteger a comunicação entre o Servidor Tivoli Identity Manager e os produtos de software e componentes com os quais o servidor se comunica. O protocolo SSL padrão de mercado, que utiliza certificados digitais assinados de uma CA (Autoridade de Certificação) para autenticação, é utilizado para proteger a comunicação em uma implementação do Tivoli Identity Manager. Adicionalmente, o SSL fornece a criptografia dos dados trocados entre os aplicativos. A criptografia torna os dados transmitidos pela rede inteligíveis apenas para o destinatário pretendido. Os certificados digitais assinados permitem que dois aplicativos se conectem a uma rede para autenticar a identidade entre si. Um aplicativo que age como um servidor SSL apresenta suas credenciais em um certificado digital assinado para verificar se um cliente SSL é a entidade que ele declara ser. Um aplicativo que age como um servidor SSL pode também ser configurado para requerer que o aplicativo que age como um cliente SSL apresente suas credenciais em um certificado, concluindo por meio disso uma troca de certificados bidirecionais. Os certificados assinados são emitidos por uma autoridade de certificação terceirizada, mediante uma taxa. Alguns utilitários, como aqueles fornecidos pelo OpenSSL, também podem emitir certificados assinados. Direitos Autorais IBM Corp. 2002,

44 Um certificado de autoridade de certificação (certificado CA) deve ser instalado para verificar a origem de um certificado digital assinado. Quando um aplicativo receber um certificado assinado de outro aplicativo, utilizará um certificado de CA para verificar o originador do certificado. Uma autoridade de certificação pode ser de renome e amplamente utilizada por outras organizações, ou pode ser local para uma região ou empresa específica. Muitos aplicativos, como navegadores da Web, são configurados com os certificados CA de autoridades de certificação de renome para eliminar ou reduzir a tarefa de distribuir certificados CA por meio de zonas de segurança em uma rede. Chaves Privadas, Chaves Públicas e Certificados Digitais Chaves, certificados digitais e autoridades de certificação confiáveis são utilizados para estabelecer e verificar as identidades dos aplicativos. O SSL utiliza tecnologia de criptografia de chave pública para autenticação. Na criptografia de chave pública, uma chave pública e uma chave privada são geradas para um aplicativo. Os dados criptografados com a chave pública só podem ser decriptografados utilizando a chave privada correspondente. De maneira semelhante, os dados criptografados com a chave privada podem ser decriptografados apenas utilizando a chave pública correspondente. A chave privada é protegida por senha em um arquivo do banco de dados de chaves, de modo que apenas o proprietário possa acessar a chave privada para decriptografar mensagens criptografadas utilizando a chave pública correspondente. Certificado digital assinado é um método padrão de mercado para verificar a autenticação de uma entidade, como um servidor, um cliente ou um aplicativo. Para garantir segurança máxima, um certificado é emitido por uma autoridade de certificação de terceiros. Um certificado contém as seguintes informações para verificar a identidade de uma entidade: Informações organizacionais Esta seção do certificado contém informações que identificam com exclusividade o proprietário do certificado, como um nome e endereço organizacional. Você fornece essas informações ao gerar um certificado com o uso de um utilitário de gerenciamento de certificados. Chave pública O receptor do certificado utiliza a chave pública para decifrar texto criptografado enviado pelo proprietário do certificado para verificar sua identidade. A chave pública tem uma chave privada correspondente que criptografa o texto. Nome distinto da autoridade de certificação O emissor do certificado identifica a si próprio com essas informações. Assinatura digital O emissor do certificado o assina com uma assinatura digital para verificar sua autenticidade. Essa assinatura é comparada à assinatura no certificado de CA correspondente para verificar se o certificado foi originado em uma autoridade de certificação confiável. Navegadores da Web, servidores e outros aplicativos ativados para SSL geralmente aceitam como genuíno qualquer certificado digital que seja assinado por uma autoridade de certificação confiável e por outro lado válido. Por exemplo, um certificado digital pode ser invalidado se tiver expirado ou se o certificado de CA utilizado para verificá-lo tiver expirado, ou porque o nome distinto do certificado digital do servidor não corresponde ao nome distinto especificado pelo cliente. 30 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

45 Certificados Auto-assinados Você pode utilizar certificados auto-assinados para testar uma configuração SSL antes de criar e instalar um certificado assinado emitido por uma autoridade de certificação. Um certificado auto-assinado contém uma chave pública, informações sobre o proprietário do certificado e a assinatura do proprietário. Possui uma chave privada associada, mas não verifica a origem do certificado por meio de uma autoridade de certificação de terceiros. Uma vez gerado um certificado auto-assinado em um aplicativo servidor SSL, você deverá extraí-lo e incluí-lo no registro de certificado do aplicativo cliente SSL. Esse procedimento é equivalente a instalar um certificado CA que corresponda a um certificado do servidor. Entretanto, não inclua a chave privada no arquivo quando você extrair um certificado auto-assinado para utilizar como o equivalente de um certificado CA. Use um utilitário key management para gerar um certificado auto-assinado e uma chave privada, para extrair um certificado auto-assinado, e para incluí-lo. Onde e como optar pelo uso de certificados auto-assinados depende de seus requisitos de segurança. Para obter o nível mais alto de autenticação entre componentes de software críticos, não utilize certificados auto-assinados ou utilize-os seletivamente. Por exemplo, você pode optar por autenticar aplicativos que protegem os dados do servidor com certificados digitais assinados e utilizar certificados auto-assinados para autenticar navegadores da Web ou adaptadores Tivoli Identity Manager. Se você estiver utilizando certificados auto-assinados, nos seguintes procedimentos, poderá substituir um certificado auto-assinado por um par de certificado CA e certificado. Formatos de Certificado e de Chave Certificados e chaves são armazenados em arquivos com os seguintes formatos: Formato.pem Um arquivo de formato.pem (privacy-enhanced mail) começa e termina com as seguintes linhas: Formato.arm -----BEGIN CERTIFICATE END CERTIFICATE----- Um formato de arquivo.pem suporta vários certificados digitais, incluindo uma cadeia de certificados. Se sua organização utiliza cadeia de certificados, use esse formato para criar certificados CA. Um arquivo.arm contém uma representação ASCII codificada em base 64 de um certificado, incluindo sua chave pública, mas não sua chave privada. Um formato de arquivo.arm é gerado e usado pelo utilitário IBM Key Management. Formato.der Um arquivo.der contém dados binários. Um arquivo.der só pode ser utilizado para um único certificado, ao contrário de um arquivo.pem, que pode conter vários certificados. Formato.pfx (PKCS12) Arquivo PKCS12 é um arquivo portátil que contém um certificado e uma chave privada correspondente. Esse formato é útil para conversões de um Capítulo 4. Configurando a Autenticação SSL para o Adaptador UDB 31

46 O Uso da Autenticação SSL tipo de implementação SSL em uma implementação diferente. Por exemplo, você pode criar e exportar um arquivo PKCS12 usando o utilitário IBM Key Management, importando, em seguida, o arquivo para outra máquina usando o utilitário CertTool. Quando você inicia o adaptador, os protocolos de conexão disponíveis são carregados. O protocolo DAML é o único protocolo disponível que suporta o uso de autenticação SSL. Você pode especificar o uso da implementação DAML SSL. A implementação DAML SSL utiliza um registro de certificado para armazenar chaves privadas e certificados. O local do registro de certificado é gerenciado internamente pela chave CertTool e pela ferramenta de gerenciamento de certificado; assim, não especifique o local do registro quando executar tarefas de gerenciamento de certificados. Para obter mais informações sobre o DAML Protocol, consulte Alterando Definições de Configuração de Protocolo na página 10. Configurando Certificados para Autenticação SSL Utilize os procedimentos a seguir para configurar o adaptador para autenticação SSL de uma ou duas vias, utilizando certificados assinados. Para executar esses procedimentos, use o utilitário CertTool. Configurando Certificados para Autenticação SSL de Uma Via Neste cenário, o servidor Tivoli Identity Manager e o adaptador Tivoli Identity Manager estão definidos para utilizar SSL. A autenticação de cliente não está definida em nenhum aplicativo. O servidor Tivoli Identity Manager funciona como o cliente SSL e inicia a conexão. O adaptador funciona como o servidor SSL e responde enviando seu certificado assinado para o Servidor Tivoli Identity Manager. O servidor Tivoli Identity Manager utiliza o certificado CA instalado para validar o certificado enviado pelo adaptador. Na Figura 2, O Aplicativo A funciona como o Servidor Tivoli Identity Manager e o Aplicativo B funciona como o adaptador Tivoli Identity Manager. Servidor Tivoli Identity Manager (cliente SSL) Adaptador Tivoli Identity Manager (servidor SSL) Armazenamento de chave Iniciar comunicação Certificado A de CA Verificar Enviar Certificado B Certificado A Figura 2. Autenticação de Uma Via (Autenticação de Servidor) Para configurar o SSL de uma via, execute as seguintes tarefas para cada aplicativo: 32 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

47 1. No adaptador, conclua estas etapas: a. Inicie o utilitário CertTool. b. Para configurar o aplicativo servidor SSL com um certificado assinado emitido por uma autoridade de certificação: 1) Crie um CSR (Certificate Signing Request) e uma chave privada. Esta etapa cria o certificado com uma chave pública incorporada e uma chave privada separada e coloca a chave privada no valor do registro PENDING_KEY. 2) Submeta o CSR à autoridade de certificação utilizando as instruções fornecidas pela CA. Ao enviar o CSR, especifique que você deseja que o certificado de CA raiz seja devolvido com o certificado do servidor. 2. No Servidor Tivoli Identity Manager, conclua uma destas etapas: v Se você estiver configurando o uso de um certificado assinado emitido por uma CA de renome, verifique se o Servidor Tivoli Identity Manager armazenou o certificado raiz da CA (certificado CA) em seu armazenamento de chave. Se o armazenamento de chave não contiver o certificado CA, extraia-o do adaptador e inclua-o no armazenamento de chave do servidor. v Se você estiver configurando o uso de certificados auto-assinados: Se você gerou o certificado auto-assinado no Servidor Tivoli Identity Manager, o certificado já estará instalado em seu armazenamento de chave. Se você gerou o certificado auto-assinado usando o utilitário key management de outro aplicativo, extraia o certificado do armazenamento de chave desse aplicativo e inclua-o no armazenamento de chave do Servidor Tivoli Identity Manager. Configurando Certificados para Autenticação SSL de Duas Vias Neste cenário, o servidor Tivoli Identity Manager e o adaptador Tivoli Identity Manager estão definidos para utilizar o SSL e o adaptador está definido para utilizar a autenticação de cliente. Ao enviar seu certificado ao Servidor Tivoli Identity Manager, o adaptador solicita a verificação de identidade do servidor, que envia seu certificado assinado ao adaptador. Ambos os aplicativos são configurados com certificados assinados e certificados CA correspondentes. Na Figura 3 na página 34, o Servidor Tivoli Identity Manager funciona como o Aplicativo A e o adaptador Tivoli Identity Manager funciona como o Aplicativo B. Capítulo 4. Configurando a Autenticação SSL para o Adaptador UDB 33

48 Servidor Tivoli Identity Manager (cliente SSL) Armazenamento de Chave Certificado A de CA Verificar Iniciar comunicação Enviar Certificado A Adaptador Tivoli Identity Manager (servidor C SSL) Certificado A Certificado B Verificar Certificado B de CA Figura 3. Autenticação SSL de Duas Vias (Autenticação de Cliente) O procedimento a seguir supõe que você já configurou o adaptador e o Servidor Tivoli Identity Manager para autenticação SSL de uma via utilizando o procedimento descrito em Configurando Certificados para Autenticação SSL de Uma Via na página 32. Portanto, se você estiver utilizando certificados assinados de uma CA: v O adaptador está configurado com uma chave privada e um certificado assinado que foi emitido por uma CA. v O Servidor Tivoli Identity Manager está configurado com o certificado CA da CA que emitiu o certificado assinado do adaptador. Para concluir a configuração do certificado para SSL de duas vias, execute as seguintes tarefas: 1. No Servidor Tivoli Identity Manager, crie um CSR e uma chave privada, obtenha um certificado de uma CA, instale o certificado CA, instale o certificado recém-assinado e extraia o certificado CA para um arquivo temporário. 2. No adaptador, inclua o certificado CA que foi extraído do armazenamento de chave do Servidor Tivoli Identity Manager para o adaptador. Quando tiver concluído a configuração de certificado de duas vias, cada aplicativo terá seu próprio certificado e chave privada e o certificado da CA que emitiu os certificados para cada aplicativo. Configurando Certificados quando o Adaptador Funciona como um Cliente SSL Neste cenário, o adaptador funciona como um cliente SSL e também como um servidor SSL. Este cenário será aplicável se o adaptador iniciar uma conexão com o servidor Web (utilizado pelo Servidor Tivoli Identity Manager) para enviar uma notificação de evento. Por exemplo, o adaptador inicia a conexão e o servidor Web responde apresentando seu certificado ao adaptador. A Figura 4 na página 35 ilustra como um adaptador Tivoli Identity Manager funciona como um servidor SSL e um cliente SSL. Ao comunicar com o Servidor Tivoli Identity Manager, o adaptador envia seu certificado para autenticação. Ao comunicar com o servidor Web, o adaptador recebe o certificado do servidor Web. 34 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

49 Certificado A Certificado C de CA Adaptador Tivoli Identity Manager A Iniciar Comunicação Certificado A Certificado A de CA Servidor Tivoli Identity Manager B Certificado C Iniciar Comunicação Certificado C Servidor Web C Figura 4. Adaptador Tivoli Identity Manager Funcionando como um Servidor SSL e um Cliente SSL Se o Servidor Web estiver configurado para autenticação SSL de duas vias, ele verificará a identidade do adaptador, que envia seu certificado assinado ao servidor Web (não mostrado na ilustração). Para ativar a autenticação SSL de duas vias entre o adaptador e o servidor Web, utilize o seguinte procedimento: 1. Configure o servidor Web para utilizar autenticação de cliente. 2. Siga o procedimento para criar e instalar um certificado assinado no servidor Web. 3. Instale o certificado CA no adaptador usando o utilitário CertTool. 4. Inclua no servidor Web o certificado CA correspondente ao certificado assinado do adaptador. Para obter mais informações sobre como configurar certificados quando o adaptador inicia uma conexão com o servidor Web (utilizado pelo Servidor Tivoli Identity Manager) para enviar uma notificação de evento, consulte o Tivoli Identity Manager Information Center. Gerenciando Certificados SSL Utilizando o CertTool Os procedimentos nesta seção descrevem como usar o utilitário CertTool para gerenciar chaves privadas e certificados. Esta seção inclui instruções para a execução das seguintes tarefas: v Iniciando o CertTool na página 36. v Gerando uma Chave Privada e um Pedido de Certificado na página 38. v Instalando o Certificado na página 39. v Instalando o Certificado e a Chave de um Arquivo PKCS12 na página 39. v Visualizando o Certificado Instalado na página 39. v Visualizando Certificados CA na página 40. v Instalando um Certificado CA na página 40. v Excluindo um Certificado CA na página 40. v Visualizando Certificados Registrados na página 40. v Registrando um Certificado na página 41. v Cancelando o Registro de um Certificado na página 41. Capítulo 4. Configurando a Autenticação SSL para o Adaptador UDB 35

50 Iniciando o CertTool Para iniciar a ferramenta de configuração de certificado, CertTool, para o Adaptador UDB, conclua estas etapas: 1. Efetue login no Adaptador UDB. 2. Vá para o diretório bin do adaptador. Por exemplo, se o diretório do Adaptador UDB estiver no local padrão, digite o seguinte comando: # cd usr/tivoli/agents/udbagent/bin 3. Digite CertTool -agent UDBAgent no prompt. O Main Menu é exibido: Main menu - Configuring agent: UDBAgent A. Generate private key and certificate request B. Install certificate from file C. Install certificate and key from PKCS12 file D. View current installed certificate E. List CA certificates F. Install a CA certificate G. Delete a CA certificate H. List registered certificates I. Register certificate J. Unregister a certificate K. Export certificate and key to PKCS12 file X. Quit Choice: No Main Menu, você pode gerar uma chave privada e o pedido de certificado, instalar e excluir certificados, registrar e cancelar o registro de certificados e listar certificados. As seções a seguir resumem o propósito de cada grupo de opções. O primeiro conjunto de opções (A a D) permite a você gerar um CSR e instalar no adaptador o certificado assinado retornado. A. Generate private key and certificate request Gere um CSR e a chave privada associada que é enviada à autoridade de certificação. Para obter mais informações sobre a opção A, consulte Gerando uma Chave Privada e um Pedido de Certificado na página 38. B. Install certificate from file Instalar um certificado a partir de um arquivo. Esse arquivo deve ser o certificado assinado retornado pela CA em resposta ao CSR gerado pela opção A. Para obter mais informações sobre a opção B, consulte Instalando o Certificado na página 39. C. Install certificate and key from a PKCS12 file Instalar um certificado a partir do arquivo formatado PKCS12 que inclua o certificado público e uma chave privada. Se as opções A e B não forem utilizadas para obter um certificado, o certificado que você utilizar deverá estar no formato PKCS12. Para obter mais informações sobre a opção C, consulte Instalando o Certificado e a Chave de um Arquivo PKCS12 na página 39. D. View current installed certificate Visualize o certificado que está instalado no sistema. Para obter mais informações sobre a opção D, consulte Visualizando o Certificado Instalado na página IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

51 O segundo conjunto de opções permite a você instalar certificados CA raiz no adaptador. Um certificado CA é utilizado pelo adaptador Tivoli Identity Manager para validar o certificado correspondente apresentado por um cliente, como o Servidor Tivoli Identity Manager. E. List CA certificates Mostrar os certificados instalados de CA. O adaptador só se comunica com os Servidores Tivoli Identity Manager cujos certificados são validados por um dos certificados CA instalados. F. Install a CA certificate Instalar um novo certificado de CA para que os certificados gerados por essa CA possam ser validados. O arquivo de certificado CA pode estar no formato codificado X.509 ou PEM. Para obter mais informações sobre como instalar um certificado CA, consulte Instalando um Certificado CA na página 40. G. Delete a CA certificate Remover um dos certificados instalados de CA. Para obter mais informações sobre como excluir um certificado CA, consulte Excluindo um Certificado CA na página 40. O restante das opções (H a K) se aplica a adaptadores que devem autenticar o aplicativo (por exemplo, o Servidor Tivoli Identity Manager ou o servidor Web) ao qual o adaptador está enviando informações. Essas opções permitem a você registrar certificados no adaptador. No Tivoli Identity Manager Versão 4.5 ou anterior, o certificado assinado do servidor Tivoli Identity Manager deve ser registrado em um adaptador para permitir autenticação de cliente no adaptador. Se você não planeja fazer upgrade de um adaptador existente para utilizar certificados CA para autenticação de cliente, o certificado assinado apresentado pelo Servidor Tivoli Identity Manager deverá ser registrado no adaptador. Se você configurar o adaptador para utilizar notificação de evento, ou a autenticação de cliente estiver ativada em DAML, será necessário instalar o certificado CA correspondente ao certificado assinado do Servidor Tivoli Identity Manager utilizando a opção F. Install a CA certificate. H. List registered certificates Listar todos os certificados registrados que serão aceitos para comunicações. Para obter mais informações sobre como listar certificados registrados, consulte Visualizando Certificados Registrados na página 40. I. Register a certificate Registrar um novo certificado. O certificado a ser registrado deve estar no formato X.509 codificado em Base 64 ou PEM. Para obter mais informações sobre como registrar certificados, consulte Registrando um Certificado na página 41. J. Unregister a certificate Cancelar (remover) o registro de um certificado da lista registrada. Para obter mais informações sobre como cancelar o registro de certificados, consulte Cancelando o Registro de um Certificado na página 41. K. Export certificate and key to PKCS12 file Exporte um certificado e uma chave privada instalados anteriormente. Serão solicitados o nome do usuário e uma senha para criptografia. Para obter mais informações sobre como exportar um certificado e uma chave para um arquivo PKCS12, consulte Exportando um Certificado e uma Chave para o Arquivo PKCS12 na página 41. Capítulo 4. Configurando a Autenticação SSL para o Adaptador UDB 37

52 Gerando uma Chave Privada e um Pedido de Certificado Um pedido de assinatura de certificado é um certificado não assinado que é um arquivo de texto. Quando você submete um certificado não assinado a uma autoridade de certificação, a CA assina o certificado com a assinatura digital privada que está incluída em seu certificado CA correspondente. Quando o CSR é assinado, ele se torna um certificado válido. Um CSR contém informações sobre sua organização, como o nome dela, o país e a chave pública do servidor Web. Para gerar um arquivo CSR, conclua estas etapas: 1. No Main Menu do CertTool, digite A. A mensagem e o prompt a seguir são exibidos: Enter values for certificate request (press enter to skip value) No prompt Organization, digite o nome de sua organização e pressione Enter. 3. No prompt Organizational Unit, digite a organizational unit e pressione Enter. 4. No prompt Agent Name, digite o nome do adaptador para o qual você está solicitando um certificado e pressione Enter. 5. No prompt , digite o endereço de da pessoa de contato desse pedido e pressione Enter. 6. No prompt State, digite o estado no qual o adaptador reside (se o adaptador estiver nos Estados Unidos) e pressione Enter. Algumas autoridades de certificação não aceitam abreviações em duas letras para estados; por isso, você deve digitar o nome completo do estado. 7. No prompt Country, digite o país no qual o adaptador reside e pressione Enter. 8. No prompt Locality, digite o nome da cidade na qual o adaptador reside e pressione Enter. 9. No prompt Accept these values, digite Y para aceitar os valores exibidos ou digite N para inserir os valores novamente e pressione Enter. A chave privada e o pedido de certificado são gerados depois que os valores são aceitos. 10. No prompt Enter name of file to store PEM cert request, digite o nome do arquivo que você deseja utilizar para armazenar os valores especificados durante as etapas anteriores e pressione Enter. 11. Pressione Enter para continuar. O pedido de certificado e os valores de entrada são gravados no arquivo especificado e o Main Menu é exibido novamente. Você pode solicitar nesse momento um certificado de uma CA confiável enviando o arquivo.pem que acabou de ser gerado para um fornecedor de autoridade de certificação. Exemplo de Pedido de Assinatura de Certificado Seu arquivo CSR será semelhante ao seguinte exemplo: -----BEGIN CERTIFICATE REQUEST----- MIIB1jCCAT8CAQAwgZUxEjAQBgNVBAoTCWFjY2VzczM2MDEUMBIGA1UECxMLZW5n aw5lzxjpbmcxedaobgnvbamtb250ywdlbnqxjdaibgkqhkig9w0bcqewfw50ywdl bnraywnjzxnzmzywlmnvbtelmakga1uebhmcvvmxezarbgnvbagtcknhbglmb3ju awexdzanbgnvbactbklydmluztcbnzanbgkqhkig9w0baqefaaobjqawgykcgyea mr6acpnwf6hllc72bmukawaxcebtxcocnnth9uc8vumhpbimagjuc4s91hprilg7 UtlbOfy6X3R3kbeR8apRR9uLYrPIvQ1b4NK0whsytij6syCySaFQIB6V7RPBatFr 6XQ9hpsARdkGytZmGTgGTJ1hSS/jA6mbxpgmttz9HPECAwEAAaAAMA0GCSqGSIb3 38 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

53 DQEBAgUAA4GBADxA1cDkvXhgZntHkwT9tCTqUNV9sim8N/U15HgMRh177jVaHJqb N1Er46vQSsOOOk4z2i/XwOmFkNNTXRVl9TLZZ/D+9mGZcDobcO+lbAKlePwyufxK Xqdpu3d433H7xfJJSNYLYBFkrQJesITqKft0Q45gIjywIrbctVUCepL END CERTIFICATE REQUEST----- Instalando o Certificado Depois de receber seu certificado da CA confiável, instale-o no registro do adaptador. Para instalar o certificado, conclua estas etapas: 1. Se você recebeu o certificado como parte de uma mensagem de , copie o texto do certificado em um arquivo de texto e copie esse arquivo no diretório bin do adaptador. Por exemplo, usr/tivoli/agents/udbagent/bin 2. No Main Menu do CertTool, digite B. O seguinte aviso é exibido: Enter name of certificate file: No prompt Enter name of certificate file, digite o caminho completo para o arquivo de certificado e pressione Enter. O certificado é instalado no registro do adaptador e o Main Menu é exibido novamente. Instalando o Certificado e a Chave de um Arquivo PKCS12 Se você não usar o utilitário CertTool para gerar um CSR a fim de obter um certificado, deverá instalar o certificado e a chave privada, os quais devem estar armazenados em um arquivo PKCS12. A CA talvez envie um arquivo protegido por senha, ou um arquivo PKCS12 (com a extensão.pfx), o qual inclui o certificado e a chave privada. Para instalar o certificado por esse arquivo PKCS12, conclua estas etapas: 1. Copie o arquivo PKCS12 no diretório bin do adaptador. Por exemplo, usr/tivoli/agents/udbagent/bin 2. No Main Menu do CertTool, digite C. O seguinte aviso é exibido: Enter name of PKCS12 file: No prompt Enter name of PKCS12 file, digite o nome do arquivo PKCS12 que tem as informações do certificado e da chave privada e pressione Enter. Por exemplo, DamlSrvr.pfx. 4. No prompt Enter password, digite a senha para acessar o arquivo e pressione Enter. O certificado e a chave privada são instalados no registro do adaptador e o Main Menu é exibido. Visualizando o Certificado Instalado Para listar o certificado que está instalado no sistema, no Main Menu do CertTool, digite D. O certificado instalado é listado e o Main Menu é exibido. O exemplo a seguir lista um certificado instalado: The following certificate is currently installed. Subject: c=us,st=california,l=irvine,o=daml,cn=daml Server Capítulo 4. Configurando a Autenticação SSL para o Adaptador UDB 39

54 Instalando um Certificado CA Se você estiver utilizando a autenticação de cliente, precisará instalar um certificado CA. O certificado CA que você instala é emitido por um fornecedor de autoridade de certificação. Para instalar um certificado CA que foi extraído em um arquivo temporário, conclua as seguintes etapas: 1. No prompt Main Menu, digite F (Install a CA certificate). O seguinte aviso é exibido: Enter name of certificate file: 2. No prompt Enter name of certificate file, digite o nome do arquivo de certificado, como DamlCACerts.pem, e pressione Enter. O arquivo de certificado é aberto e o seguinte prompt é exibido: e=admin@ibm.com,c=us,st=california,l=irvine,o=ibm,ou=engineering,cn=eng Install the CA? (Y/N) 3. No prompt Install the CA, digite Y para instalar o certificado e pressione Enter. O arquivo de certificado de CA é instalado no arquivo CACerts.pem. Visualizando Certificados CA O CertTool só instala um certificado e uma chave privada. Para listar o certificado CA que está instalado no adaptador, digite E no prompt Main Menu. Os certificados CA instalados são exibidos e o Main Menu é exibido. O exemplo a seguir lista um certificado CA instalado: Subject: o=ibm,ou=samplecacert,cn=testca Valid To: Wed Jul 26 23:59: Excluindo um Certificado CA Para excluir um certificado CA dos diretórios do adaptador, conclua as etapas a seguir: 1. No prompt Main Menu, digite G. Uma lista de todos os certificados CA instalados no adaptador é exibida. 0 - e=admin@ibm.com,c=us,st=california,l=irvine,o=ibm,ou=engineering,cn=eng 1 - e=support@ibm.com,c=us,st=california,l=irvine,o=ibm,ou=support,cn=support Enter number of CA certificate to remove: 2. No prompt Enter number of CA certificate to remove, digite o número do certificado CA que você deseja remover e pressione Enter. O certificado CA é excluído do arquivo CACerts.pem e o Main Menu é exibido. Visualizando Certificados Registrados Somente pedidos que apresentam um certificado registrado serão aceitos pelo adaptador quando a validação de cliente for ativada. Para visualizar uma lista de todos os certificados registrados disponíveis no adaptador, no prompt Main Menu, digite H. Os certificados registrados são exibidos e o Main Menu é exibido. O exemplo a seguir lista certificados registrados: 0 - e=admin@ibm.com,c=us,st=california,l=irvine,o=ibm,ou=engineering,cn=eng 1 - e=support@ibm.com,c=us,st=california,l=irvine,o=ibm,ou=support,cn=support 40 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

55 Registrando um Certificado Para registrar um certificado para o adaptador, conclua as seguintes etapas: 1. No prompt Main Menu, digite I. O seguinte aviso é exibido: Enter name of certificate file: 2. No prompt Enter name of certificate file, digite o nome do arquivo de certificado que você deseja registrar e pressione Enter. O assunto do certificado é exibido e um prompt é exibido; por exemplo: e=admin@ibm.com,c=us,st=california,l=irvine,o=ibm,ou=engineering,cn=eng Register this CA? (Y/N) 3. No prompt Register this CA, digite Y para registrar o certificado e pressione Enter. O certificado é registrado para o adaptador e o Main Menu é exibido. Cancelando o Registro de um Certificado Para cancelar o registro de um certificado para o adaptador, conclua as seguintes etapas: 1. No prompt Main Menu, digite J. Os certificados registrados são exibidos. O exemplo a seguir lista certificados registrados: 0 - e=admin@ibm.com,c=us,st=california,l=irvine,o=ibm,ou=engineering,cn=eng 1 - e=support@ibm.com,c=us,st=california,l=irvine,o=ibm,ou=support,cn=support 2. Digite o número do arquivo de certificado cujo registro você deseja cancelar e pressione Enter. O assunto do certificado selecionado e um prompt são exibidos; por exemplo: e=admin@ibm.com,c=us,st=california,l=irvine,o=ibm,ou=engineering,cn=eng Unregister this CA? (Y/N) 3. No prompt Unregister this CA, digite Y para cancelar o registro do certificado e pressione Enter. O certificado é removido da lista de certificados registrados para o adaptador e o Main Menu é exibido. Exportando um Certificado e uma Chave para o Arquivo PKCS12 Para exportar um certificado e uma chave para um arquivo PKCS12 do adaptador, conclua as seguintes etapas: 1. No prompt Main Menu, digite K. O seguinte aviso é exibido: Enter name of PKCS12 file: 2. No prompt Enter name of PKCS12 file, digite o nome do arquivo PKCS12 da chave privada ou do certificado instalado e pressione Enter. 3. No prompt Enter Password, digite a senha do arquivo PKCS12 e pressione Enter. 4. No prompt Confirm Password, digite a senha novamente e pressione Enter. O certificado ou a chave privada é exportado para o arquivo PKCS12 e o Main Menu é exibido. Capítulo 4. Configurando a Autenticação SSL para o Adaptador UDB 41

56 42 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

57 Capítulo 5. Customizando o Adaptador UDB Você pode atualizar o arquivo JAR do Adaptador UDB, UDBProfile.jar, para fazer alterações no esquema do adaptador, no formulário de conta, no formulário de serviço e nas propriedades do perfil. Para fazer essas atualizações, você deverá extrair os arquivos do arquivo JAR, fazer as alterações nos arquivos necessários e recompactar o arquivo JAR com os arquivos atualizados. Conclua estas etapas para customizar o perfil do Adaptador UDB: 1. Copie o arquivo JAR em um diretório temporário e extraia os arquivos. Para obter mais informações sobre como extrair os arquivos, consulte Copiar o Arquivo UDBProfile.jar e Extrair os Arquivos. 2. Faça as alterações apropriadas no arquivo. 3. Instale os novos atributos no Servidor Tivoli Identity Manager. Para obter mais informações sobre como atualizar esse arquivo, consulte Criar um Novo Arquivo JAR e Instalar os Novos Atributos no Servidor Tivoli Identity Manager na página 44. Copiar o Arquivo UDBProfile.jar e Extrair os Arquivos O arquivo JAR do perfil, UDBProfile.jar, está incluído no arquivo compactado do Adaptador UDB transferido por download no Web site da IBM. O arquivo UDBProfile.jar contém os seguintes arquivos: v v v v v CustomLabels.properties erudbaccount.xml erudbdamlservice.xml resource.def schema.dsml v xforms.xml Você pode modificar esses arquivos para customizar seu ambiente. Quando tiver concluído a atualização do arquivo JAR do perfil, instale-o no Servidor Tivoli Identity Manager. Para obter mais informações sobre a instalação do perfil, consulte Importando o Perfil do Adaptador no Servidor Tivoli Identity Manager na página 5. Para modificar o arquivo UDBProfile.jar, conclua as etapas a seguir: 1. Efetue logon no sistema no qual o Adaptador UDB está localizado. 2. Copie o arquivo UDBProfile.jar para um diretório temporário. 3. Extraia o conteúdo do arquivo UDBProfile.jar no diretório temporário, executando o seguinte comando: #cd /tmp jar -xvf UDBProfile.jar O comando jar criará o diretório c:/tmp/udbprofile. 4. Edite o arquivo apropriado. Direitos Autorais IBM Corp. 2002,

58 Criar um Novo Arquivo JAR e Instalar os Novos Atributos no Servidor Tivoli Identity Manager Depois de modificar os arquivos schema.dsml e CustomLabels.properties, você deverá importar esses arquivos, e qualquer outro que tenha modificado para o adaptador, para o Servidor Tivoli Identity Manager para que as alterações sejam efetivadas. Para instalar os novos atributos, conclua as seguintes etapas: 1. Crie um novo arquivo JAR utilizando os arquivos no diretório /temp, executando os seguintes comandos: #cd /tmp jar -cvf UDBProfile.jar UDBProfile 2. Importe o arquivo UDBProfile.jar para o Servidor de Aplicativos Tivoli Identity Manager. Para obter mais informações sobre como importar o arquivo, consulte Importando o Perfil do Adaptador na página Pare e inicie o servidor de diretórios. 4. Pare e inicie o serviço Adaptador UDB para efetivar as alterações. Gerenciando Senhas ao Restaurar Contas Quando as contas de uma pessoa são restauradas de um estado de suspensão anterior, você é solicitado a fornecer uma nova senha para as contas restabelecidas. Entretanto, em algumas circunstâncias, pode ser mais conveniente evitar esse comportamento. O requisito de senha para restaurar uma conta no UDB RDBMS está dividido em duas categorias: permitido e necessário. O modo de interação de cada ação de restauração com seu correspondente recurso gerenciado depende do recurso gerenciado ou dos processos de negócios implementados. Determinados recursos rejeitarão uma senha quando for feito um pedido para restaurar uma conta. Nesse caso, você poderá configurar o Tivoli Identity Manager para abster-se do novo requisito de senha. Você poderá definir o Adaptador UDB para exigir uma nova senha quando a conta for restaurada, se sua empresa tem um processo de negócios que exige que o processo de restauração de conta seja acompanhado da reconfiguração da senha. No arquivo resource.def, você pode definir se uma senha é ou não necessária como uma nova opção de protocolo. Ao importar o perfil do adaptador, se uma opção não for especificada, o importador do perfil do adaptador determinará o comportamento de restauração de senha correto dos arquivos schema.dsml e xforms.xml. Os componentes de perfil do adaptador também permitem que serviços remotos determinem a possibilidade de descartar uma senha digitada pelo usuário em situações nas quais várias contas em recursos distintos estão sendo restauradas. Nesse cenário, é possível que apenas algumas das contas em processo de restauração exijam uma senha. Os serviços remotos descartarão a senha da ação de restauração referente aos recursos gerenciados nos quais ela não é necessária. Para configurar o Adaptador UDB para não solicitar uma nova senha ao restaurar contas: 1. Pare o Servidor Tivoli Identity Manager. 2. Extraia os arquivos do arquivo UDBProfile.jar. Para obter mais informações sobre como customizar o arquivo de perfil do adaptador, consulte Copiar o Arquivo UDBProfile.jar e Extrair os Arquivos na página IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

59 3. Altere para o diretório /UDBProfile, no qual o arquivo resource.def foi criado. 4. Edite o arquivo resource.def para incluir as novas opções de protocolo, por exemplo: <Property Name = "com.ibm.itim.remoteservices.resourceproperties. PASSWORD_NOT_REQUIRED_ON_RESTORE" Value = "TRUE"/> <Property Name = "com.ibm.itim.remoteservices.resourceproperties. PASSWORD_NOT_ALLOWED_ON_RESTORE" Value = "FALSE"/> Incluindo as duas opções no exemplo anterior, você estará garantindo que não será solicitado a digitar uma senha ao restaurar uma conta. 5. Crie um novo arquivo UDBProfile.jar utilizando o arquivo resource.def e importe o arquivo de perfil do adaptador para o Servidor Tivoli Identity Manager. Para obter mais informações, consulte Criar um Novo Arquivo JAR e Instalar os Novos Atributos no Servidor Tivoli Identity Manager na página Inicie o Servidor Tivoli Identity Manager novamente. Nota: Se você estiver fazendo upgrade do perfil de um adaptador existente, o novo esquema de perfil do adaptador não será refletido imediatamente. É preciso parar e iniciar o Servidor Tivoli Identity Manager para atualizar o cache e assim o esquema do adaptador. Para obter mais informações sobre como fazer upgrade de um adaptador existente, consulte Fazendo Upgrade do Adaptador UDB na página 47. Capítulo 5. Customizando o Adaptador UDB 45

60 46 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

61 Capítulo 6. Fazendo Upgrade do Adaptador UDB ou do ADK Você pode fazer upgrade do Adaptador UDB ou do ADK (Adapter Development Kit). O ADK é o componente básico do adaptador. Enquanto todos os adaptadores têm o mesmo ADK, a funcionalidade restante do adaptador é específica do recurso gerenciado. Você pode executar um upgrade do adaptador para migrar a instalação atual do adaptador para uma versão mais nova, por exemplo, da versão 4.4 para a versão 4.6. Fazer upgrade do adaptador, em vez de reinstalá-lo, permitirá manter suas definições de configuração. Além disso, você não terá de desinstalar o adaptador atual e instalar a versão mais nova. Entretanto, se uma correção de código tiver sido feita no ADK, em vez de fazer upgrade do adaptador inteiro, você poderá fazer upgrade apenas do ADK para a versão mais nova. Fazendo Upgrade do Adaptador UDB Fazendo Upgrade do ADK Durante um upgrade, para manter todas as definições de configuração atuais, bem como o certificado e a chave privada, não desinstale a versão antiga do adaptador antes de instalar a nova versão. Durante a instalação, especifique o mesmo diretório de instalação onde o adaptador anterior foi instalado. Para obter mais informações sobre como instalar o adaptador, consulte o Capítulo 2, Instalando e Configurando o Adaptador UDB, na página 3. Se você tem atualmente a versão 4.4 ou 4.5 do Adaptador UDB instalada e quer a versão 4.6, será necessário um upgrade do adaptador. Fazer upgrade do adaptador envolve várias etapas que você deverá concluir na seqüência apropriada. Para fazer o upgrade de um adaptador existente, conclua as seguintes etapas: 1. Pare o serviço do Adaptador UDB. 2. Instale a nova versão do adaptador. Quando o adaptador atualizado for iniciado pela primeira vez, novos arquivos de log serão criados, substituindo os arquivos antigos. O ADK consiste na biblioteca de tempo de execução, na filtragem e na funcionalidade de notificação de eventos, bem como em configurações de protocolo e informações de log. O restante do adaptador é composto das funções Incluir, Modificar, Excluir e Procurar. Enquanto todos os adaptadores têm o mesmo ADK, a funcionalidade restante é específica do recurso gerenciado. Você pode utilizar o programa de upgrade do ADK para atualizar a parte ADK dos adaptadores que estão instalados atualmente em uma máquina. Isso permite instalar apenas o ADK, não o adaptador inteiro. Como parte do upgrade do ADK, as bibliotecas do ADK e do protocolo DAML são atualizadas. Além disso, os binários do agentcfg e do CertTool são atualizados. Direitos Autorais IBM Corp. 2002,

62 Antes de fazer upgrade dos arquivos do ADK, o programa de upgrade verifica a versão atual do ADK. Se o nível atual for superior ao que você está tentando instalar, uma mensagem de aviso será exibida. Para fazer upgrade do Adaptador UDB ADK, conclua as seguintes etapas: 1. Faça download do arquivo do programa de upgrade do ADK no Web site da IBM. 2. Extraia o conteúdo do arquivo compactado para um diretório temporário. 3. Altere o diretório de trabalho para o diretório temporário onde você extraiu os arquivos de instalação do adaptador. Por exemplo: # cd /tmp 4. Execute o programa de upgrade do ADK apropriado ao seu sistema operacional. #./adkinst_<operating system>.bin em que <operating system> é o nome de seu sistema operacional, como aix, solaris, linux ou hpux. 5. Na janela Bem-vindo, clique em Avançar. 6. Na janela Contrato de Licença de Software, revise o contrato de licença e decida se você aceita os termos. Se aceitá-los, clique em Aceitar. 7. Na janela Caminho de Instalação do Agente, digite o local onde o adaptador está instalado atualmente e clique em Avançar. Se nenhum adaptador for localizado, você receberá a seguinte mensagem de erro: Local de Instalação Inválido - Impossível Instalar o ADK. Você será solicitado em seguida a digitar outro caminho de instalação do adaptador ou a clicar em Cancelar para sair do programa. 8. Na janela Informações da Instalação, clique em Avançar para iniciar a instalação. 9. Se o adaptador estiver em execução atualmente, a janela Parar Agente será exibida, solicitando que você pare o adaptador. 10. Na janela Instalação Concluída, clique em Avançar. 11. Na janela Fazer Upgrade de outro ADK, clique em Sim para fazer upgrade de outro ADK do adaptador ou clique em Não para sair do programa. Arquivos de Log Entradas de log são armazenadas nos arquivos <ADKVersion>Installer.log e <ADKVersion>Installeropt.log, em que <ADKVersion> é a versão do ADK. Por exemplo, ADK46Installer.log e ADK46Installeropt.log. Esses arquivos são criados na pasta em que você executa o programa de instalação. 48 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

63 Capítulo 7. Desinstalando o Adaptador UDB Antes de remover o adaptador, informe seus usuários de que o Adaptador UDB estará indisponível e será removido do sistema. Se o servidor for colocado off-line, os pedidos do Adaptador UDB que não estiverem concluídos não poderão ser recuperados quando o servidor estiver on-line novamente. Para remover o Adaptador UDB, conclua estas etapas: 1. No diretório /bin, digite./stopagent.sh para interromper o serviço Adaptador UDB. 2. No diretório <adapter_directory>/_uninst, digite./uninstaller.bin e pressione Enter para executar o script de desinstalação, em que adapter_directory é o diretório no qual o adaptador foi instalado. 3. Na janela Bem-vindo, clique em Avançar. 4. Na janela Resumo da Desinstalação do Adaptador UDB, clique em Avançar. 5. Na janela Remover Arquivo Existente, clique em Sim para Todos se deseja remover os arquivos de log do adaptador ou clique em Não para Todos para manter os arquivos. 6. Clique em Concluir. Inspecione a árvore de diretórios para verificar se os diretórios, os subdiretórios e os arquivos do Adaptador UDB foram excluídos. Direitos Autorais IBM Corp. 2002,

64 50 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

65 Apêndice A. Atributos do Adaptador Descrições dos Atributos Como parte da implementação do adaptador, uma conta dedicada para o Tivoli Identity Manager acessar o UDB RDBMS é criada no UDB RDBMS. O Adaptador UDB consiste em arquivos e diretórios que são de propriedade da conta do Tivoli Identity Manager. Esses arquivos estabelecem comunicação com o Servidor Tivoli Identity Manager. O Servidor Tivoli Identity Manager se comunica com o Adaptador UDB utilizando atributos incluídos em pacotes de transmissão enviados por uma rede. A combinação de atributos, incluídos nos pacotes, depende do tipo de ação que o Servidor Tivoli Identity Manager solicita do Adaptador UDB. A Tabela 13 é uma listagem em ordem alfabética dos atributos que são utilizados pelo Adaptador UDB. A tabela fornece uma descrição resumida e o tipo de dados para o valor do atributo. Tabela 13. Atributos, Descrições e Tipos de Dados Atributo Atributo do Servidor de Diretórios Descrição Tipo de Dados ConnectString erudbinstancename Especifica a cadeia de conexão para conectar-se ao DB2 UDB RDBMS. IndexName erudbindexname Especifica o nome do índice. PrivAlterinSchema erudbprivalterinschema Especifica todos os esquemas nos quais o privilégio para alterar objetos no esquema é concedido ao usuário. É multi-avaliado. PrivAlterinSchemaWGr erudbprivwgralterinschema Especifica todos os esquemas nos quais o privilégio para alterar objetos no esquema com opção de concessão é concedido ao usuário. É multi-avaliado. PrivAlterTab erudbprivaltertab Especifica todas as tabelas nas quais o privilégio de alteração é concedido ao usuário. É multi-avaliado. String String String String String Direitos Autorais IBM Corp. 2002,

66 Tabela 13. Atributos, Descrições e Tipos de Dados (continuação) Atributo Atributo do Servidor de Diretórios Descrição Tipo de Dados PrivAlterTabWGr erudbprivwgrtabalter Especifica todas as tabelas nas quais o privilégio de alteração com opção de concessão é concedido ao usuário. É multi-avaliado. PrivControlIndex erudbprivindexcontrol Especifica todos os índices nos quais o privilégio de controle é concedido ao usuário. É multi-avaliado. PrivControlTab erudbprivcontroltab Especifica todas as tabelas nas quais o privilégio de controle é concedido ao usuário. É multi-avaliado. PrivControlView erudbprivviewcontrol Especifica todas as visualizações nas quais o privilégio de controle é concedido ao usuário. É multi-avaliado. PrivCreateinSchema erudbprivcreateinschema Especifica todos os esquemas nos quais o privilégio para criar objetos no esquema é concedido ao usuário. É multi-avaliado. PrivCreateinSchemaWGr erudbprivwgrcreateinschema Especifica todos os esquemas nos quais o privilégio para criar objetos no esquema com opção de concessão é concedido ao usuário. É multi-avaliado. PrivDatabase erudbprivdatabase Especifica as autoridades e os privilégios do banco de dados concedidos ao usuário. É multi-avaliado. PrivDeleteTab erudbprivdeletetab Especifica todas as tabelas nas quais o privilégio de exclusão é concedido ao usuário. É multi-avaliado. String String String String String String String String 52 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

67 Tabela 13. Atributos, Descrições e Tipos de Dados (continuação) Atributo Atributo do Servidor de Diretórios Descrição Tipo de Dados PrivDeleteTabWGr erudbprivwgrdeletetab Especifica todas as tabelas nas quais o privilégio de exclusão com opção de concessão é concedido ao usuário. É multi-avaliado. String PrivDeleteView erudbprivdeleteview Especifica todas as visualizações nas quais o privilégio de exclusão é concedido ao usuário. É multi-avaliado. String PrivDeleteViewWGr erudbprivwgrvwdeleteview Especifica todas as visualizações nas quais o privilégio de exclusão com opção de concessão é concedido ao usuário. É multi-avaliado. PrivDropinSchema erudbprivdropinschema Especifica todos os esquemas nos quais o privilégio para eliminar objetos no esquema é concedido ao usuário. É multi-avaliado. PrivDropinSchemaWGr erudbprivwgrdropinschema Especifica todos os esquemas nos quais o privilégio para eliminar objetos no esquema com opção de concessão é concedido ao usuário. É multi-avaliado. PrivIndexTab erudbprivindextab Especifica todas as tabelas nas quais o privilégio de índice é concedido ao usuário. É multi-avaliado. PrivIndexTabWGr erudbprivwgrindextab Especifica todas as tabelas nas quais o privilégio de índice com opção de concessão é concedido ao usuário. É multi-avaliado. String String String String String Apêndice A. Atributos do Adaptador 53

68 Tabela 13. Atributos, Descrições e Tipos de Dados (continuação) Atributo Atributo do Servidor de Diretórios Descrição Tipo de Dados PrivInsertTab erudbprivinserttab Especifica todas as tabelas nas quais o privilégio de inserção é concedido ao usuário. É multi-avaliado. PrivInsertTabWGr erudbprivwgrinserttab Especifica todas as tabelas nas quais o privilégio de inserção com opção de concessão é concedido ao usuário. É multi-avaliado. PrivInsertView erudbprivinsertview Especifica todas as visualizações nas quais o privilégio de inserção é concedido ao usuário. É multi-avaliado. PrivInsertViewWGr erudbprivwgrvwinsertview Especifica todas as visualizações nas quais o privilégio de inserção com opção de concessão é concedido ao usuário. É multi-avaliado. PrivRefTab erudbprivreftab Especifica todas as tabelas nas quais o privilégio de referência é concedido ao usuário. É multi-avaliado. PrivRefTabWGr erudbprivwgrreftab Especifica todas as tabelas nas quais o privilégio de referência com opção de concessão é concedido ao usuário. É multi-avaliado. PrivSelectTab erudbprivselecttab Especifica todas as tabelas nas quais o privilégio de seleção é concedido ao usuário. É multi-avaliado. String String String String String String String 54 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

69 Tabela 13. Atributos, Descrições e Tipos de Dados (continuação) Atributo Atributo do Servidor de Diretórios Descrição Tipo de Dados PrivSelectTabWGr erudbprivwgrselecttab Especifica todas as tabelas nas quais o privilégio de seleção com opção de concessão é concedido ao usuário. É multi-avaliado. PrivSelectView erudbprivselectview Especifica todas as visualizações nas quais o privilégio de seleção é concedido ao usuário. É multi-avaliado. PrivSelectViewWGr erudbprivwgrvwselectview Especifica todas as visualizações nas quais o privilégio de seleção com opção de concessão é concedido ao usuário. É multi-avaliado. PrivUpdateTab erudbprivupdatetab Especifica todas as tabelas nas quais o privilégio de atualização é concedido ao usuário. É multi-avaliado. PrivUpdateTabWGr erudbprivwgrupdatetab Especifica todas as tabelas nas quais o privilégio de atualização com opção de concessão é concedido ao usuário. É multi-avaliado. PrivUpdateView erudbprivupdateview Especifica todas as visualizações nas quais o privilégio de atualização é concedido ao usuário. É multi-avaliado. PrivUpdateViewWGr erudbprivwgrvwupdateview Especifica todas as visualizações nas quais o privilégio de atualização com opção de concessão é concedido ao usuário. É multi-avaliado. String String String String String String String Apêndice A. Atributos do Adaptador 55

70 Tabela 13. Atributos, Descrições e Tipos de Dados (continuação) Atributo Atributo do Servidor de Diretórios Descrição Tipo de Dados PrivUseTabSpace erudbprivusetabspace Especifica todos os espaços de tabelas nos quais o privilégio de utilização é concedido ao usuário. É multi-avaliado. PrivUseTabSpaceWGr erudbprivwgrusetabspace Especifica todos os espaços de tabelas nos quais o privilégio de utilização com opção de concessão é concedido ao usuário. É multi-avaliado. SchemaName erudbschemaname Especifica o nome do esquema. TableName erudbtablename Especifica o nome da tabela. TabSpaceName erudbtabspacename Especifica o nome do espaço de tabelas. UserName eruid Especifica o nome do usuário a ser gerenciado. UserStatus eraccountstatus Especifica se uma conta de usuário está, ou não, suspensa. ViewName erudbviewname Especifica o nome da visualização. String String String String String String String String Atributos por Ações do Adaptador UDB A lista a seguir relaciona as ações típicas do Adaptador UDB de acordo com o seu grupo de transações funcionais. As listas incluem mais informações sobre atributos opcionais e obrigatórios enviados ao Adaptador UDB para concluir essa ação. Adição de Logins do Banco de Dados Inclusão de Login do Sistema é um pedido para criar uma nova conta de usuário no domínio com os atributos especificados. 56 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

71 Tabela 14. Atributos de Pedido de Inclusão Atributo Obrigatório Atributo Opcional eruid erudbprivwgrvwupdateview erudbprivcreateinschema erudbprivwgrcreateinschema erudbprivalterinschema erudbprivwgralterinschema erudbprivdropinschema erudbprivwgrdropinschema erudbprivselecttab erudbprivwgrselecttab erudbprivdeletetab erudbprivwgrindextab erudbprivreftab erudbprivwgrreftab erudbprivcontroltab erudbprivindexcontrol erudbprivselectview erudbprivwgrvwselectview erudbprivinsertview erudbprivwgrvwinsertview erudbprivupdateview erudbprivinserttab erudbprivwgrinserttab erudbprivdatabase erudbprivdeleteview erudbprivwgrvwdeleteview erudbprivviewcontrol erudbprivusetabspace erudbprivwgrusetabspace erudbprivindextab erudbprivaltertab erudbprivwgrtabalter erudbprivupdatetab erudbprivwgrupdatetab erudbprivwgrdeletetab Alteração de Logins do Banco de Dados Alteração de Login do Sistema é um pedido para alterar um ou mais atributos para os usuários especificados. Tabela 15. Atributos de Pedido de Alteração Atributo Obrigatório Atributo Opcional eruid erudbprivdatabase erudbprivcreateinschema erudbprivwgrcreateinschema erudbprivalterinschema erudbprivwgralterinschema erudbprivdropinschema erudbprivwgrdropinschema erudbprivselecttab erudbprivwgrselecttab erudbprivwgrvwupdateview erudbprivselectview erudbprivwgrvwselectview erudbprivdeleteview erudbprivwgrvwdeleteview erudbprivviewcontrol erudbprivusetabspace erudbprivinserttab erudbprivwgrinserttab erudbprivwgrusetabspace erudbprivinsertview erudbprivwgrvwinsertview erudbprivupdatetab erudbprivwgrupdatetab erudbprivdeletetab erudbprivwgrdeletetab erudbprivaltertab erudbprivwgrtabalter erudbprivindextab erudbprivwgrindextab erudbprivreftab erudbprivwgrreftab erudbprivcontroltab erudbprivindexcontrol erudbprivupdateview Exclusão de Logins do Banco de Dados Exclusão de Login do Sistema é um pedido para remover o usuário especificado do Active Directory. Apêndice A. Atributos do Adaptador 57

72 Tabela 16. Atributos de Pedido de Exclusão Atributo Obrigatório Atributo Opcional eruid Nenhum Suspensão de Logins do Banco de Dados Login Suspenso do Sistema é um pedido para desativar uma conta de usuário. O usuário não é removido e seus atributos não são modificados. Tabela 17. Atributos de Pedido de Suspensão Atributo Obrigatório Atributo Opcional eruid eraccountstatus Nenhum Restauração de Logins do Banco de Dados Restauração de Login do Sistema é um pedido para ativar uma conta de usuário que estava suspensa anteriormente. Uma vez restaurada uma conta, o usuário poderá acessar o sistema com os mesmos atributos de antes que a função Suspender fosse chamada. Tabela 18. Atributos de Pedido de Restauração Atributo Obrigatório Atributo Opcional eruid eraccountstatus Nenhum Reconciliação O pedido de Reconciliação sincroniza informações da conta do usuário entre o Tivoli Identity Manager e o adaptador. Tabela 19. Atributos de Pedido de Reconciliação Atributo Todos os atributos suportados 58 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

73 Apêndice B. Configurando o Adaptador UDB para Suporte a Várias Instâncias O Adaptador UDB pode ser utilizado para gerenciar mais de uma instância de banco de dados ao mesmo tempo. Desempenhe as seguintes etapas para suportar cada instância de banco de dados que o adaptador gerenciará: 1. Crie um novo serviço no Servidor Tivoli Identity Manager para o perfil do UDB instalado. Assegure-se de especificar o nome do Serviço UDB, conforme explicado em Criando um Serviço UDB na página Inclua as seguintes chaves de entrada de registro no servidor no qual o Adaptador UDB está instalado, utilizando a ferramenta agentcfg, conforme explicado em Modificando Configurações de Registro Não-criptografadas na página 22 e Modificando Configurações de Registro Criptografadas na página 23: UDBService<alias-name> O valor dessa chave deve ser o usuário administrativo do banco de dados catalogado. UDBPasswd<alias-name> O valor dessa chave deve ser a senha do usuário administrativo do banco de dados catalogado. 3. Utilize o novo serviço no Servidor Tivoli Identity Manager para gerenciar os usuários da nova instância de banco de dados, utilizando o mesmo adaptador. Repita essas 3 etapas para cada instância de banco de dados adicional que você deseja que o Adaptador UDB suporte. Direitos Autorais IBM Corp. 2002,

74 60 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

75 Apêndice C. Informações sobre Suporte Esta seção descreve as seguintes opções para obtenção de suporte para produtos IBM: v Procurando Bases de Conhecimento v Obtendo as Correções na página 62 v Entrando em Contato com o IBM Software Support na página 62 Procurando Bases de Conhecimento Se tem um problema com seu software IBM, você quer que seja resolvido rapidamente. Comece pesquisando as bases de conhecimento disponíveis para determinar se a resolução para seu problema já está documentada. Procurar no Centro de Informações no Sistema ou Rede Local A IBM fornece uma documentação extensa que pode ser instalada na sua máquina local ou em um servidor intranet. Você pode utilizar a função de pesquisa desse centro de informações para consultar informações conceituais, instruções para concluir tarefas, informações de referência e documentos de suporte. Procurar na Internet Se não encontrar uma resposta para sua pergunta no centro de informações, pesquise na Internet para obter as informações mais recentes e mais completas que podem ajudá-lo a resolver o problema. Para localizar recursos da Internet para seu produto, abra um dos seguintes Web sites: v IBM Tivoli Identity Manager: Guia de Ajuste de Desempenho Fornece as informações necessárias para ajustar o Servidor Tivoli Identity Manager a um ambiente de produção, disponível na Web em: Clique no caractere I na lista de produtos de A a Z e, em seguida, clique no link Tivoli Identity Manager. Procure no centro de informações a seção Technical Supplements. v Redbooks e white papers estão disponíveis na Web em: IBMTivoliIdentityManager.html Procure a seção Self Help, na categoria Learn e clique no link Redbooks. v As technotes estão disponíveis na Web em: v Guia de campo estão disponíveis na Web em: v Para obter uma lista maior de outros recursos do Tivoli Identity Manager, procure no seguinte endereço da Web do IBM developerworks: Direitos Autorais IBM Corp. 2002,

76 Obtendo as Correções Uma correção do produto pode estar disponível para resolver seu problema. É possível determinar quais correções estão disponíveis para seu produto de software IBM verificando o Web site de suporte ao produto: 1. Vá para o Web site do IBM Software Support ( 2. Em Products support pages A to Z, selecione a letra do nome de seu produto. 3. Na lista de produtos específicos, clique em IBM Tivoli Identity Manager. 4. Em Self help, você localiza uma lista de correções, fix packs e outras atualizações de serviço para seu produto. 5. Clique no nome de uma correção para ler a descrição e, opcionalmente, fazer o download da correção. Para receber semanalmente notificações de sobre as correções e outras notícias sobre os produtos IBM, siga estas etapas: 1. Na página de suporte de qualquer produto IBM, clique em My support no canto superior esquerdo da página. 2. Se você já tiver se registrado, vá para a próxima etapa. Se não tiver se registrado, clique em registro no canto superior direito da página de suporte para estabelecer seu ID de usuário e senha. 3. Registre-se em My support. 4. Na página My support, clique em Edit profiles na área de janela de navegação à esquerda e role para Select Mail Preferences. Selecione uma família de produtos e marque as caixas apropriadas para o tipo de informações que você deseja. 5. Clique em Submit. 6. Para obter notificação de de outros produtos, repita as Etapas 4 e 5. Para obter informações adicionais sobre tipos de correções, consulte o Software Support Handbook ( Entrando em Contato com o IBM Software Support O IBM Software Support fornece assistência para os defeitos de produto. Antes de entrar em contato com o IBM Software Support, sua empresa deve ter um contrato ativo de manutenção de software IBM e deve estar autorizado a submeter os problemas à IBM. O tipo de contrato de manutenção de software que você precisa depende do tipo de produto que você tem: v Para produtos de software distribuídos pela IBM (incluindo, mas não se limitando a, produtos Tivoli, Lotus e Rational, bem como produtos DB2 e WebSphere que são executados em sistemas operacionais Windows ou UNIX), cadastre-se no Passport Advantage de uma das seguintes maneiras: On-line: Visite a página da Web do Passport Advantage ( Passport_Advantage_Home) e clique em How to Enroll Por Telefone: Para obter o número de telefone para ligar em seu país, vá para o Web site do IBM Software Support ( e clique no nome de sua região geográfica. v Para produtos de software IBM eserver (incluindo, mas não se limitando a, produtos DB2 e WebSphere que são executados em ambientes zseries, pseries e 62 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

77 iseries), você pode adquirir um acordo de manutenção de software diretamente de um representante de vendas IBM ou um de um Parceiro de Negócios IBM. Para obter informações adicionais sobre suporte para produtos de software eserver, visite a página da Web do IBM Technical Support Advantage ( Se não tiver certeza do tipo de contrato de manutenção de software que você precisa, ligue para IBMSERV ( ) nos Estados Unidos ou, de outros países, vá para a página de contatos do IBM Software Support Handbook na Web ( e clique no nome da sua região geográfica para obter os números de telefone de pessoas que fornecem suporte para a sua localidade. Siga as etapas deste tópico para contatar o IBM Software Support: 1. Determine o impacto de seu problema na empresa. 2. Descreva seu problema e reúna informações de apoio. 3. Submeta seu problema ao IBM Software Support. Determinar o Impacto Comercial do Problema Quando você relatar um problema à IBM, será necessário fornecer um nível de severidade. Portanto, é necessário entender e avaliar o impacto comercial do problema que você está relatando. Utilize os critérios a seguir: Gravidade 1 Impacto comercial crítico: Não é possível utilizar o programa, resultando em um impacto crítico nas operações. Essa condição requer uma solução imediata. Gravidade 2 Impacto comercial significativo: O programa é utilizável, mas é muito limitado. Gravidade 3 Algum impacto comercial: O programa é utilizável com recursos menos significativos (não críticos para as operações) não disponíveis. Gravidade 4 Impacto comercial mínimo: O problema causa um pequeno impacto nas operações ou foi implementado um engano razoável para o problema. Descrever seu Problema e Reunir Informações de Segundo Plano Ao explicar um problema à IBM, seja o mais específico possível. Inclua todas as informações relevantes de segundo plano para que os especialistas do IBM Software Support possam ajudá-lo a solucionar o problema com eficiência. Para economizar tempo, conheça as respostas a essas perguntas: v Quais versões de software você estava executando quando ocorreu o problema? v Você tem logs, rastreios e mensagens que estejam relacionados aos sintomas do problema? O IBM Software Support provavelmente solicitará estas informações. v É possível recriar o problema? Se sim, quais etapas levaram ao defeito? v Foi feita alguma alteração no sistema? (Por exemplo, hardware, sistema operacional, software de rede e etc.) v Você está utilizando, atualmente, uma solução alternativa para esse problema? Se estiver, esteja preparado para explicá-la quando relatar o problema. Apêndice C. Informações sobre Suporte 63

78 Submeter Problemas ao IBM Software Support Você pode enviar seu problema de uma entre duas maneiras: v On-line: Vá para a página Submeter e Rastrear Problemas no site do IBM Software Support ( Digite suas informações na ferramenta de submissão de problemas apropriada. v Por telefone: Para obter o número de telefone em seu país, vá para a página de contatos do IBM Software Support Handbook na Web ( e clique no nome de sua região geográfica. Se o problema que você submeter destinar-se a um defeito de software ou à documentação ausente ou inexata, o IBM Software Support criará um APAR (Authorized Program Analysis Report). O APAR descreve o problema com detalhes. Sempre que possível, o IBM Software Support fornecerá uma solução alternativa para que você implemente até que o APAR seja resolvido e uma correção seja entregue. A IBM publica os APARs resolvidos nas páginas da Web do suporte ao produto IBM diariamente para que outros usuários que tenham o mesmo problema possam se beneficiar com as mesmas resoluções. Para obter mais informações sobre resolução de problemas, consulte Procurando Bases de Conhecimento e Obtendo Correções. 64 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

79 Apêndice D. Avisos Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. É possível que a IBM não ofereça os produtos, serviços ou recursos discutidos neste documento em seu país. Consulte o representante IBM local para obter informações sobre os produtos e serviços disponíveis atualmente em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que somente produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM ou quaisquer outros direitos da IBM, poderá ser utilizado em substituição a este produto, programa ou serviço. Porém, é de responsabilidade do usuário a avaliação e verificação da operação de qualquer produto, programa ou serviço que não seja da IBM. A IBM pode ter patentes ou solicitações de patentes relativas a assuntos tratados neste documento. O fornecimento deste documento não dá ao Cliente nenhuma licença relativa a estas patentes. Pedidos de licença devem ser enviados, por escrito, para: Gerência de Relações Comerciais e Industriais da IBM Brasil Av. Pasteur, Botafogo Rio de Janeiro, RJ CEP Para pedidos de licenças com relação a informações sobre DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos, por escrito, para: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo , Japan O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO NO ESTADO EM QUE SE ENCONTRA SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO LIMITANDO ÀS GARANTIAS IMPLÍCITAS DE MERCADO OU DE ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns estados não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, esta disposição pode não se aplicar ao Cliente. Estas informações podem conter imprecisões técnicas ou erros tipográficos. Alterações são periodicamente realizadas nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nesta publicação, sem aviso prévio. Referências nestas informações a Web sites não-ibm são fornecidas apenas por conveniência e não representam de forma alguma um endosso a esses Web sites. Os materiais contidos nesses Web sites não fazem parte deste produto IBM e seu uso é de responsabilidade do cliente. Direitos Autorais IBM Corp. 2002,

80 A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrer em qualquer obrigação para com o Cliente. Licenciados deste programa que pretendam obter informações adicionais sobre o mesmo com o objetivo de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com: Gerência de Relações Comerciais e Industriais da IBM Brasil Av. Pasteur, Botafogo Rio de Janeiro, RJ CEP Tais informações podem estar disponíveis, sujeitas a termos e condições apropriados, incluindo em alguns casos, o pagamento de uma taxa. O programa licenciado descrito nessas informações e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Acordo do Cliente IBM, do Acordo Internacional de Licença de Programa IBM, ou sob qualquer acordo equivalente entre as partes. Quaisquer dados sobre desempenho contidos neste documento foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais poderão variar significativamente. Algumas medidas podem ter sido tomadas em sistemas de nível de desenvolvimento e não há garantia de que estas medidas sejam iguais em sistemas geralmente disponíveis. Além disso, algumas medidas podem ter sido estimadas através de extrapolação. O resultado real pode variar. Os usuários deste documento devem verificar os dados aplicáveis para seu ambiente específico. As informações referentes a produtos não-ibm foram obtidas com os fornecedores desses produtos, anúncios publicados ou outras fontes de publicidade disponíveis. A IBM não testou esses produtos e não pode confirmar a precisão do seu desempenho, compatibilidade ou qualquer outro requisito relacionado a produtos não-ibm. Dúvidas sobre os recursos de produtos não-ibm devem ser encaminhadas diretamente a seus fornecedores. Marcas Registradas Os seguintes termos são marcas registradas da International Business Machines Corporation nos Estados Unidos e/ou em outros países: IBM IBM (logotipo) AIX DB2 Novell SecureWay Tivoli Tivoli (logotipo) Universal Database WebSphere Lotus é uma marca registrada da Lotus Development Corporation e/ou IBM Corporation. 66 IBM Tivoli Identity Manager: DB2 Universal Database Adapter - Guia de Instalação e Configuração

81 Domino é uma marca registrada da International Business Machines Corporation e Lotus Development Corporation nos Estados Unidos e/ou em outros países. Microsoft, Windows, Windows NT e o logotipo do Windows são marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros países. Intel, Intel Inside (logotipos), MMX e Pentium são marcas registradas da Intel Corporation nos Estados Unidos e/ou em outros países. UNIX é uma marca registrada da The Open Group nos Estados Unidos e/ou em outros países. Linux é uma marca registrada da Linus Torvalds nos Estados Unidos e/ou em outros países. Sun, Sun Microsystems e o logotipo da Sun são marcas ou marcas registradas da Sun Microsystems, Inc. nos Estados Unidos e em outros países. Java e todas as marcas baseadas em Java são marcas registradas da Sun Microsystems Inc. nos Estados Unidos e/ou em outros países. Outros nomes de empresas, produtos e serviços podem ser marcas registradas ou marcas de serviços de terceiros. Apêndice D. Avisos 67