Configurar Integração com o Database User Management (PostgreSQL)

Pré-requisitos

Antes de instalar e configurar um Sistema Orquestrado do Database User Management (PostgreSQL), você deve considerar os pré-requisitos e as tarefas a seguir.

Certificação

Verifique se o seu sistema Database User Management (PostgreSQL) é certificado com o Oracle Access Governance consultando Components Certified for Integration with Oracle Access Governance para obter detalhes das versões suportadas.

Criar uma Conta de Usuário de Serviço

O Oracle Access Governance requer uma conta de usuário para acessar o sistema do Database User Management (PostgreSQL) durante as operações de serviço. Dependendo do sistema que você está usando, é possível criar o usuário no sistema gerenciado e atribuir funções e privilégios específicos ao usuário.

Criar uma Conta de Usuário de Serviço para Operações de Sistema Orquestradas no Database User Management (PostgreSQL)

Para o Database User Management (PostgreSQL):

Crie um usuário svc_user_admintest usando a seguinte consulta:

CREATE ROLE "svc_user_admintest" WITH LOGIN PASSWORD 'SecurePass123' CREATEROLE SUPERUSER
CREATEDB REPLICATION BYPASSRLS;

Atribua as seguintes funções e privilégios ao usuário criado usando a seguinte consulta:

GRANT pg_read_all_data TO "svc_user_admintest" WITH ADMIN OPTION;
GRANT SELECT ON pg_user TO "svc_user_admintest" WITH GRANT OPTION;

Configurar

Você pode estabelecer uma conexão entre o Database User Management (PostgreSQL) e o Oracle Access Governance informando os detalhes da conexão. Para isso, use a funcionalidade de sistemas orquestrados disponível na Console do Oracle Access Governance.

Navegar até a Página Sistemas Orquestrados

A página Sistemas Orquestrados da Console do Oracle Access Governance é onde você inicia a configuração do seu sistema orquestrado.

Navegue até a página Sistemas Orquestrados da Console do Oracle Access Governance, seguindo estas etapas:

No ícone do menu de navegação do Oracle Access Governance, selecione Administração de Serviço → Sistemas Orquestrados.
Selecione o botão Adicionar um sistema orquestrado para iniciar o workflow.

Selecionar sistema

Na etapa Selecionar sistema do workflow, você pode especificar qual tipo de sistema deseja integrar ao Oracle Access Governance.

Você pode procurar o sistema necessário por nome usando o campo Pesquisar.

Selecione Gerenciamento de Usuários do Banco de Dados (PostgreSQL).
Clique em Avançar.

Adicionar detalhes

Adicione detalhes como nome, descrição e modo de configuração.

Na etapa Adicionar Detalhes do workflow, informe os detalhes do sistema orquestrado:

Informe um nome para o sistema ao qual você deseja se conectar no campo Nome.
Informe uma descrição para o sistema no campo Descrição.
Decida se esse sistema orquestrado é uma origem autorizada e se o Oracle Access Governance pode gerenciar permissões definindo as caixas de seleção a seguir.
- Esta é a origem autoritativa das minhas Identidades
  Selecione uma das opções:
  - Origem de identidades e seus atributos: O sistema atua como uma identidade de origem e atributos associados. Novas identidades são criadas através desta opção.
  - Somente origem de atributos de identidade: O sistema ingere detalhes adicionais de atributos de identidade e se aplica a identidades existentes. Esta opção não ingere nem cria novos registros de identidade.
- Desejo gerenciar permissões para este sistema
O valor padrão em cada caso é Desmarcado.
Selecione Próximo.

Observação

O sistema orquestrado do Database User Management (PostgreSQL) permite que você gerencie grupos no Database User Management (PostgreSQL) usando a opção Desejo gerenciar coleções de identidades para esse sistema orquestrado. Se marcada, esta caixa de seleção permite gerenciar grupos do Database User Management (PostgreSQL) no Oracle Access Governance. Todas as alterações feitas nos grupos do Database User Management (PostgreSQL) serão reconciliadas entre o Oracle Access Governance e o sistema orquestrado. Da mesma forma, quaisquer alterações feitas no Database User Management (PostgreSQL) serão refletidas no Oracle Access Governance

Adicionar Proprietários

Adicione proprietários principais e adicionais ao sistema orquestrado para permitir que eles gerenciem recursos.

Você pode associar a propriedade do recurso adicionando proprietários principais e adicionais. Isso impulsiona o autoatendimento, pois esses proprietários podem gerenciar (ler, atualizar ou excluir) os recursos de sua propriedade. Por padrão, o criador do recurso é designado como o proprietário do recurso. Você pode atribuir um proprietário principal e até 20 proprietários adicionais para os recursos.

Observação

Ao configurar o primeiro Sistema Orquestrado para sua instância de serviço, você só poderá designar proprietários depois de ativar as identidades na seção Gerenciar Identidades.

Para adicionar proprietários:

Selecione um usuário ativo do Oracle Access Governance como o proprietário principal no campo Quem é o proprietário principal?.
Selecione um ou mais proprietários adicionais na lista Quem mais possui?. Você pode adicionar até 20 proprietários adicionais para o recurso.

Você pode exibir o Proprietário Principal na lista. Todos os proprietários podem visualizar e gerenciar os recursos que possuem.

Definições da conta

Descreva detalhes de como gerenciar definições de conta ao configurar seu sistema orquestrado, incluindo definições de notificação, e ações padrão quando uma identidade é movida ou sai da sua organização.

Na etapa Configurações da conta do workflow, informe como você deseja que o Oracle Access Governance gerencie contas quando o sistema for configurado como um sistema gerenciado:

Quando uma permissão for solicitada e a conta ainda não existir, selecione esta opção para criar novas contas. Esta opção é selecionada por padrão. Quando selecionada, o Oracle Access Governance criará uma conta se uma não existir quando uma permissão for solicitada. Se você desmarcar essa opção, as permissões serão provisionadas somente para contas existentes no sistema orquestrado. Se não existir uma conta, a operação de provisionamento falhará.
Selecione os destinatários dos e-mails de notificação quando uma conta for criada. O destinatário padrão é Usuário. Se nenhum destinatário for selecionado, as notificações não serão enviadas quando as contas forem criadas.
- Usuário
- Gerente de usuários
Configurar Contas Existentes
Observação

Você só poderá definir essas configurações se permitido pelo administrador do sistema. Quando as configurações globais de encerramento de conta estão ativadas, os administradores de aplicativos não podem gerenciar as configurações de encerramento de conta no nível do sistema orquestrado.
1. Selecionar o que fazer com contas quando o desligamento antecipado começar: Escolha a ação a ser executada quando um desligamento antecipado começar. Isso acontece quando você precisa revogar os acessos de identidade antes da data de desligamento oficial.
  - Excluir: Exclui todas as contas e permissões gerenciadas pelo Oracle Access Governance.
    Observação
    
    Se um sistema orquestrado específico não suportar a ação, nenhuma ação será executada.
  - Desativar: Desativa todas as contas e desativa as permissões gerenciadas pelo Oracle Access Governance.
    - Excluir as permissões para contas desativadas: para garantir zero acesso residual, selecione esta opção para excluir permissões designadas diretamente e permissões concedidas pela política durante a desativação da conta.
  - Nenhuma ação: Nenhuma ação é tomada quando uma identidade é sinalizada para encerramento antecipado pelo Oracle Access Governance.
2. Selecionar o que fazer com contas na data de desligamento: Selecione a ação a ser executada durante o desligamento oficial. Isso acontece quando você precisa revogar os acessos de identidade na data de desligamento oficial.
  - Excluir: Exclui todas as contas e permissões gerenciadas pelo Oracle Access Governance.
    Observação
    
    Se um sistema orquestrado específico não suportar a ação Excluir, nenhuma ação será executada.
  - Desativar: Desativa todas as contas e desativa as permissões gerenciadas pelo Oracle Access Governance.
    - Excluir as permissões para contas desativadas: para garantir zero acesso residual, selecione esta opção para excluir permissões designadas diretamente e permissões concedidas pela política durante a desativação da conta.
    Observação
    
    Se um sistema orquestrado específico não suportar a ação Desativar, a conta será excluída.
  - Nenhuma ação: Nenhuma ação é tomada sobre contas e permissões pelo Oracle Access Governance.
Quando uma identidade sai da sua empresa, você deve remover o acesso às suas contas.
Observação

Você só poderá definir essas configurações se permitido pelo administrador do sistema. Quando as configurações globais de encerramento de conta estão ativadas, os administradores de aplicativos não podem gerenciar as configurações de encerramento de conta no nível do sistema orquestrado.
Selecione uma das seguintes ações para a conta:
- Excluir: Exclui todas as contas e permissões gerenciadas pelo Oracle Access Governance.
- Desativar: Desative todas as contas e marque as permissões como inativas.
  - Excluir as permissões para contas desativadas: Exclua permissões atribuídas diretamente e concedidas por política durante a desativação da conta para garantir zero acesso residual.
- Nenhuma ação: Não execute nenhuma ação quando uma identidade sair da organização.
Observação

Essas ações só estarão disponíveis se forem suportadas pelo tipo de sistema orquestrado. Por exemplo, se Excluir não for suportado, você verá apenas as opções Desativar e Nenhuma ação.
Quando todas as permissões de uma conta são removidas, por exemplo, quando uma identidade se move entre departamentos, você pode precisar decidir o que fazer com a conta. Selecione uma das seguintes ações, se for suportada pelo tipo de sistema orquestrado:
- Excluir
- Desativar
- Nenhuma ação
Gerenciar contas que não foram criadas pelo Access Governance: Selecione para gerenciar contas que são criadas diretamente no sistema orquestrado. Com isso, você pode reconciliar contas existentes e gerenciá-las no Oracle Access Governance.

Observação

Se você não configurar o sistema como um sistema gerenciado, essa etapa do workflow será exibida, mas não será ativada. Nesse caso, você vai diretamente para a etapa Configurações de integração do workflow.

Observação

Se seu sistema orquestrado exigir descoberta dinâmica de esquema, como nas integrações REST Genérico e Tabelas de Aplicativos de Banco de Dados, somente o destino do e-mail de notificação poderá ser definido (Usuário, Usermanager) ao criar o sistema orquestrado. Não é possível definir as regras de desativação/exclusão para movers e leavers. Para fazer isso, você precisa criar o sistema orquestrado e, em seguida, atualizar as definições da conta conforme descrito em Configurar Definições da Conta do Sistema Orquestrado.

Definições de integração

Informe os detalhes da conexão com o sistema de Gerenciamento de Usuários do Banco de Dados (PostgreSQL).

Na etapa Definições de integração do workflow, informe os detalhes necessários para permitir que o Oracle Access Governance se conecte ao seu sistema de Gerenciamento de Usuários do Banco de Dados (PostgreSQL).

Definições de integração
Nome do Parâmetro	Obrigatório?	Descrição
Qual é o url de conexão fácil para o banco de dados?	Sim	Informe a string de conexão do banco de dados que você deseja integrar ao Oracle Access Governance, no formato `jdbc:postgresql:@[host]:[port]:[sid]`, por exemplo, `jdbc:postgresql://10.10.20.210:5432/postgres`.
Qual é o nome do usuário?	Sim	Informe o usuário do Database User Management (PostgreSQL) que você usará para estabelecer conexão com o banco de dados. Este é o usuário que você criou em Criar uma Conta de Usuário de Serviço.
Qual é a senha?	Sim	Informe a senha do usuário do Gerenciamento de Usuários do Banco de Dados (PostgreSQL).
Confirmar senha	Sim	Confirme a senha.
Quais são os detalhes do arquivo jar personalizado?	Sim	Informe o nome do jar e a soma de verificação do jar no seguinte formato `<jarName>::<jarChecksum>`. Por exemplo: `postgresql-42.7.5.jar::ef576afb1d8aa6f28e885ddbc6e5ed7623123b0a151e43e39b52ec0604144def2c310002d8837230cc3eef39f758dea36af1b12984ec6e510b52f8f50b66d05e` Para obter mais informações sobre jar personalizado, consulte Suporte a Jar Personalizado.

Clique em Adicionar para criar o sistema orquestrado.

Finalizar

Conclua a configuração do seu sistema orquestrado fornecendo detalhes sobre como realizar personalização adicional ou ativar e executar um carregamento de dados.

A etapa final do workflow é Concluir.

Na etapa Finalizar do workflow, você será solicitado a fazer download do agente que usará para fazer interface entre o Oracle Access Governance e o SAP User Management (UM). Selecione o link Fazer Download para fazer download do arquivo zip de agente para o ambiente no qual o agente será executado.

Após fazer download do agente, siga as instruções explicadas no artigo Administração do Agente.

Configuração de Pré-Inicialização para Inicialização do Agente

Antes de iniciar o agente, certifique-se de ter adicionado o JAR personalizado ao agente e concluído as seguintes configurações nos arquivos config.json e config.properties:

Para adicionar JAR personalizado:

Navegue até a pasta JAR personalizada.
<AGENT_HOME>/<PERSISTENT_VOLUME_LOCATION>/data/customJars
Adicione o arquivo JAR postgresql-42.7.5.jar.

Para config.json:

Navegue até o local padrão do arquivo config.json.
<AGENT_HOME>/<PERSISTENT_VOLUME_LOCATION>/data/conf/config.json
Atualize a seguinte propriedade:
"numberOfOperationsWorkerThread": 1,

Para config.properties:

Navegue até o local padrão do arquivo config.properties.
<AGENT_HOME>/<PERSISTENT_VOLUME_LOCATION>/data/conf/config.properties
Atualize a seguinte propriedade:
idoConfig.numberOfOperationsWorkerThread=1

Depois de atualizar os arquivos de configuração, você pode iniciar o agente.

Por fim, você tem a opção de configurar ainda mais seu sistema orquestrado antes de executar um carregamento de dados ou aceitar a configuração padrão e iniciar um carregamento de dados. Selecione uma opção:

Personalizar antes de ativar o sistema para cargas de dados
Ativar e preparar a carga de dados com os padrões fornecidos

Pós-Configuração

Não há etapas de pós-configuração associadas a um sistema de Gerenciamento de Usuários do Banco de Dados (PostgreSQL).

Documentação do Oracle Cloud Infrastructure