ibmpublib.boulder.ibm.com/tividd/td/itim/sc32-1155-05/pt_br/... · 2005. 8. 31. · Índice...

Tivoli® Identity Manager

Oracle Database Adapter para Windows: Guia de Instalação e Configuração

Versão 4.6

S517-7851-05

��

Nota

Antes de utilizar estas informações e o produto suportado por elas, leia as informações no Apêndice C, “Avisos”, na página

63.

Sexta 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 2003, 2005. Todos os direitos reservados.

Í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 Oracle

Database Adapter . . . . . . . . . . 1

Recursos do Adaptador . . . . . . . . . . . 1

Capítulo 2. Instalando e Configurando o

Oracle Database Adapter . . . . . . . 3

Pré-requisitos . . . . . . . . . . . . . . 3

Instalando o Adaptador . . . . . . . . . . . 4

Importando o Perfil do Adaptador no Servidor Tivoli

Identity Manager . . . . . . . . . . . . . 6

Importando o Perfil do Adaptador . . . . . . 6

Criando um Serviço do Banco de Dados Oracle . . . 7

Configurando o Adaptador . . . . . . . . . 8

Capítulo 3. Configurando o Oracle

Database Adapter do IBM Tivoli Identity

Manager . . . . . . . . . . . . . . 9

Iniciando a Ferramenta de Configuração do

Adaptador . . . . . . . . . . . . . . . 9

Visualizando Definições de Configuração . . . . 10

Alterando Definições de Configuração de Protocolo 10

Configurando a Notificação de Eventos . . . . . 14

Definindo Acionadores de Notificação de Eventos 16

Modificando um Contexto de Notificação de

Evento . . . . . . . . . . . . . . . 17

Alterando a Chave de Configuração . . . . . . 19

Alterando as Configurações do Log de Atividades 20

Alterando Configurações de Registro . . . . . . 22

Modificando Configurações de Registro

Não-criptografadas . . . . . . . . . . . 22

Modificando Configurações de Registro

Criptografadas . . . . . . . . . . . . 22

Alterando Configurações Avançadas . . . . . . 22

Visualizando Estatísticas . . . . . . . . . . 24

Alterando Configurações de Página de Códigos . . 24

Acessando a Ajuda e Opções Adicionais . . . . . 25

Capítulo 4. Modificações de Serviços

Oracle . . . . . . . . . . . . . . . 27

Acessando o Menu Principal da Ferramenta de

Configuração de Serviços . . . . . . . . . . 27

Visualizando Serviços Oracle Atuais . . . . . . 27

Incluindo um Novo Serviço Oracle . . . . . . 28

Exemplo de Inclusão de um Serviço Oracle . . . 29

Modificando um Serviço Oracle . . . . . . . 29

Exemplo de Modificação de um Serviço Oracle 30

Removendo um Serviço Oracle . . . . . . . . 30

Exemplo de Remoção de um Serviço Oracle . . 31

Testando uma Conexão Oracle . . . . . . . . 31

Exemplo de Teste de uma Conexão Oracle . . . 32

Capítulo 5. Configurando a

Autenticação SSL para o Oracle


Visão Geral dos Certificados Digitais e SSL . . . . 33

Chaves Privadas, Chaves Públicas e Certificados

Digitais . . . . . . . . . . . . . . . 34

Certificados Auto-assinados . . . . . . . . 35

Formatos de Certificado e de Chave . . . . . 35

O Uso da Autenticação SSL . . . . . . . . . 36

Configurando Certificados para Autenticação SSL 36

Configurando Certificados para Autenticação SSL

de Uma Via . . . . . . . . . . . . . 36


de Duas Vias . . . . . . . . . . . . . 37

Configurando Certificados quando o Adaptador

Funciona como um Cliente SSL . . . . . . . 38

Gerenciando Certificados SSL Utilizando o CertTool 39

Iniciando o CertTool . . . . . . . . . . 40

Gerando uma Chave Privada e um Pedido de

Certificado . . . . . . . . . . . . . 42

Instalando o Certificado . . . . . . . . . 43

Instalando o Certificado e a Chave de um

Arquivo PKCS12 . . . . . . . . . . . 43

Visualizando o Certificado Instalado . . . . . 43

Instalando um Certificado CA . . . . . . . 44

Visualizando Certificados CA . . . . . . . 44

Excluindo um Certificado CA . . . . . . . 44

Visualizando Certificados Registrados . . . . 44

Registrando um Certificado . . . . . . . . 45

Cancelando o Registro de um Certificado . . . 45

Exportando um Certificado e uma Chave para o

Arquivo PKCS12 . . . . . . . . . . . 45

Capítulo 6. Customizando o Oracle


Copiar o Arquivo OracleProfile.jar e Extrair os

Arquivos . . . . . . . . . . . . . . . 47

Criar um Novo Arquivo JAR e Instalar os Novos

Atributos no Servidor Tivoli Identity Manager . . . 48

Gerenciando Senhas ao Restaurar Contas . . . . 48

© Direitos Autorais IBM Corp. 2003, 2005 iii

Capítulo 7. Fazendo Upgrade do Oracle

Database Adapter ou do ADK . . . . . 51

Fazendo Upgrade do Oracle Database Adapter . . 51

Fazendo Upgrade do ADK . . . . . . . . . 51

Arquivos de Log . . . . . . . . . . . 52

Capítulo 8. Desinstalando o Oracle


Apêndice A. Atributos do Adaptador . . 55

Descrições dos Atributos . . . . . . . . . . 55

Atributos por Ações do Oracle Database Adapter . . 56

Adição de Logins do Banco de Dados . . . . 56

Alteração de Logins do Banco de Dados . . . . 57

Exclusão de Logins do Banco de Dados . . . . 57

Suspensão de Logins do Banco de Dados . . . 58

Restauração de Logins do Banco de Dados . . . 58

Reconciliação . . . . . . . . . . . . . 58

Apêndice B. Informações sobre

Suporte . . . . . . . . . . . . . . 59

Procurando Bases de Conhecimento . . . . . . 59

Procurar no Centro de Informações no Sistema

ou Rede Local . . . . . . . . . . . . 59

Procurar na Internet . . . . . . . . . . 59

Obtendo as Correções . . . . . . . . . . . 60

Entrando em Contato com o IBM Software Support 60

Determinar o Impacto Comercial do Problema . . 61

Descrever seu Problema e Reunir Informações de

Segundo Plano . . . . . . . . . . . . 61

Submeter Problemas ao IBM Software Support 62

Apêndice C. Avisos . . . . . . . . . 63

Marcas Registradas . . . . . . . . . . . . 64

Índice Remissivo . . . . . . . . . . 67

iv IBM Tivoli Identity Manager: Oracle Database Adapter para Windows - Guia de Instalação e Configuração

Prefácio

O IBM® Tivoli® Identity Manager Oracle Database Adapter (Oracle Database

Adapter) ativa a conectividade entre o Servidor Tivoli Identity Manager e uma

rede de sistemas que executam o Banco de Dados Oracle. Depois que o adaptador

é instalado e configurado, o Tivoli Identity Manager gerencia o acesso a recursos

do Banco de Dados Oracle com o sistema de segurança de seu site. Este manual

descreve como instalar e configurar o Oracle Database Adapter.

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.

Quem Deve Ler este Manual

Este manual destina-se a administradores de segurança do Banco de Dados Oracle

responsáveis por instalar software nos sistemas de computadores em seus sites. Os

leitores devem estar familiarizados com os conceitos do Windows® e do Banco de

Dados Oracle. A pessoa que executará o procedimento de instalação do Oracle

Database Adapter também deve estar familiarizada com os padrões do sistema em

seu site e precisa ter experiência e conhecimento apropriados do Windows e do

Oracle. Os leitores devem ser capazes de desempenhar tarefas rotineiras de

administração de sistema e de segurança do Windows e do Oracle.

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.

© Direitos Autorais IBM Corp. 2003, 2005 v

Assistência On-line ao Usuário:

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:

http://publib.boulder.ibm.com/tividd/td/tdprodlist.html

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:

http://www.ibm.com/software/sysmgmt/products/support/

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:

http://www.redbooks.ibm.com/redbooks.nsf/tips/

v Os guias de campo estão disponíveis na Web em:

http://www.ibm.com/software/sysmgmt/products/support/Field_Guides.html

v Para obter uma lista maior de outros recursos do Tivoli Identity Manager,

procure no seguinte endereço da Web do IBM developerWorks:

http://www.ibm.com/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: Oracle Database Adapter para Windows - Guia de Instalação e Configuração


http://www-306.ibm.com/software/sysmgmt/products/support/IBMTivoliIdentityManager.html





http://www.lotus.com/services/passport.nsf/WebDocs/

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:

http://www.cgselearning.com/tivoliskills/

v Tivoli Education Software Training Roadmaps na Web em:

http://www.ibm.com/software/tivoli/education/eduroad_prod.html

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 Banco de Dados Oracle

– http://www.oracle.com/technology/documentationv Sistemas operacionais

– IBM AIX®

http://www16.boulder.ibm.com/pseries/en_US/infocenter/base/aix52.htm

– Sun Solaris

http://docs.sun.com/db?q=solaris+9

– Red Hat Linux®

http://www.redhat.com/docs/

– Microsoft® Windows Server 2003

http://www.microsoft.com/windowsserver2003/proddoc/default.mspxv Servidores de bancos de dados

– IBM DB2

- Suporte: http://www.ibm.com/software/data/db2/udb/support.html

- Centro de informações:

http://publib.boulder.ibm.com/infocenter/db2help/index.jsp

- Documentação: http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/v8pubs.d2w/en_main

- Família de produtos DB2: http://www.ibm.com/software/data/db2

- Fix packs:

http://www.ibm.com/software/data/db2/udb/support/downloadv8.html

- Requisitos do sistema:

http://www.ibm.com/software/data/db2/udb/sysreqs.html– Oracle

http://www.oracle.com/technology/documentation/index.html

http://otn.oracle.com/tech/index.html

Prefácio vii

http://www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Home


http://www.cgselearning.com/tivoliskills/

http://www.ibm.com/software/tivoli/education/eduroad_prod.html

http://www.ibm.com/software/sysmgmt/products/support/supp_tech_exch.html

http://www.ibm.com/software/sysmgmt/products/support/supp_tech_exch.html

http://www.oracle.com/technology/documentation/

http://www16.boulder.ibm.com/pseries/en_US/infocenter/base/aix52.htm

http://docs.sun.com/db?q=solaris+9

http://www.redhat.com/docs/

http://www.microsoft.com/windowsserver2003/proddoc/default.mspx

http://www.ibm.com/software/data/db2/udb/support.html

http://publib.boulder.ibm.com/infocenter/db2help/index.jsp

http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/v8pubs.d2w/en_main

http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/v8pubs.d2w/en_main

http://www.ibm.com/software/data/db2

http://www.ibm.com/software/data/db2/udb/support/downloadv8.html

http://www.ibm.com/software/data/db2/udb/sysreqs.html

http://www.oracle.com/technology/documentation/index.html

http://otn.oracle.com/tech/index.html

http://otn.oracle.com/tech/linux/index.html

– Microsoft SQL Server 2000

http://www.msdn.com/library/

http://www.microsoft.com/sql/v Aplicativos do servidor de diretórios

– IBM Directory Server http://publib.boulder.ibm.com/tividd/td/IBMDS/IDSapinst52/en_US/HTML/ldapinst.htm http://www.ibm.com/software/network/directory

– Sun ONE Directory Server

http://docs.sun.com/app/docs/coll/S1_DirectoryServer_52v WebSphere Application Server

Informações adicionais estão disponíveis no diretório de produtos ou em Web

sites. http://publib.boulder.ibm.com/infocenter/ws51help/index.jsp http://www.redbooks.ibm.com/

v Sistema de mensagens incorporado do WebSphere

http://www.ibm.com/software/integration/wmq/

v IBM HTTP Server

http://www.ibm.com/software/webservers/httpservers/library.html

Publicações 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:

http://www.ibm.com/software/tivoli/literature/

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:

http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm

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:



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: Oracle Database Adapter para Windows - Guia de Instalação e Configuração

http://otn.oracle.com/tech/linux/index.html

http://www.msdn.com/library/

http://www.microsoft.com/sql/

http://publib.boulder.ibm.com/tividd/td/IBMDS/IDSapinst52/en_US/HTML/ldapinst.htm

http://publib.boulder.ibm.com/tividd/td/IBMDS/IDSapinst52/en_US/HTML/ldapinst.htm

http://www.ibm.com/software/network/directory

http://docs.sun.com/app/docs/coll/S1_DirectoryServer_52

http://publib.boulder.ibm.com/infocenter/ws51help/index.jsp

http://www.redbooks.ibm.com/

http://www.ibm.com/software/integration/wmq/

http://www-3.ibm.com/software/webservers/httpservers/library.html

http://www.ibm.com/software/tivoli/literature/

http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm


Acessibilidade

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.

Informações sobre Suporte

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 B, “Informações sobre Suporte”, na página 59.

Convenções Utilizadas neste Manual

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.

Convenções Tipográficas

Este guia utiliza as seguintes convenções sobre tipos de letra:

Negrito

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

Itálico

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

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: Oracle Database Adapter para Windows - Guia de Instalação e Configuração


LDAP_HOME v Para IBM Directory Server Versão 5.2

Windows:

caminho\IBM\LDAP

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

O diretório que

contém o código do

servidor de

diretórios.

IDS_instance_HOME Para IBM Directory Server Versão 6.0

Windows:

unidade\

ibmslapd-instance_owner_name

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/idsslapd-ldapdb2.

O diretório que

contém a instância

do IBM Directory

Server Versão 6.0.

HTTP_HOME Windows:

caminho\IBMHttpServer

UNIX:

caminho/IBMHttpServer

O diretório que


IBM HTTP Server.

Prefácio xi


ITIM_HOME Windows:

caminho\IBM\itim

UNIX:

caminho/IBM/itim

O diretório de base

que contém o

código, a

configuração e a

documentação do

Tivoli Identity

Manager.

WAS_HOME Windows:

caminho\WebSphere\AppServer

UNIX:

caminho/WebSphere/AppServer

O diretório home do

WebSphere

Application Server.

WAS_MQ_HOME Windows:

caminho\ibm\WebSphere MQ

UNIX:

caminho/mqm

O diretório que


WebSphere MQ.

WAS_NDM_HOME Windows:

caminho\WebSphere\DeploymentManager

UNIX:

caminho/WebSphere/DeploymentManager

O diretório home no

gerenciador de

implementação.

Tivoli_Common_Directory Windows:

caminho\ibm\tivoli\common\CTGIM

UNIX:

caminho/ibm/tivoli/common/CTGIM

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: Oracle Database Adapter para Windows - Guia de Instalação e Configuração

Capítulo 1. Visão Geral do Oracle Database Adapter

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 Sybase Adapter ativa a conectividade entre o

Servidor Tivoli Identity Manager e um sistema que executa o Banco de Dados

Oracle. Este guia de instalação fornece as informações básicas que você precisa

para instalar e configurar o Oracle Database Adapter. Este capítulo fornece uma

visão geral do adaptador e de seus recursos.

Recursos do Adaptador

Você pode utilizar o Oracle Database Adapter para automatizar as seguintes tarefas

administrativas:

v Criar uma conta do Banco de Dados Oracle.

v Modificar contas do Banco de Dados Oracle.

v Excluir contas do Banco de Dados Oracle.

v Suspender contas do Banco de Dados Oracle.

v Restaurar contas do Banco de Dados Oracle.

v Reconciliar contas do Banco de Dados Oracle com contas do Tivoli Identity

Manager.

© Direitos Autorais IBM Corp. 2003, 2005 1

2 IBM Tivoli Identity Manager: Oracle Database Adapter para Windows - Guia de Instalação e Configuração

Capítulo 2. Instalando e Configurando o Oracle Database

Adapter

Instalar e configurar o Oracle Database Adapter 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.

Pré-requisitos

A Tabela 1 identifica os pré-requisitos de hardware, software e autorização para

instalar o Oracle Database Adapter. Verifique se todos os pré-requisitos foram

atendidos antes de instalar o Oracle Database Adapter.

Tabela 1. Pré-requisitos para Instalar o Oracle Database Adapter

Sistema v Um 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 v Windows 2000

v Windows 2003

v Windows XP

Banco de Dados Oracle v Banco de Dados Oracle 8i

v Banco de Dados Oracle 9i

v Banco de Dados Oracle 10g

Nota: O adaptador suporta o Banco de Dados Oracle

versões 8i, 9i e 10g em execução em qualquer plataforma

que possa ser acessada pelo software Oracle Client.

Software Oracle Client Uma das seguintes versões do software Oracle Client

deve ser instalada no mesmo sistema no qual o adaptador

Oracle está sendo executado:

v Oracle Client 8i

v Oracle Client 9i

v Oracle Client 10g


Tabela 1. Pré-requisitos para Instalar o Oracle Database Adapter (continuação)

Conta de Serviços Oracle Para cada instância do Oracle gerenciada pelo adaptador,

você deve fornecer uma conta e senha do Oracle. A conta

Oracle deve ter os seguintes privilégios e funções do

Oracle:

v CONCEDER PRIVILÉGIOS

v CONCEDER REGRAS

v CRIAR SESSÃO

v CRIAR USUÁRIO

v ALTERAR USUÁRIO

v ALTERAR SISTEMA

v ELIMINAR USUÁRIO

v SELECIONAR TABELAS

v SELECIONAR QUALQUER DICIONÁRIO

Para o Oracle 9i e 10g, os seguintes privilégios e funções

adicionais do Oracle devem ser concedidos para conta do

Adaptador Oracle:

v SELECIONAR EM SYS.DBA_USERS

v SELECIONAR EM SYS.DBA_SYS_PRIVS

v SELECIONAR EM SYS.DBA_ROLE_PRIVS

v SELECIONAR EM SYS.DBA_TS_QUOTAS

v SELECIONAR EM SYS.DBA_ROLES

v SELECIONAR EM SYS.DBA_PROFILES

v SELECIONAR EM SYS.DBA_TABLESPACES

Conectividade da Rede v Rede TCP/IP

v Para fins de segurança, a IBM recomenda a instalação

do adaptador em um NTFS (Sistema de Arquivo do

Windows NT).

Autoridade de Administrador

do Sistema

O usuário que está concluindo o procedimento de

instalação do Oracle Database Adapter deve ter a

autoridade de administrador do sistema para concluir as

etapas deste capítulo.

O instalador deve ser capaz de criar Contas do Serviço

Oracle, conforme descrito acima.

Servidor Tivoli Identity

Manager

Versão 4.6

Instalando o Adaptador

Os arquivos de instalação do Tivoli Identity Manager Oracle Database Adapter

estão disponíveis para download a partir do 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 compactado de instalação do Oracle Database

Adapter a partir do Web site da IBM.

2. Extraia o conteúdo do arquivo em um diretório temporário e navegue até esse

diretório.


3. Inicie o programa de instalação utilizando o arquivo setup.exe no diretório

temporário. Por exemplo, selecione Executar... no menu Iniciar e digite

C:\Temp\Setup.exe no campo Abrir.

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 aceitar, selecione Aceitar e depois clique em Avançar.

6. 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.

7. Na janela Nomes de Serviços do Oracle, digite as seguintes informações: o

nome do serviço Oracle, o nome da conta do Oracle e a senha da conta do

Oracle. Em seguida, clique em Avançar.

As instâncias do Oracle devem ser definidas para que o adaptador funcione

corretamente. Os nomes de serviço fazem distinção entre maiúsculas e

minúsculas.

Nome de Serviço do Oracle

O nome do serviço para a instância de banco de dados gerenciada pelo

adaptador.

Conta do Oracle

O nome da conta do serviço Oracle que o adaptador utiliza para

gerenciar a instância do Oracle.

Senha da Conta

A senha da conta de serviço do Oracle

Nota: Você pode incluir nomes de serviços adicionais para que o adaptador

gerencie após a conclusão da instalação. Consulte o Capítulo 3,

Figura 1. Janela Selecionar Diretório de Destino

Capítulo 2. Instalando e Configurando o Oracle Database Adapter 5

“Configurando o Oracle Database Adapter do IBM Tivoli Identity

Manager”, na página 9 e o Capítulo 4, “Modificações de Serviços Oracle”

para obter informações adicionais sobre como adicionar, modificar e

excluir instâncias gerenciadas.

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.

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 Oracle Database

Adapter incluem o arquivo JAR do adaptador, OracleProfile.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 OracleProfile.jar inclui todos os arquivos que são necessários para

definir o esquema do adaptador, o formulário de conta 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 Oracle Database Adapter. O perfil é

utilizado para criar um serviço do Oracle Database Adapter 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:

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 autoridade para desempenhar 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

OracleProfile.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 o perfil do adaptador for importado com êxito, a seguinte mensagem é

exibida:

A instalação do perfil foi concluída.

v Se o perfil do adaptador não for importado com êxito, a seguinte mensagem

é 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á instalado no diretório \data do Tivoli Identity Manager.


Criando um Serviço do Banco de Dados Oracle

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 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ço, selecione Perfil do BD Oracle e, em seguida,

clique em Continuar. O formulário de serviço Oracle DB Adapter é exibido. O

formulário de serviço contém os seguintes campos:

Nome do Serviço

Especifique um nome que defina esse serviço Banco de Dados Oracle

no Servidor Tivoli Identity Manager. Nome do Serviço é um campo

obrigatório.

Descrição

Especifique uma descrição opcional para esse serviço.

URL Especifique o local e o número da porta do Oracle Database Adapter. O

número da porta é definido na configuração do protocolo utilizando o

programa agentCfg. Para obter informações adicionais sobre definições

de configuração de protocolo, consulte “Alterando Definições de

Configuração de Protocolo” na página 10. URL é um campo

obrigatório.

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 5,

“Configurando a Autenticação SSL para o Oracle Database Adapter”,

na página 33.

ID do Usuário

Especifique um nome de usuário do protocolo DAML (Directory Access

Markup Language). O nome do usuário é definido na configuração do

protocolo utilizando o programa agentCfg. Para obter informações

adicionais sobre as definições de configuração de protocolo, consulte

“Alterando Definições de Configuração de Protocolo” na página 10. ID

do Usuário é um campo obrigatório.

Senha Especifique a senha para o nome do usuário do protocolo DAML. Essa

senha é definida na configuração do protocolo utilizando o programa

agentCfg. Para obter informações adicionais sobre as definições de

configuração de protocolo, consulte “Alterando Definições de

Configuração de Protocolo” na página 10. Senha é um campo

obrigatório.

Serviço Oracle

Especifique o Nome do Serviço Oracle gerenciado por esse serviço.

Para obter informações adicionais sobre o Nome do Serviço Oracle,

Capítulo 2. Instalando e Configurando o Oracle Database Adapter 7

consulte o Capítulo 4, “Modificações de Serviços Oracle”, na página 27.

Serviço Oracle é 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 Banco de Dados Oracle.6. Para verificar a conexão, pressione Testar.

7. Para criar o serviço, pressione Submeter.

Configurando o Adaptador

Depois de instalar o Tivoli Identity Manager Oracle Database Adapter e importar o

perfil do adaptador, a configuração é necessária para assegurar que ele funcione

corretamente.

Para configurar o Oracle Database Adapter, conclua as etapas a seguir:

1. Inicie o serviço Oracle Database Adapter utilizando a Ferramenta de Serviço do

Windows.

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 10.

3. Configure o Oracle Database Adapter 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 14.

4. 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 5,

“Configurando a Autenticação SSL para o Oracle Database Adapter”, na página

33.

5. 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 Oracle Database Adapter do IBM Tivoli Identity

Manager”, na página 9.

6. Defina os Nomes dos Serviços Oracle a serem gerenciados pelo Oracle Database

Adapter. Para obter informações adicionais sobre como definir os nomes dos

serviços Oracle, consulte o Capítulo 4, “Modificações de Serviços Oracle”, na

página 27.

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 do Banco

de Dados Oracle” na página 7.

8. Configure o formulário de conta do adaptador. Para obter informações sobre

como configurar o formulário de conta do adaptador, consulte o IBM Tivoli

Identity Manager Information Center.


Capítulo 3. Configurando o Oracle Database Adapter do IBM

Tivoli Identity Manager

Utilize o programa de configuração do adaptador, agentCfg, para visualizar ou

modificar os parâmetros do Oracle Database Adapter. Todas as alterações feitas nos

parâmetros 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 Oracle Database Adapter, conclua estas etapas:

1. No menu Iniciar, selecione Programas → Acessórios → Prompt de Comandos.

2. No prompt de comandos, vá para o diretório \bin do adaptador. Por exemplo,

digite o seguinte comando, se o Oracle Database Adapter estiver no local

padrão:

cd C:\Tivoli\Agents\OracleAgent\bin

3. Digite o seguinte comando:

agentCfg -agent OracleAgent

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 25 para conhecer os

procedimentos sobre como utilizar argumentos adicionais.

4. No prompt Enter configuration key for Agent ’OracleAgent’, digite a chave de

configuração do Oracle Database Adapter.

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.

OracleAgent 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.


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

Consulte a página 10.

B Alterando definições de

configuração de protocolo


S Configurando notificação de

eventos


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


G Alterando configurações avançadas Consulte a página 22.

H Visualizando estatísticas Consulte a página 24.

T Alterando configurações de página

de códigos


Visualizando Definições de Configuração

O procedimento a seguir descreve como exibir as definições de configuração do

Oracle Database Adapter.

1. No Agent Main Configuration Menu, digite A. As definições de configuração do

Oracle Database Adapter são exibidas. A tela a seguir é um exemplo das

definições de configuração do Oracle Database Adapter.

Configuration Settings

-------------------------------------------

Name : OracleAgent

Version : 4.6

ADK Version : 4.65

ERM Version : 4.65

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 : C:\Tivoli\Agents\OracleAgentLog

Log File Name : OracleAgent.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 Oracle Database Adapter 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 43 para obter informações adicionais sobre como instalar certificados.

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 Oracle Database Adapter, 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 Oracle Database Adapter.

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 DAML Protocol Properties

Menu é exibido.

3. No DAML Protocol Properties Menu, digite C. As propriedades do protocolo

configurado são exibidas. 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 45580 ;Protocol Server port number.

E. USE_SSL FALSE ;Use SSL secure connection.

F. SRV_NODENAME 9.38.215.20 ;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 na página 12 a seguir para obter informações adicionais

sobre as propriedades que você pode configurar para o DAML Protocol.

Capítulo 3. Configurando o Oracle Database Adapter do IBM Tivoli Identity Manager 11

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.

Esse valor é o ID de usuário que o Servidor Tivoli Identity Manager

utiliza para conectar-se ao adaptador.

O ID de usuário padrão é agent.

B O seguinte aviso é exibido:

Modify Property ’PASSWORD’:

Digite uma senha.

Esse valor é a senha para o ID de usuário que o Servidor Tivoli Identity

Manager utiliza para conectar-se ao adaptador.

A senha padrão é agent.

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 é

45580.

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 43.

u O seguinte aviso é exibido:

Modify Property ’SRV_NODENAME’:

Digite o nome do servidor ou um endereço IP, por exemplo, 9.38.215.20.

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.


Tabela 3. Opções do DAML Protocol Menu (continuação)


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 é 9443.

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 39.

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 5,

“Configurando a Autenticação SSL para o Oracle Database Adapter”, na

página 33.

5. No prompt, altere o valor e pressione Enter.

O Protocol Properties Menu é exibido com as novas definições.

Se você não deseja alterar o valor, basta pressionar 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 Oracle Database Adapter 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.

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 que são 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 10.

2. 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.


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 verificar notificação de eventos e

pressione Enter.


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:

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


n Se essa opção estiver ativada, o adaptador atualizará o Servidor Tivoli

Identity Manager com as alterações no adaptador a intervalos regulares.

Quando a opção está definida para:

v Disabled, pressionar a tecla A muda para ativada

v Enabled, pressionar a tecla A muda para desativada

Digite A para alternar entre as opções.

R O seguinte aviso é exibido:

Enter new interval

([ww:dd:hh:mm:ss])

Digite um intervalo de reconciliação diferente.Por 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.


Tabela 4. Opções do Event Notification Menu (continuação)


E O Event Notification Entry Types Menu é exibido. Consulte “Definindo

Acionadores de Notificação de Eventos” 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.

Nota: 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.

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 de Remoção de Contexto é 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}

-----------------------------------------------

3. 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 as novas definições.

Definindo Acionadores de Notificação de Eventos

Por padrão, todos os atributos são consultados em busca de alterações no valor.

Alguns atributos que são alterados com freqüência (por exemplo, duração de senha

ou último logon com êxito) devem ser omitidos.

1. No Event Notification Menu, digite E. O 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 executada2. 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.

Event Notification Attribute Listing

-------------------------------------

(a) **erPassword (b) **erOracleTblSpcQuota (c) **erOracleAuthenticationType

(d) **erUid (e) **erOracleServiceName (f) **erOracleEDefaultTableSpace

(g) **erOracleProfile (h) **erOracleSysPriv (i) **erOracleTemporaryTableSpace

(j) **erOracleRole (k) **erOracleExpirePwd (l) **erOracleGlobalName

(p)rev page 1 of 3 (n)ext

-----------------------------

X. Done

Select menu option:

3. Digite a letra correspondente da opção de menu para o atributo a ser excluído

de uma notificação de evento.

Os atributos marcados com dois asteriscos (**) são retornados durante a

notificação de evento. 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 Oracle

Database Adapter 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 Oracle Database Adapter é o ponto no servidor de diretório

que é utilizado como raiz do adaptador. Pode ser um ponto de base OU

(Organizational Unit) ou 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 menu 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:

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


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, digite A. O Reconciliation Attribute Passed to Agent

Menu é exibido.

Reconciliation Attributes Passed to Agent for Context: Context1

----------------------------------------------------

----------------------------------------------------

A. Add new attribute

B. Modify attribute value

C. Remove attribute

X. Done

Select menu option:


O Oracle Database Adapter requer que o atributo erOracleServiceName seja

especificado para cada contexto. O valor do atributo erOracleServiceName deve

ser configurado para o Nome do Serviço Oracle definido no Formulário de

Serviço do Tivoli Identity Manager.

2. Digite a letra da opção de menu 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 Reconciliation Attributes Passed to Agent Menu é exibido com as alterações.

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.

Para configurar o DN de destino, conclua as etapas a seguir:

1. No Modify Context Menu, digite B.

2. No prompt Enter Target DN, digite o DN de destino do 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:

Tabela 6. Elementos e Definições do DN

Elemento Definição

erservicename Especifica o nome do serviço de destino

Q Especifica o nome da organização

ou Especifica o nome do tenant no qual a

organização se encontra

rootsuffix Especifica a 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, 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 Oracle Database Adapter, conclua as

etapas a seguir:

1. No prompt 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 Main Menu é exibido.

Alterando as Configurações do Log de Atividades

Quando você ativa o log, o Oracle Database Adapter mantém um arquivo de log

datado de todas as transações, OracleAgent.log. Por padrão, o arquivo de log está

no diretório \log.

Para alterar as configurações do log de atividades do Oracle Database Adapter,


1. No prompt Main Menu, digite E.

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: C:\Tivoli\Agents\OracleAgentLog).

C. Activity Log File Name (current: OracleAgent.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 da opção do Activity Logging Menu que 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 alterar o

valor.

Tabela 7. Opções do Activity Logging Menu


O Defina essa opção como ativada para que o adaptador mantenha um

arquivo de log datado de todas as transações.


v Disabled, pressionar a tecla A muda para ativada

v Enabled, pressionar a tecla A muda para desativada

Digite A para alternar entre as opções.

B O seguinte aviso é exibido:

Enter log file directory:

Digite um valor diferente para o diretório de registro, por exemplo,

C:\Log. Quando a opção de log está ativada, detalhes sobre cada pedido

de acesso são armazenados no arquivo de log que se encontra nesse

diretório.


Tabela 7. Opções do Activity Logging Menu (continuação)


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.

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.


v Disabled, pressionar a tecla F altera o valor para ativada

v Enabled, pressionar a tecla F altera o valor para desativada

Digite F para alternar entre as opções.

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.


v Disabled, pressionar a tecla G altera o valor para ativada

v Enabled, pressionar a tecla G altera o valor para desativada

Digite G para alternar entre as opções.

H Se essa opção estiver definida como ativada, o adaptador manterá um

arquivo de log de todas as transações no ADK (Adapter Development

Kit) e em arquivos de biblioteca. O log de base aumentará

substancialmente o tamanho dos logs.


v Disabled, pressionar a tecla H altera o valor para ativada

v Enabled, pressionar a tecla H altera o valor para desativada

Digite H para alternar entre as opções.


Tabela 7. Opções do Activity Logging Menu (continuação)


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.


v Disabled, pressionar a tecla I altera o valor para ativada

v Enabled, pressionar a tecla I altera o valor para desativada

Digite I para alternar entre as opções.

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 as novas definições.

Alterando Configurações de Registro

Para alterar as configurações de registro do Oracle Database Adapter, conclua as

etapas a seguir:

1. No Main Menu, digite F. O Registry Menu é exibido.

OracleAgent 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.

Modificando Configurações de Registro Não-criptografadas

As configurações de registro não criptografadas do Adaptador Oracle são

utilizadas para armazenar os nomes de serviços Oracle gerenciados pelo adaptador.

Consulte o Capítulo 4, “Modificações de Serviços Oracle”, na página 27 para obter

informações sobre como configurar nomes de serviços Oracle adicionais.

Modificando Configurações de Registro Criptografadas

As configurações de registro criptografadas do Oracle Database Adapter são

utilizadas para armazenar a senha dos nomes de serviços Oracle gerenciados pelo

adaptador. Consulte o Capítulo 4, “Modificações de Serviços Oracle”, na página 27

para obter informações sobre como configurar nomes de serviços Oracle adicionais.

Alterando Configurações Avançadas

Você pode alterar as configurações de contagem de encadeamentos do Oracle

Database Adapter 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 Oracle Database Adapter. Para alterar essas configurações,


1. No prompt Main Menu, digite G.

O Advanced Settings Menu é exibido. O exemplo a seguir mostra as

configurações padrão de contagem de encadeamentos.

OracleAgent 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 da opção de menu da configuração avançada que você deseja

alterar. Para obter uma descrição de cada opção, consulte a Tabela 8.

Tabela 8. 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.


E Controla quantos pedidos DELETE simultâneos podem ser executados

por vez.


E Controla quantos pedidos SEARCH simultâneos podem ser executados

por vez.


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.



3. Altere o valor e pressione Enter.

O Advanced Settings Menu é exibido com as novas definições.

Visualizando Estatísticas

Para visualizar um log de eventos do Oracle Database Adapter, conclua as etapas a

seguir:

1. No prompt Main Menu, digite H.

O histórico de atividades do adaptador é exibido.

OracleAgent 4.6 Agent Request Statistics

--------------------------------------------------------------------

Date Add Mod Del Ssp Res Rec

-----------------------------------------------------------------

11/15/02 000001 000000 000000 000000 000000 000001

-----------------------------------------------------------------

X. Done

2. Digite X para retornar ao Menu Main Configuration.

Alterando Configurações de Página de Códigos

Para listar as informações da página de códigos suportada do Oracle Database

Adapter, o adaptador deverá estar em execução. Execute o seguinte comando para

visualizar as informações da página de códigos:

agentCfg -agent [adapter_name] -codepages

Para alterar as configurações da página de códigos do Oracle Database Adapter,


1. No prompt Main Menu, digite I.

O Code Page Support Menu do adaptador é exibido.

OracleAgent 4.6 Codepage Support Menu

-------------------------------------------

* Configured codepage: US-ASCII

-------------------------------------------

*

*******************************************

* Restart Agent After Configuring Codepages

*******************************************

A. Codepage Configure.

X. Done

Select menu option:

2. Digite A para configurar uma página de códigos.

Nota: A página de códigos do OracleAgent utiliza unicode; portanto, essa

opção não é aplicável.

3. Digite X para retornar ao Menu Main Configuration.


Acessando a Ajuda e Opções Adicionais

Para acessar o menu de ajuda do agentCfg e utilizar os argumentos da ajuda,


1. No prompt 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

A Tabela 9 descreve cada argumento.

Tabela 9. Argumentos e Descrições do Comando 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 -findall

v -list

v -tail

v -agent

Digite um nome de host ou endereço IP como o valor.

-findall Utilize esse argumento para procurar e exibir todos os

endereços de porta entre 44970 e 44994 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 Oracle Database Adapter. Por

padrão, a primeira vez que você instala um adaptador, ele é

designado ao endereço de porta 44970 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.


Tabela 9. Argumentos e Descrições do Comando de Ajuda do agentCfg (continuação)

Argumento Descrição

-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 Banco de Dados Oracle. Isso permite a você verificar se o

adaptador pode conectar-se ao Banco de Dados Oracle 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. Note que o endereço de porta do Servidor Tivoli Identity Manager is

44970. A saída é semelhante à seguinte:

Agent(s) installed on node ’127.0.0.1’

-----------------------

OracleAgent (44970)

Digite agentCfg -agent OracleAgent para exibir o Main Menu da ferramenta

agentCfg, que é utilizada para visualizar ou modificar os parâmetros do Oracle

Database Adapter.

Digite agentCfg -list -hostname 192.9.200.7 para listar os adaptadores em

um host cujo endereço IP seja 192.9.200.7. A saída é semelhante à seguinte:

Agent(s) installed on node ’192.9.200.7’

------------------

OracleAgent (44970)

Digite agentCfg -agent OracleAgent -hostname 192.9.200.7 para exibir o

Main Menu da ferramenta agentCfg para um host cujo endereço IP seja

192.9.200.7. Utilize as opções do menu para exibir ou modificar os parâmetros

do Oracle Database Adapter.


Capítulo 4. Modificações de Serviços Oracle

Este capítulo descreve como utilizar o programa de configuração de serviços para

visualizar ou modificar Serviços Oracle. Para que a modificação com essa

ferramenta tenha efeito imediatamente, você deve reiniciar o Oracle Database

Adapter.

Nota: Os nomes dos Serviços Oracle utilizados devem ser nomes válidos na

Configuração de Rede do Cliente Oracle.

Acessando o Menu Principal da Ferramenta de Configuração de

Serviços

O procedimento a seguir descreve como acessar o Main Menu da ferramenta

serviceCfg para parâmetros do Oracle Database Adapter:

1. Efetue login na conta do Oracle Database Adapter.

2. Altere para o diretório \bin do Oracle Database Adapter.

# cd C:\Tivoli\Agents\OracleAgentbin

3. Digite serviceCfg e pressione Enter.

O Main Menu é exibido.

IBM Oracle Agent Services Utility.

-------------------------------------------

1) Display current Oracle Services.

2) Add a new Oracle Service.

3) Modify an Oracle Service.

4) Remove an Oracle Service.

5) Test Oracle Connection.

0) Exit.

Enter Option:

No Main Menu, selecione uma das opções para desempenhar as seguintes tarefas:

v Para a opção 1, consulte “Visualizando Serviços Oracle Atuais”

v Para a opção 2, consulte “Incluindo um Novo Serviço Oracle” na página 28

v Para a opção 3, consulte “Modificando um Serviço Oracle” na página 29

v Para a opção 4, consulte “Removendo um Serviço Oracle” na página 30

v Para a opção 5, consulte “Testando uma Conexão Oracle” na página 31

Digite 0 para retornar ao Menu Principal.

Visualizando Serviços Oracle Atuais

Para visualizar o Serviço Oracle, conclua as seguintes etapas:

1. No prompt Main Menu, digite 1.

São exibidos os Serviços Oracle atuais para o Oracle Database Adapter. A

amostra a seguir corresponde às definições do Serviço Oracle:



-------------------------------------------

Display Current Services.

Available Oracle Services 1 through 10

OraService1=sugar:plum

OraService2=peach:blossom

OraService3=apple:cider

OraService4=orange:juice

N)next; P)previous; X)exit; -->

2. No menu Display Current Services, digite a letra do menu relativa à ação que

você deseja desempenhar e pressione Enter.

Tabela 10. Descrições de Opções de Visualização


N Listar os próximos dez Serviços Oracle.

P Listar os dez Serviços Oracle anteriores.

Incluindo um Novo Serviço Oracle

Para incluir um novo Serviço Oracle, conclua as seguintes etapas:


É exibido o menu Add a new Oracle Service.

2. No prompt Oracle Service Name, digite o nome do novo serviço Oracle e

pressione Enter.

O seguinte aviso é exibido:

.....Oracle Account:

3. No prompt .....Oracle Account, digite o nome da conta do serviço Oracle e

pressione Enter.

Esse nome corresponde ao nome da Conta de Administração Oracle.


....Account password:

4. No prompt ....Account password, digite a senha da conta do serviço Oracle e

pressione Enter.

Essa senha corresponde à senha da Conta de Administração Oracle.


...Verify password:

5. No prompt ...Verify password, digite a senha da conta do serviço Oracle

novamente e pressione Enter.


Hit any key to continue

6. No prompt Hit any key to continue, pressione qualquer tecla para continuar.

O Main Menu é exibido.


Exemplo de Inclusão de um Serviço Oracle

A seguir está um script de amostra que incluirá um novo Serviço Oracle:


------------------------------------------------

Adding ’OracService1’.

Oracle Service Name: bart

.....Oracle Account: maggie

.....Account Password:

.....Verify Password:

Added Service ’bart’ with Account ’maggie’, Version ’8’.


Modificando um Serviço Oracle

Para modificar um Serviço Oracle, conclua as seguintes etapas:


O menu Modify Service é exibido.


----------------------------------------

Modify Service.






N)next; P)previous; M)modify; X)exit; -->

2. No menu Modify Service, digite a letra do menu relativa à ação que você

deseja desempenhar e pressione Enter.

Tabela 11. Descrições de Opções de Modificação




M Modificar um Serviço Oracle.

3. Digite o número do Serviço Oracle que você deseja modificar e pressione Enter.


Enter the OraService number to modify :

4. No prompt Enter the OraService number to modify, aceite o nome padrão do

serviço ou digite um novo nome e pressione Enter.


Oracle Service Name [sugar]:

5. No prompt Oracle Service Name, aceite o valor padrão ou digite um novo

nome de conta do serviço e pressione Enter.


.....Oracle Account [fairy]:

6. No prompt .....Oracle Account, aceite o valor padrão ou digite um novo nome

de conta e pressione Enter.


.....Account Password :

7. No prompt .....Account Password, digite a senha da conta do Serviço Oracle e

pressione Enter.

Capítulo 4. Modificações de Serviços Oracle 29


.....Verify Password :

8. No prompt .....Verify Password, digite a senha da conta do administrador do

Oracle novamente e pressione Enter.




O menu Modify an Oracle Service é exibido com os novos valores listados.

Exemplo de Modificação de um Serviço Oracle

O exemplo a seguir é um script que modifica um Serviço Oracle:


----------------------------------------

Modify Service.


OraService1= plum:system

OraService2= peach:oradba

OraService3= palm:es300

OraService4= basswood:oradba

N)next; P)previous; M)modify; X)exit; --> M

Enter the OraService number to modify : 1

Oracle Service Name [plum]:

.....Oracle Account [system]: itim

.....Account Password:

.....Verify Password:

Update Service ’plum’ with Account ’itim’, Version ’8’.

Hit any key to continue.

Removendo um Serviço Oracle

Para remover um Serviço Oracle, conclua as seguintes etapas:


O menu Remove Service é exibido.

IBM Oracle Agent Services Utility

---------------------------------------------

Remove Service






N)next; P)previous; R)remove; X)exit; -->

2. No menu Remove Service, digite a letra do menu relativa à ação que você

deseja desempenhar e pressione Enter.

Tabela 12. Descrições de Opções de Remoção




R Remover um Serviço Oracle.

3. Digite o número do Serviço Oracle que você deseja remover e pressione Enter.



Enter the OraService number to delete :

4. No prompt Enter the OraService number to delete, digite Y e pressione Enter.


Are you sure [Y/N]:

5. No prompt Are you sure [Y/N], digite Y para excluir o Serviço ou N para

cancelar.

Se você escolher Y, o Serviço Oracle selecionado será excluído.

Exemplo de Remoção de um Serviço Oracle

O exemplo a seguir é um script que remova um Serviço Oracle:


-----------------------------------------------

Remove Service.






N)next; P)previous; R)remove; X)exit; --> r

Enter the OraService number to delete : 1

Removing ’OraService1’...

service name : ’sugar’

account : ’plum’

Are you sure [Y/N]: y

Testando uma Conexão Oracle

Para testar a conexão de um Serviço Oracle, conclua as seguintes etapas:


O menu Test Oracle Service connection é exibido.


---------------------------------------------

Test Oracle connection.






N)next; P)previous; T)test connection; X)exit; -->

2. No menu Test Oracle connection, digite a letra do menu relativa à ação que

você deseja desempenhar e pressione Enter.

Tabela 13. Descrições de Opções de Teste




T Testar a conexão de um Serviço Oracle.

3. Digite o número do Serviço Oracle que você deseja testar e pressione Enter.


Enter the OraService number to test :

4. No prompt Enter the OraService number to test, digite o número do Serviço

Oracle que você deseja testar.

Capítulo 4. Modificações de Serviços Oracle 31

Se o teste for bem-sucedido, a seguinte mensagem será exibida:

Connection SUCCESSFUl to ’OraService1 : sugar’ .


O menu Test Oracle connection é exibido.

Exemplo de Teste de uma Conexão Oracle

O exemplo a seguir é um script que testa uma conexão Oracle:


----------------------------------------

Test Oracle connection.






N)next; P)previous; T)test connection; X)exit; --> t

Enter the OraService number to test: 1

Connection SUCCESSFUL to ’OraService1 : sugar’ .

Hit any key to continue.


Capítulo 5. Configurando a Autenticação SSL para o Oracle

Database Adapter

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


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.


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.


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


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:

-----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.

Formato .arm

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 5. Configurando a Autenticação SSL para o Oracle Database Adapter 35

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.

O Uso da Autenticação SSL

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.


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.

Para configurar o SSL de uma via, execute as seguintes tarefas para cada

aplicativo:

Iniciar comunicação

Servidor Tivoli IdentityManager (cliente SSL)

Armazenamentode chave

CertificadoA de CA

Adaptador Tivoli IdentityManager (servidor SSL)

CertificadoA

Verificar Enviar Certificado B

Figura 2. Autenticação de Uma Via (Autenticação de Servidor)


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


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 38, o Servidor Tivoli Identity Manager funciona como o

Aplicativo A e o adaptador Tivoli Identity Manager funciona como o Aplicativo B.


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 36. 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 39 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.

CIniciar comunicaçãoArmazenamento

de Chave

CertificadoA de CA

CertificadoB

CertificadoA

CertificadoB de CA

Adaptador Tivoli IdentityManager (servidor SSL)

Servidor Tivoli IdentityManager (cliente SSL)

Verificar

Enviar Certificado AVerificar

Figura 3. Autenticação SSL de Duas Vias (Autenticação de Cliente)


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 40.

v “Gerando uma Chave Privada e um Pedido de Certificado” na página 42.

v “Instalando o Certificado” na página 43.

v “Instalando o Certificado e a Chave de um Arquivo PKCS12” na página 43.

v “Visualizando o Certificado Instalado” na página 43.

v “Visualizando Certificados CA” na página 44.

v “Instalando um Certificado CA” na página 44.

v “Excluindo um Certificado CA” na página 44.

v “Visualizando Certificados Registrados” na página 44.

v “Registrando um Certificado” na página 45.

v “Cancelando o Registro de um Certificado” na página 45.

AdaptadorTivoliIdentityManager

ServidorTivoliIdentityManager

Certificado A de CACertificado A

CACertificado C de

Certificado C

Servidor Web

A B

C

Iniciar Comunicação

Certificado A

Iniciar Comunicação

Certificado C

Figura 4. Adaptador Tivoli Identity Manager Funcionando como um Servidor SSL e um

Cliente SSL


Iniciando o CertTool

Para iniciar a ferramenta de configuração de certificado, CertTool, para o Oracle

Database Adapter, conclua estas etapas:

1. Selecione Programas no menu Iniciar, selecione Acessórios e, em seguida,

selecione Prompt de Comandos.

2. Na janela Prompt de Comandos do DOS do Microsoft Windows, vá para o

diretório bin do adaptador. Por exemplo, se o diretório do Oracle Database

Adapter estiver no local padrão, digite o seguinte comando:

cd C:\Tivoli\Agents\OracleAgent\bin

3. Digite CertTool -agent OracleAgent no prompt. O Main Menu é exibido:

Main menu - Configuring agent: OracleAgent

------------------------------

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 42.

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 43.

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 43.


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 43.

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


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 44.

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 44.

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 44.

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 45.

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 45.


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 45.

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)

-------------------------------------------------------------------------

2. 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 Email, digite o endereço de e-mail 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

DQEBAgUAA4GBADxA1cDkvXhgZntHkwT9tCTqUNV9sim8N/U15HgMRh177jVaHJqb

N1Er46vQSsOOOk4z2i/XwOmFkNNTXRVl9TLZZ/D+9mGZcDobcO+lbAKlePwyufxK

Xqdpu3d433H7xfJJSNYLYBFkrQJesITqKft0Q45gIjywIrbctVUCepL2

-----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 e-mail, copie o

texto do certificado em um arquivo de texto e copie esse arquivo no diretório

bin do adaptador. Por exemplo,

C:\Tivoli\Agents\OracleAgent\bin

2. No Main Menu do CertTool, digite B. O seguinte aviso é exibido:

Enter name of certificate file:

-------------------------------------------------------------------------

3. 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,

C:\Tivoli\Agents\OracleAgent\bin

2. No Main Menu do CertTool, digite C. O seguinte aviso é exibido:

Enter name of PKCS12 file:

-------------------------------------------------------------------------

3. 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

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).



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:

[email protected],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:59 2006

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 - [email protected],c=US,st=California,l=Irvine,o=IBM,ou=Engineering,cn=Eng

1 - [email protected],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:




Registrando um Certificado

Para registrar um certificado para o adaptador, conclua as seguintes etapas:

1. No prompt Main Menu, digite I.



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:


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:



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:


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.


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 6. Customizando o Oracle Database Adapter

Você pode atualizar o arquivo JAR do Oracle Database Adapter, OracleProfile.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 Oracle Database Adapter:

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 OracleProfile.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 48.

Copiar o Arquivo OracleProfile.jar e Extrair os Arquivos

O arquivo JAR do perfil, OracleProfile.jar, está incluído no arquivo compactado do

Oracle Database Adapter transferido por download no Web site da IBM. O arquivo

OracleProfile.jar contém os seguintes arquivos:

v CustomLabels.properties

v erOracleAccount.xml

v erOracleDAMLService.xml

v resource.def

v 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 6.

Para modificar o arquivo OracleProfile.jar, conclua as etapas a seguir:

1. Efetue logon no sistema no qual o Oracle Database Adapter está instalado.

2. No menu Iniciar, clique em Programas → Acessórios → Prompt de Comandos.

3. Copie o arquivo OracleProfile.jar para um diretório temporário.

4. Extraia o conteúdo do arquivo OracleProfile.jar no diretório temporário

executando o seguinte comando:

cd c:\temp

jar -xvf OracleProfile.jar

O comando jar criará o diretório c:\temp\OracleProfile.

5. Edite o arquivo apropriado.


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 c:\temp

jar -cvf OracleProfile.jar OracleProfile

2. Importe o arquivo OracleProfile.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 6.

3. Pare e inicie o servidor de diretórios.

4. Pare e inicie o serviço Oracle Database Adapter 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 Banco de Dados Oracle 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 Oracle Database Adapter 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 Oracle Database Adapter para não solicitar uma nova senha ao

restaurar contas:

1. Pare o Servidor Tivoli Identity Manager.

2. Extraia os arquivos do arquivo OracleProfile.jar. Para obter mais informações

sobre como customizar o arquivo de perfil do adaptador, consulte “Copiar o

Arquivo OracleProfile.jar e Extrair os Arquivos” na página 47.


3. Vá para o diretório \OracleProfile, 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 OracleProfile.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

48.

6. 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 Oracle Database Adapter” na página 51.

Capítulo 6. Customizando o Oracle Database Adapter 49

Capítulo 7. Fazendo Upgrade do Oracle Database Adapter ou

do ADK

Você pode fazer upgrade do Oracle Database Adapter 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 Oracle Database Adapter

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 Oracle Database Adapter”, na página 3.

Se você tem atualmente a versão 4.4 ou 4.5 do Oracle Database Adapter 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 Oracle Database Adapter.

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.

Fazendo Upgrade do ADK

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.


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 Oracle Database Adapter ADK, conclua as seguintes etapas:

1. Faça download do arquivo compactado do programa de upgrade do ADK no

Web site da IBM.

2. Extraia o conteúdo do arquivo compactado em um diretório temporário.


4. Inicie o programa de upgrade utilizando o arquivo adkinst_win32.exe no

diretório temporário. Por exemplo, selecione Executar no menu Iniciar e digite

C:\TEMP\adkinst_win32.exe no campo Abrir.

Se nenhum adaptador estiver instalado, você receberá a seguinte mensagem de

erro e o programa será encerrado:

Nenhum Agente Instalado - Impossível Instalar o ADK.


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 Informações da Instalação, clique em Avançar para iniciar a

instalação.

8. Na janela Instalação Concluída, clique em Concluir 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.


Capítulo 8. Desinstalando o Oracle Database Adapter

Antes de remover o adaptador, informe seus usuários de que o Oracle Database

Adapter estará indisponível e será removido do sistema. Se o servidor for colocado

off-line, os pedidos do Oracle Database Adapter que não estiverem concluídos não

poderão ser recuperados quando o servidor estiver on-line novamente.

Para remover o Oracle Database Adapter, conclua estas etapas:


2. Abra o Windows Explorer e execute <adapter_directory>\_uninst\uninstaller.exe,

em que adapter_directory é o diretório no qual o adaptador foi instalado.


4. Na janela Resumo da Desinstalação do Oracle Database Adapter, clique em

Avançar.

5. Clique em Concluir.

Inspecione o diretório do adaptador em busca de diretórios, subdiretórios e

arquivos do Oracle Database Adapter para verificar se a desinstalação está

concluída. A instância do Oracle Database Adapter que foi desinstalada não

deverá mais aparecer na janela Serviços.


Apêndice A. Atributos do Adaptador

Como parte da implementação do adaptador, uma conta dedicada para o Tivoli

Identity Manager acessar o Banco de Dados Oracle é criada no Banco de Dados

Oracle. O Oracle Database Adapter 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.

Descrições dos Atributos

O Servidor Tivoli Identity Manager se comunica com o Oracle Database Adapter

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 Oracle Database Adapter.

A Tabela 14 é uma listagem em ordem alfabética dos atributos que são utilizados

pelo Oracle Database Adapter. A tabela fornece uma descrição resumida e o tipo de

dados para o valor do atributo.

Tabela 14. Atributos, Descrições e Tipos de Dados.

Atributo do Servidor de Diretórios Descrição Tipo de Dados

erOracleAuthenticationType Especifica como o usuário é autenticado pelo Banco

de Dados Oracle. Existem três métodos de

autenticação:

LOCAL

A autenticação do usuário é

desempenhada pelos bancos de dados

Oracle locais.

EXTERNO


desempenhada pelo Sistema Operacional.

GLOBAL


desempenhada pela Rede.

String

erOracleExpirePwd Especifica quando a senha expira. Se configurado

como true, a senha da conta expira imediatamente.

Booleano

erOracleGlobalName Especifica o nome externo se a autenticação for

configurada como GLOBAL.

String

erPassword Especifica a senha do usuário Binário

erOracleProfile Especifica o nome do perfil do usuário. String


Tabela 14. Atributos, Descrições e Tipos de Dados. (continuação)

Atributo do Servidor de Diretórios Descrição Tipo de Dados

erOracleTblSpcQuota Especifica a quantidade de espaço alocado para o

usuário em um espaço de tabelas.

xM em <nome do espaço de tabelas>

xK em <nome do espaço de tabelas>

x em <nome do espaço de tabelas>

UNLIMITED em <nome do espaço de tabelas>

Em que x em valor numérico > 0

M é para megabyte

K é para kilobyte

UNLIMITED é para sem limite

Qualquer nome de espaço de tabelas válido

definido no Banco de Dados do Oracle.

String

erOracleRole Especifica a função designada ao usuário.

Qualquer função válida definida no Banco de

Dados Oracle.

String

erOracleServiceName Especifica o nome do serviço Oracle, definido pela

configuração de Rede do Oracle Client. O

adaptador utiliza esse valor para conectar-se ao

Banco de Dados Oracle.

String

erOracleSysPriv Especifica se um usuário tem o direito de

desempenhar uma operação específica do banco de

dados ou uma classe de operações do banco de

dados.

Qualquer Privilégio do Sistema válido definido no

Banco de Dados do Oracle.

String

erOracleDefaultTableSpace Especifica o nome padrão para o espaço de tabelas

alocado para o usuário.

String

erOracleTemporaryTableSpace Especifica o nome do espaço de tabelas temporário

alocado para o usuário.

String

erUid Especifica o ID do usuário.

O ID do usuário deve ser criado com base nas

regras descritas na Referência SQL do Oracle.

String

Atributos por Ações do Oracle Database Adapter

A lista a seguir relaciona as ações típicas do Oracle Database Adapter de acordo

com o seu grupo de transações funcionais. As listas incluem mais informações

sobre atributos opcionais e obrigatórios enviados ao Oracle Database Adapter 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.


Tabela 15. Atributos de Pedido de Inclusão

Atributo Obrigatório Atributo Opcional

erUid

erOracleServiceName

erOracleAuthenticationType

erOracleExpirePwd

erOracleGlobalName

erPassword

erOracleProfile

erOracleTblSpcQuota

erOracleRole

erOracleSysPriv

erOracleDefaultTableSpace

erOracleTemporaryTableSpace

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 16. Atributos de Pedido de Alteração


erUid

erOracleServiceName

erOracleAuthenticationType

erOracleExpirePwd

erOracleGlobalName

erPassword

erOracleProfile

erOracleTblSpcQuota

erOracleRole

erOracleSysPriv

erOracleDefaultTableSpace

erOracleTemporaryTableSpace

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.

Tabela 17. Atributos de Pedido de Exclusão


erUid

erOracleServiceName

Nenhum

Apêndice A. Atributos do Adaptador 57

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 18. Atributos de Pedido de Suspensão


erUid

erOracleServiceName

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 19. Atributos de Pedido de Restauração


erUid

erOracleServiceName

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 20. Atributos de Pedido de Reconciliação


erOracleServiceName Nenhum


Apêndice B. 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 60

v “Entrando em Contato com o IBM Software Support” na página 60

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:



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 Os guias 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:









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

(http://www.ibm.com/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 e-mail 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 e-mail de outros produtos, repita as Etapas 4 e 5.

Para obter informações adicionais sobre tipos de correções, consulte o Software

Support Handbook (http://techsupport.services.ibm.com/guides/handbook.html).

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

(http://www.lotus.com/services/passport.nsf/WebDocs/

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

(http://techsupport.services.ibm.com/guides/contacts.html) 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


http://www.ibm.com/software/support

http://techsupport.services.ibm.com/guides/handbook.html



http://techsupport.services.ibm.com/guides/contacts.html

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

(http://www.ibm.com/servers/eserver/techsupport.html).

Se não tiver certeza do tipo de contrato de manutenção de software que você

precisa, ligue para 1-800-IBMSERV (1-800-426-7378) nos Estados Unidos ou, de

outros países, vá para a página de contatos do IBM Software Support Handbook

na Web (http://techsupport.services.ibm.com/guides/contacts.html) 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 B. Informações sobre Suporte 61

http://www.ibm.com/servers/eserver/techsupport.html


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 (http://www.ibm.com/software/support/probsub.html).

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

(http://techsupport.services.ibm.com/guides/contacts.html) 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.


http://www.ibm.com/software/support/probsub.html


Apêndice C. 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, 138-146

Botafogo

Rio de Janeiro, RJ

CEP 22290-240

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 106-0032, 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.


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, 138-146

Botafogo

Rio de Janeiro, RJ

CEP 22290-240

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.


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 C. Avisos 65

Índice Remissivo

Aacessibilidade

formato pdf, para software de leitor de tela ix

instrução para documentação ix

texto, alternativa para imagens de documento ix

adaptadoratributos

descrições 55

pela ação do adaptador 56

etapas de configuração 8

etapas de customização 47

features 1

propósito do perfil 6

remoção 53

upgrade 51

upgrade do ADK 51

visão geral da instalação 1

Adaptador Tivoli Identity Managercomunicação com o servidor 37, 38

comunicação SSL 37, 38

agentCfgalterando parâmetros do adaptador

chave de configuração 19

definições de protocolos 11

definições de registro 22

processamento de pedidos 23

arguments 25

exibindo definições de configuração 10

menusajuda 25

Configuração de Protocolos 11

definições avançadas 23

Main Configuration 9

notificação de evento 14

registro 22

registro de atividades 20

arquivo ADK46Installer.log 52

arquivo ADK46Installeropt.log 52

arquivo PKCS12exportar certificado e chave 45

instalação de certificado e chave 43

arquivo protegido por senhaVeja arquivo PKCS12

arquivo trace.log 6

ativar/desativar com agentCfg 20

atributosdescrições 55

por ação do Oracle Database Adapteradd 56

alterar 57

Opções de Desempenho 57

reconciliation 58

restauração 58

suspender 58

atualizandoperfil do adaptador 47

autenticação de cliente 37

autoridade de administrador 4

autoridade de certificaçãodefinição 33

Bbases de conhecimento, pesquisando para localizar resolução

de problema de software 59

Ccentros de informações, pesquisando para localizar resolução

de problema de software 59

certificado auto-assinado 35

certificadosauto-assinado 35

CAexclusão 44

exibindo instalado 44

funções disponíveis 41

instalando 44

chaves privadas e certificados digitais 34

definição 33

exemploscertificate signing request (CSR) 43

exibindoregistered 44

exibindo instalado 43

exibindo registrado 44

ferramenta de configuração de protocolosVeja CertTool

ferramentas de gerenciamento de certificadoVeja CertTool

formatos de chave 35

instalação 43

a partir de um arquivo 43

amostra 43

pedido 42

registeredexibindo 44

registrando 45

removendo 45

registrar 41

visão geral 33

visualizandoinstalado 43

certificate signing request (CSR) 43

CertToolalterando parâmetros do adaptador

acessando 36, 40

options 40

autenticação de cliente 41

certificadoinstalação 43

certificado de CAcomo instalar 44

exclusão 44

exibindo 44

certificado registradoexibindo 44

registrando 45

removendo 45

certificateexibindo instalado 43

exibindo registrado 44


CertTool (continuação)certificate (continuação)

pedido 42

registrar 41

chave privada, gerando 42

instalar certificado 43

chave privadadefinição 33

chave privada, gerando 42

chave pública 34

codificaçãoDAML Protocol

Tipo da Origem 11

valor padrão 11

SSL 33

conectividade da rede 4

configuraçãodefinições

alterando com agentCfg 9

exibindo com agentCfg 10

valor padrão 10

keyalterando com agentCfg 19

finally 9

valor padrão 9, 19

SSL 36

configuração de duas viasSSL

cliente 37

cliente e servidor 38

conjunto de caracteres da Europa Ocidental, suporte 23

conjuntos de caracteres, suportados 23

contextatributos de pesquisa 18

banco de dados de linha de base 19

DN de destino 19

exclusão 16

modificando 17

contextolistando 16

convençõesdiretório HOME

Tivoli_Common_Directory xii

DB_INSTANCE_HOME x

HTTP_HOME xi

ITIM_HOME xii

LDAP_HOME xi

WAS_HOME xii

WAS_MQ_HOME xii

WAS_NDM_HOME xii

tipográfica ix

utilizado neste documento ix

variável UNIX, notação de diretório x

convenções referentes a tipos de caracteres ix

correções, obtendo 60

criptografiaSSL 34

CSRarquivo, gerando 42

definição 42

DDAML protocol

configurando com agentCfg 11

DAML Protocolautenticação SSL 36

DAML Protocol (continuação)codificação

Tipo da Origem 11

criptografiavalor padrão 11

options 11

propriedades, modificada com agentCfgopções 11

require_cert_reg 13

senha 12

srv_nodename 12

srv_portnumber 13

validate_client_ce 13

DB_INSTANCE_HOMEdefinição x

diretório de instalação do DB2 UDB x

definição de contagem de encadeamentoalterando com agentCfg 22

máximo de pedidos simultâneos 23

pedidos de adição de logins do sistema 23

pedidos de alteração de logins do sistema 23

pedidos de exclusão de logins do sistema 23

pedidos de reconciliação 23

valores padrão 22

definições de registrocriptografadas 22

não criptografadas 22

definições de registro criptografadas 22

definições de registro não criptografadas 22

desinstalação 53

determinação de problemasdescrevendo o problema para IBM Software Support 61

determinando o impacto comercial para o IBM Software

Support 61

submetendo o problema ao IBM Software Support 62

directoryHTTP_HOME xi

LDAP_HOME xi

nomes, notação UNIX x

DiretórioDB_INSTANCE_HOME x

instalaçãoDB2 UDB x

IBM Directory Server xi

IBM HTTP Server xi

produto WebSphere Application Server Base xii

WebSphere MQ xii

instalação do pacoteproduto WebSphere Application Server Network

Deployment xii

instalação do Sun ONE Directory Server xi

ITIM_HOME xii

WAS_HOME xii

WAS_MQ_HOME xii

WAS_NDM_HOME xii

diretórios homeDB_INSTANCE_HOME x

HTTP_HOME xi

ITIM_HOME xii

LDAP_HOME xi

WAS_HOME xii

WAS_MQ_HOME xii

WAS_NDM_HOME xii

documentosrelacionadas viii

Tivoli Identity Manager biblioteca v


EEvent Notification

ativar/desativar 15

contextexclusão 16

Fferramenta de configuração do adaptador

Veja agentCfg

formato pdf, para software de leitor de tela ix

HHTTP_HOME

definição xi

diretório de instalação do IBM HTTP Server xi

Iimplementações SSL, DAML Protocol 36

importarquivo PKCS12 35

perfil do adaptador 6, 48

inabilidade, utilizando a documentação ix

instalaçãocertificate 43

desinstalação 53

DiretórioDB2 UDB x

IBM Directory Server xi

IBM HTTP Server xi

produto WebSphere Application Server Base xii

Sun ONE Directory Server xi

perfil 6

instalação do pacoteDiretório

produto WebSphere Application Server Network

Deployment xii

WebSphere MQ xii

Internet, pesquisando para localizar resolução de problema de

software 59, 60

ITIM_HOMEdefinição xii

Diretório xii

LLDAP_HOME

definição xi

diretório de instalação do IBM Directory Server xi

diretório de instalação do Sun ONE Directory Server xi

log de depuraçãoativar/desativar com agentCfg 20

finally 21

valor padrão 20

log de detalhesativar/desativar com agentCfg 20

finally 21

valor padrão 20

logsarquivo ADK46Installer.log 52

arquivo ADK46Installeropt.log 52

arquivo trace.log 6

ativar/desativar, alterando com agentCfg 20

logs (continuação)configurações, alterando com o adapterCfg 20

configurações de atividade, alterando 10

definições, modificada com agentCfgnome do arquivo de log 21

tamanho máximo do arquivo 21

definições, valores padrão 20

depurar 20

detail 20

diretório, alterando com agentCfg 20

estatísticas 24

exibir utilizando o agentCfg 26

nome do arquivo, alterando com agentCfg 20

visualizando estatísticas 24

visualizar eventos 10

Mmanuais

consulte as publicações viii

menu de ajuda para agentCfg 25

acessando com o comando -help 25

Nnomes de caminhos, notação x

notificação de eventoalterando com agentCfg 14

contextatributos de pesquisa 18

banco de dados de linha de base 19

DN de destino 19

modificando 17

contextolistando 16

iniciando manualmente 15

reconciliationatributos 16

contexto 16

intervalos 15

modificando 16

prioridade do processo 16

tamanho do cache 15

número da porta, alterando com o agentCfg 12

Pportnumber

alterando com agentCfg 11

pré-requisitos da instalaçãoautoridade de administrador 4

conectividade da rede 4

conta de serviço Oracle 4

Servidor Tivoli Identity Manager 4

sistema 3

sistema operacional de rede 3

software do banco de dados Oracle 3

software Oracle Client 3

pré-requisitos de sistema operacional 3

Pré-requisitos do Servidor Tivoli Identity Manager 4

pré-requisitos do sistema 3

propriedades, modificada com agentCfg 11

protocolDAML

configurando com agentCfg 11

propriedades, modificada com agentCfg 11

Índice Remissivo 69

protocol (continuação)DAML (continuação)

tipo de criptografia 11

valor padrão de criptografia 11

SSLconfiguração de duas vias 37, 38

configuração de servidor para adaptador 36

visão geral 33

protocolo DAMLpropriedades, modificada com agentCfg

portnumber 12

username 12

publicaçõesacessando on-line viii

relacionadas viii

Tivoli Identity Manager biblioteca v

publicações on-lineacessando viii

Rreconciliação

atributos 16

modificando 16

reconciliationatributos 58

context 16

intervalos 15

prioridade do processo 16

registro de atividades 20

require_cert_reg, alterando com o agentCfg 13

restaurando contasrequisitos de senha 48

Ssenhas

alterando a chave de configuração 19

chave de configuração, valor padrão 9, 19

senhas, alterando com o agentCfgprotocolo DAML 12

Servidor Tivoli Identity Managercomunicação com o adaptador 36

comunicação SSL 36

configurando a notificação de eventos 14

importando o perfil do adaptador 6

Software Supportcontatando 60

descrevendo o problema para IBM Software Support 61

determinando o impacto comercial para o IBM Software

Support 61

submetendo o problema ao IBM Software Support 62

srv_nodename, alterando com agentCfg 12

srv_portnumber, alterando com agentCfg 13

SSLcertificados auto-assinados 35

chaves privadas e certificados digitais 34

codificação 33

configuração de duas vias 37, 38

configuração de servidor para adaptador 36

formatos de chave 35

instalação de certificado 33

pedido de assinatura de certificado 42

visão geral 33

suporte ao clienteconsulte o suporte ao software 60

suporte UTF8 23

Ttexto, alternativa para imagens de documento ix

Tivoli_Common_Directorydefinição xii

Tivoli Software Information Center viii

Uupgrade

adaptador 51

ADK 51

perfil do adaptador 6

username, alterando com agentCfg 12

Vvalidação do cliente, SSL 38

validate_client_ce, alterando com agentCfg 13

variável de ambientenotação UNIX x

visão geral do adaptador 1

WWAS_HOME

definição xii

diretório de instalação do WebSphere Application Server

Base xii

WAS_MQ_HOMEdefinição xii

diretório de instalação do WebSphere MQ xii

WAS_NDM_HOMEdefinição xii

diretório de instalação do WebSphere Application Server

Network Deployment xii


��

Número do Programa:

Impresso em Brazil

S517-7851-05

ibmpublib.boulder.ibm.com/tividd/td/itim/sc32-1155-05/pt_br/... · 2005. 8. 31. · Índice...

Documents