How to whitelist a particular IP and allow it to connect to your RDS database.
What This Is About
By default, if you create an Amazon RDS MySQL database you won’t be able to connect to it unless you specifically whitelist inbound traffic sources.
In this post, I will show you step by step in the easiest way possible how to allow an IP to connect to your RDS instance (in other words, open port 3306). I am assuming this will be helpful for developers using RDS for the first time and wondering why they can’t just connect! 🤯
The instructions will pretty much work to open firewall ports for your AWS EC2 instances.
Note: when creating your RDS instance, make sure you choose to make it publicly accessible (it’s an option that pops up to you when creating the database).
Steps To Whitelist an IP
Choose your RDS database from the list of instances.
Scroll to the “Details” section then find the “Security groups” and click on the active security group link. This will directly redirect you to the security group you need to whitelist the IP address at.
Make sure the security group that belongs to your RDS database is selected/highlighted. If you are not sure which one it is, you can match them by the VPC ID (in this case it’s the one ending in 0bc0) or the GROUP IP (ending in 6cbf).
Click on “Inbound” at the bottom (you can also right click the highlighted item and click “Edit inbound rules”). Then click “Edit”.
In this last step you will just need to select the port to whitelist. If you are using the default MySQL port then selecting the “MYSQL/Aurora” option works. If you are using a custom port for your database, then under the “Type” dropdown select “Custom TCP Rule” and type the port number in the “Port Range” field.
Under the “Source” we finally add the IP address or IP range we need to whitelist. Note: The IP addresses you enter here must be not he range format, which means that you need to append /32 to the end of your IP address.
Example: to whitelist 22.214.171.124 you need to enter 126.96.36.199/32 in the source field.
Don’t forget to click “Save” then you are done ✅
Verify You Can Connect
Personally, I like using
telnet to check for open ports. In our case we can do the following to check if we can connect to the database instance after whitelisting the IP:
$ telnet hostname_or_endpoint_or_database_ip port
In the screenshot above, seeing the “Connected….” means that we can successfully connect to the RDS instance. If you only see the “Trying ….” line then you are still unable to access the instance.
If you are still unable to connect
- Repeat the steps and make sure you followed all instructions
- Make sure that your RDS instance is set to “Publicly Accessible”
- Verify you are trying to connect from the same IP address you whitelisted