!!!! ACTIVELY UNDER CONSTRUCTION !!!!
Amazon Relational Database Service (Amazon RDS) makes it easy to set up, operate, and scale a relational database in the cloud. With this value proposition in mind, customers want to leverage cloud databases such as RDS to become the ForgeRock Identity Management (IDM) repository. This guide describes how to configure the Postgres flavor of RDS as an IDM repository.
- Setup AWS RDS Postgres instance.
- Configure network and security.
- Modify ForgeRock Postgres script.
- Complete steps for Postgres as an IDM repo, as documented in Installation Guide.
Setup Amazon RDS Postgres
Before starting, some key configuration details are needed:
- Port 5432
- PubliclyAccessible (true or false)
- Inbound add rules to accommodate the Postgres port (ie 5432) limited by IP addresses (optional)
- Outbound rules "CidrIp": "0.0.0.0/0"
- Enter the RDS Console
- Create a PostgreSQL DB Instance that matches a version ForgeRock Identity Management supports per our release notes: https://backstage.forgerock.com/docs/idm
- Configure based upon https://aws.amazon.com/getting-started/tutorials/create-connect-postgresql-db/
The above highlights changes from default settings. These are to create new security groups, VPC, subnets and to make the instance publicly available.
In production tighter control over the network may be desired, but the scope of this paper is not to illustrate a hardened configuration, but rather provide an easy configuration example for understanding.
Configure network and security
In the ForgeRock Installation Guide regarding the topic of Postgres repository configuration, there is a step that details how to setup security related to client connections. This step details how to edit the Postgres client authentication configuration file, pg_hba.conf. This step can be ignored as a step in the configuration, as it cannot be performed in the AWS RDS service. The functional equivalent is to setup an AWS Security Group configuration that allows remote clients (Identity Management process) to connect.
Inbound rules should look like this:
Outbound rules should look like this:
Security Group / VPC Architecture
Note there is a relationship with the Amazon concept of Virtual Private Cloud (VPC) settings and the associated Amazon concept of a Security Group. Both are key to connectivity to services, including RDS.
Modify ForgeRock Postgres script
There exist some RDS nuances, that require modification to the createuser.psql script.
edit this file in Identity Management (AKA OpenIDM) environment:
copy the createuser.pgsql to create-user-aws-rds.pgsql and edit as below.